|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
An optional interface, normally implemented by a Container, that indicates
support for a pipeline of Valves is present. When pipeline support
is present, the Container's invoke()
method will call the
invoke()
method of the first added Valve, which will either
generate the response or pass the request on to the next Valve in the
pipeline.
The Container must ensure that at least one Valve in the pipeline actually generates the response and returns. Typically, this is accomplished by configuring the Container's normal processing (in the absence of any other Valves) as a Valve that always appears last in the pipeline.
Method Summary | |
void |
addValve(Valve valve)
Add a new Valve to the end of the pipeline associated with this Container. |
Valve |
findValves()
Return the first Valve in the pipeline associated with this Container. |
void |
removeValve(Valve valve)
Remove the specified Valve from the pipeline associated with this Container, if it is found; otherwise, do nothing. |
Method Detail |
public void addValve(Valve valve)
setContainer
method must be called, with this Container
as an argument. The method may throw an
IllegalArgumentException
if this Valve chooses not to
be associated with this Container, or IllegalStateException
if it is already associated with a different Container.valve
- Valve to be addedjava.lang.IllegalArgumentException
- if this Container refused to
accept the specified Valvejava.lang.IllegalArgumentException
- if the specifie Valve refuses to be
associated with this ContainerIllegalStateException
- if the specified Valve is already
associated with a different Containerpublic Valve findValves()
null
is returned.public void removeValve(Valve valve)
valve
- Valve to be removed
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |