org.apache.ws.security.message
Interface CallbackLookup

All Known Implementing Classes:

DOMCallbackLookup

public interface CallbackLookup

This interface defines a pluggable way of locating Elements that are referenced via an Id.

Method Summary

Element	getElement(String id, String valueType, boolean checkMultipleElements) Get the DOM element that corresponds to the given id and ValueType reference.
List<Element>	getElements(String localname, String namespace) Get the DOM element(s) that correspond to the given localname/namespace.

Method Detail

getElement

Element getElement(String id,
                   String valueType,
                   boolean checkMultipleElements)
                   throws WSSecurityException

Get the DOM element that corresponds to the given id and ValueType reference. The Id can be a wsu:Id or else an Id attribute, or a SAML Id when the ValueType refers to a SAML Assertion.

Parameters:

id - The id of the element to locate

valueType - The ValueType attribute of the element to locate (can be null)

checkMultipleElements - If true then go through the entire tree and return null if there are multiple elements with the same Id

Returns:

the located element

Throws:

WSSecurityException

getElements

List<Element> getElements(String localname,
                          String namespace)
                          throws WSSecurityException

Get the DOM element(s) that correspond to the given localname/namespace.

Parameters:

localname - The localname of the Element(s)

namespace - The namespace of the Element(s)

Returns:

the located element(s)

Throws:

WSSecurityException