JavaTM 2 Platform
Std. Ed. v1.3

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  KeySpec engineGetKeySpec(Key key, Class 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 KeySpec engineGetKeySpec(Key key,
                                            Class keySpec)
                                     throws InvalidKeySpecException
指定された鍵オブジェクトの仕様 (鍵データ) を返します。keySpec は、鍵データが返される仕様クラスを識別します。たとえば、それが DSAPublicKeySpec.class の場合は、鍵データが DSAPublicKeySpec クラスのインスタンスに返されることを示します。
パラメータ:
key - 鍵
keySpec - 鍵データが返される仕様クラス
戻り値:
要求される仕様クラスのインスタンスにおける基本の鍵仕様 (鍵データ)
例外:
InvalidKeySpecException - 要求される鍵仕様が指定の鍵に不適切な場合、あるいは認識されない形式の鍵を指定した場合など、指定の鍵を処理できない場合

engineTranslateKey

protected abstract Key engineTranslateKey(Key key)
                                   throws InvalidKeyException
プロバイダが未知であるか、信頼できない可能性がある鍵オブジェクトを、この鍵ファクトリの対応する鍵オブジェクトに変換します。
パラメータ:
key - プロバイダが未知であるか、信頼できない鍵
戻り値:
変換した鍵
例外:
InvalidKeyException - 指定された鍵をこの鍵ファクトリで処理できない場合

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.