javax.xml.crypto
Interface XMLCryptoContext

All Known Subinterfaces:

XMLSignContext, XMLValidateContext

All Known Implementing Classes:

DOMSignContext, DOMValidateContext

public interface XMLCryptoContext

Contains common context information for XML cryptographic operations.

This interface contains methods for setting and retrieving properties that affect the processing of XML signatures or XML encrypted structures.

Note that XMLCryptoContext instances can contain information and state specific to the XML cryptographic structure it is used with. The results are unpredictable if an XMLCryptoContext is used with multiple structures (for example, you should not use the same XMLValidateContext instance to validate two different XMLSignature objects).

Method Summary

java.lang.Object	get(java.lang.Object key) Returns the value to which this context maps the specified key.
java.lang.String	getBaseURI() Returns the base URI.
KeySelector	getKeySelector() Returns the key selector for finding a key.
java.lang.Object	getProperty(java.lang.String name) Returns the value of the specified property.
URIDereferencer	getURIDereferencer() Returns a URIDereferencer that is used to dereference URIReferences.
java.lang.Object	put(java.lang.Object key, java.lang.Object value) Associates the specified value with the specified key in this context.
void	setBaseURI(java.lang.String baseURI) Sets the base URI.
void	setKeySelector(KeySelector ks) Sets the key selector for finding a key.
java.lang.Object	setProperty(java.lang.String name, java.lang.Object value) Sets the specified property.
void	setURIDereferencer(URIDereferencer dereferencer) Sets a URIDereferencer that is used to dereference URIReferences.

Method Detail

getBaseURI

public java.lang.String getBaseURI()

Returns the base URI.

Returns:

the base URI, or null if not specified

See Also:

setBaseURI(String)

setBaseURI

public void setBaseURI(java.lang.String baseURI)

Sets the base URI.

Parameters:

baseURI - the base URI, or null to remove current value

Throws:

java.lang.IllegalArgumentException - if baseURI is not RFC 2396 compliant

See Also:

getBaseURI()

getKeySelector

public KeySelector getKeySelector()

Returns the key selector for finding a key.

Returns:

the key selector, or null if not specified

See Also:

setKeySelector(KeySelector)

setKeySelector

public void setKeySelector(KeySelector ks)

Sets the key selector for finding a key.

Parameters:

ks - the key selector, or null to remove the current setting

See Also:

getKeySelector()

getURIDereferencer

public URIDereferencer getURIDereferencer()

Returns a URIDereferencer that is used to dereference URIReferences.

Returns:

the URIDereferencer, or null if not specified

See Also:

setURIDereferencer(URIDereferencer)

setURIDereferencer

public void setURIDereferencer(URIDereferencer dereferencer)

Sets a URIDereferencer that is used to dereference URIReferences. The specified URIDereferencer is used in place of an implementation's default URIDereferencer.

Parameters:

dereferencer - the URIDereferencer, or null to remove any current setting

See Also:

getURIDereferencer()

setProperty

public java.lang.Object setProperty(java.lang.String name,
                                    java.lang.Object value)

Sets the specified property.

Parameters:

name - the name of the property

value - the value of the property to be set

Returns:

the previous value of the specified property, or null if it did not have a value

Throws:

java.lang.NullPointerException - if name is null

See Also:

getProperty(String)

getProperty

public java.lang.Object getProperty(java.lang.String name)

Returns the value of the specified property.

Parameters:

name - the name of the property

Returns:

the current value of the specified property, or null if it does not have a value

Throws:

java.lang.NullPointerException - if name is null

See Also:

setProperty(String, Object)

get

public java.lang.Object get(java.lang.Object key)

Returns the value to which this context maps the specified key.

More formally, if this context contains a mapping from a key k to a value v such that (key==null ? k==null : key.equals(k)), then this method returns v; otherwise it returns null. (There can be at most one such mapping.)

This method is useful for retrieving arbitrary information that is specific to the cryptographic operation that this context is used for.

Parameters:

key - the key whose associated value is to be returned

Returns:

the value to which this context maps the specified key, or null if there is no mapping for the key

See Also:

put(Object, Object)

put

public java.lang.Object put(java.lang.Object key,
                            java.lang.Object value)

Associates the specified value with the specified key in this context. If the context previously contained a mapping for this key, the old value is replaced by the specified value.

This method is useful for storing arbitrary information that is specific to the cryptographic operation that this context is used for.

Parameters:

key - key with which the specified value is to be associated with

value - value to be associated with the specified key

Returns:

the previous value associated with the key, or null if there was no mapping for the key

Throws:

java.lang.IllegalArgumentException - if some aspect of this key or value prevents it from being stored in this context

See Also:

get(Object)