Module cl.netswitch.lib

Package cl.netswitch.lib.channel

package cl.netswitch.lib.channel

Classes and interfaces to build external components that operate inside the NetSwitch server. These external components are specified in the configuration file of the switch. They are dynamically loaded, and then invoked when specific server events occur.

The NetSwitch server has two types of devices: Connectors and Listeners. A Connector (or client) connects to a remote listener, and can have only one bidirectional communication channel (or socket). A Listener (or server) waits for connections from remote clients, and can have several bidirectional communication channels, one for each client.

A ChannelFilter is an external component. Each time a Connector or Listener channel is created, a new instance of a ChannelFilter is initialized and bound to the channel. From that point on, every inbound or outbound Message is passed to the ChannelFilter for inspection and possible modification. Finally, when the channel is closed, the ChannelFilter instance is terminated and released.

A ChannelCodec is another type of external component. Each time a Connector or Listener channel receives input bytes, it calls the ChannelCodec to decode the bytes and produce an inbound Message. Also, each time a channel writes a Message, it calls the ChannelCodec to encode the message into an outbound sequence of bytes.

See Also:

• ChannelCodec
• ChannelFilter
• Message

Class	Description
ChannelCodec	Encodes and decodes messages sent through a communication channel.
ChannelDecoder	Decodes a Message from an inbound ByteBuffer.
ChannelEncoder	Encodes an outbound Message into a ByteBuffer.
ChannelFilter	Inspects or modifies inbound and outbound Messages of a communication channel.
CodecContext	Allows a ChannelCodec to communicate with its container.
CodecException	Signals that a encoder/decoder error of some kind has occurred.
FilterContext	Allows a ChannelFilter to communicate with its container.
FilterException	Signals that a filter error of some kind has occurred.