DataSource (DoqueDB JDBC Document (javadoc))

java.lang.Object
- jp.co.ricoh.doquedb.jdbcx.DataSource

すべての実装されたインタフェース:

java.sql.Wrapper, javax.naming.Referenceable, javax.sql.CommonDataSource, javax.sql.DataSource
```
public class DataSource
extends java.lang.Object
implements javax.sql.DataSource
```
この DataSource オブジェクトが表す物理データソースへの接続に対するファクトリです。 DriverManager 機能の代わりに、DataSource オブジェクトが接続を得るための適切な手段となります。 DataSource インタフェースを実装するオブジェクトは一般に、JavaTM Naming and Directory (JNDI) API を基にしたネームサービスで登録されています。ここに記述されていない javax.sql.DataSource メソッドは jp.co.ricoh.doquedb.jdbcx.SydDataSource に記述されています。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

DataSource()

コンストラクタ
コンストラクタと説明
`DataSource()`

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`void`	`close()` 使用中であるか否かに関係なく、この DataSource およびすべてのプールされた接続を終えます。
`java.sql.Connection`	`getConnection()` 接続プールから接続を取得します。
`java.sql.Connection`	`getConnection(java.lang.String user_, java.lang.String password_)` ユーザとパスワードがデフォルト接続プールに評価するのと同じでない場合、非プールされた接続を得ます。
`java.lang.String`	`getDatabaseName()` データベースの名前を得ます。
`static DataSource`	`getDataSource(java.lang.String name)`
`java.lang.String`	`getDataSourceName()` この DataSource の名前を得ます。
`int`	`getInitialConnections()` この DataSource が初期化されるとき作成される接続数を得ます。
`int`	`getLoginTimeout()` データベースへの接続試行中に、このデータソースが待機する最長時間 (秒) を取得します。
`java.io.PrintWriter`	`getLogWriter()` この DataSource オブジェクトのログライターを取得します。
`int`	`getMaxConnections()` プールが許容する最大の接続数を得ます。
`java.lang.String`	`getNetworkProtocol()` サーバとの通信に使用するプロトコルを得ます。
`java.util.logging.Logger`	`getParentLogger()` ドライバで使用されるすべてのロガーの親ロガーを返す。
`java.lang.String`	`getPassword()` ユーザパスワードを取得します。
`int`	`getPortNumber()` サーバのTCP/IP接続のポート番号を取得します。
`int`	`getPrepareThreshold()` サーバ側が準備する可能にするためにデフォルト敷居を得ます。
`javax.naming.Reference`	`getReference()` このDataSourceのためにカスタム特性を「スーパー-クラス」で定義された特性に追加します。
`java.lang.String`	`getServerName()` ホストの名前を得ます。
`java.lang.String`	`getUrl()` 供給された他の資産からDriverManager URLを取得。
`java.lang.String`	`getUser()` ユーザ名を取得します。
`void`	`initialize()` この DataSource を初期化します。
`boolean`	`isWrapperFor(java.lang.Class<?> iface)` [サポート外] 常に`false`を返します
`void`	`setDatabaseName(java.lang.String databaseName_)` DataSource の対象となるデータベース名を設定します。
`void`	`setDataSourceName(java.lang.String dataSourceName_)` この DataSource に名前を設定します。
`void`	`setInitialConnections(int initialConnections_)` この DataSource が初期化されるとき作成される接続数を設定します。
`void`	`setLoginTimeout(int loginTime_)` データベースへの接続試行中に、このデータソースが待機する最長時間 (秒) を設定します。
`void`	`setLogWriter(java.io.PrintWriter printWriter_)` この DataSource オブジェクトのログライターを java.io.PrintWriter オブジェクトに設定します。
`void`	`setMaxConnections(int maxConnections_)` プールが許容する最大の接続数を設定します。
`void`	`setNetworkProtocol(java.lang.String networkProtocol_)` DataSource の対象となるプロトコルを設定します。
`void`	`setPassword(java.lang.String password_)` DataSource の対象となるユーザパスワードを設定します。
`void`	`setPortNumber(int portNumber_)` DataSource の対象となるポート番号を設定します。
`void`	`setPrepareThreshold(int count_)` サーバ側を可能にするためのデフォルト敷居が準備するセット。
`void`	`setServerName(java.lang.String serverName_)` DataSource の対象となるサーバ名を設定します。
`void`	`setUrl(java.lang.String url_)` DataSource の対象となるJDBCのURLを設定します。
`void`	`setUser(java.lang.String user_)` DataSource の対象となるユーザ名を設定します。
`<T> T`	`unwrap(java.lang.Class<T> iface)` [サポート外]

クラスから継承されたメソッド java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェースから継承されたメソッド javax.sql.CommonDataSource
getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

- コンストラクタの詳細
  - DataSource
```
public DataSource()
```
- メソッドの詳細
  - getDataSource
```
public static DataSource getDataSource(java.lang.String name)
```
  - setServerName
```
public void setServerName(java.lang.String serverName_)
```
    DataSource の対象となるサーバ名を設定します。
    
    パラメータ:
    
    serverName_ - サーバ名。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後にサーバ名は変更出来ません。
  - setPortNumber
```
public void setPortNumber(int portNumber_)
```
    DataSource の対象となるポート番号を設定します。
    
    パラメータ:
    
    portNumber_ - ポート番号。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後にポート番号は変更出来ません。
  - setDatabaseName
```
public void setDatabaseName(java.lang.String databaseName_)
```
    DataSource の対象となるデータベース名を設定します。
    
    パラメータ:
    
    databaseName_ - データベース名。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後にデータベース名は変更出来ません。
  - setUser
```
public void setUser(java.lang.String user_)
```
    DataSource の対象となるユーザ名を設定します。
    
    パラメータ:
    
    user_ - ユーザ名。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後にユーザ名は変更出来ません。
  - setPassword
```
public void setPassword(java.lang.String password_)
```
    DataSource の対象となるユーザパスワードを設定します。
    
    パラメータ:
    
    password_ - ユーザパスワード。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後にユーザパスワードは変更出来ません。
  - setNetworkProtocol
```
public void setNetworkProtocol(java.lang.String networkProtocol_)
```
    DataSource の対象となるプロトコルを設定します。
    
    パラメータ:
    
    networkProtocol_ - プロトコル。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後にプロトコルは変更出来ません。
  - setUrl
```
public void setUrl(java.lang.String url_)
```
    DataSource の対象となるJDBCのURLを設定します。
    
    パラメータ:
    
    url_ - JDBC の URL
  - getInitialConnections
```
public int getInitialConnections()
```
    この DataSource が初期化されるとき作成される接続数を得ます。
    
    戻り値:
    
    初期化される時に作成される接続数。
  - setInitialConnections
```
public void setInitialConnections(int initialConnections_)
```
    この DataSource が初期化されるとき作成される接続数を設定します。
    
    パラメータ:
    
    initialConnections_ - 初期化される時に作成される接続数。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後には設定出来ません。
  - getMaxConnections
```
public int getMaxConnections()
```
    プールが許容する最大の接続数を得ます。
    
    戻り値:
    
    許されたプールされた接続の最大数。
  - setMaxConnections
```
public void setMaxConnections(int maxConnections_)
```
    プールが許容する最大の接続数を設定します。
    
    パラメータ:
    
    maxConnections_ - 最大が許すプールされた接続数。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後には設定出来ません。
  - getDataSourceName
```
public java.lang.String getDataSourceName()
```
    この DataSource の名前を得ます。
    
    戻り値:
    
    データソース名。
  - setDataSourceName
```
public void setDataSourceName(java.lang.String dataSourceName_)
```
    この DataSource に名前を設定します。
    
    パラメータ:
    
    dataSourceName_ - データソース名。
    
    例外:
    
    java.lang.IllegalStateException - 初期化後には設定出来ません。
    
    java.lang.IllegalArgumentException - 既に存在します。
  - initialize
```
public void initialize()
                throws java.sql.SQLException
```
    この DataSource を初期化します。
    
    例外:
    
    java.sql.SQLException - 十分な物理接続を作成することができないとき起こります。
  - getConnection
```
public java.sql.Connection getConnection(java.lang.String user_,
                                         java.lang.String password_)
                                  throws java.sql.SQLException
```
    ユーザとパスワードがデフォルト接続プールに評価するのと同じでない場合、非プールされた接続を得ます。
    
    定義:
    
    getConnection インタフェース内 javax.sql.DataSource
    
    パラメータ:
    
    user_ - ユーザ。
    
    password_ - ユーザパスワード。
    
    戻り値:
    
    java.sql.Connection
    
    例外:
    
    java.sql.SQLException - どんなプールされた接続も手があいていなくて、新しい物理接続を作成することができないとき起こります。
  - getConnection
```
public java.sql.Connection getConnection()
                                  throws java.sql.SQLException
```
    接続プールから接続を取得します。
    
    定義:
    
    getConnection インタフェース内 javax.sql.DataSource
    
    戻り値:
    
    プールされた接続
    
    例外:
    
    java.sql.SQLException - どんなプールされた接続も手があいていなくて、新しい物理接続を作成することができないとき起こります。
  - close
```
public void close()
```
    使用中であるか否かに関係なく、この DataSource およびすべてのプールされた接続を終えます。
  - getReference
```
public javax.naming.Reference getReference()
                                    throws javax.naming.NamingException
```
    このDataSourceのためにカスタム特性を「スーパー-クラス」で定義された特性に追加します。
    
    定義:
    
    getReference インタフェース内 javax.naming.Referenceable
    
    戻り値:
    
    javax.naming.Reference
    
    例外:
    
    javax.naming.NamingException
  - unwrap
```
public <T> T unwrap(java.lang.Class<T> iface)
             throws java.sql.SQLException
```
    [サポート外]
    
    定義:
    
    unwrap インタフェース内 java.sql.Wrapper
    
    例外:
    
    java.sql.SQLException
  - isWrapperFor
```
public boolean isWrapperFor(java.lang.Class<?> iface)
                     throws java.sql.SQLException
```
    [サポート外]
    常にfalseを返します
    
    定義:
    
    isWrapperFor インタフェース内 java.sql.Wrapper
    
    例外:
    
    java.sql.SQLException
  - getParentLogger
```
public java.util.logging.Logger getParentLogger()
                                         throws jp.co.ricoh.doquedb.exception.NotSupported
```
    ドライバで使用されるすべてのロガーの親ロガーを返す。 [サポート外！]
    
    定義:
    
    getParentLogger インタフェース内 javax.sql.CommonDataSource
    
    戻り値:
    
    Loggerオブジェクト。
    
    例外:
    
    jp.co.ricoh.doquedb.exception.NotSupported
  - getLoginTimeout
```
public int getLoginTimeout()
                    throws java.sql.SQLException
```
    データベースへの接続試行中に、このデータソースが待機する最長時間 (秒) を取得します。値が 0 のとき、デフォルトのシステムタイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを意味します。
    
    戻り値:
    
    タイムアウト秒
    
    例外:
    
    java.sql.SQLException
  - setLoginTimeout
```
public void setLoginTimeout(int loginTime_)
```
    データベースへの接続試行中に、このデータソースが待機する最長時間 (秒) を設定します。値が 0 のとき、デフォルトのシステムタイムアウトが設定されている場合はその値になります。そうでない場合はタイムアウトしないことを意味します。
    
    パラメータ:
    
    loginTime_ - タイムアウト秒
  - getLogWriter
```
public java.io.PrintWriter getLogWriter()
                                 throws java.sql.SQLException
```
    この DataSource オブジェクトのログライターを取得します。
    
    例外:
    
    java.sql.SQLException
  - setLogWriter
```
public void setLogWriter(java.io.PrintWriter printWriter_)
                  throws java.sql.SQLException
```
    この DataSource オブジェクトのログライターを java.io.PrintWriter オブジェクトに設定します。
    
    パラメータ:
    
    printWriter_ - 新しいログライター。ログの取得を無効にする場合は null に設定する
    
    例外:
    
    java.sql.SQLException
  - getServerName
```
public java.lang.String getServerName()
```
    ホストの名前を得ます。
    
    戻り値:
    
    サーバ名
  - getDatabaseName
```
public java.lang.String getDatabaseName()
```
    データベースの名前を得ます。
    
    戻り値:
    
    データベース名
  - getUser
```
public java.lang.String getUser()
```
    ユーザ名を取得します。
    
    戻り値:
    
    ユーザ名
  - getPassword
```
public java.lang.String getPassword()
```
    ユーザパスワードを取得します。
    
    戻り値:
    
    ユーザパスワード
  - getPortNumber
```
public int getPortNumber()
```
    サーバのTCP/IP接続のポート番号を取得します。
    
    戻り値:
    
    ポート番号
  - setPrepareThreshold
```
public void setPrepareThreshold(int count_)
```
    サーバ側を可能にするためのデフォルト敷居が準備するセット。
    
    パラメータ:
    
    count_ - サーバ側が準備する声明オブジェクトを再利用しなければならない回数
  - getPrepareThreshold
```
public int getPrepareThreshold()
```
    サーバ側が準備する可能にするためにデフォルト敷居を得ます。
    
    戻り値:
    
    カウント
  - getNetworkProtocol
```
public java.lang.String getNetworkProtocol()
```
    サーバとの通信に使用するプロトコルを得ます。
    
    戻り値:
    
    プロトコル
  - getUrl
```
public java.lang.String getUrl()
```
    供給された他の資産からDriverManager URLを取得。
    
    戻り値:
    
    URL

クラス DataSource

コンストラクタのサマリー

メソッドのサマリー

クラスから継承されたメソッド java.lang.Object

インタフェースから継承されたメソッド javax.sql.CommonDataSource

コンストラクタの詳細

DataSource

メソッドの詳細

getDataSource

setServerName

setPortNumber

setDatabaseName

setUser

setPassword

setNetworkProtocol

setUrl

getInitialConnections

setInitialConnections

getMaxConnections

setMaxConnections

getDataSourceName

setDataSourceName

initialize

getConnection

getConnection

close

getReference

unwrap

isWrapperFor

getParentLogger

getLoginTimeout

setLoginTimeout

getLogWriter

setLogWriter

getServerName

getDatabaseName

getUser

getPassword

getPortNumber

setPrepareThreshold

getPrepareThreshold

getNetworkProtocol

getUrl