Package javax.xml.xquery
Interface ConnectionPoolXQDataSource
-
public interface ConnectionPoolXQDataSourceA factory forPooledXQConnectionobjects. An object that implements this interface will typically be registered with a JNDI based naming service.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description intgetLoginTimeout()Gets the maximum time in seconds that this datasource can wait while attempting to connect to a database.java.io.PrintWritergetLogWriter()Retrieves the log writer for this datasource object.PooledXQConnectiongetPooledConnection()Attempts to establish a physical connection to an XML datasource that can be used as a pooled connection.PooledXQConnectiongetPooledConnection(java.lang.String user, java.lang.String password)Attempts to establish a physical connection to an XML datasource using the supplied username and password, that can be used as a pooled connection.java.lang.StringgetProperty(java.lang.String name)Returns the current value of the named property if set, elsenull.java.lang.String[]getSupportedPropertyNames()Returns an array containing the property names supported by this datasource.voidsetLoginTimeout(int seconds)Sets the maximum time in seconds that this datasource will wait while attempting to connect to a database.voidsetLogWriter(java.io.PrintWriter out)Sets the log writer for this datasource object to the givenjava.io.PrintWriterobject.voidsetProperties(java.util.Properties props)Sets the data source properties from the specifiedPropertiesinstance.voidsetProperty(java.lang.String name, java.lang.String value)Sets the named property to the specified value.
-
-
-
Method Detail
-
getPooledConnection
PooledXQConnection getPooledConnection() throws XQException
Attempts to establish a physical connection to an XML datasource that can be used as a pooled connection.- Returns:
- a
PooledXQConnectionobject that is a physical connection to the XML datasource that thisConnectionPoolXQDataSourceobject represents - Throws:
XQException- if a datasource access error occurs
-
getPooledConnection
PooledXQConnection getPooledConnection(java.lang.String user, java.lang.String password) throws XQException
Attempts to establish a physical connection to an XML datasource using the supplied username and password, that can be used as a pooled connection.- Parameters:
user- the user on whose behalf the connection is being madepassword- the user's password- Returns:
- a
PooledXQConnectionobject that is a physical connection to the XML datasource that thisConnectionPoolXQDataSourceobject represents - Throws:
XQException- if a datasource access error occurs
-
getLoginTimeout
int getLoginTimeout() throws XQExceptionGets the maximum time in seconds that this datasource can wait while attempting to connect to a database. A value of zero means that the timeout is the default system timeout if there is one; otherwise, it means that there is no timeout. When a datasource object is created, the login timeout is initially zero. It is implementation-defined whether the returned login timeout is actually used by the data source implementation.- Returns:
- the datasource login time limit
- Throws:
XQException- if a datasource access error occurs
-
getLogWriter
java.io.PrintWriter getLogWriter() throws XQExceptionRetrieves the log writer for this datasource object. The log writer is a character output stream to which all logging and tracing messages for this datasource will be printed. This includes messages printed by the methods of this object, messages printed by methods of other objects manufactured by this object, and so on. When a datasource object is created, the log writer is initiallynull; in other words, the default is for logging to be disabled.- Returns:
- the log writer for this datasource or
nullif logging is disabled - Throws:
XQException- if a datasource access error occurs
-
getSupportedPropertyNames
java.lang.String[] getSupportedPropertyNames()
Returns an array containing the property names supported by this datasource.- Returns:
String[]an array of property names supported by this implementation
-
setProperty
void setProperty(java.lang.String name, java.lang.String value) throws XQExceptionSets the named property to the specified value. If a property with the same name was already set, then this method will override the old value for that property with the new value.If the implementation does not support the given property or if it can determine that the value given for this property is invalid, then an exception is thrown. If an exception is thrown, then no previous value is overwritten.
- Parameters:
name- the name of the property to setvalue- the value of the named property- Throws:
XQException- if (1) the given property is not recognized, or (2) the value for the given property is determined to be invalid
-
getProperty
java.lang.String getProperty(java.lang.String name) throws XQExceptionReturns the current value of the named property if set, elsenull. If the implementation does not support the given property then an exception is raised.- Parameters:
name- the name of the property whose value is needed- Returns:
Stringrepresenting the value of the required property if set, elsenull- Throws:
XQException- if a given property is not supported
-
setProperties
void setProperties(java.util.Properties props) throws XQExceptionSets the data source properties from the specifiedPropertiesinstance. Properties set before this call will still apply but those with the same name as any of these properties will be replaced. Properties set after this call also apply and may replace properties set during this call.If the implementation does not support one or more of the given property names, or if it can determine that the value given for a specific property is invalid, then an exception is thrown. If an exception is thrown, then no previous value is overwritten. is invalid, then an exception is raised.
- Parameters:
props- the list of properties to set- Throws:
XQException- if (1) a given property is not recognized, or (2) the value for a given property is determined to be invalid
-
setLoginTimeout
void setLoginTimeout(int seconds) throws XQExceptionSets the maximum time in seconds that this datasource will wait while attempting to connect to a database. A value of zero specifies that the timeout is the default system timeout if there is one; otherwise, it specifies that there is no timeout. When a datasource object is created, the login timeout is initially zero. It is implementation-defined whether the specified login timeout is actually used by the data source implementation.- Parameters:
seconds- the datasource login time limit- Throws:
XQException- if a datasource access error occurs
-
setLogWriter
void setLogWriter(java.io.PrintWriter out) throws XQExceptionSets the log writer for this datasource object to the givenjava.io.PrintWriterobject. The log writer is a character output stream to which all logging and tracing messages for this datasource will be printed. This includes messages printed by the methods of this object, messages printed by methods of other objects manufactured by this object, and so on. When a datasource object is created the log writer is initiallynull; in other words, the default is for logging to be disabled.- Parameters:
out- the new log writer; to disable logging, set tonull- Throws:
XQException- if a datasource access error occurs
-
-