This package provides Advisor infrastructure classes and interfaces.
The classes and interfaces in this package enable developers to develop custom advislets
and register them in the advislet-registry.xml.
The custom advislets can be invoked by constructing an advice request
and passing it to the Advisor, an advice will be returned as a result of processing the advice request.
The errors if any occurred during the processing of an AdviceRequest will be stored in the advice
and the advice will be marked as incomplete to indicate there were errors.
There is only one advisor that is an EJB and called EjbAdvisor that should be used to get an advice. The
advisor will invoke one or more advislets to construct the advice for the advice request.
The advislets chain (that is two or more advislets linked together to form a compound advislet)
could be formed and registered as a compound advislet in the advislet-registry. The package also contains
classes to transform output of one advislet into the input of another advislet in the advislets chain.
The following steps can be followed to develop and use custom advislet.
- Develop the custom advislet
- Register it in the advislet-registry by giving the custom advislet a key.
- Construct an AdviseRequest by specifying the key of the custom advislet and other required parameters.
- Pass the AdviceRequest to the EjbAdvisor, advisor will process the request and return an advice object.
- Inspect the returned advice for its completeness, if it is complete then get the stored results from the advice.
@see com.bea.p13n.advisor.Advislet
@see com.bea.p13n.advisor.AdviceRequest
@see com.bea.p13n.advisor.Advisor
@see com.bea.p13n.advisor.EjbAdvisor
@see com.bea.p13n.advisor.Advice