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

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

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

TimeStampClient

直系の既知のサブクラス:

AmanoTimeStampClient

public class HttpTimeStampClient

extends java.lang.Object

implements TimeStampClient

本クラスはタイムスタンプ局と RFC 3161 で定義されている HTTP 経由のタイムスタンププロトコルを使用して通信するときに使用するクラスです。

HttpTimeStampClient では URL によってタイムスタンプトークン発行先タイムスタンプ局を指定します。

コンストラクタの概要

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

メソッドの概要

java.lang.String	getAccessLocation() タイムスタンプ局のURLを返します。
int	getConnectionTimeout() タイムスタンプサーバへの接続が確立するまでに HttpTimeStampClient が待機する最長時間 (ミリ秒) を返します。
ProxyHost	getProxyHost() HTTPプロキシサーバを返します。
int	getTimeout() タイムスタンプサーバへ接続後、サーバの応答を待機する最長時間 (ミリ秒) を返します。
byte[]	sendRequest(byte[] timeStampReq) タイムスタンプ局に DER で符号化された形式のタイムスタンプリクエストを送信し、 DER で符号化された形式のタイムスタンプトークンを取得します。
TimeStampToken	sendRequest(TimeStampReq timeStampReq) タイムスタンプ局にタイムスタンプリクエストを送信し、 タイムスタンプトークンを取得します。
void	setAccessLocation(java.lang.String accessLocation) タイムスタンプ局の URL を設定します。
void	setConnectionTimeout(int connectionTimeout) タイムスタンプサーバへの接続が確立するまでに HttpTimeStampClient が待機する最長時間 (ミリ秒) を設定します。
void	setProxyHost(ProxyHost proxyHost) HTTPプロキシサーバを設定します。
void	setTimeout(int timeout) タイムスタンプサーバへ接続後、サーバの応答を待機する最長時間 (ミリ秒) を設定します。

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

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

コンストラクタの詳細

HttpTimeStampClient

public HttpTimeStampClient(java.lang.String accessLocation)

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

パラメータ:

accessLocation - タイムスタンプ局の URL

例外:

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

メソッドの詳細

getAccessLocation

public java.lang.String getAccessLocation()

タイムスタンプ局のURLを返します。

定義:

インタフェース TimeStampClient 内の getAccessLocation

戻り値:

タイムスタンプ局のURL

関連項目:

setAccessLocation(java.lang.String)

setAccessLocation

public void setAccessLocation(java.lang.String accessLocation)

タイムスタンプ局の URL を設定します。

定義:

インタフェース TimeStampClient 内の setAccessLocation

パラメータ:

accessLocation - タイムスタンプ局の URL

例外:

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

関連項目:

getAccessLocation()

getProxyHost

public ProxyHost getProxyHost()

HTTPプロキシサーバを返します。 HTTPプロキシサーバを使用しない場合はnullを返します。 HttpTimeStampClient が作成されると、HTTPプロキシサーバは null に初期化されます。

戻り値:

HTTPプロキシサーバ。設定されていない場合は null。

関連項目:

setProxyHost(jp.co.amano.etiming.atss3161.ProxyHost)

setProxyHost

public void setProxyHost(ProxyHost proxyHost)

HTTPプロキシサーバを設定します。 HTTPプロキシサーバを使用しない場合は引数にnullを指定します。 HttpTimeStampClient が作成されると、HTTPプロキシサーバは null に初期化されます。

パラメータ:

proxyHost - HTTPプロキシサーバ。設定しない場合は null。

関連項目:

getProxyHost()

sendRequest

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

タイムスタンプ局に DER で符号化された形式のタイムスタンプリクエストを送信し、 DER で符号化された形式のタイムスタンプトークンを取得します。

タイムスタンプ局が HTTP エラーで応答した場合は HttpStatusException がスローされます。このとき HttpStatusException の getStatusCode メソッドを使用することで HTTP エラーを取得できます。

定義:

インタフェース TimeStampClient 内の sendRequest

パラメータ:

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

戻り値:

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

例外:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

sendRequest

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

タイムスタンプ局にタイムスタンプリクエストを送信し、 タイムスタンプトークンを取得します。

定義:

インタフェース TimeStampClient 内の sendRequest

パラメータ:

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

戻り値:

タイムスタンプトークン

例外:

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

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

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

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

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

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

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

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

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

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

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

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

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

導入されたバージョン:

1.10

関連項目:

sendRequest(byte[])

getTimeout

public int getTimeout()

タイムスタンプサーバへ接続後、サーバの応答を待機する最長時間 (ミリ秒) を返します。
HttpTimeStampClient が作成されると、サーバの応答のタイムアウトは 5000 に初期化されます。

戻り値:

タイムスタンプサーバの応答のタイムアウト (ミリ秒)

関連項目:

setTimeout(int)

setTimeout

public void setTimeout(int timeout)

タイムスタンプサーバへ接続後、サーバの応答を待機する最長時間 (ミリ秒) を設定します。
HttpTimeStampClient が作成されると、サーバの応答のタイムアウトは 5000 に初期化されます。

パラメータ:

timeout - タイムスタンプサーバの応答のタイムアウト (ミリ秒)

例外:

java.lang.IllegalArgumentException - 指定したタイムアウトが 0 を含む 0 よりも小さい場合

関連項目:

getTimeout()

getConnectionTimeout

public int getConnectionTimeout()

タイムスタンプサーバへの接続が確立するまでに HttpTimeStampClient が待機する最長時間 (ミリ秒) を返します。
HttpTimeStampClient が作成されると、接続タイムアウトは 5000 に初期化されます。

戻り値:

タイムスタンプサーバの接続タイムアウト (ミリ秒)

関連項目:

setConnectionTimeout(int)

setConnectionTimeout

public void setConnectionTimeout(int connectionTimeout)

タイムスタンプサーバへの接続が確立するまでに HttpTimeStampClient が待機する最長時間 (ミリ秒) を設定します。
HttpTimeStampClient が作成されると、接続タイムアウトは 5000 に初期化されます。

パラメータ:

connectionTimeout - タイムスタンプサーバの接続タイムアウト (ミリ秒)

例外:

java.lang.IllegalArgumentException - 指定したタイムアウトが 0 を含む 0 よりも小さい場合

関連項目:

getConnectionTimeout()