XMLSignature
オブジェクトを作成するため、または対応するXML表現からXMLSignature
オブジェクトを非整列化するためのファクトリ。
XMLSignatureFactory型
XMLSignatureFactory
の各インスタンスは、特定のXMLメカニズム型をサポートします。 XMLSignatureFactory
を作成するには、static getInstance
メソッドの1つを呼び出し、目的のXMLメカニズム型を渡します。たとえば:
XMLSignatureFactory factory = XMLSignatureFactory.getInstance("DOM");
このファクトリが生成するオブジェクトは、「DOMのメカニズム要件」で定義されているDOM相互運用性の要件に基づいて作成されます。 標準メカニズムのタイプのリストは、「Javaセキュリティ標準アルゴリズム名仕様」のXMLSignatureFactory
のセクションを参照してください。
XMLSignatureFactory
実装は、Provider
メカニズムを使用して登録およびロードされます。 たとえば、DOMメカニズムをサポートするサービス・プロバイダはProvider
サブクラスで次のように指定されます。
put("XMLSignatureFactory.DOM", "org.example.DOMXMLSignatureFactory");
実装は、デフォルトのメカニズム・タイプDOMを最低限サポートする必要があります。
呼出し側は同じXMLSignatureFactory
インスタンスを使用して、生成される特定のXMLSignature
のXMLStructure
を作成する必要があります。 異なるプロバイダからのXMLStructure
または異なるメカニズム型がともに使用される場合、動作は定義されていません。
また、このファクトリによって作成されるXMLStructure
には、XMLSignature
に固有で再利用には対応していない状態が格納されます。
ゼロからXMLSignatureを作成する
XMLSignatureFactory
が作成されると、オブジェクトは適切なメソッドを呼び出してインスタンス化できます。 たとえば、Reference
インスタンスは、newReference
メソッドの1つを呼び出すことで作成できます。
XMLからXMLSignatureを非整列化する
または、unmarshalXMLSignature
メソッドを呼び出してXMLコンテンツを格納するメカニズム固有のXMLValidateContext
インスタンスを渡すことによって、既存のXML表現からXMLSignature
を作成できます。
DOMValidateContext context = new DOMValidateContext(key, signatureElement); XMLSignature signature = factory.unmarshalXMLSignature(context);各
XMLSignatureFactory
は、そのファクトリ型用に必須のXMLValidateContext
型をサポートする必要がありますが、その他をサポートすることもできます。 DOM XMLSignatureFactory
は、DOMValidateContext
オブジェクトをサポートする必要があります。
XMLへのXMLSignatureの署名および整列化
ファクトリによって作成される各XMLSignature
は、XMLSignature
オブジェクトのsign
メソッドを呼び出して、署名キーおよび整列化パラメータを格納するメカニズム固有のXMLSignContext
オブジェクトを渡すことによって、XML表現に対して整列化し署名することもできます(DOMSignContext
を参照)。 たとえば、
DOMSignContext context = new DOMSignContext(privateKey, document); signature.sign(context);並行アクセス
このクラスのstaticメソッドは、スレッド・セーフであることが保証されています。 このクラスで定義されているstaticメソッドは、悪影響を与えることなく、複数スレッドが並行して呼び出すことができます。
しかしこのことは、このクラスで定義されている非staticメソッドには当てはまりません。 特定のプロバイダで特に説明がないかぎり、単一のXMLSignatureFactory
インスタンスに並行してアクセスする必要のある複数スレッドは、スレッド間で同期を取り、必要に応じてロックしなければいけません。 異なるXMLSignatureFactory
インスタンスを操作する複数スレッドは、同期化される必要はありません。
- 導入されたバージョン:
- 1.6
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明static XMLSignatureFactory
デフォルトのXML処理メカニズムおよび表現型("DOM")をサポートするXMLSignatureFactory
を返します。static XMLSignatureFactory
getInstance
(String mechanismType) 指定されたXML処理メカニズムおよび表現の型(例: 「DOM」)をサポートするXMLSignatureFactory
を返します。static XMLSignatureFactory
getInstance
(String mechanismType, String provider) 指定したプロバイダが提供する、要求されたXML処理メカニズムおよび表現型(例: 「DOM」)をサポートするXMLSignatureFactory
を返します。static XMLSignatureFactory
getInstance
(String mechanismType, Provider provider) 指定したプロバイダが提供する、要求されたXML処理メカニズムおよび表現型(例: 「DOM」)をサポートするXMLSignatureFactory
を返します。final KeyInfoFactory
KeyInfo
オブジェクトを作成するKeyInfoFactory
を返します。final String
このXMLSignatureFactory
がサポートするXML処理メカニズムおよび表現の型を返します(例: 「DOM」)。final Provider
このXMLSignatureFactory
のプロバイダを返します。abstract URIDereferencer
Reference
オブジェクト内でデフォルトの間接参照URIに使用されるURIDereferencer
への参照を返します。abstract boolean
isFeatureSupported
(String feature) 指定した機能がサポートされるかどうかを示します。abstract CanonicalizationMethod
newCanonicalizationMethod
(String algorithm, C14NMethodParameterSpec params) 指定したアルゴリズムURIおよびパラメータ用にCanonicalizationMethod
を作成します。abstract CanonicalizationMethod
newCanonicalizationMethod
(String algorithm, XMLStructure params) 指定したアルゴリズムURIおよびパラメータ用にCanonicalizationMethod
を作成します。abstract DigestMethod
newDigestMethod
(String algorithm, DigestMethodParameterSpec params) 指定したアルゴリズムURIおよびパラメータ用にDigestMethod
を作成します。abstract Manifest
newManifest
(List<? extends Reference> references) 指定されたReference
のリストを格納するManifest
を作成します。abstract Manifest
newManifest
(List<? extends Reference> references, String id) 指定されたReference
のリストとオプションのIDを格納するManifest
を作成します。abstract Reference
newReference
(String uri, DigestMethod dm) 指定されたURIおよびダイジェスト・メソッドでReference
を作成します。abstract Reference
newReference
(String uri, DigestMethod dm, List<? extends Transform> transforms, String type, String id) 指定したパラメータでReference
を作成します。abstract Reference
newReference
(String uri, DigestMethod dm, List<? extends Transform> transforms, String type, String id, byte[] digestValue) 指定されたパラメータおよびあらかじめ計算されたダイジェスト値でReference
を作成します。abstract Reference
newReference
(String uri, DigestMethod dm, List<? extends Transform> appliedTransforms, Data result, List<? extends Transform> transforms, String type, String id) 指定したパラメータでReference
を作成します。abstract SignatureMethod
newSignatureMethod
(String algorithm, SignatureMethodParameterSpec params) 指定したアルゴリズムURIおよびパラメータ用にSignatureMethod
を作成します。abstract SignatureProperties
newSignatureProperties
(List<? extends SignatureProperty> properties, String id) 指定されたSignatureProperty
のリストとオプションのIDを格納するSignatureProperties
を作成します。abstract SignatureProperty
newSignatureProperty
(List<? extends XMLStructure> content, String target, String id) 指定したXMLStructure
、ターゲットURI、およびオプションのidのリストを格納するSignatureProperty
を作成します。abstract SignedInfo
newSignedInfo
(CanonicalizationMethod cm, SignatureMethod sm, List<? extends Reference> references) 指定した標準化メソッドおよび署名メソッド、1つ以上の参照のリストを使用してSignedInfo
を作成します。abstract SignedInfo
newSignedInfo
(CanonicalizationMethod cm, SignatureMethod sm, List<? extends Reference> references, String id) 指定したパラメータでSignedInfo
を作成します。abstract Transform
newTransform
(String algorithm, TransformParameterSpec params) 指定したアルゴリズムURIおよびパラメータ用にTransform
を作成します。abstract Transform
newTransform
(String algorithm, XMLStructure params) 指定したアルゴリズムURIおよびパラメータ用にTransform
を作成します。abstract XMLObject
newXMLObject
(List<? extends XMLStructure> content, String id, String mimeType, String encoding) 指定したパラメータからXMLObject
を作成します。abstract XMLSignature
newXMLSignature
(SignedInfo si, KeyInfo ki) XMLSignature
を作成し、その内容を指定したSignedInfo
オブジェクトおよびKeyInfo
オブジェクトで初期化します。abstract XMLSignature
newXMLSignature
(SignedInfo si, KeyInfo ki, List<? extends XMLObject> objects, String id, String signatureValueId) 指定したパラメータを使用して、XMLSignature
を作成して初期化します。abstract XMLSignature
unmarshalXMLSignature
(XMLValidateContext context) メカニズム固有のXMLValidateContext
インスタンスからの新しいXMLSignature
インスタンスを非整列化します。abstract XMLSignature
unmarshalXMLSignature
(XMLStructure xmlStructure) メカニズム固有のXMLStructure
インスタンスからの新しいXMLSignature
インスタンスを非整列化します。
-
コンストラクタの詳細
-
XMLSignatureFactory
protected XMLSignatureFactory()デフォルトのコンストラクタ、サブクラスによる呼出し用。
-
-
メソッドの詳細
-
getInstance
public static XMLSignatureFactory getInstance(String mechanismType) 指定されたXML処理メカニズムおよび表現の型(例: 「DOM」)をサポートするXMLSignatureFactory
を返します。このメソッドは標準JCAプロバイダ検索メカニズムを使用して、目的のメカニズム型の
XMLSignatureFactory
実装を検出およびインスタンス化します。 登録済みのセキュリティProvider
のリストを、最優先のProvider
からトラバースします。 指定したメカニズムをサポートする最初のProvider
からの新しいXMLSignatureFactory
オブジェクトが返されます。登録済みプロバイダのリストは、
Security.getProviders()
メソッド経由で取得できます。- 実装上のノート:
- JDKリファレンス実装では、
jdk.security.provider.preferred
Security
プロパティを使用して、指定されたアルゴリズムの優先プロバイダの順序を決定します。 これは、Security.getProviders()
によって返されるプロバイダの順序とは異なる場合があります。 - パラメータ:
mechanismType
- XML処理メカニズムおよび表現の型。 標準メカニズムのタイプのリストは、「Javaセキュリティ標準アルゴリズム名仕様」のXMLSignatureFactory
のセクションを参照してください。- 戻り値:
- 新しい
XMLSignatureFactory
- 例外:
NullPointerException
-mechanismType
がnull
である場合NoSuchMechanismException
- 指定したメカニズムのXMLSignatureFactory
実装をサポートするProvider
が存在しない場合- 関連項目:
-
getInstance
public static XMLSignatureFactory getInstance(String mechanismType, Provider provider) 指定したプロバイダが提供する、要求されたXML処理メカニズムおよび表現型(例: 「DOM」)をサポートするXMLSignatureFactory
を返します。 指定したProvider
オブジェクトは、プロバイダ・リストに登録する必要はありません。- パラメータ:
mechanismType
- XML処理メカニズムおよび表現の型。 標準メカニズムのタイプのリストは、「Javaセキュリティ標準アルゴリズム名仕様」のXMLSignatureFactory
のセクションを参照してください。provider
-Provider
オブジェクト- 戻り値:
- 新しい
XMLSignatureFactory
- 例外:
NullPointerException
-provider
またはmechanismType
がnull
の場合NoSuchMechanismException
- 指定したメカニズム用のXMLSignatureFactory
実装が指定したProvider
オブジェクトで使用できない場合- 関連項目:
-
getInstance
public static XMLSignatureFactory getInstance(String mechanismType, String provider) throws NoSuchProviderException 指定したプロバイダが提供する、要求されたXML処理メカニズムおよび表現型(例: 「DOM」)をサポートするXMLSignatureFactory
を返します。 指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。登録済みプロバイダのリストは、
Security.getProviders()
メソッド経由で取得できます。- パラメータ:
mechanismType
- XML処理メカニズムおよび表現の型。 標準メカニズムのタイプのリストは、「Javaセキュリティ標準アルゴリズム名仕様」のXMLSignatureFactory
のセクションを参照してください。provider
- プロバイダ名の文字列名- 戻り値:
- 新しい
XMLSignatureFactory
- 例外:
NoSuchProviderException
- 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない場合NullPointerException
-provider
またはmechanismType
がnull
の場合NoSuchMechanismException
- 指定したメカニズム用のXMLSignatureFactory
実装が指定したプロバイダで使用できない場合- 関連項目:
-
getInstance
public static XMLSignatureFactory getInstance()デフォルトのXML処理メカニズムおよび表現型("DOM")をサポートするXMLSignatureFactory
を返します。このメソッドは標準JCAプロバイダ検索メカニズムを使用して、デフォルトのメカニズム型の
XMLSignatureFactory
実装を検出およびインスタンス化します。 登録済みのセキュリティProvider
のリストを、最優先のProvider
からトラバースします。 DOMメカニズムをサポートする最初のProvider
からの新しいXMLSignatureFactory
オブジェクトが返されます。登録済みプロバイダのリストは、
Security.getProviders()
メソッド経由で取得できます。- 戻り値:
- 新しい
XMLSignatureFactory
- 例外:
NoSuchMechanismException
- DOMメカニズムのXMLSignatureFactory
実装をサポートするProvider
が存在しない場合- 関連項目:
-
getMechanismType
public final String getMechanismType()このXMLSignatureFactory
がサポートするXML処理メカニズムおよび表現の型を返します(例: 「DOM」)。- 戻り値:
- この
XMLSignatureFactory
がサポートするXML処理メカニズム型
-
getProvider
public final Provider getProvider()このXMLSignatureFactory
のプロバイダを返します。- 戻り値:
- この
XMLSignatureFactory
のプロバイダ
-
newXMLSignature
public abstract XMLSignature newXMLSignature(SignedInfo si, KeyInfo ki) XMLSignature
を作成し、その内容を指定したSignedInfo
オブジェクトおよびKeyInfo
オブジェクトで初期化します。- パラメータ:
si
- 署名情報ki
- キー情報。null
も可- 戻り値:
XMLSignature
- 例外:
NullPointerException
-si
がnull
である場合
-
newXMLSignature
public abstract XMLSignature newXMLSignature(SignedInfo si, KeyInfo ki, List<? extends XMLObject> objects, String id, String signatureValueId) 指定したパラメータを使用して、XMLSignature
を作成して初期化します。- パラメータ:
si
- 署名情報ki
- キー情報。null
も可objects
-XMLObject
のリスト。空またはnull
も可id
- Id。null
も可signatureValueId
- SignatureValue Id。null
も可- 戻り値:
XMLSignature
- 例外:
NullPointerException
-si
がnull
である場合ClassCastException
- どのobjects
もXMLObject
型ではない場合
-
newReference
public abstract Reference newReference(String uri, DigestMethod dm) 指定されたURIおよびダイジェスト・メソッドでReference
を作成します。- パラメータ:
uri
- 参照URI。null
も可dm
- ダイジェスト・メソッド- 戻り値:
Reference
- 例外:
IllegalArgumentException
-uri
がRFC 2396に準拠していない場合NullPointerException
-dm
がnull
である場合
-
newReference
public abstract Reference newReference(String uri, DigestMethod dm, List<? extends Transform> transforms, String type, String id) 指定したパラメータでReference
を作成します。- パラメータ:
uri
- 参照URI。null
も可dm
- ダイジェスト・メソッドtransforms
-Transform
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。null
または空文字列も可。type
- 参照型、URIとして。null
も可id
- 参照ID。null
も可- 戻り値:
Reference
- 例外:
ClassCastException
- どのtransforms
もTransform
型ではない場合IllegalArgumentException
-uri
がRFC 2396に準拠していない場合NullPointerException
-dm
がnull
である場合
-
newReference
public abstract Reference newReference(String uri, DigestMethod dm, List<? extends Transform> transforms, String type, String id, byte[] digestValue) 指定されたパラメータおよびあらかじめ計算されたダイジェスト値でReference
を作成します。このメソッドは、
Reference
のダイジェスト値が以前に計算されていた場合に便利です。 たとえば、OASIS-DSS (Digital Signature Services)仕様を参照してください。- パラメータ:
uri
- 参照URI。null
も可dm
- ダイジェスト・メソッドtransforms
-Transform
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。null
または空文字列も可。type
- 参照型、URIとして。null
も可id
- 参照ID。null
も可digestValue
- ダイジェスト値。 以後の変更から保護するために、この配列は複製される。- 戻り値:
Reference
- 例外:
ClassCastException
- どのtransforms
もTransform
型ではない場合IllegalArgumentException
-uri
がRFC 2396に準拠していない場合NullPointerException
-dm
またはdigestValue
がnull
の場合
-
newReference
public abstract Reference newReference(String uri, DigestMethod dm, List<? extends Transform> appliedTransforms, Data result, List<? extends Transform> transforms, String type, String id) 指定したパラメータでReference
を作成します。このメソッドは、変換のリストがすでに
Reference
に対して適用されている場合に便利です。 たとえば、OASIS-DSS (Digital Signature Services)仕様を参照してください。この参照を含む
XMLSignature
が生成される場合、指定したtransforms
(nullでない場合)は指定したresult
に適用されます。Reference
要素の結果として得られるTransforms
要素は、appliedTransforms
とtransforms
を連結したものに設定されます。- パラメータ:
uri
- 参照URI。null
も可dm
- ダイジェスト・メソッドappliedTransforms
- すでに適用されたTransform
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。 リストには少なくとも1つのエントリが含まれている必要がある。result
-appliedTransforms
のシーケンスを処理した結果transforms
- 署名を生成したときに適用されるTransform
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。null
または空文字列も可。type
- 参照型、URIとして。null
も可id
- 参照ID。null
も可- 戻り値:
Reference
- 例外:
ClassCastException
- (どちらかのリストの)変換がどれもTransform
型ではない場合IllegalArgumentException
-uri
がRFC 2396に準拠していない場合、またはappliedTransforms
が空の場合NullPointerException
-dm
、appliedTransforms
、またはresult
がnull
の場合
-
newSignedInfo
public abstract SignedInfo newSignedInfo(CanonicalizationMethod cm, SignatureMethod sm, List<? extends Reference> references) 指定した標準化メソッドおよび署名メソッド、1つ以上の参照のリストを使用してSignedInfo
を作成します。- パラメータ:
cm
- 標準化メソッドsm
- 署名メソッドreferences
- 1つ以上のReference
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。- 戻り値:
SignedInfo
- 例外:
ClassCastException
- どの参照もReference
型でない場合IllegalArgumentException
-references
が空である場合NullPointerException
- いずれかのパラメータがnull
の場合
-
newSignedInfo
public abstract SignedInfo newSignedInfo(CanonicalizationMethod cm, SignatureMethod sm, List<? extends Reference> references, String id) 指定したパラメータでSignedInfo
を作成します。- パラメータ:
cm
- 標準化メソッドsm
- 署名メソッドreferences
- 1つ以上のReference
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。id
- Id。null
も可- 戻り値:
SignedInfo
- 例外:
ClassCastException
- どの参照もReference
型でない場合IllegalArgumentException
-references
が空である場合NullPointerException
-cm
、sm
、またはreferences
がnull
の場合
-
newXMLObject
public abstract XMLObject newXMLObject(List<? extends XMLStructure> content, String id, String mimeType, String encoding) 指定したパラメータからXMLObject
を作成します。- パラメータ:
content
-XMLStructure
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。null
または空文字列も可。id
- Id。null
も可mimeType
- MIMEタイプ。null
も可encoding
- エンコーディング。null
も可- 戻り値:
XMLObject
- 例外:
ClassCastException
-content
にXMLStructure
型ではないエントリが含まれている場合
-
newManifest
指定されたReference
のリストを格納するManifest
を作成します。- パラメータ:
references
- 1つ以上のReference
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。- 戻り値:
Manifest
- 例外:
NullPointerException
-references
がnull
である場合IllegalArgumentException
-references
が空である場合ClassCastException
-references
にReference
型ではないエントリが含まれている場合
-
newManifest
指定されたReference
のリストとオプションのIDを格納するManifest
を作成します。- パラメータ:
references
- 1つ以上のReference
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。id
- Id。null
も可- 戻り値:
Manifest
- 例外:
NullPointerException
-references
がnull
である場合IllegalArgumentException
-references
が空である場合ClassCastException
-references
にReference
型ではないエントリが含まれている場合
-
newSignatureProperty
public abstract SignatureProperty newSignatureProperty(List<? extends XMLStructure> content, String target, String id) 指定したXMLStructure
、ターゲットURI、およびオプションのidのリストを格納するSignatureProperty
を作成します。- パラメータ:
content
- 1つ以上のXMLStructure
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。target
- このプロパティの適用先のSignatureのターゲットURIid
- Id。null
も可- 戻り値:
SignatureProperty
- 例外:
NullPointerException
-content
またはtarget
がnull
の場合IllegalArgumentException
-content
が空である場合ClassCastException
-content
にXMLStructure
型ではないエントリが含まれている場合
-
newSignatureProperties
public abstract SignatureProperties newSignatureProperties(List<? extends SignatureProperty> properties, String id) 指定されたSignatureProperty
のリストとオプションのIDを格納するSignatureProperties
を作成します。- パラメータ:
properties
- 1つ以上のSignatureProperty
のリスト。 以後の変更から保護するために、このリストは防御的にコピーされる。id
- Id。null
も可- 戻り値:
SignatureProperties
- 例外:
NullPointerException
-properties
がnull
である場合IllegalArgumentException
-properties
が空である場合ClassCastException
-properties
にSignatureProperty
型ではないエントリが含まれている場合
-
newDigestMethod
public abstract DigestMethod newDigestMethod(String algorithm, DigestMethodParameterSpec params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException 指定したアルゴリズムURIおよびパラメータ用にDigestMethod
を作成します。- パラメータ:
algorithm
- ダイジェスト・アルゴリズムを識別するURIparams
- アルゴリズム固有のダイジェスト・パラメータ。null
も可- 戻り値:
DigestMethod
- 例外:
InvalidAlgorithmParameterException
- 指定されたパラメータが、要求されたアルゴリズムには不適切な場合NoSuchAlgorithmException
- 指定されたアルゴリズムの実装が見つからない場合NullPointerException
-algorithm
がnull
である場合
-
newSignatureMethod
public abstract SignatureMethod newSignatureMethod(String algorithm, SignatureMethodParameterSpec params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException 指定したアルゴリズムURIおよびパラメータ用にSignatureMethod
を作成します。- パラメータ:
algorithm
- 署名アルゴリズムを識別するURIparams
- アルゴリズム固有の署名パラメータ。null
も可- 戻り値:
SignatureMethod
- 例外:
InvalidAlgorithmParameterException
- 指定されたパラメータが、要求されたアルゴリズムには不適切な場合NoSuchAlgorithmException
- 指定されたアルゴリズムの実装が見つからない場合NullPointerException
-algorithm
がnull
である場合
-
newTransform
public abstract Transform newTransform(String algorithm, TransformParameterSpec params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException 指定したアルゴリズムURIおよびパラメータ用にTransform
を作成します。- パラメータ:
algorithm
- 変換アルゴリズムを識別するURIparams
- アルゴリズム固有の変換パラメータ。null
も可- 戻り値:
Transform
- 例外:
InvalidAlgorithmParameterException
- 指定されたパラメータが、要求されたアルゴリズムには不適切な場合NoSuchAlgorithmException
- 指定されたアルゴリズムの実装が見つからない場合NullPointerException
-algorithm
がnull
である場合
-
newTransform
public abstract Transform newTransform(String algorithm, XMLStructure params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException 指定したアルゴリズムURIおよびパラメータ用にTransform
を作成します。 パラメータはメカニズム固有のXMLStructure
として指定されます(例:DOMStructure
)。 このメソッドは、パラメータがXML形式でありパラメータ指定のための標準クラスがない場合に便利です。- パラメータ:
algorithm
- 変換アルゴリズムを識別するURIparams
- パラメータの非整列化を開始するメカニズム固有のXML構造。必須ではない場合またはオプションの場合はnull
も可- 戻り値:
Transform
- 例外:
ClassCastException
-params
の型がこのXMLSignatureFactory
には不適切な場合InvalidAlgorithmParameterException
- 指定されたパラメータが、要求されたアルゴリズムには不適切な場合NoSuchAlgorithmException
- 指定されたアルゴリズムの実装が見つからない場合NullPointerException
-algorithm
がnull
である場合
-
newCanonicalizationMethod
public abstract CanonicalizationMethod newCanonicalizationMethod(String algorithm, C14NMethodParameterSpec params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException 指定したアルゴリズムURIおよびパラメータ用にCanonicalizationMethod
を作成します。- パラメータ:
algorithm
- 標準化アルゴリズムを識別するURIparams
- アルゴリズム固有の標準化パラメータ。null
も可- 戻り値:
CanonicalizationMethod
- 例外:
InvalidAlgorithmParameterException
- 指定されたパラメータが、要求されたアルゴリズムには不適切な場合NoSuchAlgorithmException
- 指定されたアルゴリズムの実装が見つからない場合NullPointerException
-algorithm
がnull
である場合
-
newCanonicalizationMethod
public abstract CanonicalizationMethod newCanonicalizationMethod(String algorithm, XMLStructure params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException 指定したアルゴリズムURIおよびパラメータ用にCanonicalizationMethod
を作成します。 パラメータはメカニズム固有のXMLStructure
として指定されます(例:DOMStructure
)。 このメソッドは、パラメータがXML形式でありパラメータ指定のための標準クラスがない場合に便利です。- パラメータ:
algorithm
- 標準化アルゴリズムを識別するURIparams
- パラメータの非整列化を開始するメカニズム固有のXML構造。必須ではない場合またはオプションの場合はnull
も可- 戻り値:
CanonicalizationMethod
- 例外:
ClassCastException
-params
の型がこのXMLSignatureFactory
には不適切な場合InvalidAlgorithmParameterException
- 指定されたパラメータが、要求されたアルゴリズムには不適切な場合NoSuchAlgorithmException
- 指定されたアルゴリズムの実装が見つからない場合NullPointerException
-algorithm
がnull
である場合
-
getKeyInfoFactory
public final KeyInfoFactory getKeyInfoFactory()KeyInfo
オブジェクトを作成するKeyInfoFactory
を返します。 返されたKeyInfoFactory
は、このXMLSignatureFactory
と同じメカニズム型およびプロバイダを持ちます。- 戻り値:
KeyInfoFactory
- 例外:
NoSuchMechanismException
- 同じメカニズム型およびプロバイダを持つKeyFactory
実装が利用可能でない場合
-
unmarshalXMLSignature
public abstract XMLSignature unmarshalXMLSignature(XMLValidateContext context) throws MarshalException メカニズム固有のXMLValidateContext
インスタンスからの新しいXMLSignature
インスタンスを非整列化します。- パラメータ:
context
- 署名の非整列化を開始するメカニズム固有のコンテキスト- 戻り値:
XMLSignature
- 例外:
NullPointerException
-context
がnull
である場合ClassCastException
-context
の型がこのファクトリには不適切な場合MarshalException
- 非整列化の実行中に回復不可能な例外が発生した場合
-
unmarshalXMLSignature
public abstract XMLSignature unmarshalXMLSignature(XMLStructure xmlStructure) throws MarshalException メカニズム固有のXMLStructure
インスタンスからの新しいXMLSignature
インスタンスを非整列化します。 このメソッドは、XMLSignature
を非整列化するだけで検証しない場合に便利です。- パラメータ:
xmlStructure
- 署名の非整列化を開始するメカニズム固有のXML構造- 戻り値:
XMLSignature
- 例外:
NullPointerException
-xmlStructure
がnull
である場合ClassCastException
-xmlStructure
の型がこのファクトリには不適切な場合MarshalException
- 非整列化の実行中に回復不可能な例外が発生した場合
-
isFeatureSupported
public abstract boolean isFeatureSupported(String feature) 指定した機能がサポートされるかどうかを示します。- パラメータ:
feature
- 機能名(絶対URIとして)- 戻り値:
- 指定した機能がサポートされる場合は
true
、そうでない場合はfalse
- 例外:
NullPointerException
-feature
がnull
である場合
-
getURIDereferencer
public abstract URIDereferencer getURIDereferencer()Reference
オブジェクト内でデフォルトの間接参照URIに使用されるURIDereferencer
への参照を返します。- 戻り値:
- デフォルトの
URIDereferencer
への参照。null
になることはない
-