org.tsds.datasource

Class TsmlNcml

java.lang.Object

org.tsds.datasource.TsmlNcml

public class TsmlNcml
extends java.lang.Object

This new transport for the TSDS server uses a dialect of ncml to describe data. Using a particular dialect allows a simple reader to be used without having to include the full netcdf library. The public method "doRead" the entry point, and is given the location of one of ncml+tsml data, and then internal references are followed to load the data values as well as metadata.

Constructor Summary

Constructors

Constructor and Description
TsmlNcml()

Method Summary

Modifier and Type	Method and Description
QDataSet	doRead(java.net.URL url, java.net.URLConnection connect) read the ncml+tsml from the url, and follow references to read in the dataset.
protected MutablePropertyDataSet	location(org.w3c.dom.Node node)
static void	main(java.lang.String[] args)
protected MutablePropertyDataSet	netcdf(org.w3c.dom.Node node)
protected MutablePropertyDataSet	tsds(java.net.URL url, int size, int len1, java.lang.Object type, ProgressMonitor mon) Read in the binary table from the server.
protected MutablePropertyDataSet	tsdsLocation(org.w3c.dom.Node node) read in values in a different location using the org.timeseries.tsds IOServiceProvider.
protected MutablePropertyDataSet	variable(org.w3c.dom.Node node, java.util.Map<java.lang.String,org.w3c.dom.Node> dimensions, MutablePropertyDataSet values)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TsmlNcml

public TsmlNcml()

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Throws:

java.lang.Exception

doRead

public QDataSet doRead(java.net.URL url,
                       java.net.URLConnection connect)
                throws java.io.IOException,
                       javax.xml.parsers.ParserConfigurationException,
                       org.xml.sax.SAXException

read the ncml+tsml from the url, and follow references to read in the dataset.

Parameters:

url - the location of ncml+tsml file. This also defines the codebase for references within the file.

connect, - if non-null, use this connection. url must still be provided to define the codebase.

Returns:

the data in a QDataSet.

Throws:

java.io.IOException

javax.xml.parsers.ParserConfigurationException

org.xml.sax.SAXException

netcdf

protected MutablePropertyDataSet netcdf(org.w3c.dom.Node node)
                                 throws java.net.MalformedURLException,
                                        java.io.IOException

Throws:

java.net.MalformedURLException

java.io.IOException

location

protected MutablePropertyDataSet location(org.w3c.dom.Node node)
                                   throws java.net.MalformedURLException,
                                          java.io.IOException

Throws:

java.net.MalformedURLException

java.io.IOException

variable

protected MutablePropertyDataSet variable(org.w3c.dom.Node node,
                                          java.util.Map<java.lang.String,org.w3c.dom.Node> dimensions,
                                          MutablePropertyDataSet values)

Parameters:

node -

dimensions -

values - if non-null, these are the values read in via iosp.

Returns:

tsdsLocation

protected MutablePropertyDataSet tsdsLocation(org.w3c.dom.Node node)
                                       throws java.net.MalformedURLException,
                                              java.io.IOException

read in values in a different location using the org.timeseries.tsds IOServiceProvider. The location should be URLEncoded or XML-escaped (&) in the ncml document. iospParam should identify the type and filter of the data, e.g. "double,filter4". Currently just filter4 and filter0 are supported.

Parameters:

node -

Returns:

Throws:

java.net.MalformedURLException

java.io.IOException

tsds

protected MutablePropertyDataSet tsds(java.net.URL url,
                                      int size,
                                      int len1,
                                      java.lang.Object type,
                                      ProgressMonitor mon)
                               throws java.io.IOException

Read in the binary table from the server. size is the total size of the tsds stream.

Parameters:

url - url location of the data.

size - the total size of the stream

len1 - length per record if rank 2, -1 if rank 1.

type - BufferDataSet.Float, etc.

mon -

Returns:

Throws:

java.io.IOException