| java.lang.Object
 org.apache.derby.jdbc.ClientBaseDataSource
All known Subclasses: org.apache.derby.jdbc.ClientDataSource,
| ClientBaseDataSource | | abstract public class ClientBaseDataSource implements Serializable,Referenceable(Code) | | Base class for client-side DataSource implementations.
|
| Method Summary | |
| static LogWriter | computeDncLogWriter(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex, int traceLevel)
| | public static LogWriter | computeDncLogWriter(Connection connection, PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex, int traceLevel)
| | LogWriter | computeDncLogWriterForNewConnection(String logWriterInUseSuffix)
| | static LogWriter | computeDncLogWriterForNewConnection(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, int traceLevel, String logWriterInUseSuffix, int traceFileSuffixIndex)
| | static PrintWriter | computePrintWriter(PrintWriter logWriter, String traceDirectory, String traceFile, boolean traceFileAppend, String logWriterInUseSuffix, int traceFileSuffixIndex)
| | final public String | getConnectionAttributes()
| | public String | getDataSourceName()
| | public String | getDatabaseName()
| | public String | getDescription()
| | public PrintWriter | getLogWriter()
| | public int | getLoginTimeout()
| | public static String | getPassword(Properties properties)
| | final public String | getPassword()
| | public int | getPortNumber()
| | public Reference | getReference()
| | public static boolean | getRetrieveMessageText(Properties properties)
| | public boolean | getRetrieveMessageText()
| | public static short | getSecurityMechanism(Properties properties)
| | public short | getSecurityMechanism()
| | public short | getSecurityMechanism(String password)
| | public String | getServerName()
| | public static String | getTraceDirectory(Properties properties)
| | public String | getTraceDirectory()
| | public static String | getTraceFile(Properties properties)
| | public String | getTraceFile()
| | public static boolean | getTraceFileAppend(Properties properties)
| | public boolean | getTraceFileAppend()
| | public static int | getTraceLevel(Properties properties)
| | public int | getTraceLevel()
| | public static short | getUpgradedSecurityMechanism(String password)
This method has logic to upgrade security mechanism to a better (more secure)
one if it is possible. | | public static String | getUser(Properties properties)
| | public String | getUser()
| | final public void | setConnectionAttributes(String prop)
Set this property to pass in more Derby specific connection URL attributes.
Any attributes that can be set using a property of this DataSource implementation
(e.g user, password) should not be set in connectionAttributes. | | public synchronized void | setDataSourceName(String dataSourceName)
| | public synchronized void | setDatabaseName(String databaseName)
| | public synchronized void | setDescription(String description)
| | public synchronized void | setLogWriter(PrintWriter logWriter)
| | public synchronized void | setLoginTimeout(int seconds)
| | final public synchronized void | setPassword(String password)
| | public synchronized void | setPortNumber(int portNumber)
| | public synchronized void | setRetrieveMessageText(boolean retrieveMessageText)
| | public synchronized void | setSecurityMechanism(short securityMechanism)
| | public synchronized void | setServerName(String serverName)
| | public synchronized void | setTraceDirectory(String traceDirectory)
| | public synchronized void | setTraceFile(String traceFile)
| | public synchronized void | setTraceFileAppend(boolean traceFileAppend)
| | public synchronized void | setTraceLevel(int traceLevel)
| | public synchronized void | setUser(String user)
| | static Properties | tokenizeAttributes(String attributeString, Properties properties)
| | void | updateDataSourceValues(Properties prop)
The dataSource keeps individual fields for the values that are relevant to the client. |
| CLEAR_TEXT_PASSWORD_SECURITY | | final public static short CLEAR_TEXT_PASSWORD_SECURITY(Code) | | |
| ENCRYPTED_PASSWORD_SECURITY | | final public static short ENCRYPTED_PASSWORD_SECURITY(Code) | | |
| ENCRYPTED_USER_AND_PASSWORD_SECURITY | | final public static short ENCRYPTED_USER_AND_PASSWORD_SECURITY(Code) | | |
| STRONG_PASSWORD_SUBSTITUTE_SECURITY | | final public static short STRONG_PASSWORD_SUBSTITUTE_SECURITY(Code) | | |
| SUPPORTS_EUSRIDPWD | | static boolean SUPPORTS_EUSRIDPWD(Code) | | |
| TRACE_ALL | | final public static int TRACE_ALL(Code) | | |
| TRACE_CONNECTION_CALLS | | final public static int TRACE_CONNECTION_CALLS(Code) | | |
| TRACE_CONNECTS | | final public static int TRACE_CONNECTS(Code) | | |
| TRACE_DIAGNOSTICS | | final public static int TRACE_DIAGNOSTICS(Code) | | |
| TRACE_DRIVER_CONFIGURATION | | final public static int TRACE_DRIVER_CONFIGURATION(Code) | | |
| TRACE_NONE | | final public static int TRACE_NONE(Code) | | |
| TRACE_PARAMETER_META_DATA | | final public static int TRACE_PARAMETER_META_DATA(Code) | | |
| TRACE_PROTOCOL_FLOWS | | final public static int TRACE_PROTOCOL_FLOWS(Code) | | |
| TRACE_RESULT_SET_CALLS | | final public static int TRACE_RESULT_SET_CALLS(Code) | | |
| TRACE_RESULT_SET_META_DATA | | final public static int TRACE_RESULT_SET_META_DATA(Code) | | |
| TRACE_STATEMENT_CALLS | | final public static int TRACE_STATEMENT_CALLS(Code) | | |
| TRACE_XA_CALLS | | final public static int TRACE_XA_CALLS(Code) | | |
| USER_ONLY_SECURITY | | final public static short USER_ONLY_SECURITY(Code) | | The source security mechanism to use when connecting to this data source.
Security mechanism options are:
- USER_ONLY_SECURITY
- CLEAR_TEXT_PASSWORD_SECURITY
- ENCRYPTED_PASSWORD_SECURITY
- ENCRYPTED_USER_AND_PASSWORD_SECURITY - both password and user are encrypted
- STRONG_PASSWORD_SUBSTITUTE_SECURITY
The default security mechanism is USER_ONLY SECURITY
If the application specifies a security mechanism then it will be the only one attempted. If the specified
security mechanism is not supported by the conversation then an exception will be thrown and there will be no
additional retries.
This property is currently only available for the DNC driver.
Both user and password need to be set for all security mechanism except USER_ONLY_SECURITY
|
| connectionAttributes | | protected String connectionAttributes(Code) | | |
| propertyDefault_portNumber | | final public static int propertyDefault_portNumber(Code) | | |
| propertyDefault_retrieveMessageText | | final public static boolean propertyDefault_retrieveMessageText(Code) | | |
| propertyDefault_securityMechanism | | final public static short propertyDefault_securityMechanism(Code) | | |
| propertyDefault_serverName | | final public static String propertyDefault_serverName(Code) | | |
| propertyDefault_traceFileAppend | | final public static boolean propertyDefault_traceFileAppend(Code) | | |
| propertyDefault_traceLevel | | final public static int propertyDefault_traceLevel(Code) | | |
| propertyDefault_user | | final public static String propertyDefault_user(Code) | | |
| securityMechanism | | protected short securityMechanism(Code) | | |
| traceLevel | | protected int traceLevel(Code) | | |
| ClientBaseDataSource | | ClientBaseDataSource()(Code) | | |
| getConnectionAttributes | | final public String getConnectionAttributes()(Code) | | Derby specific connection URL attributes |
| getLoginTimeout | | public int getLoginTimeout()(Code) | | |
| getPortNumber | | public int getPortNumber()(Code) | | |
| getRetrieveMessageText | | public static boolean getRetrieveMessageText(Properties properties)(Code) | | |
| getRetrieveMessageText | | public boolean getRetrieveMessageText()(Code) | | |
| getSecurityMechanism | | public static short getSecurityMechanism(Properties properties)(Code) | | Return security mechanism if it is set, else upgrade the security mechanism
if possible and return the upgraded security mechanism
Parameters:
properties - Look in the properties if securityMechanism is set or notif set, return this security mechanism security mechanism |
| getSecurityMechanism | | public short getSecurityMechanism()(Code) | | return the security mechanism
if security mechanism has not been set explicitly on datasource
then upgrade the security mechanism to a more secure one if possible
See Also: ClientBaseDataSource.getUpgradedSecurityMechanism(String) the security mechanism |
| getSecurityMechanism | | public short getSecurityMechanism(String password)(Code) | | return the security mechanism for this datasource object
if security mechanism has not been set explicitly on datasource
then upgrade the security mechanism to a more secure one if possible
Parameters:
password - password of user
See Also: ClientBaseDataSource.getUpgradedSecurityMechanism(String) the security mechanism |
| getTraceFileAppend | | public static boolean getTraceFileAppend(Properties properties)(Code) | | |
| getTraceFileAppend | | public boolean getTraceFileAppend()(Code) | | |
| getTraceLevel | | public int getTraceLevel()(Code) | | |
| getUpgradedSecurityMechanism | | public static short getUpgradedSecurityMechanism(String password)(Code) | | This method has logic to upgrade security mechanism to a better (more secure)
one if it is possible. Currently derby server only has support for USRIDPWD,
USRIDONL, EUSRIDPWD and USRSSBPWD (10.2+) - this method only considers these
possibilities. USRIDPWD, EUSRIDPWD and USRSSBPWD require a password, USRIDONL
is the only security mechanism which does not require password.
1. if password is not available, then security mechanism possible is USRIDONL
2. if password is available,then USRIDPWD is returned.
Parameters:
password - password argument upgraded security mechanism if possible |
| setConnectionAttributes | | final public void setConnectionAttributes(String prop)(Code) | | Set this property to pass in more Derby specific connection URL attributes.
Any attributes that can be set using a property of this DataSource implementation
(e.g user, password) should not be set in connectionAttributes. Conflicting
settings in connectionAttributes and properties of the DataSource will lead to
unexpected behaviour.
Parameters:
prop - set to the list of Cloudscape connection attributes separated by semi-colons. E.g., to specify anencryption bootPassword of "x8hhk2adf", and set upgrade to true, do the following: ds.setConnectionAttributes("bootPassword=x8hhk2adf;upgrade=true"); See Derby documentation forcomplete list. |
| setDataSourceName | | public synchronized void setDataSourceName(String dataSourceName)(Code) | | |
| setDatabaseName | | public synchronized void setDatabaseName(String databaseName)(Code) | | |
| setDescription | | public synchronized void setDescription(String description)(Code) | | |
| setLoginTimeout | | public synchronized void setLoginTimeout(int seconds)(Code) | | |
| setPassword | | final public synchronized void setPassword(String password)(Code) | | |
| setPortNumber | | public synchronized void setPortNumber(int portNumber)(Code) | | |
| setRetrieveMessageText | | public synchronized void setRetrieveMessageText(boolean retrieveMessageText)(Code) | | |
| setSecurityMechanism | | public synchronized void setSecurityMechanism(short securityMechanism)(Code) | | sets the security mechanism
Parameters:
securityMechanism - to set |
| setServerName | | public synchronized void setServerName(String serverName)(Code) | | |
| setTraceDirectory | | public synchronized void setTraceDirectory(String traceDirectory)(Code) | | |
| setTraceFile | | public synchronized void setTraceFile(String traceFile)(Code) | | |
| setTraceFileAppend | | public synchronized void setTraceFileAppend(boolean traceFileAppend)(Code) | | |
| setTraceLevel | | public synchronized void setTraceLevel(int traceLevel)(Code) | | |
| updateDataSourceValues | | void updateDataSourceValues(Properties prop)(Code) | | The dataSource keeps individual fields for the values that are relevant to the client. These need to be updated
when set connection attributes is called.
|
|
|