public final class TerminalFactory extends Object
それぞれのTerminalFactoryには、それがどのように実装されたかを示すtype
があります。これは、getInstance()メソッドを使用して実装を取得するときに指定する必要があり、getType()メソッドを使って取得できます。
定義されているのは、次の標準の型名です。
PC/SC
None
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の文字列表現を返します。
|
public static String getDefaultType()
これは次のように決定されます。このクラスが初期化されるときに、システム・プロパティjavax.smartcardio.TerminalFactory.DefaultType
が検査されます。これが設定されている場合、この型のTerminalFactoryは、params
の値としてnull
を渡してgetInstance(String,Object)メソッドを呼び出すことでインスタンス化されます。呼出しが成功すると、型はデフォルトの型になり、ファクトリはデフォルト・ファクトリになります。
システム・プロパティが設定されていない場合、またはgetInstance()呼出しがなんらかの理由で失敗した場合、システムにより実装固有のデフォルト型とTerminalFactoryがデフォルトになります。
public static TerminalFactory getDefault()
デフォルトのTerminalFactoryは常に使用可能です。ただし、実装によっては端末が提供されない場合があります。
public static TerminalFactory getInstance(String type, Object params) throws NoSuchAlgorithmException
このメソッドは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。指定された型をサポートする最初のProviderのTerminalFactorySpi実装をカプセル化する新しいTerminalFactoryオブジェクトが返されます。
登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
TerminalFactory
は、指定されたパラメータのObjectで初期化されます。必要なパラメータの型は、TerminalFactory
の型によって異なります。
type
- 要求されたTerminalFactoryの型params
- TerminalFactorySpi実装に渡すパラメータ。パラメータの必要がない場合はnullNullPointerException
- typeがnullの場合NoSuchAlgorithmException
- 指定された型のTerminalFactorySpiをサポートするProviderがない場合public static TerminalFactory getInstance(String type, Object params, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
指定されたプロバイダのTerminalFactorySpi実装をカプセル化する新しいTerminalFactoryオブジェクトが返されます。指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。
登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
TerminalFactory
は、指定されたパラメータの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オブジェクトが返されます。指定したプロバイダ・オブジェクトは、プロバイダ・リストに登録する必要はありません。
TerminalFactory
は、指定されたパラメータのObjectで初期化されます。必要なパラメータの型は、TerminalFactory
の型によって異なります。
type
- 要求されたTerminalFactoryの型params
- TerminalFactorySpi実装に渡すパラメータ。パラメータの必要がない場合はnullprovider
- プロバイダNullPointerException
- typeがnullの場合IllegalArgumentException
- providerがnullの場合NoSuchAlgorithmException
- 指定された型のTerminalFactorySpi実装が、指定されたプロバイダから使用可能でない場合public Provider getProvider()
public String getType()
public CardTerminals terminals()
Copyright © 2005, 2018, Oracle and/or its affiliates. All rights reserved.