jp.co.amano.etiming.atss3161
クラス TimeStampReqGenerator

java.lang.Object
  jp.co.amano.etiming.atss3161.TimeStampReqGenerator

public class TimeStampReqGenerator

extends java.lang.Object

TimeStampReqGenerator はタイムスタンプリクエストの生成に使用するクラスです。
generate メソッドの呼び出しで新たなタイムスタンプリクエストを生成します。

generate メソッドの呼び出し時にノンスを含める設定になっている場合、generate メソッドの呼び出しごとに新しいノンスが生成されてタイムスタンプリクエストに設定されます。

関連項目:

TimeStampReq

コンストラクタの概要

TimeStampReqGenerator()
TimeStampReqGeneratorオブジェクトを生成します。

メソッドの概要

void	disableNonce() 生成したタイムスタンプリクエストにノンスを含めないように設定します。
void	enableNonce() タイムスタンプリクエストにノンスを含めるように設定します。
void	enableNonce(int nonceSize) 指定されたサイズで生成されたノンスを含めるように設定します。
void	enableNonce(int nonceSize, java.security.SecureRandom random) 指定されたサイズとユーザが提供する乱数ジェネレータを使って生成されたノンスを含めるように設定します。
TimeStampReq	generate() タイムスタンプリクエストを作成します。
MessageImprint	getMessageImprint() タイムスタンプ対象データのメッセージダイジェストを返します。
ObjectIdentifier	getReqPolicy() TSA ポリシー IDを返します。
boolean	isCertReq() タイムスタンプリクエストの結果として返されるタイムスタンプトークンにタイムスタンプ局の公開鍵証明書を含めるかどうかを返します。
boolean	isNonceEnabled() タイムスタンプリクエストにノンスを含めるかどうかを返します。
void	setCertReq(boolean certReq) タイムスタンプリクエストの結果として返されるタイムスタンプトークンにタイムスタンプ局の公開鍵証明書を含めるかどうかを設定します。
void	setMessageImprint(MessageImprint messageImprint) タイムスタンプ対象データのメッセージダイジェストを設定します。
void	setReqPolicy(ObjectIdentifier reqPolicy) TSA ポリシー IDを設定します。

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

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

コンストラクタの詳細

TimeStampReqGenerator

public TimeStampReqGenerator()

TimeStampReqGeneratorオブジェクトを生成します。

メソッドの詳細

disableNonce

public void disableNonce()

生成したタイムスタンプリクエストにノンスを含めないように設定します。

関連項目:

isNonceEnabled()

enableNonce

public void enableNonce()

タイムスタンプリクエストにノンスを含めるように設定します。

タイムスタンプリクエスト生成時には TST Lib-J標準の乱数ジェネレータで 16 バイトの整数を生成し、これをノンスとして設定します。

関連項目:

isNonceEnabled()

enableNonce

public void enableNonce(int nonceSize)

指定されたサイズで生成されたノンスを含めるように設定します。

タイムスタンプリクエスト生成時には TST Lib-J標準の乱数ジェネレータで指定されたサイズの整数を生成し、 これをノンスとして設定します。

パラメータ:

nonceSize - ノンスサイズ (バイト数で指定)

例外:

java.lang.IllegalArgumentException - ノンスサイズが 0 を含む 0 以下の場合

関連項目:

isNonceEnabled()

enableNonce

public void enableNonce(int nonceSize,
                        java.security.SecureRandom random)

指定されたサイズとユーザが提供する乱数ジェネレータを使って生成されたノンスを含めるように設定します。

タイムスタンプリクエスト生成時には指定された乱数ジェネレータで指定されたサイズの整数を生成し、 これをノンスとして設定します。

パラメータ:

nonceSize - ノンスサイズ (バイト数で指定)

random - 乱数ジェネレータ

例外:

java.lang.IllegalArgumentException - ノンスサイズが 0 を含む 0 以下の場合

関連項目:

isNonceEnabled()

generate

public TimeStampReq generate()
                      throws java.security.NoSuchAlgorithmException

タイムスタンプリクエストを作成します。
本メソッドの使用前には setMessageImprint メソッドを使用してタイムスタンプ対象データのメッセージダイジェストを設定しておく必要があります。

次の設定は TimeStampReqGenerator から作成されたタイムスタンプリクエストへコピーされます。

• タイムスタンプ対象データのメッセージダイジェスト(messageImprint)
• TSA ポリシー ID(reqPolicy)
• タイムスタンプトークン内に TSA 証明書を含めるかどうか(certReq)

また、ノンスを含める設定になっている場合、generate メソッドの呼び出しごとにノンスが生成され、タイムスタンプリクエストに設定されます。

ノンス生成に TST Lib-J標準の乱数ジェネレータを使用する場合、 generate メソッドを呼び出すと内部で乱数ジェネレータが作成されます。 このとき NoSuchAlgorithmException が発生することがあります。
ユーザが用意した乱数ジェネレータを使用する場合は enableNonce(int, java.security.SecureRandom) メソッドを使用してあらかじめ乱数ジェネレータを設定しておく必要があります。

戻り値:

新たに生成されたタイムスタンプリクエスト

例外:

java.security.NoSuchAlgorithmException - 標準の乱数アルゴリズムが使用可能でない場合

java.lang.IllegalStateException - タイムスタンプ対象データのメッセージダイジェストが設定されていない場合

getReqPolicy

public ObjectIdentifier getReqPolicy()

TSA ポリシー IDを返します。設定されていない場合は null を返します。 TimeStampReqGenerator 作成時には TSA ポリシー IDは null として初期化されます。

戻り値:

TSA ポリシー ID。設定されていない場合は null。

関連項目:

setReqPolicy(jp.co.amano.etiming.atss3161.ObjectIdentifier)

setReqPolicy

public void setReqPolicy(ObjectIdentifier reqPolicy)

TSA ポリシー IDを設定します。 TSA ポリシー IDを設定しない場合は null を指定します。 TimeStampReqGenerator 作成時には TSA ポリシー IDは null として初期化されます。

パラメータ:

reqPolicy - TSA ポリシー ID。設定しない場合は null。

関連項目:

getReqPolicy()

isNonceEnabled

public boolean isNonceEnabled()

タイムスタンプリクエストにノンスを含めるかどうかを返します。 ノンスを含める場合は true、含めない場合は false を返します。

TimeStampReqGenerator 作成時にはノンスを含める設定 (サイズは 16 バイト、乱数ジェネレータはTST Lib-J標準のものを使用) で初期化されます。

戻り値:

タイムスタンプリクエストにノンスを含める場合は true、 使用しない場合は false。

関連項目:

enableNonce(), enableNonce(int), enableNonce(int,SecureRandom), disableNonce()

isCertReq

public boolean isCertReq()

タイムスタンプリクエストの結果として返されるタイムスタンプトークンにタイムスタンプ局の公開鍵証明書を含めるかどうかを返します。 タイムスタンプ局の公開鍵証明書を含める場合はtrue、含めない場合はfalseを返します。 TimeStampReqGenerator作成時にはこの値はtrueとして初期化されます。

戻り値:

タイムスタンプ局の公開鍵証明書を含める場合はtrue、含めない場合はfalse

関連項目:

setCertReq(boolean)

setCertReq

public void setCertReq(boolean certReq)

タイムスタンプリクエストの結果として返されるタイムスタンプトークンにタイムスタンプ局の公開鍵証明書を含めるかどうかを設定します。 タイムスタンプ局の公開鍵証明書を含める場合はtrue、含めない場合はfalseを設定します。 TimeStampReqGenerator作成時にはこの値はtrueとして初期化されます。

パラメータ:

certReq - 証明書を含める場合はtrue。含めない場合はfalse。

関連項目:

isCertReq()

getMessageImprint

public MessageImprint getMessageImprint()

タイムスタンプ対象データのメッセージダイジェストを返します。 TimeStampReqGenerator 作成時にはこの値は null として初期化されています。 generate メソッドを呼び出してタイムスタンプリクエストを作成する前にはタイムスタンプ対象データのメッセージダイジェストを設定しておかなくてはなりません。

戻り値:

タイムスタンプ対象データのメッセージダイジェスト。設定されていない場合は null。

関連項目:

setMessageImprint(jp.co.amano.etiming.atss3161.MessageImprint)

setMessageImprint

public void setMessageImprint(MessageImprint messageImprint)

タイムスタンプ対象データのメッセージダイジェストを設定します。 nullを設定することはできません。 TimeStampReqGenerator作成時にはこの値はnullとして初期化されています。 generateメソッドを呼び出してタイムスタンプリクエストを作成する前にはタイムスタンプ対象データのメッセージダイジェストを設定しておかなくてはなりません。

パラメータ:

messageImprint - タイムスタンプ対象データのメッセージダイジェスト

例外:

NullPointerExeption - 引数messageImprintにnullを指定した場合

関連項目:

getMessageImprint()