- すべての実装されたインタフェース:
Cloneable
,CRLSelector
public class X509CRLSelector extends Object implements CRLSelector
X509CRLs
を選択するCRLSelector
です。 このクラスは、証明書の取消し状況をチェックするためにCertStore
からCRLを選択するときに、特に役立ちます。
最初に構築されたX509CRLSelector
には有効な基準が含まれていないため、各get
メソッドはデフォルト値(null
)を返します。 したがって、match
メソッドは、X509CRL
に対してtrue
を返します。 通常、X509CRLSelector
は、setIssuers
やsetDateAndTime
を呼び出していくつかの基準を有効にしたあと、CertStore.getCRLs
や類似のメソッドに渡されます。
これから説明するX.509 CRLフィールドと機能拡張の定義については、RFC 5280「Internet X.509 Public Key Infrastructure Certificate and CRL Profile」を参照してください。
並行アクセス
特に断らないかぎり、このクラスで定義されているメソッドはスレッドセーフではありません。 単一のオブジェクトに並行アクセスする必要のある複数スレッドは、スレッド間で同期をとり、必要に応じてロックする必要があります。 複数のスレッドがそれぞれ個別のオブジェクトを処理する場合、それらのスレッドは同期する必要はありません。
- 導入されたバージョン:
- 1.4
- 関連項目:
CRLSelector
,X509CRL
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 X509CRLSelector()
X509CRLSelector
を作成します。 -
メソッドのサマリー
修飾子と型 メソッド 説明 void
addIssuer(X500Principal issuer)
名前をissuerNamesの基準値に追加します。void
addIssuerName(byte[] name)
名前をissuerNamesの基準値に追加します。void
addIssuerName(String name)
バグ: 代わりにaddIssuer(X500Principal)またはaddIssuerName(byte[])を使用してください。Object
clone()
このオブジェクトの複製を返します。X509Certificate
getCertificateChecking()
チェック対象の証明書を返します。Date
getDateAndTime()
dateAndTime基準値を返します。Collection<Object>
getIssuerNames()
issuerNamesの基準値の複製を返します。Collection<X500Principal>
getIssuers()
issuerNamesの基準値を返します。BigInteger
getMaxCRL()
maxCRLNumber基準値を返します。BigInteger
getMinCRL()
minCRLNumber基準値を返します。boolean
match(CRL crl)
CRL
が選択されるかどうかを判断します。void
setCertificateChecking(X509Certificate cert)
チェック対象の証明書を設定します。void
setDateAndTime(Date dateAndTime)
dateAndTime基準値を設定します。void
setIssuerNames(Collection<?> names)
注: 代わりにsetIssuers(Collection)を使用するか、このメソッドを使用する際にバイト配列形式の識別名のみを指定してください。void
setIssuers(Collection<X500Principal> issuers)
issuerNamesの基準値を設定します。void
setMaxCRLNumber(BigInteger maxCRL)
maxCRLNumber基準値を設定します。void
setMinCRLNumber(BigInteger minCRL)
minCRLNumber基準値を設定します。String
toString()
X509CRLSelector
のプリント可能表現を返します。
-
コンストラクタの詳細
-
X509CRLSelector
public X509CRLSelector()X509CRLSelector
を作成します。 最初は条件が設定されていないため、どのX509CRL
でも一致します。
-
-
メソッドの詳細
-
setIssuers
public void setIssuers(Collection<X500Principal> issuers)issuerNamesの基準値を設定します。X509CRL
にある発行者識別名は、指定された識別名の少なくとも1つと一致する必要があります。null
の場合、発行者識別名は問われません。このメソッドを使用すると、呼出し側は、1回のメソッド呼出しで、
X509CRLs
に含まれる発行者名の完全なセットを指定できます。 指定した値でissuerNames基準値の前の値が置き換えられます。names
パラメータがnull
ではない場合は、X500Principal
のCollection
です。names
パラメータには重複した識別名が含まれていることがありますが、それらはgetIssuers
メソッドから返された名前のCollection
から削除できます。以後の変更から保護するために、
Collection
にコピーが行われます。- パラメータ:
issuers
- X500PrincipalsのCollection
(またはnull
)- 導入されたバージョン:
- 1.5
- 関連項目:
getIssuers()
-
setIssuerNames
public void setIssuerNames(Collection<?> names) throws IOException注: 代わりにsetIssuers(Collection)を使用するか、このメソッドを使用する際にバイト配列形式の識別名のみを指定してください。 詳細は、addIssuerName(String)
を参照してください。issuerNamesの基準値を設定します。
X509CRL
にある発行者識別名は、指定された識別名の少なくとも1つと一致する必要があります。null
の場合、発行者識別名は問われません。このメソッドを使用すると、呼出し側は、1回のメソッド呼出しで、
X509CRLs
に含まれる発行者名の完全なセットを指定できます。 指定した値でissuerNames基準値の前の値が置き換えられます。names
パラメータがnull
ではない場合は、名前のCollection
です。 それぞれの名前はString
か、識別名を表すバイト配列(それぞれがRFC 2253またはASN.1 DER符号化形式)です。 この引数の値としてnull
が指定された場合、issuerNamesのチェックは行われません。names
パラメータには重複した識別名が含まれていることがありますが、それらはgetIssuerNames
メソッドから返された名前のCollection
から削除できます。名前がバイト配列で指定された場合、X.501で定義されているDER符号化された単一識別名が含まれる必要があります。 この構造体のASN.1表記は次のようになります。
Name ::= CHOICE { RDNSequence } RDNSequence ::= SEQUENCE OF RelativeDistinguishedName RelativeDistinguishedName ::= SET SIZE (1 .. MAX) OF AttributeTypeAndValue AttributeTypeAndValue ::= SEQUENCE { type AttributeType, value AttributeValue } AttributeType ::= OBJECT IDENTIFIER AttributeValue ::= ANY DEFINED BY AttributeType .... DirectoryString ::= CHOICE { teletexString TeletexString (SIZE (1..MAX)), printableString PrintableString (SIZE (1..MAX)), universalString UniversalString (SIZE (1..MAX)), utf8String UTF8String (SIZE (1.. MAX)), bmpString BMPString (SIZE (1..MAX)) }
以後の変更から保護するために、
Collection
にディープ・コピーが行われます。- パラメータ:
names
- 名前のCollection
。またはnull
- 例外:
IOException
- 構文解析エラーが発生した場合- 関連項目:
getIssuerNames()
-
addIssuer
public void addIssuer(X500Principal issuer)名前をissuerNamesの基準値に追加します。X509CRL
にある発行者識別名は、指定された識別名の少なくとも1つと一致する必要があります。このメソッドでは、呼出し側が名前を
X509CRLs
に含まれる発行者名のセットに追加できます。 指定した名前は、issuerNames基準で先に存在する値に追加されます。 指定した名前が重複する場合は無視されます。- パラメータ:
issuer
- X500Principalとしての発行者- 導入されたバージョン:
- 1.5
-
addIssuerName
public void addIssuerName(String name) throws IOExceptionバグ: 代わりにaddIssuer(X500Principal)またはaddIssuerName(byte[])を使用してください。 このメソッドの実行結果を信用しないでください。RFC 2253文字列形式で記述された一部の識別名では、符号化情報の損失により、CRLの一致処理に失敗する可能性があるからです。名前をissuerNamesの基準値に追加します。
X509CRL
にある発行者識別名は、指定された識別名の少なくとも1つと一致する必要があります。このメソッドでは、呼出し側が名前を
X509CRLs
に含まれる発行者名のセットに追加できます。 指定した名前は、issuerNames基準で先に存在する値に追加されます。 指定した名前が重複する場合は無視されます。- パラメータ:
name
- RFC 2253形式の名前- 例外:
IOException
- 構文解析エラーが発生した場合
-
addIssuerName
public void addIssuerName(byte[] name) throws IOException名前をissuerNamesの基準値に追加します。X509CRL
にある発行者識別名は、指定された識別名の少なくとも1つと一致する必要があります。このメソッドでは、呼出し側が名前を
X509CRLs
に含まれる発行者名のセットに追加できます。 指定した名前は、issuerNames基準で先に存在する値に追加されます。 指定した名前が重複する場合は無視されます。 名前がバイト配列で指定された場合、X.501で定義されているDER符号化された単一識別名が含まれる必要があります。 この構造体のASN.1表記は次のようになります。名前はバイト配列で指定されます。 このバイト配列には、X.501で定義されているDER符号化された単一識別名が含まれる必要があります。 この構造体のASN.1表記は、
setIssuerNames(Collection names)
で説明しています。以後の変更から保護するために、ここで提供されるバイト配列は複製されています。
- パラメータ:
name
- ASN.1 DER符号化形式による名前を含むバイト配列- 例外:
IOException
- 構文解析エラーが発生した場合
-
setMinCRLNumber
public void setMinCRLNumber(BigInteger minCRL)minCRLNumber基準値を設定します。X509CRL
では、CRL数拡張機能がなければいけません。CRL数拡張機能の値は指定した値以上になります。null
の場合、minCRLNumberのチェックは行われません。- パラメータ:
minCRL
- 許容される最小CRL数。またはnull
-
setMaxCRLNumber
public void setMaxCRLNumber(BigInteger maxCRL)maxCRLNumber基準値を設定します。X509CRL
では、CRL数拡張機能がなければいけません。CRL数拡張機能の値は指定した値以下になります。null
が指定された場合、maxCRLNumberのチェックは行われません。- パラメータ:
maxCRL
- 許容される最大CRL数。またはnull
-
setDateAndTime
public void setDateAndTime(Date dateAndTime)dateAndTime基準値を設定します。 指定した日付は、X509CRL
のthisUpdateコンポーネントの値以降で、かつnextUpdateコンポーネントの値以前でなければいけません。X509CRL
にnextUpdateコンポーネントが含まれていない場合は、一致する日付はありません。null
の場合、dateAndTimeのチェックは行われません。以後の変更から保護するために、ここで提供される
Date
は複製されています。- パラメータ:
dateAndTime
- 一致させるDate
。またはnull
- 関連項目:
getDateAndTime()
-
setCertificateChecking
public void setCertificateChecking(X509Certificate cert)チェック対象の証明書を設定します。 これは、条件ではありません。 特定の証明書の失効をチェックする際に、CertStore
が関連するCRLを検索するのに役立つオプション情報です。null
が指定された場合、このようなオプション情報は提供されません。- パラメータ:
cert
- チェック対象のX509Certificate
。またはnull
- 関連項目:
getCertificateChecking()
-
getIssuers
public Collection<X500Principal> getIssuers()issuerNamesの基準値を返します。X509CRL
にある発行者識別名は、指定された識別名の少なくとも1つと一致する必要があります。 返された値がnull
の場合は、発行者識別名は問われません。戻り値が
null
でない場合、その戻り値は、X500Principal
の変更不可能なCollection
です。- 戻り値:
- 名前の変更不可能な
Collection
。またはnull
- 導入されたバージョン:
- 1.5
- 関連項目:
setIssuers(java.util.Collection<javax.security.auth.x500.X500Principal>)
-
getIssuerNames
public Collection<Object> getIssuerNames()issuerNamesの基準値の複製を返します。X509CRL
にある発行者識別名は、指定された識別名の少なくとも1つと一致する必要があります。 返された値がnull
の場合は、発行者識別名は問われません。返された値が
null
ではない場合は、名前のCollection
になります。 それぞれの名前はString
か、識別名を表すバイト配列(それぞれがRFC 2253またはASN.1 DER符号化形式)です。 返されるCollection
には、重複する名前が含まれていることがあります。名前がバイト配列で指定された場合、X.501で定義されているDER符号化された単一識別名が含まれる必要があります。 この構造体のASN.1表記については、
setIssuerNames(Collection names)
のドキュメントを参照してください。以後の変更から保護するために、
Collection
にディープ・コピーが行われます。- 戻り値:
- 名前の
Collection
。またはnull
- 関連項目:
setIssuerNames(java.util.Collection<?>)
-
getMinCRL
public BigInteger getMinCRL()minCRLNumber基準値を返します。X509CRL
では、CRL数拡張機能がなければいけません。CRL数拡張機能の値は指定した値以上になります。null
の場合、minCRLNumberのチェックは行われません。- 戻り値:
- 許容される最小CRL数。または
null
-
getMaxCRL
public BigInteger getMaxCRL()maxCRLNumber基準値を返します。X509CRL
では、CRL数拡張機能がなければいけません。CRL数拡張機能の値は指定した値以下になります。null
が指定された場合、maxCRLNumberのチェックは行われません。- 戻り値:
- 許容される最大CRL数。または
null
-
getDateAndTime
public Date getDateAndTime()dateAndTime基準値を返します。 指定した日付は、X509CRL
のthisUpdateコンポーネントの値以降で、かつnextUpdateコンポーネントの値以前でなければいけません。X509CRL
にnextUpdateコンポーネントが含まれていない場合は、一致する日付はありません。null
の場合、dateAndTimeのチェックは行われません。以後の変更から保護するために、返される
Date
は複製されています。- 戻り値:
- 一致させる
Date
。またはnull
- 関連項目:
setDateAndTime(java.util.Date)
-
getCertificateChecking
public X509Certificate getCertificateChecking()チェック対象の証明書を返します。 これは、条件ではありません。 特定の証明書の失効をチェックする際に、CertStore
が関連するCRLを検索するのに役立つオプション情報です。 返された値がnull
の場合、そのような追加情報は提供されません。- 戻り値:
- チェック対象の証明書。または
null
- 関連項目:
setCertificateChecking(java.security.cert.X509Certificate)
-
toString
public String toString()X509CRLSelector
のプリント可能表現を返します。 -
match
public boolean match(CRL crl)CRL
が選択されるかどうかを判断します。- 定義:
match
、インタフェース:CRLSelector
- パラメータ:
crl
- チェック対象のCRL
- 戻り値:
CRL
が選択される場合はtrue
、そうでない場合はfalse
-
clone
public Object clone()このオブジェクトの複製を返します。- 定義:
clone
、インタフェース:CRLSelector
- オーバーライド:
clone
、クラス:Object
- 戻り値:
- コピー
- 関連項目:
Cloneable
-