ConnectionFactory (Jakarta EE 8 Specification API)

java.lang.ObjectSE
- javax.xml.registry.ConnectionFactory

```
public abstract class ConnectionFactory
extends ObjectSE
```
これは、Jakarta XML Registries 接続を作成するためのファクトリクラスの抽象基本クラスです。Jakarta XML Registries ConnectionFactory オブジェクトは、レジストリプロバイダーとの接続を作成するために、プロバイダー固有の方法で構成されます。
JNDIAPI を使用して ConnectionFactory を検索する
クライアントが Jakarta XML Registries ConnectionFactory を検索するための推奨される方法は、Java Naming and Directory Interface ^TM （JNDI）API 内です。ConnectionFactory オブジェクトは、JNDI API に基づく方法など、プロバイダー固有の方法でネーミングサービスに登録されます。この登録により、ConnectionFactory オブジェクトが論理名に関連付けられます。アプリケーションがその ConnectionFactory オブジェクトに関連付けられたプロバイダーとの接続を確立する場合、アプリケーションはルックアップを実行し、論理名を提供します。その後、アプリケーションは、返された ConnectionFactory オブジェクトを使用して、メッセージングプロバイダーへの接続を作成できます。
JNDIAPI を使用せずに ConnectionFactory を検索する
Jakarta XML Registries は、JNDI API を使用する必要のない Jakarta XML Registries ConnectionFactory を検索する別の方法を提供します。これは、Jakarta XML Registries API で提供される抽象クラス ConnectionFactory の newInstance 静的メソッドを使用して行われます。newInstance メソッドは Jakarta XML Registries ConnectionFactory を返します。クライアントは、システムプロパティ javax.xml.registry.ConnectionFactoryClass を定義することで、newInstance メソッドによってインスタンス化されるファクトリクラスを指定できます。このプロパティが設定されていない場合、Jakarta XML Registries プロバイダーはデフォルトの ConnectionFactory インスタンスを返す必要があります。
作成者:
Farrukh S. Najmi
関連事項:
Connection

コンストラクターの概要
コンストラクター
コンストラクターと説明
ConnectionFactory()

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

メソッドのサマリー

すべてのメソッド静的メソッドインスタンスメソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`abstract Connection`	`createConnection()` 名前付き接続を作成します。
`abstract FederatedConnection`	`createFederatedConnection(CollectionSE connections)` FederatedConnection を作成します。
`abstract PropertiesSE`	`getProperties()` createConnection および createFederatedConnection 呼び出し中に使用されるプロパティを取得します。
`static ConnectionFactory`	`newInstance()` デフォルトの `ConnectionFactory` オブジェクトを作成します。
`abstract void`	`setProperties(PropertiesSE properties)` createConnection および createFederatedConnection 呼び出し中に使用されるプロパティを設定します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - ConnectionFactory
```
public ConnectionFactory()
```
- メソッドの詳細
  - setProperties
```
public abstract void setProperties(PropertiesSE properties)
                            throws JAXRException
```
    createConnection および createFederatedConnection 呼び出し中に使用されるプロパティを設定します。
    標準接続プロパティ:
    javax.xml.registry.queryManagerURL - ターゲットレジストリプロバイダー内のクエリマネージャーサービスの URL 文字列
    javax.xml.registry.lifeCycleManagerURL - ターゲットレジストリプロバイダー内のライフサイクルマネージャーサービスの URL 文字列。指定しない場合、デフォルトで上記の queryManagerURL の値にする必要があります
    javax.xml.registry.semanticEquivalences - 意味的同等性の指定を可能にする文字列
    javax.xml.registry.security.authenticationMethod - レジストリプロバイダーで認証するときに使用される認証方法について、Jakarta XML Registries プロバイダーにヒントを提供する文字列。可能な値には、"UDDI_GET_AUTHTOKEN"、"HTTP_BASIC"、"CLIENT_CERTIFICATE"、"MS_PASSPORT" が含まれますが、これらに限定されません。
    javax.xml.registry.uddi.maxRows - 検索操作で返される行の最大数を指定する整数。このプロパティは UDDI プロバイダーに固有です
    javax.xml.registry.postalAddressScheme - この接続のデフォルトの住所スキームとして使用される ClassificationScheme の ID を指定する文字列
    機能レベル: 0
    パラメーター:
    properties - Jakarta XML Registries 仕様で指定されているか、プロバイダー固有の構成プロパティ。
    例外:
    JAXRException - Jakarta XML Registries プロバイダーで内部エラーが発生した場合
  - getProperties
```
public abstract PropertiesSE getProperties()
                                  throws JAXRException
```
    createConnection および createFederatedConnection 呼び出し中に使用されるプロパティを取得します。
    機能レベル: 0
    戻り値:
    このオブジェクトに定義されたプロパティ
    例外:
    JAXRException - Jakarta XML Registries プロバイダーで内部エラーが発生した場合
  - createConnection
```
public abstract Connection createConnection()
                                     throws JAXRException
```
    名前付き接続を作成します。このような接続は、Jakarta XML Registries プロバイダーとの通信に使用できます。
    機能レベル: 0
    戻り値:
    この呼び出しによって作成された接続
    例外:
    JAXRException - Jakarta XML Registries プロバイダーで内部エラーが発生した場合
    関連事項:
    Connection
  - createFederatedConnection
```
public abstract FederatedConnection createFederatedConnection(CollectionSE connections)
                                                       throws JAXRException
```
    FederatedConnection を作成します。
    機能レベル: 0 (オプション)
    パラメーター:
    connections - Connection オブジェクトのコレクションです。Connection オブジェクトは FederatedConnection オブジェクトの場合もあることに注意してください。
    戻り値:
    この呼び出しによって作成された FederatedConnection
    例外:
    JAXRException - Jakarta XML Registries プロバイダーで内部エラーが発生した場合
    関連事項:
    FederatedConnection
  - newInstance
```
public static ConnectionFactory newInstance()
                                     throws JAXRException
```
    デフォルトの ConnectionFactory オブジェクトを作成します。
    戻り値:
    ConnectionFactory の新しいインスタンス
    例外:
    JAXRException - Jakarta XML Registries プロバイダーで内部エラーが発生した場合

クラス ConnectionFactory

JNDIAPI を使用して ConnectionFactory を検索する

JNDIAPI を使用せずに ConnectionFactory を検索する

コンストラクターの概要

メソッドのサマリー

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

コンストラクターの詳細

ConnectionFactory

メソッドの詳細

setProperties

getProperties

createConnection

createFederatedConnection

newInstance