|
IBM WebSphere Application ServerTM Release 8 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Mediation
Defines the contract between mediation primitives and the mediation flow engine.
Any mediation implementation must conform the the JavaBean specification by implementing a default constructor, and getters/setters for all properties. Indexed properties must be implemented using arrays, with the appropriate getters and setters.
A mediation primitive has the following lifecycle:
MediationServices
(including creating the input and output terminals) and set it using the
setMediationServices
method.init
method upon when the mediation
primitive can perform any necessary initialization. The engine will only
call init() once.mediate
method being called.Note that mediation primitives are stateless objects, and the same instance is not guaranteed to be called on subsequent invocations of a flow. Also note that there is no explicit termination of the mediation, and as such, primitives should not maintain long-running resources such as database connections.
In the mediate
method, the mediation primitive may perform
inspection and modification of the message. It may fire output terminals in
any order, and at any time. The same output terminal may be fired multiple
times. It may also throw a
MediationConfigurationException
or a
MediationBusinessException
to represent an error in the mediation processing. The mediation flow engine
will invoke any failure terminal automatically on the throwing of an
exception.
Field Summary | |
---|---|
static java.lang.String |
$sccsid
|
static java.lang.String |
COPYRIGHT
|
Method Summary | |
---|---|
void |
init()
Initialises the mediation. |
void |
mediate(InputTerminal inputTerminal,
commonj.sdo.DataObject message)
Invoked when a message arrives at the specified input terminal of this mediation primitive. |
void |
setMediationServices(MediationServices mediationServices)
Sets the mediation services. |
Field Detail |
---|
static final java.lang.String COPYRIGHT
static final java.lang.String $sccsid
Method Detail |
---|
void setMediationServices(MediationServices mediationServices)
mediationServices
- the mediation services objectvoid init() throws MediationConfigurationException
MediationConfigurationException
- if any configuration problems
occur in the initialization of this mediation primitive.void mediate(InputTerminal inputTerminal, commonj.sdo.DataObject message) throws MediationConfigurationException, MediationBusinessException
inputTerminal
- the input terminal being invokedmessage
- the message to mediate
MediationConfigurationException
- if there is a problem with the
configuration of the mediation primitive
MediationBusinessException
- if there is a problem with the
business logic processing of the mediation primitive
|
IBM WebSphere Application ServerTM Release 8 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |