Interface XConnection

Devguide

索引

Methods' 要約

せいにするs' 要約

Methods' 詳細（に述べる）s

せいにするs' 詳細（に述べる）s

:: com :: sun :: 星／主役にする :: sdbc ::

interface XConnection

Base Interfaces

XConnection
┗ XCloseable

XCloseable

(言及／関連d interface's 要約:): 供給するs for the 解放（する）ing of 資源s acquired by the 器具／実施するing 反対する.

Description: 代表するs a 関係 (開会／開廷／会期) with a 明確な／細部 database. Within the 状況 of a 関係, SQL 声明s are 遂行する／発効させるd and results are returned.; A 関係's database is able to 供給する（警察などへの）密告，告訴（状）述べるing its （米）棚上げする／（英）提議するs, its supported SQL grammar, its 蓄える／店d 手続きs, and the 能力s of this 関係. This （警察などへの）密告，告訴（状） is 得るd with the XDatabaseMetaData::getMetaData() method.
See also: XDriverManager, XStatement, XDatabaseMetaData

Methods' 要約
createStatement	creates a new 声明反対する for sending SQL 声明s to the database.
prepareStatement	creates a PreparedStatement 反対する for sending parameterized SQL 声明s to the database.
prepareCall	creates a CallableStatement 反対する for calling database 蓄える／店d 手続きs.
nativeSQL	変えるs the given SQL 声明 into the system's native SQL grammar. A driver may 変える the JDBC SQL grammar into its system's native SQL grammar 事前の to sending it; this method returns the native form of the 声明 that the driver would have sent.
setAutoCommit	始める，決めるs this 関係's 自動車-commit 方式.
getAutoCommit	gets the 現在の自動車-commit 明言する／公表する.
commit	makes all changes made since the previous commit/rollback 永久の and 解放（する）s any database locks 現在／一般に held by the 関係. This method should be used only when 自動車-commit 方式 has been 無能にするd.
rollback	減少（する）s all changes made since the previous commit/rollback and 解放（する）s any database locks 現在／一般に held by this 関係. This method should be used only when 自動車-commit has been 無能にするd.
isClosed	実験（する）s to see if a 関係 is の近くにd.
getMetaData	gets the metadata regarding this 関係's database.
setReadOnly	puts this 関係 in read-only 方式 as a hint to enable database optimizations.
isReadOnly	実験（する）s to see if the 関係 is in read-only 方式.
setCatalog	始める，決めるs a catalog 指名するーするために select a subspace of this 関係's database in which to work. If the driver does not support catalogs, it will silently ignore this request.
getCatalog	returns the 関係's 現在の catalog 指名する.
setTransactionIsolation	試みる／企てるs to change the 処理／取引孤立／分離 level to the one given.
getTransactionIsolation	gets this 関係's 現在の処理／取引孤立／分離 level.
getTypeMap	gets the type 地図／計画する反対する associated with this 関係. Only drivers which 器具／実施する the custom type mapping 施設 will return an 反対するさもなければ NULL could be returned.
setTypeMap	任命する／導入するs the given type 地図／計画する as the type 地図／計画する for this 関係. The type 地図／計画する will be used for the custom mapping of SQL structured types and 際立った types.

Methods' 詳細（に述べる）s

createStatement

XStatement
createStatement()
raises(	SQLException );

Description

creates a new 声明反対する for sending SQL 声明s to the database.

SQL 声明s without parameters are 普通は遂行する／発効させるd using 声明反対するs. If the same SQL 声明 is 遂行する／発効させるd many times, it is more efficient to use a PreparedStatement .

Result 始める，決めるs created using the returned 声明 will have 今後-only type, and read-only concurrency, by default.

Escape 過程ing for the SQL-声明 is enabled, by default.

Returns

a new 声明反対する

Throws

SQLException if a database 接近 error occurs.

prepareStatement

XPreparedStatement
prepareStatement(	[in] string	sql )
raises(	SQLException );

Description

creates a PreparedStatement 反対する for sending parameterized SQL 声明s to the database.

A SQL 声明 with or without IN parameters can be pre-収集するd and 蓄える／店d in a PreparedStatement 反対する. This 反対する can then be used to efficiently 遂行する／発効させる this 声明多重の times.

公式文書，認める: This method is optimized for 扱うing parametric SQL 声明s that 利益 from precompilation. If the driver supports precompilation, the method prepareStatement will send the 声明 to the database for precompilation. Some drivers may not support precompilation. In this 事例／患者, the 声明 may not be sent to the database until the PreparedStatement is 遂行する／発効させるd. This has no direct 影響 on 使用者s; however, it does 影響する／感情 which method throws 確かな SQLExceptions.

Result 始める，決めるs created using the returned PreparedStatement will have 今後-only type and read-only concurrency, by default.

Escape 過程ing for the SQL-声明 is enabled, by default.

Parameter sql

a SQL 声明 that may 含む／封じ込める one or more '?' IN parameter placeholders

Returns

a new PreparedStatement 反対する含む／封じ込めるing the pre-収集するd 声明

Throws

SQLException if a database 接近 error occurs.

prepareCall

XPreparedStatement
prepareCall(	[in] string	sql )
raises(	SQLException );

Description

creates a CallableStatement 反対する for calling database 蓄える／店d 手続きs.

The CallableStatement 供給するs methods for setting up its IN and OUT parameters, and methods for 遂行する／発効させるing the call to a 蓄える／店d 手続き.

公式文書，認める: This method is optimized for 扱うing 蓄える／店d 手続き call 声明s. Some drivers may send the call 声明 to the database when the method prepareCall is done;
others may wait until the CallableStatement is 遂行する／発効させるd. This has no direct 影響 on 使用者s; however, it does 影響する／感情 which method throws 確かな SQLExceptions. Result 始める，決めるs created using the returned CallableStatement will have 今後-only type and read-only concurrency, by default.

Parameter sql

a SQL 声明 that may 含む／封じ込める one or more '?' IN parameter placeholders

Returns

a new PreparedStatement 反対する含む／封じ込めるing the pre-収集するd 声明

Throws

SQLException if a database 接近 error occurs.

nativeSQL

string
nativeSQL(	[in] string	sql )
raises(	SQLException );

Description: 変えるs the given SQL 声明 into the system's native SQL grammar. A driver may 変える the JDBC SQL grammar into its system's native SQL grammar 事前の to sending it; this method returns the native form of the 声明 that the driver would have sent.
Parameter sql: a SQL 声明 that may 含む／封じ込める one or more '?' parameter placeholders
Returns: the native form of this 声明
Throws: SQLException if a database 接近 error occurs.

setAutoCommit

無効の
setAutoCommit(	[in] boolean	autoCommit )
raises(	SQLException );

Description

始める，決めるs this 関係's 自動車-commit 方式.

If a 関係 is in 自動車-commit 方式, then all its SQL 声明s will be 遂行する／発効させるd and committed as individual 処理／取引s. さもなければ, its SQL 声明s are grouped into 処理／取引s that are 終結させるd by a call to either the method XConnection::commit() or the method XConnection::rollback() . By default, new 関係s are in 自動車-commit 方式.

The commit occurs when the 声明完全にするs or the next 遂行する／発効させる occurs, whichever comes first. In the 事例／患者 of 声明s returning a ResultSet, the 声明完全にするs when the last 列／漕ぐ／騒動 of the ResultSet has been retrieved or the ResultSet has been の近くにd. In 前進するd 事例／患者s, a 選び出す／独身声明 may return 多重の results 同様に as 生産（高） parameter values. In these 事例／患者s the commit occurs when all results and 生産（高） parameter values have been retrieved.

Parameter autoCommit

true enables 自動車-commit; 誤った 無能にするs 自動車-commit.

Throws

SQLException if a database 接近 error occurs.

getAutoCommit

boolean
getAutoCommit()
raises(	SQLException );

Description: gets the 現在の自動車-commit 明言する／公表する.
Returns: the 現在の明言する／公表する of 自動車-commit 方式.
Throws: SQLException if a database 接近 error occurs.
See also: setAutoCommit

commit

無効の
commit()
raises(	SQLException );

Description: makes all changes made since the previous commit/rollback 永久の and 解放（する）s any database locks 現在／一般に held by the 関係. This method should be used only when 自動車-commit 方式 has been 無能にするd.
Throws: SQLException if a database 接近 error occurs.
See also: setAutoCommit

rollback

無効の
rollback()
raises(	SQLException );

Description: 減少（する）s all changes made since the previous commit/rollback and 解放（する）s any database locks 現在／一般に held by this 関係. This method should be used only when 自動車-commit has been 無能にするd.
Throws: SQLException if a database 接近 error occurs.
See also: setAutoCommit

isClosed

boolean
isClosed()
raises(	SQLException );

Description: 実験（する）s to see if a 関係 is の近くにd.; 公式文書，認める: A 関係 is automatically の近くにd if no one 言及／関連s it anymore. 確かな致命的な errors also result in a の近くにd 関係.
Returns: true if the 関係 is の近くにd; 誤った if it's still open.
Throws: SQLException if a database 接近 error occurs.

getMetaData

XDatabaseMetaData
getMetaData()
raises(	SQLException );

Description: gets the metadata regarding this 関係's database.; A 関係's database is able to 供給する（警察などへの）密告，告訴（状）述べるing its （米）棚上げする／（英）提議するs, its supported SQL grammar, its 蓄える／店d 手続きs, the 能力s of this 関係, and so on. This （警察などへの）密告，告訴（状） is made 利用できる through a DatabaseMetaData 反対する.
Returns: a DatabaseMetaData 反対する for this 関係.
Throws: SQLException if a database 接近 error occurs.

setReadOnly

無効の
setReadOnly(	[in] boolean	readOnly )
raises(	SQLException );

Description: puts this 関係 in read-only 方式 as a hint to enable database optimizations.; 公式文書，認める: This method cannot be called while in the middle of a 処理／取引. Calling setReadOnly with true does not やむを得ず原因（となる）令状s to be 禁じるd.
Parameter readONly: true enables read-only 方式; 誤った 無能にするs read-only 方式.
Throws: SQLException if a database 接近 error occurs.

isReadOnly

boolean
isReadOnly()
raises(	SQLException );

Description: 実験（する）s to see if the 関係 is in read-only 方式.
Returns: true if 関係 is read-only and 誤った さもなければ.
Throws: SQLException if a database 接近 error occurs.

setCatalog

無効の
setCatalog(	[in] string	catalog )
raises(	SQLException );

Description: 始める，決めるs a catalog 指名するーするために select a subspace of this 関係's database in which to work. If the driver does not support catalogs, it will silently ignore this request.
Parameter catalog: the 指名する of the catalog.
Throws: SQLException if a database 接近 error occurs.

getCatalog

string
getCatalog()
raises(	SQLException );

Description: returns the 関係's 現在の catalog 指名する.
Returns: the 現在の catalog 指名する or an empty string.
Throws: SQLException if a database 接近 error occurs.

setTransactionIsolation

無効の
setTransactionIsolation(	[in] long	level )
raises(	SQLException );

Description

試みる／企てるs to change the 処理／取引孤立／分離 level to the one given.

The constants defined in TransactionIsolation are the possible 処理／取引孤立／分離 levels.

公式文書，認める: This method cannot be called while in the middle of a 処理／取引.

Parameter level

one of the TransactionIsolation values with the exception of NONE; some databases may not support other values.

Throws

SQLException if a database 接近 error occurs.

getTransactionIsolation

long
getTransactionIsolation()
raises(	SQLException );

Description: gets this 関係's 現在の処理／取引孤立／分離 level.
Returns: the 現在の TransactionIsolation 方式 value.
Throws: SQLException if a database 接近 error occurs.

getTypeMap

::com::sun::星／主役にする::コンテナ::XNameAccess
getTypeMap()
raises(	SQLException );

Description: gets the type 地図／計画する反対する associated with this 関係. Only drivers which 器具／実施する the custom type mapping 施設 will return an 反対するさもなければ NULL could be returned.; Unless the 使用／適用 has 追加するd an 入ること／参加（者） to the type 地図／計画する, the 地図／計画する returned will be empty.
Returns: the XNameAccess 反対する associated with this 関係反対する.
Throws: SQLException if a database 接近 error occurs.

setTypeMap

無効の
setTypeMap(	[in] ::com::sun::星／主役にする::コンテナ::XNameAccess	typeMap )
raises(	SQLException );

Description: 任命する／導入するs the given type 地図／計画する as the type 地図／計画する for this 関係. The type 地図／計画する will be used for the custom mapping of SQL structured types and 際立った types.; Only if the driver supports custom type mapping is the setting of a 地図／計画する許すd.
Parameter typeMap: 始める，決める the XNameAccess 反対する associated with this 関係反対する.
Throws: SQLException if a database 接近 error occurs.

最高の，を越す of Page

Copyright © 2013, The Apache ソフトウェア創立／基礎, Licensed under the Apache License, 見解／翻訳／版 2.0. Apache, the Apache feather logo, Apache OpenOffice and OpenOffice.org are trademarks of The Apache ソフトウェア創立／基礎. Other 指名するs may be trademarks of their 各々の owners.

API

SDK

Tips ‘n’ Tricks

Miscellaneous