com.sun.multicast.reliable.channel
Interface DynamicFilter

All Superinterfaces:
RMPacketSocket

public interface DynamicFilter
extends RMPacketSocket

An object that filters or otherwise transforms data on a packet-based channel. In general, a dynamic filter stands before an RMPacketSocket and transforms data as it passes through.

Dynamic filters may be used for many purposes. For instance, they may compress or decompress data, encrypt or decrypt it, or filter it based on access rights or other criteria. They are installed at the receiver by using channel's setDynamicFilter method. Since sometimes a filter may need be distributed to the receivers from a central location, such as at the Channel Manager, dynamic filters should implement Serializable so for example it can be easily stored in a file.

See Also:
Channel, ChannelManager

Method Summary
 RMPacketSocket getLowerSocket()
          Gets the lower level RMPacketSocket.
 void setLowerSocket(RMPacketSocket lower)
          Sets the lower level RMPacketSocket.
 
Methods inherited from interface com.sun.multicast.reliable.transport.RMPacketSocket
abort, close, getInterface, getMaxLength, getRMStatistics, getTransportProfile, receive, send, setInterface
 

Method Detail

getLowerSocket

public RMPacketSocket getLowerSocket()
Gets the lower level RMPacketSocket. This is the socket to which the DynamicFilter sends data after transformation and from which it gets data before transformation. This socket may or may not be a DynamicFilter.
Returns:
the lower socket (null if none)

setLowerSocket

public void setLowerSocket(RMPacketSocket lower)
                    throws UnsupportedException
Sets the lower level RMPacketSocket. This is the socket to which the DynamicFilter sends data after transformation and from which it gets data before transformation. This socket may or may not be a DynamicFilter.
Parameters:
lower - the lower socket (null if none)
Throws:
UnsupportedException - if the lower socket cannot be set


JavaTM Reliable MulticastTM Service version 1.1
Copyright (c) 2001, Sun Microsystems Laboratories, All rights reserved.