public interface XMLCryptoContext
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).
| Modifier and Type | Method and Description |
|---|---|
Object |
get(Object
Returns the value to which this context maps the specified key.
|
String |
getBaseURI()
Returns the base URI.
|
String |
getDefaultNamespacePrefix()
Returns the default namespace prefix.
|
KeySelector |
getKeySelector()
Returns the key selector for finding a key.
|
String |
getNamespacePrefix(String
Returns the namespace prefix that the specified namespace URI is associated with.
|
Object |
getProperty(String
Returns the value of the specified property.
|
URIDereferencer |
getURIDereferencer()
Returns a
URIDereferencer that is used to dereference
URIReferences.
|
Object |
put(Object
Associates the specified value with the specified key in this context.
|
String |
putNamespacePrefix(String
Maps the specified namespace URI to the specified prefix.
|
void |
setBaseURI(String
Sets the base URI.
|
void |
setDefaultNamespacePrefix(String
Sets the default namespace prefix.
|
void |
setKeySelector(KeySelector
Sets the key selector for finding a key.
|
Object |
setProperty(String
Sets the specified property.
|
void |
setURIDereferencer(URIDereferencer
Sets a
URIDereferencer that is used to dereference
URIReferences.
|
StringgetBaseURI()
null if not specified
setBaseURI(String)
void setBaseURI(StringbaseURI)
baseURI - the base URI, or
null to remove current value
IllegalArgumentException - if
baseURI is not RFC 2396 compliant
getBaseURI()
KeySelectorgetKeySelector()
null if not specified
setKeySelector(KeySelector)
void setKeySelector(KeySelectorks)
ks - the key selector, or
null to remove the current setting
getKeySelector()
URIDereferencergetURIDereferencer()
URIDereferencer that is used to dereference
URIReferences.
URIDereferencer, or
null if not specified
setURIDereferencer(URIDereferencer)
void setURIDereferencer(URIDereferencerdereferencer)
URIDereferencer that is used to dereference
URIReferences. The specified
URIDereferencer is used in place of an implementation's default
URIDereferencer.
dereferencer - the
URIDereferencer, or
null to remove any current setting
getURIDereferencer()
StringgetNamespacePrefix(String namespaceURI, String defaultPrefix)
putNamespacePrefix method.
namespaceURI - a namespace URI
defaultPrefix - the prefix to be returned in the event that the the specified namespace URI has not been bound to a prefix.
defaultPrefix if the URI is not registered. If the namespace URI is registered but has no prefix, an empty string (
"") is returned.
NullPointerException - if
namespaceURI is
null
putNamespacePrefix(String, String)
StringputNamespacePrefix(String namespaceURI, String prefix)
namespaceURI - a namespace URI
prefix - a namespace prefix (or
null to remove any existing mapping). Specifying the empty string (
"") binds no prefix to the namespace URI.
null if there was none
NullPointerException - if
namespaceURI is
null
getNamespacePrefix(String, String)
StringgetDefaultNamespacePrefix()
putNamespacePrefix method.
null if none has been set.
setDefaultNamespacePrefix(String)
void setDefaultNamespacePrefix(StringdefaultPrefix)
putNamespacePrefix method.
defaultPrefix - the default namespace prefix, or
null to remove the current setting. Specify the empty string (
"") to bind no prefix.
getDefaultNamespacePrefix()
ObjectsetProperty(String name, Object value)
name - the name of the property
value - the value of the property to be set
null if it did not have a value
NullPointerException - if
name is
null
getProperty(String)
ObjectgetProperty(String name)
name - the name of the property
null if it does not have a value
NullPointerException - if
name is
null
setProperty(String, Object)
Objectget(Object 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.
key - the key whose associated value is to be returned
null if there is no mapping for the key
put(Object, Object)
Objectput(Object key, Object value)
This method is useful for storing arbitrary information that is specific to the cryptographic operation that this context is used for.
key - key with which the specified value is to be associated with
value - value to be associated with the specified key
null if there was no mapping for the key
IllegalArgumentException - if some aspect of this key or value prevents it from being stored in this context
get(Object)