ch.specchio.client

Class SPECCHIODatabaseDescriptor

java.lang.Object

ch.specchio.client.SPECCHIODatabaseDescriptor

All Implemented Interfaces:

SPECCHIOServerDescriptor

public class SPECCHIODatabaseDescriptor
extends java.lang.Object
implements SPECCHIOServerDescriptor

This class encapsulates all of the information necessary to connect to a local database via a JDBC driver.

Constructor Summary

Constructors

Constructor and Description
SPECCHIODatabaseDescriptor(java.lang.String[] tokens) Constructor for SPECCHIOClientFactory.process_line().
SPECCHIODatabaseDescriptor(java.lang.String server, int port, java.lang.String schema, java.lang.String dataSourceName) Constructor for an anonymous connection to the database.
SPECCHIODatabaseDescriptor(java.lang.String server, int port, java.lang.String schema, java.lang.String dataSourceName, java.lang.String user, java.lang.String password) Constructor.

Method Summary

Modifier and Type	Method and Description
SPECCHIOClient	createClient() Create a web client that can connect to the server represented by this descriptor.
java.lang.String	getAccountConfigurationString() Get the string describing the account configuration for db_config.txt
java.lang.String	getDatabaseName() The the database name.
java.lang.String	getDataSourceName() Get a name of the datasource (JNDI).
java.lang.String	getDisplayName(boolean showUser, boolean show_datasource_name) Get the display name of this server.
java.lang.String	getDisplayUser() Get the user name.
int	getList_index() index at which this descriptor is found in the list of known connections
java.lang.String	getPassword() Get the password.
int	getPort() Get the port number.
java.lang.String	getPreferenceNodeName() Get the node name in preferences or line number in legacy file
java.lang.String	getServer() Get the database server name.
java.lang.Boolean	isEncrypted() Defines if this connection is encrypted
void	setDataSourceName(java.lang.String dataSourceName)
void	setList_index(int list_index) set index at which this descriptor is found in the list of known connections
void	setUser(User user) Set the user information associated with this account.
java.lang.String	toString() Get a string representation of the server.
java.lang.Boolean	usesDefaultTrustStore() Defines if this connection relies on the default JVM trust store

Methods inherited from class java.lang.Object

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

Constructor Detail

SPECCHIODatabaseDescriptor

public SPECCHIODatabaseDescriptor(java.lang.String server,
                                  int port,
                                  java.lang.String schema,
                                  java.lang.String dataSourceName,
                                  java.lang.String user,
                                  java.lang.String password)

Constructor.

Parameters:

server - the database host name

port - the database port number

schema - the database schema name

user - the username

password - the password

SPECCHIODatabaseDescriptor

public SPECCHIODatabaseDescriptor(java.lang.String server,
                                  int port,
                                  java.lang.String schema,
                                  java.lang.String dataSourceName)

Constructor for an anonymous connection to the database.

Parameters:

server - the database host name

port - the database port number

schema - the database schema name

user - the username

password - the password

SPECCHIODatabaseDescriptor

public SPECCHIODatabaseDescriptor(java.lang.String[] tokens)
                           throws SPECCHIODatabaseClientException

Constructor for SPECCHIOClientFactory.process_line().

Parameters:

tokens - the array of strings read from the input file

Throws:

SPECCHIODatabaseClientException - the tokens are not correctly formatted

Method Detail

createClient

public SPECCHIOClient createClient()

Create a web client that can connect to the server represented by this descriptor.

Specified by:

createClient in interface SPECCHIOServerDescriptor

Returns:

a new SPECCHIODatabaseClient object

getAccountConfigurationString

public java.lang.String getAccountConfigurationString()

Get the string describing the account configuration for db_config.txt

getDatabaseName

public java.lang.String getDatabaseName()

The the database name.

Returns:

the database schema name.

getDisplayName

public java.lang.String getDisplayName(boolean showUser,
                                       boolean show_datasource_name)

Get the display name of this server.

Specified by:

getDisplayName in interface SPECCHIOServerDescriptor

Parameters:

showUser - include the user account details in the display?

show_datasource_name - include the JNDI details in the display?

Returns:

a string describing the server, suitable for display to the user

getDisplayUser

public java.lang.String getDisplayUser()

Get the user name.

Specified by:

getDisplayUser in interface SPECCHIOServerDescriptor

Returns:

the user name

getPassword

public java.lang.String getPassword()

Get the password.

Returns:

the password

getPort

public int getPort()

Get the port number.

Returns:

the port number

getServer

public java.lang.String getServer()

Get the database server name.

Returns:

the database server name

setUser

public void setUser(User user)

Set the user information associated with this account.

Specified by:

setUser in interface SPECCHIOServerDescriptor

Parameters:

user - the user information

toString

public java.lang.String toString()

Get a string representation of the server.

Overrides:

toString in class java.lang.Object

getDataSourceName

public java.lang.String getDataSourceName()

Description copied from interface: SPECCHIOServerDescriptor

Get a name of the datasource (JNDI).

Specified by:

getDataSourceName in interface SPECCHIOServerDescriptor

Returns:

a string holding the name of the datasource (JNDI)

setDataSourceName

public void setDataSourceName(java.lang.String dataSourceName)

getPreferenceNodeName

public java.lang.String getPreferenceNodeName()

Description copied from interface: SPECCHIOServerDescriptor

Get the node name in preferences or line number in legacy file

Specified by:

getPreferenceNodeName in interface SPECCHIOServerDescriptor

Returns:

a string with the name or line number

usesDefaultTrustStore

public java.lang.Boolean usesDefaultTrustStore()

Description copied from interface: SPECCHIOServerDescriptor

Defines if this connection relies on the default JVM trust store

Specified by:

usesDefaultTrustStore in interface SPECCHIOServerDescriptor

Returns:

true is default trust store is used

isEncrypted

public java.lang.Boolean isEncrypted()

Description copied from interface: SPECCHIOServerDescriptor

Defines if this connection is encrypted

Specified by:

isEncrypted in interface SPECCHIOServerDescriptor

Returns:

true if this is a HTTPS connection

getList_index

public int getList_index()

Description copied from interface: SPECCHIOServerDescriptor

index at which this descriptor is found in the list of known connections

Specified by:

getList_index in interface SPECCHIOServerDescriptor

Returns:

index if known, otherwise -1

setList_index

public void setList_index(int list_index)

Description copied from interface: SPECCHIOServerDescriptor

set index at which this descriptor is found in the list of known connections

Specified by:

setList_index in interface SPECCHIOServerDescriptor