Skip navigation links
Vordel SDK

Package com.vordel.circuit

This package models a com.vordel.circuit.Circuit and its constituent filters.

See: Description

Package com.vordel.circuit Description

This package models a com.vordel.circuit.Circuit and its constituent filters.

Each implementation of a filter defines a subclass of Filter to encapsulate information common to all uses of that Filter. When it appears in a Circuit, a Filter is wrapped with a com.vordel.circuit.FilterContainer. The FilterContainer used to wrap a specific Filter is decided whent the Circuit is "configure()"d by a factory object.

This allows a server to provide FilterContainers that subclass MessageProcessor, to provide the server-side functionality of the server, while a GUI can hang more user-centric information from a separate subclass of Filter.

Filter itself contains two factory methods for creating the two types of FilterContainers commonly used by Vordel's Server and Management Console

Within the server, requests are handled by passing a Message object to a Circuit consisting of MessageProcessors. Thus invoked, the MessageProcessor performs some inspection or modification of that Message object before returning a boolean value, or throwing an exception. The return value is used to decide on the direction to follow for the next MessageProcessor to be invoked.

The Message object represents the state of the request as its passes through the circuit, and consists of a mapping from property names to values. A property name is a string, and its associated value may be of any compound Java type, but any particular property should always have a well-known type.

The Message is populated with a set of properties by the invoker of the circuit (eg, the VordelSecure HTTP gateway). As the message passes from one filter to the other, properties may be added, removed, or modified.

Upon completion, the invoker may analyse the resultant set of properties (and return value of the circuit), to decide on a response to pass to the original client.

Skip navigation links
Vordel SDK


This documentation and all its contents and graphics, copyright © 1999 - 2011 Vordel