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

java.lang.Object
  jp.co.amano.etiming.atss3161.HttpTimeStampClient
      jp.co.amano.etiming.atss3161.AmanoTimeStampClient

すべての実装インタフェース:

TimeStampClient

public class AmanoTimeStampClient

extends HttpTimeStampClient

アマノタイムスタンプ局に対してタイムスタンプトークンの生成の要求を行います。

アマノタイムスタンプ局に対してタイムスタンプトークンの生成の要求を行う場合には、 アマノタイムスタンプサービスにて発行しているライセンスファイルが必要です。

コンストラクタの概要

AmanoTimeStampClient(java.lang.String accessLocation)
AmanoTimeStampClient オブジェクトを生成し、指定したアマノタイムスタンプ局の URL でその AmanoTimeStampClient オブジェクトを初期化します。

メソッドの概要

byte[]	getLicense() ユーザ認証用ライセンスを返します。
byte[]	sendRequest(byte[] timeStampReq) アマノタイムスタンプ局に DER で符号化された形式のタイムスタンプリクエストを送信し、 DER で符号化された形式のタイムスタンプトークンを取得します。
TimeStampToken	sendRequest(TimeStampReq timeStampReq) アマノタイムスタンプ局にタイムスタンプリクエストを送信し、 タイムスタンプトークンを取得します。
void	setLicense(byte[] license, char[] password) ユーザ認証用のライセンスとそのパスワードを設定します。

クラス jp.co.amano.etiming.atss3161.HttpTimeStampClient から継承したメソッド

getAccessLocation, getConnectionTimeout, getProxyHost, getTimeout, setAccessLocation, setConnectionTimeout, setProxyHost, setTimeout

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

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

コンストラクタの詳細

AmanoTimeStampClient

public AmanoTimeStampClient(java.lang.String accessLocation)

AmanoTimeStampClient オブジェクトを生成し、指定したアマノタイムスタンプ局の URL でその AmanoTimeStampClient オブジェクトを初期化します。

パラメータ:

accessLocation - アマノタイムスタンプ局の URL

例外:

java.lang.IllegalArgumentException - URL の形式が不正である場合

メソッドの詳細

getLicense

public byte[] getLicense()

ユーザ認証用ライセンスを返します。ライセンスが設定されていない場合は null を返します。

戻り値:

ユーザ認証用ライセンス。設定されていない場合は null。

関連項目:

setLicense(byte[], char[])

setLicense

public void setLicense(byte[] license,
                       char[] password)
                throws LicenseException

ユーザ認証用のライセンスとそのパスワードを設定します。 設定するライセンス、またはパスワードに null を指定することはできません。

パラメータ:

license - ライセンスが格納されたバイトデータ

password - 指定したライセンスに対応するパスワード

例外:

LicenseException - license の形式が不正である場合

LicenseException - password が不正である場合

関連項目:

getLicense()

sendRequest

public byte[] sendRequest(byte[] timeStampReq)
                   throws TransportException,
                          ATSSDERParsingException,
                          RejectionResponseStatusException,
                          TSTFieldVerificationException,
                          java.security.GeneralSecurityException

アマノタイムスタンプ局に DER で符号化された形式のタイムスタンプリクエストを送信し、 DER で符号化された形式のタイムスタンプトークンを取得します。
本メソッドの使用前には、あらかじめ setLicense メソッドを使用してライセンスを設定しておく必要があります。

AmanoTimeStampClient の sendRequest メソッドは接続先のタイムスタンプ局からアマノタイムスタンプ局によって定義されるエラー情報付きの HTTP レスポンスを受け取った場合、AmanoTransportException をスローします。 それ以外の HTTP エラーを表すレスポンスを受け取った場合は HttpStatusException をスローします。
AmanoTransportException がスローされた場合は getStatusCode メソッドを使用することで HTTP レスポンスのステータスコードを、 getDetailCode メソッドを使用することでエラーの詳細コードをそれぞれ取得できます。
アマノタイムスタンプ局によって定義されるエラーの詳細コードにはついては AmanoTransportException を参照してください。

定義:

インタフェース TimeStampClient 内の sendRequest

オーバーライド:

クラス HttpTimeStampClient 内の sendRequest

パラメータ:

timeStampReq - タイムスタンプリクエストの DER で符号化された形式

戻り値:

タイムスタンプトークンの DER で符号化された形式

例外:

ATSSDERParsingException - タイムスタンプリクエストの形式が不正である場合

TimeoutException - タイムスタンプ局との通信中にタイムアウトが発生した場合

HttpStatusException - HTTP レスポンスステータスが要求の失敗を示していた場合

AmanoTransportException - HTTP レスポンスがアマノタイムスタンプ局によって定義されるエラー情報を含んでいる場合

TransportException - タイムスタンプ局との通信エラーが発生した場合

ATSSDERParsingException - タイムスタンプレスポンスを解析中にエラーが発生した場合

RejectionResponseStatusException - タイムスタンプリクエストが棄却された場合

InvalidMessageImprintException - タイムスタンプリクエストのタイムスタンプ対象データのメッセージダイジェストと タイムスタンプトークン内のものが一致しない場合

InvalidNonceException - タイムスタンプリクエストのノンスと タイムスタンプトークン内のものが一致しない場合

TSACertificateNotFoundException - タイムスタンプリクエストに証明書要求を指定したのにもかかわらず タイムスタンプトークン内に TSA 証明書が含まれていない場合

CertificateFoundException - タイムスタンプリクエストに証明書要求を指定しなかったのにもかかわらず タイムスタンプトークン内に証明書が含まれる場合

InvalidPolicyException - タイムスタンプリクエストの TSA ポリシー IDと タイムスタンプトークン内のものが一致しない場合

TSTFieldVerificationException - タイムスタンプトークンのフィールドがタイムスタンプリクエストに 対応しない場合

java.security.cert.CertificateException - タイムスタンプトークンに含まれる証明書確認中にエラーが発生した場合

java.security.GeneralSecurityException - セキュリティ例外が発生した場合

java.lang.IllegalStateException - ライセンス情報が設定されていない場合

関連項目:

AmanoTransportException

sendRequest

public TimeStampToken sendRequest(TimeStampReq timeStampReq)
                           throws TransportException,
                                  ATSSDERParsingException,
                                  RejectionResponseStatusException,
                                  TSTFieldVerificationException,
                                  java.security.GeneralSecurityException

アマノタイムスタンプ局にタイムスタンプリクエストを送信し、 タイムスタンプトークンを取得します。
本メソッドの使用前には、あらかじめ setLicense メソッドを使用してライセンスを設定しておく必要があります。

定義:

インタフェース TimeStampClient 内の sendRequest

オーバーライド:

クラス HttpTimeStampClient 内の sendRequest

パラメータ:

timeStampReq - タイムスタンプリクエスト

戻り値:

タイムスタンプトークン

例外:

TimeoutException - タイムスタンプ局との通信中にタイムアウトが発生した場合

HttpStatusException - HTTP レスポンスステータスが要求の失敗を示していた場合

AmanoTransportException - HTTP レスポンスがアマノタイムスタンプ局によって定義されるエラー情報を含んでいる場合

TransportException - タイムスタンプ局との通信エラーが発生した場合

ATSSDERParsingException - タイムスタンプレスポンスを解析中にエラーが発生した場合

RejectionResponseStatusException - タイムスタンプリクエストが棄却された場合

InvalidMessageImprintException - タイムスタンプリクエストのタイムスタンプ対象データのメッセージダイジェストと タイムスタンプトークン内のものが一致しない場合

InvalidNonceException - タイムスタンプリクエストのノンスと タイムスタンプトークン内のものが一致しない場合

TSACertificateNotFoundException - タイムスタンプリクエストに証明書要求を指定したのにもかかわらず タイムスタンプトークン内に TSA 証明書が含まれていない場合

CertificateFoundException - タイムスタンプリクエストに証明書要求を指定しなかったのにもかかわらず タイムスタンプトークン内に証明書が含まれる場合

InvalidPolicyException - タイムスタンプリクエストの TSA ポリシー IDと タイムスタンプトークン内のものが一致しない場合

TSTFieldVerificationException - タイムスタンプトークンのフィールドがタイムスタンプリクエストに 対応しない場合

java.security.cert.CertificateException - タイムスタンプトークンに含まれる証明書確認中にエラーが発生した場合

java.security.GeneralSecurityException - セキュリティ例外が発生した場合

java.lang.IllegalStateException - ライセンス情報が設定されていない場合

導入されたバージョン:

1.10

関連項目:

sendRequest(byte[]), AmanoTransportException