<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 ) &rarr; <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 ) &rarr; <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 ) &rarr; <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(  ) &rarr; <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(  ) &rarr; 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 ) &rarr; 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(  ) &rarr; 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>