java.security
クラス KeyFactorySpi

java.lang.Object
  java.security.KeyFactorySpi

public abstract class KeyFactorySpi
extends Object

このクラスは、KeyFactory クラスの Service Provider Interface (SPI) を定義します。特定アルゴリズムの鍵ファクトリの実装を提供する各暗号サービスプロバイダは、このクラスのすべての abstract メソッドを実装する必要があります。

鍵ファクトリは、Key 型の不透明な暗号鍵である「鍵」と、基本の鍵データの透明な表現である「鍵仕様」との間の変換を行うために使用します。

鍵ファクトリは双方向性です。つまり、指定した鍵仕様 (鍵データ) から不透明な鍵オブジェクトを構築することも、適切な形式で鍵オブジェクトの基本の鍵データを取り出すこともできます。

同じ鍵に対して、互換性のある複数の鍵仕様が存在する場合があります。たとえば DSA 公開鍵は、DSAPublicKeySpec または X509EncodedKeySpec を使って指定できます。鍵ファクトリを使用すると、互換性のある鍵仕様間の変換を行うことができます。

プロバイダは、その鍵ファクトリでサポートする鍵仕様をすべてドキュメント化する必要があります。

導入されたバージョン:

1.2

関連項目:

KeyFactory, Key, PublicKey, PrivateKey, KeySpec, DSAPublicKeySpec, X509EncodedKeySpec

コンストラクタの概要

KeyFactorySpi()

メソッドの概要

protected abstract PrivateKey	engineGeneratePrivate(KeySpec keySpec) 指定された鍵仕様 (鍵データ) から非公開鍵オブジェクトを生成します。
protected abstract PublicKey	engineGeneratePublic(KeySpec keySpec) 指定された鍵仕様 (鍵データ) から公開鍵オブジェクトを生成します。
protected abstract <T extends KeySpec> T	engineGetKeySpec(Key key, Class<T> keySpec) 指定された鍵オブジェクトの仕様 (鍵データ) を返します。
protected abstract Key	engineTranslateKey(Key key) プロバイダが未知であるか、信頼できない可能性がある鍵オブジェクトを、この鍵ファクトリの対応する鍵オブジェクトに変換します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

KeyFactorySpi

public KeyFactorySpi()

メソッドの詳細

engineGeneratePublic

protected abstract PublicKey engineGeneratePublic(KeySpec keySpec)
                                           throws InvalidKeySpecException

指定された鍵仕様 (鍵データ) から公開鍵オブジェクトを生成します。

パラメータ:

keySpec - 公開鍵の仕様 (鍵データ)

戻り値:

公開鍵

例外:

InvalidKeySpecException - 指定された鍵仕様がこの鍵ファクトリによる公開鍵の生成に不適切な場合

engineGeneratePrivate

protected abstract PrivateKey engineGeneratePrivate(KeySpec keySpec)
                                             throws InvalidKeySpecException

指定された鍵仕様 (鍵データ) から非公開鍵オブジェクトを生成します。

パラメータ:

keySpec - 非公開鍵の仕様 (鍵データ)

戻り値:

非公開鍵

例外:

InvalidKeySpecException - 指定された鍵仕様がこの鍵ファクトリによる非公開鍵の生成に不適切な場合

engineGetKeySpec

protected abstract <T extends KeySpec> T engineGetKeySpec(Key key,
                                                          Class<T> keySpec)
                                               throws InvalidKeySpecException

指定された鍵オブジェクトの仕様 (鍵データ) を返します。keySpec は、鍵データが返される仕様クラスを識別します。たとえば、それが DSAPublicKeySpec.class の場合は、鍵データが DSAPublicKeySpec クラスのインスタンスに返されることを示します。

パラメータ:

key - 鍵

keySpec - 鍵データが返される仕様クラス

戻り値:

要求される仕様クラスのインスタンスにおける基本の鍵仕様 (鍵データ)

例外:

InvalidKeySpecException - 要求される鍵仕様が指定された鍵に不適切な場合、あるいは認識されない形式の鍵を指定した場合など、指定された鍵を処理できない場合

engineTranslateKey

protected abstract Key engineTranslateKey(Key key)
                                   throws InvalidKeyException

プロバイダが未知であるか、信頼できない可能性がある鍵オブジェクトを、この鍵ファクトリの対応する鍵オブジェクトに変換します。

パラメータ:

key - プロバイダが未知であるか、信頼できない鍵

戻り値:

変換した鍵

例外:

InvalidKeyException - 指定された鍵をこの鍵ファクトリで処理できない場合