Interface FirebirdConnectionProperties
- 
- All Known Implementing Classes:
- FBAbstractCommonDataSource,- FBConnectionPoolDataSource,- FBConnectionProperties,- FBManagedConnectionFactory,- FBSimpleDataSource,- FBXADataSource
 
 public interface FirebirdConnectionPropertiesConnection properties for the Firebird connection. Main part of this interface corresponds to the Database Parameter Buffer, but also contains properties to specify default transaction parameters.
- 
- 
Method SummaryAll Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.StringgetAuthPlugins()Get the list of authentication plugins to try.intgetBlobBufferSize()intgetBuffersNumber()java.lang.StringgetCharSet()intgetConnectTimeout()Get the current connect timeout.java.lang.StringgetDatabase()DatabaseParameterBuffergetDatabaseParameterBuffer()Get the database parameter buffer corresponding to the current connection request information.java.lang.StringgetDataTypeBind()Get thedataTypeBindconfiguration.java.lang.StringgetDbCryptConfig()Get the database encryption plugin configuration.java.lang.StringgetDefaultIsolation()Get the default transaction isolation level as string.intgetDefaultTransactionIsolation()Get the default transaction isolation level.java.lang.StringgetEncoding()java.lang.StringgetGeneratedKeysEnabled()Get thegeneratedKeysEnabledconfiguration.java.lang.StringgetNonStandardProperty(java.lang.String key)Get the property that does not have corresponding getter method by its name.java.lang.StringgetPassword()java.lang.StringgetRoleName()java.lang.StringgetSessionTimeZone()Get thesessionTimeZone.intgetSocketBufferSize()intgetSoTimeout()Get the current Socket blocking timeout (SoTimeout).java.lang.StringgetSqlDialect()java.lang.StringgetTpbMapping()Get the used TPB mapping.TransactionParameterBuffergetTransactionParameters(int isolation)Get the transaction parameter buffer corresponding to the current connection request information.java.lang.StringgetType()java.lang.StringgetUserName()java.lang.StringgetWireCrypt()Get the wire encryption level value.booleanisDefaultResultSetHoldable()Get the default ResultSet holdability.booleanisIgnoreProcedureType()Get the value forignoreProcedureType.booleanisTimestampUsesLocalTimezone()booleanisUseFirebirdAutocommit()Get whether to use Firebird autocommit (experimental).booleanisUseStandardUdf()booleanisUseStreamBlobs()booleanisWireCompression()Get if wire compression should be enabled.voidsetAuthPlugins(java.lang.String authPlugins)Sets the authentication plugins to try.voidsetBlobBufferSize(int bufferSize)voidsetBuffersNumber(int buffersNumber)voidsetCharSet(java.lang.String charSet)voidsetConnectTimeout(int connectTimeout)Set the connect timeout.voidsetDatabase(java.lang.String database)voidsetDataTypeBind(java.lang.String dataTypeBind)Sets thedataTypeBindconfiguration.voidsetDbCryptConfig(java.lang.String dbCryptConfig)Sets the database encryption plugin configuration.voidsetDefaultIsolation(java.lang.String isolation)Set the default transaction isolation level as string.voidsetDefaultResultSetHoldable(boolean isHoldable)Sets the default ResultSet holdability.voidsetDefaultTransactionIsolation(int defaultIsolationLevel)Set the default transaction isolation level.voidsetEncoding(java.lang.String encoding)voidsetGeneratedKeysEnabled(java.lang.String generatedKeysEnabled)Sets thegeneratedKeysEnabledconfiguration.voidsetIgnoreProcedureType(boolean ignoreProcedureType)Sets the valueignoreProcedureType.voidsetNonStandardProperty(java.lang.String propertyMapping)Set the property that does not have corresponding setter method.voidsetNonStandardProperty(java.lang.String key, java.lang.String value)Set the property that does not have corresponding setter method.voidsetPassword(java.lang.String password)voidsetRoleName(java.lang.String roleName)voidsetSessionTimeZone(java.lang.String sessionTimeZone)Sets thesessionTimeZone.voidsetSocketBufferSize(int socketBufferSize)voidsetSoTimeout(int soTimeout)Set the Socket blocking timeout (SoTimeout).voidsetSqlDialect(java.lang.String sqlDialect)voidsetTimestampUsesLocalTimezone(boolean timestampUsesLocalTimezone)voidsetTpbMapping(java.lang.String tpbMapping)Set path to the properties file with the TPB mapping.voidsetTransactionParameters(int isolation, TransactionParameterBuffer tpb)Set transaction parameters for the specified transaction isolation level.voidsetType(java.lang.String type)voidsetUseFirebirdAutocommit(boolean useFirebirdAutocommit)Set whether to use Firebird autocommit (experimental).voidsetUserName(java.lang.String userName)voidsetUseStandardUdf(boolean useStandardUdf)voidsetUseStreamBlobs(boolean useStreamBlobs)voidsetWireCompression(boolean wireCompression)Sets if the connection should try to enable wire compression.voidsetWireCrypt(java.lang.String wireCrypt)Sets the wire encryption level.
 
- 
- 
- 
Method Detail- 
getDatabasejava.lang.String getDatabase() - Returns:
- path to the database including the server name and the port, if needed.
 
 - 
setDatabasevoid setDatabase(java.lang.String database) - Parameters:
- database- path to the database including the server name and the port, if needed.
 
 - 
getTypejava.lang.String getType() - Returns:
- type of the connection, for example, "PURE_JAVA", "LOCAL", "EMBEDDED", depends on the GDS implementations installed in the system.
 
 - 
setTypevoid setType(java.lang.String type) - Parameters:
- type- type of the connection, for example, "PURE_JAVA", "LOCAL", "EMBEDDED", depends on the GDS implementations installed in the system.
 
 - 
getBlobBufferSizeint getBlobBufferSize() - Returns:
- BLOB buffer size in bytes.
 
 - 
setBlobBufferSizevoid setBlobBufferSize(int bufferSize) - Parameters:
- bufferSize- size of the BLOB buffer in bytes.
 
 - 
getCharSetjava.lang.String getCharSet() - Returns:
- Character set for the connection.
- See Also:
- setCharSet(String)
 
 - 
setCharSetvoid setCharSet(java.lang.String charSet) - Parameters:
- charSet- Character set for the connection. Similar to- encodingproperty, but accepts Java names instead of Firebird ones.
 
 - 
getEncodingjava.lang.String getEncoding() - Returns:
- Character encoding for the connection.
- See Also:
- setEncoding(String)
 
 - 
setEncodingvoid setEncoding(java.lang.String encoding) - Parameters:
- encoding- Character encoding for the connection. See Firebird documentation for more information.
 
 - 
getRoleNamejava.lang.String getRoleName() - Returns:
- SQL role to use.
 
 - 
setRoleNamevoid setRoleName(java.lang.String roleName) - Parameters:
- roleName- SQL role to use.
 
 - 
getSqlDialectjava.lang.String getSqlDialect() - Returns:
- SQL dialect of the client.
 
 - 
setSqlDialectvoid setSqlDialect(java.lang.String sqlDialect) - Parameters:
- sqlDialect- SQL dialect of the client.
 
 - 
isUseStreamBlobsboolean isUseStreamBlobs() - Returns:
- trueif stream blobs should be created, otherwise- false.
 
 - 
setUseStreamBlobsvoid setUseStreamBlobs(boolean useStreamBlobs) - Parameters:
- useStreamBlobs-- trueif stream blobs should be created, otherwise- false.
 
 - 
isUseStandardUdfboolean isUseStandardUdf() - Returns:
- trueif driver should assume that standard UDF are installed.
 
 - 
setUseStandardUdfvoid setUseStandardUdf(boolean useStandardUdf) - Parameters:
- useStandardUdf-- trueif driver should assume that standard UDF are installed.
 
 - 
getSocketBufferSizeint getSocketBufferSize() - Returns:
- socket buffer size in bytes, or -1 is not specified.
 
 - 
setSocketBufferSizevoid setSocketBufferSize(int socketBufferSize) - Parameters:
- socketBufferSize- socket buffer size in bytes.
 
 - 
isTimestampUsesLocalTimezoneboolean isTimestampUsesLocalTimezone() - Returns:
- trueif the Jaybird 1.0 handling of the calendar in corresponding setters. This is also compatible with MySQL calendar treatment.
 
 - 
setTimestampUsesLocalTimezonevoid setTimestampUsesLocalTimezone(boolean timestampUsesLocalTimezone) - Parameters:
- timestampUsesLocalTimezone-- trueif the Jaybird 1.0 handling of the calendar in corresponding setters. This is also compatible with MySQL calendar treatment.
 
 - 
getUserNamejava.lang.String getUserName() - Returns:
- name of the user that will be used when connecting to the database.
 
 - 
setUserNamevoid setUserName(java.lang.String userName) - Parameters:
- userName- name of the user that will be used when connecting to the database.
 
 - 
getPasswordjava.lang.String getPassword() - Returns:
- password corresponding to the specified user name.
 
 - 
setPasswordvoid setPassword(java.lang.String password) - Parameters:
- password- password corresponding to the specified user name.
 
 - 
getBuffersNumberint getBuffersNumber() - Returns:
- number of cache buffers that should be allocated for this connection, should be specified for ClassicServer instances, SuperServer has a server-wide configuration parameter.
 
 - 
setBuffersNumbervoid setBuffersNumber(int buffersNumber) - Parameters:
- buffersNumber- number of cache buffers that should be allocated for this connection, should be specified for ClassicServer instances, SuperServer has a server-wide configuration parameter.
 
 - 
getNonStandardPropertyjava.lang.String getNonStandardProperty(java.lang.String key) Get the property that does not have corresponding getter method by its name.- Parameters:
- key- name of the property to get.
- Returns:
- value of the property.
 
 - 
setNonStandardPropertyvoid setNonStandardProperty(java.lang.String key, java.lang.String value)Set the property that does not have corresponding setter method.- Parameters:
- key- name of the property to set.
- value- value of the property.
 
 - 
setNonStandardPropertyvoid setNonStandardProperty(java.lang.String propertyMapping) Set the property that does not have corresponding setter method.- Parameters:
- propertyMapping- parameter value in the ?propertyName[=propertyValue]? form, this allows setting non-standard parameters using configuration files.
 
 - 
getDatabaseParameterBufferDatabaseParameterBuffer getDatabaseParameterBuffer() throws java.sql.SQLException Get the database parameter buffer corresponding to the current connection request information.- Returns:
- instance of DatabaseParameterBuffer.
- Throws:
- java.sql.SQLException- if database parameter buffer cannot be created.
 
 - 
getTpbMappingjava.lang.String getTpbMapping() Get the used TPB mapping.- Returns:
- path to the TPB mapping.
- See Also:
- setTpbMapping(String)
 
 - 
setTpbMappingvoid setTpbMapping(java.lang.String tpbMapping) Set path to the properties file with the TPB mapping. The path begins with the protocol specification followed by the path to the resource. A special protocol"res:"should be used to specify resource in the classpath. For the compatibility reasons, if no protocol is specified, classpath is used by default. Properties file contains a mapping between the transaction isolation level (name of the constant in theConnectioninterface and a comma-separated list of TPB parameters.- Parameters:
- tpbMapping- path to the properties file.
 
 - 
getDefaultTransactionIsolationint getDefaultTransactionIsolation() Get the default transaction isolation level. This is the transaction isolation level for the newly created connections.- Returns:
- default transaction isolation level.
 
 - 
setDefaultTransactionIsolationvoid setDefaultTransactionIsolation(int defaultIsolationLevel) Set the default transaction isolation level.- Parameters:
- defaultIsolationLevel- default transaction isolation level.
 
 - 
getDefaultIsolationjava.lang.String getDefaultIsolation() Get the default transaction isolation level as string. This method is complementary to thegetDefaultTransactionIsolation(), however it takes a string as parameter instead of a numeric constant.- Returns:
- default transaction isolation as string.
- See Also:
- setDefaultIsolation(String)
 
 - 
setDefaultIsolationvoid setDefaultIsolation(java.lang.String isolation) Set the default transaction isolation level as string. This method is complementary to thesetDefaultTransactionIsolation(int), however it takes a string as parameter instead of a numeric constant. Following strings are allowed:- "TRANSACTION_READ_COMMITTED"for a READ COMMITTED isolation level.
- "TRANSACTION_REPEATABLE_READ"for a REPEATABLE READ isolation level.
- "TRANSACTION_SERIALIZABLE"for a SERIALIZABLE isolation level.
 - Parameters:
- isolation- string constant representing a default isolation level.
 
 - 
getTransactionParametersTransactionParameterBuffer getTransactionParameters(int isolation) Get the transaction parameter buffer corresponding to the current connection request information.- Parameters:
- isolation- transaction isolation level for which TPB should be returned.
- Returns:
- instance of TransactionParameterBuffer.
 
 - 
setTransactionParametersvoid setTransactionParameters(int isolation, TransactionParameterBuffer tpb)Set transaction parameters for the specified transaction isolation level. The specified TPB is used as a default mapping for the specified isolation level.- Parameters:
- isolation- transaction isolation level.
- tpb- instance of- TransactionParameterBuffercontaining transaction parameters.
 
 - 
isDefaultResultSetHoldableboolean isDefaultResultSetHoldable() Get the default ResultSet holdability.- Returns:
- truewhen ResultSets are holdable by default,- falsenot holdable.
 
 - 
setDefaultResultSetHoldablevoid setDefaultResultSetHoldable(boolean isHoldable) Sets the default ResultSet holdability.- Parameters:
- isHoldable-- truewhen ResultSets are holdable by default,- falsenot holdable.
 
 - 
getSoTimeoutint getSoTimeout() Get the current Socket blocking timeout (SoTimeout).- Returns:
- The socket blocking timeout in milliseconds (0 is 'infinite')
 
 - 
setSoTimeoutvoid setSoTimeout(int soTimeout) Set the Socket blocking timeout (SoTimeout).- Parameters:
- soTimeout- Timeout in milliseconds (0 is 'infinite')
 
 - 
getConnectTimeoutint getConnectTimeout() Get the current connect timeout.- Returns:
- Connect timeout in seconds (0 is 'infinite', or better: OS specific timeout)
 
 - 
setConnectTimeoutvoid setConnectTimeout(int connectTimeout) Set the connect timeout.- Parameters:
- connectTimeout- Connect timeout in seconds (0 is 'infinite', or better: OS specific timeout)
 
 - 
isUseFirebirdAutocommitboolean isUseFirebirdAutocommit() Get whether to use Firebird autocommit (experimental).- Returns:
- trueuse Firebird autocommit
 
 - 
setUseFirebirdAutocommitvoid setUseFirebirdAutocommit(boolean useFirebirdAutocommit) Set whether to use Firebird autocommit (experimental).- Parameters:
- useFirebirdAutocommit-- trueUse Firebird autocommit
 
 - 
getWireCryptjava.lang.String getWireCrypt() Get the wire encryption level value.- Returns:
- Wire encryption level (nullimpliesDEFAULT)
- Since:
- 4.0
 
 - 
setWireCryptvoid setWireCrypt(java.lang.String wireCrypt) Sets the wire encryption level.Values are defined by WireCrypt, values are handled case insensitive. Invalid values are accepted, but will cause an error when a connection is established.- Parameters:
- wireCrypt- Wire encryption level
- Since:
- 4.0
 
 - 
getDbCryptConfigjava.lang.String getDbCryptConfig() Get the database encryption plugin configuration.- Returns:
- Database encryption plugin configuration, meaning plugin specific
- Since:
- 3.0.4
 
 - 
setDbCryptConfigvoid setDbCryptConfig(java.lang.String dbCryptConfig) Sets the database encryption plugin configuration.- Parameters:
- dbCryptConfig- Database encryption plugin configuration, meaning plugin specific
- Since:
- 3.0.4
 
 - 
getAuthPluginsjava.lang.String getAuthPlugins() Get the list of authentication plugins to try.- Returns:
- comma-separated list of authentication plugins, or nullfor driver default
- Since:
- 4.0
 
 - 
setAuthPluginsvoid setAuthPlugins(java.lang.String authPlugins) Sets the authentication plugins to try.Invalid names are skipped during authentication. - Parameters:
- authPlugins- comma-separated list of authentication plugins, or- nullfor driver default
- Since:
- 4.0
 
 - 
getGeneratedKeysEnabledjava.lang.String getGeneratedKeysEnabled() Get thegeneratedKeysEnabledconfiguration.- Returns:
- configuration value for generatedKeysEnabled, ornullfor driver default
- Since:
- 4.0
 
 - 
setGeneratedKeysEnabledvoid setGeneratedKeysEnabled(java.lang.String generatedKeysEnabled) Sets thegeneratedKeysEnabledconfiguration.- Parameters:
- generatedKeysEnabled- Generated keys support configuration:- default(or null/empty),- disabled,- ignored, or a list of statement types to enable (possible values:- insert,- update,- delete,- update_or_insert,- merge)
 
 - 
getDataTypeBindjava.lang.String getDataTypeBind() Get thedataTypeBindconfiguration.- Returns:
- configuration value for dataTypeBind, ornullfor driver default
- Since:
- 4.0
 
 - 
setDataTypeBindvoid setDataTypeBind(java.lang.String dataTypeBind) Sets thedataTypeBindconfiguration.If the value is explicitly set to a non-null value and the connected server is Firebird 4 or higher, this will configure the data type binding with the specified values using isc_dpb_set_bind, which is equivalent to executingSET BINDstatements with the values.See also Firebird documentation for SET BIND.- Parameters:
- dataTypeBind- Firebird 4+ data type bind configuration, a semicolon-separated list of- <from-type> TO <to-type>
- Since:
- 4.0
 
 - 
getSessionTimeZonejava.lang.String getSessionTimeZone() Get thesessionTimeZone.- Returns:
- value for sessionTimeZone, ornullfor driver default (JVM default time zone)
- Since:
- 4.0
 
 - 
setSessionTimeZonevoid setSessionTimeZone(java.lang.String sessionTimeZone) Sets thesessionTimeZone.- Parameters:
- sessionTimeZone- Firebird 4+ session time zone name (we strongly suggest to use Java compatible names only), use- "server"to use server default time zone (note: conversion will use JVM default time zone)
- Since:
- 4.0
 
 - 
isIgnoreProcedureTypeboolean isIgnoreProcedureType() Get the value forignoreProcedureType.- Returns:
- value for ignoreProcedureType
- Since:
- 3.0.6
 
 - 
setIgnoreProcedureTypevoid setIgnoreProcedureType(boolean ignoreProcedureType) Sets the valueignoreProcedureType.When set to true, the CallableStatementimplementation in Jaybird will ignore metadata information about the stored procedure type and default to usingEXECUTE PROCEDURE, unless the type is explicitly set usingFirebirdCallableStatement.setSelectableProcedure(boolean). This can be useful in situations where a stored procedure is selectable, but tooling or code expects an executable stored procedure.- Parameters:
- ignoreProcedureType-- trueIgnore procedure type
- Since:
- 3.0.6
 
 - 
isWireCompressionboolean isWireCompression() Get if wire compression should be enabled.Wire compression requires Firebird 3 or higher, and the server must have the zlib library. If compression cannot be negotiated, the connection will be made without wire compression. This property will be ignored for native connections. For native connections, the configuration in firebird.confread by the client library will be used.- Returns:
- truewire compression enabled
- Since:
- 4.0
 
 - 
setWireCompressionvoid setWireCompression(boolean wireCompression) Sets if the connection should try to enable wire compression.- Parameters:
- wireCompression-- trueenable wire compression,- falsedisable wire compression (the default)
- Since:
- 4.0
- See Also:
- isWireCompression()
 
 
- 
 
-