org.das2.client

Class DasServer

java.lang.Object

org.das2.client.DasServer

public class DasServer
extends java.lang.Object

Represents a remote Das 2.1 compliant server. Use the create() method to instantiate new Das 2 server objects. Each call to create() will only allocate a new server instance if no server matching the given URL has already been created.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DasServer.DataSrcListItem Class to represent know information about an item in a list of data sources.

Method Summary

Modifier and Type	Method and Description
Key	authenticate(java.lang.String user, java.lang.String passCrypt) Deprecated.
void	changePassword(java.lang.String user, java.lang.String oldPass, java.lang.String newPass) Deprecated.
static DasServer	create(java.net.URL url) Get a Das2 server instance.
static DasServer	createPlasmaWaveGroup() return one DasServer to serve as an example.
javax.swing.tree.TreeModel	getDataSetList()
protected javax.swing.tree.TreeModel	getDataSetList(java.lang.String sSuffix)
javax.swing.tree.TreeModel	getDataSetListWithDiscovery()
java.lang.String	getHost()
Key	getKey(java.lang.String resource)
javax.swing.ImageIcon	getLogo()
java.lang.String	getName() Query the remote DasServer for it's id string.
java.lang.String	getPath()
int	getPort()
java.lang.String	getProto()
StandardDataStreamSource	getStandardDataStreamSource(java.net.URL url)
StreamDescriptor	getStreamDescriptor(java.net.URL dataSetID)
java.lang.String	getURL() Provide the Das2 Server location.
java.net.URL	getURL(java.lang.String formData)
java.util.List	groups(Key key) Deprecated. this is not used.
java.lang.String	readServerResponse(java.io.BufferedInputStream in) Deprecated.
void	setKey(Key key)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

createPlasmaWaveGroup

public static DasServer createPlasmaWaveGroup()

return one DasServer to serve as an example.

Returns:

getURL

public java.lang.String getURL()

Provide the Das2 Server location. Note that more than one Das2 server may be present on a single host web-site.

Returns:

A URL string containing protocol, host and path information.

create

public static DasServer create(java.net.URL url)

Get a Das2 server instance.

Parameters:

url - A Das2 resource URL. Only the protocol, host, port and path information are used. All other items, such as a GET query are ignored.

Returns:

If a server matching the given url's protocol, host and path has already been created, that instance is returned, otherwise a new instance is created.

getName

public java.lang.String getName()

Query the remote DasServer for it's id string. For Das 2.1 servers this is handled by sending the GET query ?server=id.

Returns:

A string containing the id, or the empty string if the query failed

getLogo

public javax.swing.ImageIcon getLogo()

getDataSetListWithDiscovery

public javax.swing.tree.TreeModel getDataSetListWithDiscovery()
                                                       throws DasException

Throws:

DasException

getDataSetList

public javax.swing.tree.TreeModel getDataSetList()
                                          throws DasException

Throws:

DasException

getDataSetList

protected javax.swing.tree.TreeModel getDataSetList(java.lang.String sSuffix)
                                             throws DasIOException

Throws:

DasIOException

getStandardDataStreamSource

public StandardDataStreamSource getStandardDataStreamSource(java.net.URL url)

getStreamDescriptor

public StreamDescriptor getStreamDescriptor(java.net.URL dataSetID)
                                     throws DasException

Throws:

DasException

authenticate

@Deprecated
public Key authenticate(java.lang.String user,
                                    java.lang.String passCrypt)

Deprecated.

Handles key based authentication

groups

public java.util.List groups(Key key)

Deprecated. this is not used.

returns a List<String> of resource Id's available with this key

Parameters:

key - the key

Returns:

a list of the groups.

changePassword

public void changePassword(java.lang.String user,
                           java.lang.String oldPass,
                           java.lang.String newPass)
                    throws DasServerException

Deprecated.

old code for changing password

Parameters:

user -

oldPass -

newPass -

Throws:

DasServerException

readServerResponse

public java.lang.String readServerResponse(java.io.BufferedInputStream in)

Deprecated.

Parameters:

in -

Returns:

getProto

public java.lang.String getProto()

getHost

public java.lang.String getHost()

getPort

public int getPort()

getPath

public java.lang.String getPath()

getURL

public java.net.URL getURL(java.lang.String formData)
                    throws java.net.MalformedURLException

Throws:

java.net.MalformedURLException

getKey

public Key getKey(java.lang.String resource)

setKey

public void setKey(Key key)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object