/management/wls/{version}/datasources/vendors/id/{vendor}/drivers/id/{driver-class-name}

このリソースは、特定のデータベース・ドライバに適切なデータベース接続の構築を支援します。

リソースでは、次のメソッドがサポートされます。

• OPTIONSメソッド

• POSTメソッド

OPTIONSメソッド

このリソースのOPTIONSメソッドは、デフォルト値が事前移入されているテンプレート・エンティティを返します。

特定の種類のデータベース・ドライバに適切なデータベース接続を構築する場合、ドライバ・クラス名を検索し、このメソッドを呼び出して、このドライバに入力する必要がある属性がリストされたテンプレートを取得します。値を入力した後、入力済テンプレートをデータベース接続に変換するPOSTメソッドでこれを使用します。

ロール

管理者、デプロイヤ

レスポンス本文

返されるレスポンス本文には、DatabaseDriverAttributesエンティティが含まれます。

このメソッドは次のリンクを返すことができます。

• uri=/management/wls/{version}/datasources/vendors/id/{vendor}/drivers/id/{driver-class-name}/connection rel=connection

レスポンス・コード

このメソッドは、標準のHTTPステータス・コードのいずれかを返します。

例

例1   特定のドライバのデータベース接続を行うためのテンプレートの取得

この例は、OPTIONSメソッドを使用して、データベース・ドライバ構成のテンプレートを取得します。

リクエストの例

curl -v \
--user username:password \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-X OPTIONS http://localhost:7001/management/wls/latest/datasources/vendors/id/Derby/drivers/id/Derby's%20Driver%20(Type%204)%20Versions:Any

レスポンスの例

HTTP/1.1 200 OK

Response Body:
{"item": {
    "attributes": [
        {
            "name": "DbmsHost",
            "value": null,
            "defaultValue": null,
            "description": null,
            "inUrl": true,
            "required": true
        },
        {
            "name": "DbmsPort",
            "value": "1527",
            "defaultValue": "1527",
            "description": null,
            "inUrl": true,
            "required": true
        },
        {
            "name": "DbmsName",
            "value": null,
            "defaultValue": null,
            "description": null,
            "inUrl": true,
            "required": true
        },
        {
            "name": "DbmsUsername",
            "value": null,
            "defaultValue": null,
            "description": null,
            "inUrl": false,
            "required": true
        },
        {
            "name": "DbmsPassword",
            "value": null,
            "defaultValue": null,
            "description": null,
            "inUrl": false,
            "required": true
        }
    ],
    "passwordAttributeName": "DbmsPassword"
}}

POSTメソッド

このリソースのPOSTメソッドは、ドライバ固有の属性のセットを、汎用のデータベース接続エンティティに変換し、接続URLおよびプロパティのリストを適切にフォーマットします。

注意: RESTリソースはクリアテキスト・パスワードを返すことができないため、ドライバ属性のいずれかにパスワードが保持されていても、返されるドライバにパスワードは入力されていません。これを補うために、クライアントは、データベース・ドライバ属性エンティティを保持し、そのpasswordAttributeNameプロパティを使用してパスワードを保持する属性を検索し、返されたデータベース接続エンティティのpasswordプロパティをそのパスワードに設定する必要があります。

ロール

管理者、デプロイヤ

リクエスト本文

リクエスト本文には、完全に移入されたDatabaseDriverAttributesエンティティが含まれている必要があります。読取り専用パラメータ値は無視されます。

レスポンス本文

返されるレスポンス本文には、DatabaseConnectionエンティティが含まれます。

レスポンス・コード

このメソッドは、標準のHTTPステータス・コードのいずれかを返します。

例

例1   特定のデータベースのデータベース接続の作成

この例は、POSTメソッドを使用して、データベース接続構成を構築します。

リクエストの例

curl -v \
--user username:password \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-H Content-Type:application/json \
-d "{
    attributes: [
        { name: 'DbmsHost', value: 'localhost' },
        { name: 'DbmsPort', value: '1527' },
        { name: 'DbmsName', value: 'db1' },
        { name: 'DbmsUsername', value: 'u1' },
        { name: 'DbmsPassword', value: 'p1' }
    ]
}" \
-X POST http://localhost:7001/management/wls/latest/datasources/vendors/id/Derby/drivers/id/Derby's%20Driver%20(Type%204)%20Versions:Any

レスポンスの例

HTTP/1.1 200 OK

Response Body:
{"item": {
    "properties": [
        {
            "name": "user",
            "value": "u1"
        },
        {
            "name": "portNumber",
            "value": "1527"
        },
        {
            "name": "databaseName",
            "value": "db1;create=true"
        },
        {
            "name": "serverName",
            "value": "localhost"
        }
    ],
    "driverName": "org.apache.derby.jdbc.ClientDriver",
    "url": "jdbc:derby:\/\/localhost:1527\/db1;ServerName=localhost;databaseName=db1"
}}