com.webify.fabric.engine.extension
Interface ContextBuilder


public interface ContextBuilder

Populates the object representation of the invocation context based on message headers, explicit SOAP headers and custom message content.

Version:
$Id: $
Author:
dranatunga

Method Summary
 void buildContext(XmlElement element, SessionAccess session)
          Invoked whenever a request's SOAP header contained an element with the QName returned by getTriggerElementInHeader().
 javax.xml.namespace.QName getTriggerElementInHeader()
           
 

Method Detail

getTriggerElementInHeader

javax.xml.namespace.QName getTriggerElementInHeader()
Returns:
QName of the element that indicates this context builder should be invoked; a null indicating that this builder should be invoked for every request.

buildContext

void buildContext(XmlElement element,
                  SessionAccess session)
                  throws ContextException
Invoked whenever a request's SOAP header contained an element with the QName returned by getTriggerElementInHeader().

Parameters:
element - the element that triggered this callback. Null if this builder indicated a null as its trigger QName.
session - object that allows this plugin to modify the current request's context.
Throws:
ContextException - if the element contained data that makes this request invalid/unsupportable. Of particular interest are the exceptions InvalidContextException and SecurityContextException.
See Also:
SessionAccess.setContextIdentifier(String), SessionAccess.setKeyedProperty(String, Object), SessionAccess.setStoredProperty(Object, Object), SessionAccess.setTransientProperty(Object, Object), InvalidContextException, SecurityContextException


Copyright © 2002-2009 IBM. All Rights Reserved.