<h2>org.autoplot.datasource.DataSourceFactory</h2><p>DataSourceFactories create data sources which resolve a URI into a QDataSet. Some DataSourceFactories support discovery, meaning they will provide a GUI to create URIs with no other information.</p> <hr> <a name="getCapability"></a> <h2>getCapability</h2> getCapability( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html'>java.lang.Class</a> clazz ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html'>Object</a> <p>return additional tools for creating valid URIs, such as TimeSeriesBrowse. This may soon include a file selector, and an automatic GUI created from the completions model.</p> <h3>Parameters</h3> clazz - the class, such as org.autoplot.datasource.capability.TimeSeriesBrowse <h3>Returns:</h3> the capability, such as an instance of org.autoplot.datasource.capability.TimeSeriesBrowse <br><br> <a href="https://github.com/autoplot/dev/search?q=getCapability&unscoped_q=getCapability">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSourceFactory.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSourceFactory.html#getCapability">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSourceFactory.java#l47">[view source]</a> <br> <br> <hr> <a name="getCompletions"></a> <h2>getCompletions</h2> getCompletions( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/autoplot/datasource/CompletionContext.html'>org.autoplot.datasource.CompletionContext</a> cc, <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 context-sensitive completions. If an exception is thrown, then an a error dialog is displayed for RuntimeExceptions. Compile-time exceptions may be displayed more gently, relying on getMessage to aid the human operator.</p> <h3>Parameters</h3> cc - the context for the completion. <br> mon - a progress monitor, for example to monitor a file download. <h3>Returns:</h3> a set of completions <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/DataSourceFactory.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSourceFactory.html#getCompletions">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSourceFactory.java#l38">[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>return a dataSource for the url</p> <h3>Parameters</h3> uri - the URI <h3>Returns:</h3> the DataSource <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/DataSourceFactory.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSourceFactory.html#getDataSource">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSourceFactory.java#l27">[view source]</a> <br> <br> <hr> <a name="getDescription"></a> <h2>getDescription</h2> getDescription( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>return a short description of the factory, or empty string. For example, "NASA Common Data Format (CDF) Files" or "NASA CDAWeb". This will be used to identify files or discovery sources.</p> <h3>Returns:</h3> a short description of the factory. <br><br> <a href="https://github.com/autoplot/dev/search?q=getDescription&unscoped_q=getDescription">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSourceFactory.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSourceFactory.html#getDescription">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSourceFactory.java#l85">[view source]</a> <br> <br> <hr> <a name="isFileResource"></a> <h2>isFileResource</h2> isFileResource( ) → boolean <p>true if the data source is based on files. For example, a CDF file is true, since the URIs contain cdf file names, and while vap+cdaweb uses files to move data, it is not file based. This is initially used to limit the entries in file choosers.</p> <h3>Returns:</h3> true if the data source is based on files. <br><br> <a href="https://github.com/autoplot/dev/search?q=isFileResource&unscoped_q=isFileResource">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSourceFactory.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSourceFactory.html#isFileResource">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSourceFactory.java#l77">[view source]</a> <br> <br> <hr> <a name="reject"></a> <h2>reject</h2> reject( <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/util/List.html'>java.util.List</a> problems, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → boolean <p>quick check to see that an uri looks acceptable. since 2012b, this should provide a list of objects marking reasons for rejecting. Though each object is simply a marker, toString method of each should provide some meaningful information to developers. This list will be passed into the editor if available.</p> <h3>Parameters</h3> suri - the uri. <br> problems - list to which problems should be added. TODO: human readable or PROB_TIMERANGE? <br> mon - a progress monitor, for example to monitor a file download. <h3>Returns:</h3> true if the string cannot be used as a URI. <br><br> <a href="https://github.com/autoplot/dev/search?q=reject&unscoped_q=reject">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSourceFactory.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSourceFactory.html#reject">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSourceFactory.java#l60">[view source]</a> <br> <br> <hr> <a name="supportsDiscovery"></a> <h2>supportsDiscovery</h2> supportsDiscovery( ) → boolean <p>mark that this source has an editor that allows discovery of data, and the GUI can be entered with "vap+ext:" This must be consistent with the reject method of the editor.</p> <h3>Returns:</h3> true if the data source factory supports discovery. <br><br> <a href="https://github.com/autoplot/dev/search?q=supportsDiscovery&unscoped_q=supportsDiscovery">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/autoplot/datasource/DataSourceFactory.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/autoplot/datasource/DataSourceFactory.html#supportsDiscovery">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/DataSource/src/org/autoplot/datasource/DataSourceFactory.java#l68">[view source]</a> <br> <br>