<h2>org.autoplot.datasource.DataSetURI</h2><p>Works with DataSourceRegistry to translate a URI into a DataSource. Also, will provide completions.</p> <h2>DataSetURI( )</h2> <p></p> <hr> <a name="RECOGNIZE_FILE_EXTENSION_JSON"></a> <h2>RECOGNIZE_FILE_EXTENSION_JSON</h2> <p>carefully inspect the file to see if there is a particular handler for it.</p> <hr> <a name="RECOGNIZE_FILE_EXTENSION_XML"></a> <h2>RECOGNIZE_FILE_EXTENSION_XML</h2> <p>carefully inspect the file to see if there is a particular handler for it.</p> <hr> <a name="abbreviateForHumanComsumption"></a> <h2>abbreviateForHumanComsumption</h2> abbreviateForHumanComsumption( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> ssuri, int len ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>return a human-readable abbreviation of the URI, limiting to len characters.</p> <h3>Parameters</h3> ssuri - a String <br> len - an int <h3>Returns:</h3> a string of length no more than len characters <br><br> <a href="https://github.com/autoplot/dev/search?q=abbreviateForHumanComsumption&unscoped_q=abbreviateForHumanComsumption">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#abbreviateForHumanComsumption">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l439">[view source]</a> <br> <br> <hr> <a name="blurTsbResolutionUri"></a> <h2>blurTsbResolutionUri</h2> blurTsbResolutionUri( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> value ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>create the URI without the timerange.</p> <h3>Parameters</h3> value - a uri. e.g. /tmp/foo$Y$m$d.dat?timerange=2014-001 <h3>Returns:</h3> null or the value without the timerange, e.g. /tmp/foo$Y$m$d.dat <br><br> <a href="https://github.com/autoplot/dev/search?q=blurTsbResolutionUri&unscoped_q=blurTsbResolutionUri">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#blurTsbResolutionUri">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l393">[view source]</a> <br> <br> <hr> <a name="blurTsbUri"></a> <h2>blurTsbUri</h2> blurTsbUri( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> value ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>create the URI without the timerange.</p> <h3>Parameters</h3> value - a uri. e.g. /tmp/foo$Y$m$d.dat?timerange=2014-001 <h3>Returns:</h3> null or the value without the timerange, e.g. /tmp/foo$Y$m$d.dat <br><br> <a href="https://github.com/autoplot/dev/search?q=blurTsbUri&unscoped_q=blurTsbUri">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#blurTsbUri">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l374">[view source]</a> <br> <br> <hr> <a name="checkLength"></a> <h2>checkLength</h2> checkLength( <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a> file ) → void <p>check that the file has length>0 and throw EmptyFileException if it does. This code is the standard way this should be done.</p> <h3>Parameters</h3> file - a File <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=checkLength&unscoped_q=checkLength">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#checkLength">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l786">[view source]</a> <br> <br> <hr> <a name="downloadResourceAsTempFile"></a> <h2>downloadResourceAsTempFile</h2> downloadResourceAsTempFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URL.html'>java.net.URL</a> url, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a> <p>This loads the URL to a local temporary file. If the temp file is already downloaded and less than 10 seconds old, it will be used.</p> <h3>Parameters</h3> url - the address to download. <br> mon - a progress monitor. <h3>Returns:</h3> a File in the FileSystemCache. The file will have question marks and ampersands removed. <h3>See Also:</h3> <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/DataSetURI/downloadResourceAsTempFile/.html'>DataSetURI.downloadResourceAsTempFile.</a> <br> <br><br> <a href="https://github.com/autoplot/dev/search?q=downloadResourceAsTempFile&unscoped_q=downloadResourceAsTempFile">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#downloadResourceAsTempFile">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1086">[view source]</a> <br> <br> downloadResourceAsTempFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URL.html'>java.net.URL</a> url, int timeoutSeconds, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a><br> <hr> <a name="fromFile"></a> <h2>fromFile</h2> fromFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a> file ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>canonical method for converting from File to human-readable string. This simply tacks on "file://" to the filename. This was introduced so that there is one canonical way to do this.</p> <h3>Parameters</h3> file - a File <h3>Returns:</h3> a String <br><br> <a href="https://github.com/autoplot/dev/search?q=fromFile&unscoped_q=fromFile">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#fromFile">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l756">[view source]</a> <br> <br> <hr> <a name="fromUri"></a> <h2>fromUri</h2> fromUri( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> uri ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>canonical method for converting URI to human-readable string, containing spaces and other illegal characters. Note pluses in the query part are interpreted as spaces. See also URISplit.uriDecode,etc.</p> <h3>Parameters</h3> uri - an URI <h3>Returns:</h3> a String <br><br> <a href="https://github.com/autoplot/dev/search?q=fromUri&unscoped_q=fromUri">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#fromUri">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l733">[view source]</a> <br> <br> <hr> <a name="getCacheFilename"></a> <h2>getCacheFilename</h2> getCacheFilename( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> suri ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a> <p>provide standard logic for identifying the cache location for a file. The file will not be downloaded, but clients can check to see if such resource has already been loaded. There is one case where this might be slow, and that's when a zip file must be downloaded to get the location. This returns null if the file is not from the cache (e.g. local file references).</p> <h3>Parameters</h3> suri - the uri like http://autoplot.org/data/autoplot.dat <h3>Returns:</h3> the cache file, like /home/jbf/autoplot_data/fscache/http/autoplot.org/data/autoplot.dat, or null if the file is not from the cache. <br><br> <a href="https://github.com/autoplot/dev/search?q=getCacheFilename&unscoped_q=getCacheFilename">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getCacheFilename">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l919">[view source]</a> <br> <br> <hr> <a name="getCompletions"></a> <h2>getCompletions</h2> getCompletions( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl, int carotpos, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>this is never used in the application code. It must be left over from an earlier system. This is used in Test005, some scripts, and IDL codes, so don't delete it!</p> <h3>Parameters</h3> surl - a String <br> carotpos - an int <br> mon - a ProgressMonitor <h3>Returns:</h3> a java.util.List <br><br> <a href="https://github.com/autoplot/dev/search?q=getCompletions&unscoped_q=getCompletions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getCompletions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1631">[view source]</a> <br> <br> <hr> <a name="getDataSource"></a> <h2>getDataSource</h2> getDataSource( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> uri ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/autoplot/datasource/DataSource.html'>org.autoplot.datasource.DataSource</a> <p>get the data source for the URI.</p> <h3>Parameters</h3> uri - the URI. <h3>Returns:</h3> the data source from which the data set can be retrieved. <br><br> <a href="https://github.com/autoplot/dev/search?q=getDataSource&unscoped_q=getDataSource">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getDataSource">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l178">[view source]</a> <br> <br> getDataSource( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> suri ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/autoplot/datasource/DataSource.html'>org.autoplot.datasource.DataSource</a><br> <hr> <a name="getDataSourceFactory"></a> <h2>getDataSourceFactory</h2> getDataSourceFactory( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> uri, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/autoplot/datasource/DataSourceFactory.html'>org.autoplot.datasource.DataSourceFactory</a> <p>get the datasource factory for the URL. This has the rarely-used logic that looks up MIME types for HTTP requests.</p> <h3>Parameters</h3> uri - the URI of the data source. <br> mon - progress monitor <h3>Returns:</h3> the factory that produces the data source. <br><br> <a href="https://github.com/autoplot/dev/search?q=getDataSourceFactory&unscoped_q=getDataSourceFactory">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getDataSourceFactory">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l501">[view source]</a> <br> <br> <hr> <a name="getDataSourceFormat"></a> <h2>getDataSourceFormat</h2> getDataSourceFormat( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> uri ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/autoplot/datasource/DataSourceFormat.html'>org.autoplot.datasource.DataSourceFormat</a> <p>for now, just hide the URI stuff from clients, let's not mess with factories</p> <h3>Parameters</h3> uri - the URI describing the output format and any arguments. <h3>Returns:</h3> the DataSourceFormat that formats a dataset to the format. <br><br> <a href="https://github.com/autoplot/dev/search?q=getDataSourceFormat&unscoped_q=getDataSourceFormat">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getDataSourceFormat">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l460">[view source]</a> <br> <br> <hr> <a name="getDataSourceUri"></a> <h2>getDataSourceUri</h2> getDataSourceUri( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/autoplot/datasource/DataSource.html'>org.autoplot.datasource.DataSource</a> ds ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>Prefix the URL with the datasource extension if necessary, so that the URL would resolve to the dataSource. This is to support TimeSeriesBrowse, and any time a resouce URL must be understood out of context. TODO: note ds.getURI() should return the fully-qualified URI, so this is no longer necessary.</p> <h3>Parameters</h3> ds - the data source. <h3>Returns:</h3> the canonical URI. <br><br> <a href="https://github.com/autoplot/dev/search?q=getDataSourceUri&unscoped_q=getDataSourceUri">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getDataSourceUri">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l211">[view source]</a> <br> <br> <hr> <a name="getDiscoverableExtensions"></a> <h2>getDiscoverableExtensions</h2> getDiscoverableExtensions( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>return a list of the extensions we were can immediately enter the editor, so new users can plot things without knowing how to start a URI. Since rev 10581, this uses introspection to call the reject method to support compiling the applet.</p> <h3>Returns:</h3> a java.util.List <br><br> <a href="https://github.com/autoplot/dev/search?q=getDiscoverableExtensions&unscoped_q=getDiscoverableExtensions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getDiscoverableExtensions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l2222">[view source]</a> <br> <br> <hr> <a name="getExplicitExt"></a> <h2>getExplicitExt</h2> getExplicitExt( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>return the extension prefix of the URI, if specified.</p> <h3>Parameters</h3> surl - a String <h3>Returns:</h3> null or an extension like "tsds" <br><br> <a href="https://github.com/autoplot/dev/search?q=getExplicitExt&unscoped_q=getExplicitExt">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getExplicitExt">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l160">[view source]</a> <br> <br> <hr> <a name="getExt"></a> <h2>getExt</h2> getExt( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>returns the explicit extension, or the file extension if found, or null. The extension will not contain a period. Inputs include:<ul> <li>ac_h2_cris_20111221_v06.cdf → "cdf" <li>/tmp/ac_h2_cris_20111221_v06.cdf → "cdf" <li>/tmp/ac_h2_cris_20111221_v06 → null </ul></p> <h3>Parameters</h3> surl - a String <h3>Returns:</h3> the extension found, without the ".", or null if no period is found in the filename. <br><br> <a href="https://github.com/autoplot/dev/search?q=getExt&unscoped_q=getExt">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getExt">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l124">[view source]</a> <br> <br> <hr> <a name="getFactoryCompletions"></a> <h2>getFactoryCompletions</h2> getFactoryCompletions( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl1, int carotPos, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>get the completions from the plug-in factory..</p> <h3>Parameters</h3> surl1 - a String <br> carotPos - an int <br> mon - a ProgressMonitor <h3>Returns:</h3> a java.util.List <br><br> <a href="https://github.com/autoplot/dev/search?q=getFactoryCompletions&unscoped_q=getFactoryCompletions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getFactoryCompletions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l2306">[view source]</a> <br> <br> <hr> <a name="getFile"></a> <h2>getFile</h2> getFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URL.html'>java.net.URL</a> url, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a> <p>return a file reference for the url. This is initially to fix the problem for Windows where new URL( "file://c:/myfile.dat" ).getPath() -> "/myfile.dat". This will use a temporary local file in some cases, such as when the URL has parameters, which prevent use with the FileSystem model. TODO: why are there both getFile(url,mon) and getFile( suri, allowHtml, mon )???</p> <h3>Parameters</h3> url - the URL of the file. <br> mon - progress monitor or null. If null then AlertProgressMonitor is used to show when the download time is not trivial. <h3>Returns:</h3> the File <h3>See Also:</h3> <a href='null'>getFile(java.lang.String, boolean, org.das2.util.monitor.ProgressMonitor)</a> <br> <br><br> <a href="https://github.com/autoplot/dev/search?q=getFile&unscoped_q=getFile">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getFile">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l842">[view source]</a> <br> <br> getFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> suri, boolean allowHtml, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a><br> getFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> uri, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a><br> getFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> uri, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a><br> getFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> uri ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a><br> <hr> <a name="getFileSystemAggCompletions"></a> <h2>getFileSystemAggCompletions</h2> getFileSystemAggCompletions( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl, int carotpos, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>get completions within the filesystem that appear to form aggregations. Note this does not appear to be used, having no Java references.</p> <h3>Parameters</h3> surl - a String <br> carotpos - an int <br> mon - a ProgressMonitor <h3>Returns:</h3> a java.util.List <br><br> <a href="https://github.com/autoplot/dev/search?q=getFileSystemAggCompletions&unscoped_q=getFileSystemAggCompletions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getFileSystemAggCompletions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1768">[view source]</a> <br> <br> <hr> <a name="getFileSystemCacheCompletions"></a> <h2>getFileSystemCacheCompletions</h2> getFileSystemCacheCompletions( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl, int carotpos, boolean inclAgg, boolean inclFiles, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> acceptPattern, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>gets completions based on cached folders. This supports use when the filesystem is offline, when parents are not web filesystems, and presents used folders separately.</p> <h3>Parameters</h3> surl - http://sarahandjeremy.net/ <br> carotpos - the position of the carot. Presently everything after the carot is ignored. <br> inclAgg - include aggregations it sees. These are a guess. <br> inclFiles - include files as well as aggregations. <br> acceptPattern - if non-null, files and aggregations much match this. <br> mon - a ProgressMonitor <h3>Returns:</h3> possibly immutable list. <br><br> <a href="https://github.com/autoplot/dev/search?q=getFileSystemCacheCompletions&unscoped_q=getFileSystemCacheCompletions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getFileSystemCacheCompletions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1835">[view source]</a> <br> <br> <hr> <a name="getFileSystemCompletions"></a> <h2>getFileSystemCompletions</h2> getFileSystemCompletions( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl, int carotpos, boolean inclAgg, boolean inclFiles, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> acceptPattern, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>get completions within the filesystem for the directory listing of files.</p> <h3>Parameters</h3> surl - a String <br> carotpos - an int <br> inclAgg - include aggregations it sees. These are a guess. <br> inclFiles - include files as well as aggregations. <br> acceptPattern - if non-null, files and aggregations much match this. <br> mon - a ProgressMonitor <h3>Returns:</h3> a java.util.List <br><br> <a href="https://github.com/autoplot/dev/search?q=getFileSystemCompletions&unscoped_q=getFileSystemCompletions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getFileSystemCompletions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1814">[view source]</a> <br> <br> getFileSystemCompletions( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl, int carotpos, boolean inclAgg, <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> inclFiles, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> acceptPattern, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a><br> <hr> <a name="getHostCompletions"></a> <h2>getHostCompletions</h2> getHostCompletions( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl, int carotpos, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>get completions for hosts, by looking in the user's cache area.</p> <h3>Parameters</h3> surl - a String <br> carotpos - an int <br> mon - a ProgressMonitor <h3>Returns:</h3> possibly immutable list. <br><br> <a href="https://github.com/autoplot/dev/search?q=getHostCompletions&unscoped_q=getHostCompletions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getHostCompletions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1676">[view source]</a> <br> <br> <hr> <a name="getHtmlFile"></a> <h2>getHtmlFile</h2> getHtmlFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URL.html'>java.net.URL</a> url, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/File.html'>java.io.File</a> <p>get the file, allowing it to have "<html>" in the front. Normally this is not allowed because of http://sourceforge.net/tracker/?func=detail&aid=3379717&group_id=199733&atid=970682</p> <h3>Parameters</h3> url - an URL <br> mon - a ProgressMonitor <h3>Returns:</h3> a java.io.File <br><br> <a href="https://github.com/autoplot/dev/search?q=getHtmlFile&unscoped_q=getHtmlFile">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getHtmlFile">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1468">[view source]</a> <br> <br> <hr> <a name="getInputStream"></a> <h2>getInputStream</h2> getInputStream( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URL.html'>java.net.URL</a> url, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html'>java.io.InputStream</a> <p>get the InputStream from the path part of the URI. The stream must be closed by the client.</p> <h3>Parameters</h3> url - URL like http://autoplot.org/data/autoplot.dat <br> mon - monitor that will monitor the stream as it is transmitted. <h3>Returns:</h3> the InputStream, which must be closed by the client. TODO: check usages... <br><br> <a href="https://github.com/autoplot/dev/search?q=getInputStream&unscoped_q=getInputStream">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getInputStream">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l639">[view source]</a> <br> <br> getInputStream( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> uri, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html'>java.io.InputStream</a><br> <hr> <a name="getResourceURI"></a> <h2>getResourceURI</h2> getResourceURI( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> uri ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> <p>returns the URI to be interpreted by the DataSource. This identifies a file (or database) resource that can be passed to VFS.</p> <h3>Parameters</h3> uri - an URI <h3>Returns:</h3> the URI for the datasource resource, or null if it is not valid. <br><br> <a href="https://github.com/autoplot/dev/search?q=getResourceURI&unscoped_q=getResourceURI">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getResourceURI">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l303">[view source]</a> <br> <br> getResourceURI( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a><br> <hr> <a name="getSortedDiscoverableExtentions"></a> <h2>getSortedDiscoverableExtentions</h2> getSortedDiscoverableExtentions( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>return the list of discoverable extentions, sorted by recent use.</p> <h3>Returns:</h3> a java.util.List <br><br> <a href="https://github.com/autoplot/dev/search?q=getSortedDiscoverableExtentions&unscoped_q=getSortedDiscoverableExtentions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getSortedDiscoverableExtentions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l2249">[view source]</a> <br> <br> <hr> <a name="getTypesCompletions"></a> <h2>getTypesCompletions</h2> getTypesCompletions( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl, int carotpos, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/List.html'>java.util.List</a> <p>return a list of completions showing discovery plugins, and the list of supported filesystem types.</p> <h3>Parameters</h3> surl - a String <br> carotpos - an int <br> mon - a ProgressMonitor <h3>Returns:</h3> a java.util.List <br><br> <a href="https://github.com/autoplot/dev/search?q=getTypesCompletions&unscoped_q=getTypesCompletions">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getTypesCompletions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l2190">[view source]</a> <br> <br> <hr> <a name="getURI"></a> <h2>getURI</h2> getURI( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> <p>canonical method for getting the Autoplot URI. If no protocol is specified, then file:// is used. Note URIs may contain prefix like vap+bin:http://www.cdf.org/data.cdf. The result will start with an Autoplot scheme like "vap:" or "vap+cdf:" Note 20111117: "vap+cdaweb:" -> URI( "vap+cdaweb:file:///" that's why this works to toUri doesn't.</p> <h3>Parameters</h3> surl - the string from the user that should be representable as a URI. <h3>Returns:</h3> the URI or null if it's clearly not a URI. <br><br> <a href="https://github.com/autoplot/dev/search?q=getURI&unscoped_q=getURI">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getURI">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1501">[view source]</a> <br> <br> <hr> <a name="getURIValid"></a> <h2>getURIValid</h2> getURIValid( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> <p>get a URI from the string which is believed to be valid. This was introduced because a number of codes called getURI without checking for null, which could be returned when the URI could not be parsed ("This is not a uri"). Codes that didn't check would produce a null pointer exception, and now they will produce a more accurate error.</p> <h3>Parameters</h3> surl - a String <h3>Returns:</h3> a java.net.URI <br><br> <a href="https://github.com/autoplot/dev/search?q=getURIValid&unscoped_q=getURIValid">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getURIValid">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1481">[view source]</a> <br> <br> <hr> <a name="getURL"></a> <h2>getURL</h2> getURL( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URL.html'>java.net.URL</a> <p>canonical method for getting the URL. These will always be web-downloadable URLs.</p> <h3>Parameters</h3> surl - the string from the user that should be representable as a URI. <h3>Returns:</h3> null or the URL if available. <br><br> <a href="https://github.com/autoplot/dev/search?q=getURL&unscoped_q=getURL">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getURL">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l1548">[view source]</a> <br> <br> <hr> <a name="getWebURL"></a> <h2>getWebURL</h2> getWebURL( <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> uri ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URL.html'>java.net.URL</a> <p>returns a downloadable URL from the Autoplot URI, perhaps popping off the data source specifier. This assumes that the resource is a URL, and getResourceURI().toURL() should be used to handle all cases.</p> <h3>Parameters</h3> uri - An Autoplot URI. <h3>Returns:</h3> a URL that can be downloaded, or null if it is not found. <br><br> <a href="https://github.com/autoplot/dev/search?q=getWebURL&unscoped_q=getWebURL">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#getWebURL">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l337">[view source]</a> <br> <br> <hr> <a name="init"></a> <h2>init</h2> init( ) → void <p>call this to trigger initialization</p> <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=init&unscoped_q=init">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#init">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l2532">[view source]</a> <br> <br> <hr> <a name="isAggregating"></a> <h2>isAggregating</h2> isAggregating( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> surl ) → boolean <p>check that the string uri is aggregating by looking for %Y's (etc) in the file part of the URI. This also looks for:<ul> <li>$y -- two digit year <li>$(o -- orbit number <li>$(periodic -- interval number <li>$v -- version </ul></p> <h3>Parameters</h3> surl - a String <h3>Returns:</h3> a boolean <br><br> <a href="https://github.com/autoplot/dev/search?q=isAggregating&unscoped_q=isAggregating">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#isAggregating">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l246">[view source]</a> <br> <br> <hr> <a name="main"></a> <h2>main</h2> main( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> args ) → void <p></p> <h3>Parameters</h3> args - a java.lang.String[] <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=main&unscoped_q=main">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#main">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l2535">[view source]</a> <br> <br> <hr> <a name="maybePlusToSpace"></a> <h2>maybePlusToSpace</h2> maybePlusToSpace( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> ssheet ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>Legacy behavior was to convert pluses into spaces in URIs. This caused problems distinguishing spaces from pluses, so we dropped this as the default behavior. If data sources are to support legacy URIs, then they should use this routine to mimic the behavior. This checks if the URI already contains spaces, and will not convert if there are already spaces.</p> <h3>Parameters</h3> ssheet - a String <h3>Returns:</h3> a String <br><br> <a href="https://github.com/autoplot/dev/search?q=maybePlusToSpace&unscoped_q=maybePlusToSpace">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#maybePlusToSpace">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l775">[view source]</a> <br> <br> <hr> <a name="resetUriTsbTime"></a> <h2>resetUriTsbTime</h2> resetUriTsbTime( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> value, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> timeRange ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>return the URI with a new time.</p> <h3>Parameters</h3> value - a String <br> timeRange - a DatumRange <h3>Returns:</h3> the URI with a new time. <br><br> <a href="https://github.com/autoplot/dev/search?q=resetUriTsbTime&unscoped_q=resetUriTsbTime">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#resetUriTsbTime">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l416">[view source]</a> <br> <br> <hr> <a name="toUri"></a> <h2>toUri</h2> toUri( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> suri ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/net/URI.html'>java.net.URI</a> <p>canonical method for converting string from the wild into a URI-safe string. This contains the code that converts a colloquial string URI into a properly formed URI. For example: space is converted to "%20" %Y is converted to $Y This does not add file: or vap:. Pluses are only changed in the params part.</p> <h3>Parameters</h3> suri - a String <h3>Returns:</h3> a java.net.URI <br><br> <a href="https://github.com/autoplot/dev/search?q=toUri&unscoped_q=toUri">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#toUri">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l698">[view source]</a> <br> <br> <hr> <a name="unaggregate"></a> <h2>unaggregate</h2> unaggregate( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> resourceURI, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> timerange ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> <p>taken from unaggregate.jy in the servlet.</p> <h3>Parameters</h3> resourceURI - resource URI like "file://tmp/data$Y$m$d.dat" <br> timerange - a timerange that will be covered by the span. <h3>Returns:</h3> the strings resolved. <br><br> <a href="https://github.com/autoplot/dev/search?q=unaggregate&unscoped_q=unaggregate">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSetURI.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSetURI.html#unaggregate">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSetURI.java#l277">[view source]</a> <br> <br>