|
Java Smart Card I/O | |||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object javax.smartcardio.TerminalFactory
public final class TerminalFactory
CardTerminal オブジェクトのファクトリです。 これにより、アプリケーションで次のことができます。
それぞれの TerminalFactory には、それがどのように実装されたかを示す type
があります。これは、getInstance() メソッドを使用して実装を取得するときに指定する必要があり、getType() メソッドを使って取得できます。
定義されているのは、次の標準の型名です。
PC/SC
なし
None
を返し、getDefault() は None
TerminalFactory のインスタンスを返します。この型のファクトリは、getInstance()
メソッドを呼び出すことでは取得できません。
注: getInstance()
メソッドを使って初期化パラメータを受け入れるプロバイダ実装では、可能なかぎり String の名前と値のペアをベースにしたパラメータの表現として Properties オブジェクトを使用することを強くお勧めします。これにより、各プロバイダがパラメータとしてさまざまなプロバイダ固有のクラスを使用する場合に比べて、アプリケーションでの複数プロバイダとの相互運用が簡単になります。
TerminalFactory は、拡張可能なサービスプロバイダフレームワークを利用します。新しい実装の追加を必要とするサービスプロバイダは、詳細について TerminalFactorySpi クラスを参照してください。
CardTerminals
,
Provider
メソッドの概要 | |
---|---|
static TerminalFactory |
getDefault()
デフォルトの TerminalFactory インスタンスを返します。 |
static String |
getDefaultType()
デフォルトの TerminalFactory 型を取得します。 |
static TerminalFactory |
getInstance(String type,
Object params)
指定されたパラメータで初期化される、指定された型の TerminalFactory を返します。 |
static TerminalFactory |
getInstance(String type,
Object params,
Provider provider)
指定されたパラメータで初期化される、指定された型の TerminalFactory を返します。 |
static TerminalFactory |
getInstance(String type,
Object params,
String provider)
指定されたパラメータで初期化される、指定された型の TerminalFactory を返します。 |
Provider |
getProvider()
この TerminalFactory のプロバイダを返します。 |
String |
getType()
この TerminalFactory の型を返します。 |
CardTerminals |
terminals()
このファクトリでサポートされる端末をカプセル化する、新しい CardTerminals オブジェクトを返します。 |
String |
toString()
この TerminalFactory の文字列表現を返します。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
メソッドの詳細 |
---|
public static String getDefaultType()
これは次のように決定されます。
このクラスが初期化されるときに、システムプロパティー javax.smartcardio.TerminalFactory.DefaultType
が検査されます。システムプロパティーが設定されている場合、この型の TerminalFactory は、params
の値として null
を指定して getInstance(String,Object) メソッドを呼び出すことでインスタンス生成されます。呼び出しが成功すると、型はデフォルトの型になり、ファクトリは default ファクトリになります。
システムプロパティーが設定されていない場合、または getInstance() 呼び出しがなんらかの理由で失敗した場合、システムにより実装固有のデフォルト型と TerminalFactory がデフォルトになります。
public static TerminalFactory getDefault()
デフォルトの TerminalFactory は常に使用可能です。ただし、実装によっては端末が提供されない場合があります。
public static TerminalFactory getInstance(String type, Object params) throws NoSuchAlgorithmException
このメソッドは、最優先の Provider から順に、登録済みのセキュリティー Provider のリストをトラバースします。指定された型をサポートする最初の Provider の TerminalFactorySpi 実装をカプセル化する新しい TerminalFactory オブジェクトが返されます。
登録済みプロバイダのリストは、Security.getProviders() メソッド経由で取得できます。
TransformService
は、指定されたパラメータの Object で初期化されます。必要なパラメータの型は、TerminalFactory
の型によって異なります。
type
- 要求された TerminalFactory の型params
- TerminalFactorySpi 実装に渡すパラメータ。パラメータの必要がない場合は null
NullPointerException
- type が null の場合
NoSuchAlgorithmException
- 指定された型の TerminalFactorySpi をサポートする Provider がない場合public static TerminalFactory getInstance(String type, Object params, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
指定されたプロバイダの TerminalFactorySpi 実装をカプセル化する新しい TerminalFactory オブジェクトが返されます。指定したプロバイダは、セキュリティープロバイダリストに登録する必要があります。
登録済みプロバイダのリストは、Security.getProviders() メソッド経由で取得できます。
TransformService
は、指定されたパラメータの Object で初期化されます。必要なパラメータの型は、TerminalFactory
の型によって異なります。
type
- 要求された TerminalFactory の型params
- TerminalFactorySpi 実装に渡すパラメータ。パラメータの必要がない場合は nullprovider
- プロバイダ名
NullPointerException
- type が null の場合
IllegalArgumentException
- provider が null または空の文字列である場合
NoSuchAlgorithmException
- 指定された型の TerminalFactorySpi 実装が、指定されたプロバイダから使用可能でない場合
NoSuchAlgorithmException
- 指定された型の TerminalFactory が見つからなかった場合
NoSuchProviderException
- 指定されたプロバイダが見つからなかった場合public static TerminalFactory getInstance(String type, Object params, Provider provider) throws NoSuchAlgorithmException
指定されたプロバイダオブジェクトの TerminalFactorySpi 実装をカプセル化する新しい TerminalFactory オブジェクトが返されます。指定したプロバイダオブジェクトは、プロバイダーリストに登録する必要はありません。
TransformService
は、指定されたパラメータの Object で初期化されます。必要なパラメータの型は、TerminalFactory
の型によって異なります。
type
- 要求された TerminalFactory の型params
- TerminalFactorySpi 実装に渡すパラメータ。パラメータの必要がない場合は nullprovider
- プロバイダ
NullPointerException
- type が null の場合
IllegalArgumentException
- provider が null の場合
NoSuchAlgorithmException
- 指定された型の TerminalFactorySpi 実装が、指定されたプロバイダから使用可能でない場合public Provider getProvider()
public String getType()
public CardTerminals terminals()
public String toString()
Object
内の toString
|
Java Smart Card I/O | |||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |