| java.lang.Object
 org.apache.derby.jdbc.ClientBaseDataSource
org.apache.derby.jdbc.ClientDataSource
All known Subclasses: org.apache.derby.jdbc.ClientConnectionPoolDataSource, org.apache.derby.jdbc.ClientXADataSource, org.apache.derby.jdbc.ClientDataSource40,
| ClientDataSource | | public class ClientDataSource extends ClientBaseDataSource implements DataSource(Code) | | ClientDataSource is a simple data source implementation
that can be used for establishing connections in a
non-pooling, non-distributed environment.
The class ClientConnectionPoolDataSource can be used in a connection pooling environment,
and the class ClientXADataSource can be used in a distributed, and pooling
environment. Use these DataSources if your application runs under
JDBC3.0 or JDBC2.0, that is, on the following Java Virtual Machines:
- JDBC 3.0 - Java 2 - JDK 1.4, J2SE 5.0
- JDBC 2.0 - Java 2 - JDK 1.2,1.3
The example below registers a DNC data source object with a JNDI naming service.
org.apache.derby.client.ClientDataSource dataSource = new org.apache.derby.client.ClientDataSource ();
dataSource.setServerName ("my_derby_database_server");
dataSource.setDatabaseName ("my_derby_database_name");
javax.naming.Context context = new javax.naming.InitialContext();
context.bind ("jdbc/my_datasource_name", dataSource);
The first line of code in the example creates a data source object.
The next two lines initialize the data source's
properties. Then a Java object that references the initial JNDI naming
context is created by calling the
InitialContext() constructor, which is provided by JNDI.
System properties (not shown) are used to tell JNDI the
service provider to use. The JNDI name space is hierarchical,
similar to the directory structure of many file
systems. The data source object is bound to a logical JNDI name
by calling Context.bind(). In this case the JNDI name
identifies a subcontext, "jdbc", of the root naming context
and a logical name, "my_datasource_name", within the jdbc
subcontext. This is all of the code required to deploy
a data source object within JNDI. This example is provided
mainly for illustrative purposes. We expect that developers
or system administrators will normally use a GUI tool to
deploy a data source object.
Once a data source has been registered with JNDI,
it can then be used by a JDBC application, as is shown in the
following example.
javax.naming.Context context = new javax.naming.InitialContext ();
javax.sql.DataSource dataSource = (javax.sql.DataSource) context.lookup ("jdbc/my_datasource_name");
java.sql.Connection connection = dataSource.getConnection ("user", "password");
The first line in the example creates a Java object
that references the initial JNDI naming context. Next, the
initial naming context is used to do a lookup operation
using the logical name of the data source. The
Context.lookup() method returns a reference to a Java Object,
which is narrowed to a javax.sql.DataSource object. In
the last line, the DataSource.getConnection() method
is called to produce a database connection.
This simple data source subclass of ClientBaseDataSource maintains
it's own private password property.
The specified password, along with the user, is validated by DERBY.
This property can be overwritten by specifing
the password parameter on the DataSource.getConnection() method call.
This password property is not declared transient, and therefore
may be serialized to a file in clear-text, or stored
to a JNDI server in clear-text when the data source is saved.
Care must taken by the user to prevent security
breaches.
|
| Constructor Summary | |
| public | ClientDataSource()
Creates a simple DERBY data source with default property values for a non-pooling, non-distributed environment. |
| ClientDataSource | | public ClientDataSource()(Code) | | Creates a simple DERBY data source with default property values for a non-pooling, non-distributed environment.
No particular DatabaseName or other properties are associated with the data source.
Every Java Bean should provide a constructor with no arguments since many beanboxes attempt to instantiate a bean
by invoking its no-argument constructor.
|
| getConnection | | public Connection getConnection() throws SQLException(Code) | | Attempt to establish a database connection in a non-pooling, non-distributed environment.
a Connection to the database
throws:
java.sql.SQLException - if a database-access error occurs. |
| getConnection | | public Connection getConnection(String user, String password) throws SQLException(Code) | | Attempt to establish a database connection in a non-pooling, non-distributed environment.
Parameters:
user - the database user on whose behalf the Connection is being made
Parameters:
password - the user's password a Connection to the database
throws:
java.sql.SQLException - if a database-access error occurs. |
| Methods inherited from org.apache.derby.jdbc.ClientBaseDataSource | static LogWriter computeDncLogWriter(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex, int traceLevel) throws SqlException(Code)(Java Doc)
public static LogWriter computeDncLogWriter(Connection connection, PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex, int traceLevel) throws SqlException(Code)(Java Doc)
LogWriter computeDncLogWriterForNewConnection(String logWriterInUseSuffix) throws SqlException(Code)(Java Doc)
static LogWriter computeDncLogWriterForNewConnection(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, int traceLevel, String logWriterInUseSuffix, int traceFileSuffixIndex) throws SqlException(Code)(Java Doc)
static PrintWriter computePrintWriter(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex) throws SqlException(Code)(Java Doc)
final public String getConnectionAttributes()(Code)(Java Doc)
public String getDataSourceName()(Code)(Java Doc)
public String getDatabaseName()(Code)(Java Doc)
public String getDescription()(Code)(Java Doc)
public PrintWriter getLogWriter()(Code)(Java Doc)
public int getLoginTimeout()(Code)(Java Doc)
public static String getPassword(Properties properties)(Code)(Java Doc)
final public String getPassword()(Code)(Java Doc)
public int getPortNumber()(Code)(Java Doc)
public Reference getReference() throws NamingException(Code)(Java Doc)
public static boolean getRetrieveMessageText(Properties properties)(Code)(Java Doc)
public boolean getRetrieveMessageText()(Code)(Java Doc)
public static short getSecurityMechanism(Properties properties)(Code)(Java Doc)
public short getSecurityMechanism()(Code)(Java Doc)
public short getSecurityMechanism(String password)(Code)(Java Doc)
public String getServerName()(Code)(Java Doc)
public static String getTraceDirectory(Properties properties)(Code)(Java Doc)
public String getTraceDirectory()(Code)(Java Doc)
public static String getTraceFile(Properties properties)(Code)(Java Doc)
public String getTraceFile()(Code)(Java Doc)
public static boolean getTraceFileAppend(Properties properties)(Code)(Java Doc)
public boolean getTraceFileAppend()(Code)(Java Doc)
public static int getTraceLevel(Properties properties)(Code)(Java Doc)
public int getTraceLevel()(Code)(Java Doc)
public static short getUpgradedSecurityMechanism(String password)(Code)(Java Doc)
public static String getUser(Properties properties)(Code)(Java Doc)
public String getUser()(Code)(Java Doc)
final public void setConnectionAttributes(String prop)(Code)(Java Doc)
public synchronized void setDataSourceName(String dataSourceName)(Code)(Java Doc)
public synchronized void setDatabaseName(String databaseName)(Code)(Java Doc)
public synchronized void setDescription(String description)(Code)(Java Doc)
public synchronized void setLogWriter(PrintWriter logWriter)(Code)(Java Doc)
public synchronized void setLoginTimeout(int seconds)(Code)(Java Doc)
final public synchronized void setPassword(String password)(Code)(Java Doc)
public synchronized void setPortNumber(int portNumber)(Code)(Java Doc)
public synchronized void setRetrieveMessageText(boolean retrieveMessageText)(Code)(Java Doc)
public synchronized void setSecurityMechanism(short securityMechanism)(Code)(Java Doc)
public synchronized void setServerName(String serverName)(Code)(Java Doc)
public synchronized void setTraceDirectory(String traceDirectory)(Code)(Java Doc)
public synchronized void setTraceFile(String traceFile)(Code)(Java Doc)
public synchronized void setTraceFileAppend(boolean traceFileAppend)(Code)(Java Doc)
public synchronized void setTraceLevel(int traceLevel)(Code)(Java Doc)
public synchronized void setUser(String user)(Code)(Java Doc)
static Properties tokenizeAttributes(String attributeString, Properties properties) throws SqlException(Code)(Java Doc)
void updateDataSourceValues(Properties prop)(Code)(Java Doc)
|
|
|