toString() method is used.
Note that units are ignored by this client, default units are used.
URLs must all have the following format
adde://host/point?keyword_1=value_1&keyword_2=value_2
there can be any valid combination of the following supported keywords:
group= ADDE group name
descr= ADDE descriptor name
pos= request an absolute or relative ADDE
position number
select= to specify which data is required
param= what parameters to return
num= maximum number of obs to return
user= ADDE user identification
proj= a valid ADDE project number
trace=<0/1> setting to 1 tells server to write debug
trace file (imagedata, imagedirectory)
version=1 ADDE version number, currently 1
the following keywords are required:
group
descr
an example URL might look like:
adde://rtds/point?group=neons&type=metar
Constructor Summary
AddePointDataReader (java.lang.String request)
creates an AddePointDataReader object that allows reading ADDE point
datasets.
Method Summary
int[][]
getData ()
Return the data sent by the server
int
getNumParams ()
return the number of parameters
java.lang.String[]
getParams ()
Get the list of parameters
int[]
getScales ()
Get the list of scaling factors
java.lang.String[]
getUnits ()
Get the list of units
static void
main (java.lang.String[] args)
test by running 'java edu.wisc.ssec.mcidas.adde.AddePointDataReader'
java.lang.String
toString ()
Return a formated string of the returned data
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
AddePointDataReader
public AddePointDataReader (java.lang.String request)
throws AddeException
creates an AddePointDataReader object that allows reading ADDE point
datasets.
Parameters: request
- ADDE URL to read from. See class javadoc.
an example URL might look like:
adde://rtds.ho.bom.gov.au/point?group=neons&descr=metar
Throws:
AddeException
- if there are no datasets of the particular
type or there is an error reading data
getData
public int[][] getData ()
throws AddeException
Return the data sent by the server
Returns: array of the data. Data is in the format of an integer array
of unscaled integers as returned from the server.
Throws:
AddeException
- if there was an error reading data
getParams
public java.lang.String[] getParams ()
throws AddeException
Get the list of parameters
Returns: array of the parameter names. The names will be in the same
order as the array of data values in the getData()
method.
Throws:
AddeException
- if there was an error reading data
getUnits
public java.lang.String[] getUnits ()
throws AddeException
Get the list of units
Returns: array of the unit names. The names will be in the same
order as the array of data values in the getData()
method.
Throws:
AddeException
- if there was an error reading data
getScales
public int[] getScales ()
throws AddeException
Get the list of scaling factors
Returns: array of the scaling factors (powers of 10). The scaling
factors will be in the same order as the array of data
values in the getData()
method.
Throws:
AddeException
- if there was an error reading data
getNumParams
public int getNumParams ()
throws AddeException
return the number of parameters
Returns: number of parameters returned from the server
Throws:
AddeException
toString
public java.lang.String toString ()
Return a formated string of the returned data
Overrides: toString
in class java.lang.Object
Returns: formatted representation of the data ala McIDAS PTLIST command.
main
public static void main (java.lang.String[] args)
throws java.lang.Exception
test by running 'java edu.wisc.ssec.mcidas.adde.AddePointDataReader'
Throws:
java.lang.Exception