|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.jgroups.stack.Protocol
org.jgroups.protocols.TP
org.jgroups.protocols.TUNNEL
public class TUNNEL
Replacement for UDP. Instead of sending packets via UDP, a TCP connection is
opened to a Router (using the RouterStub client-side stub), the IP
address/port of which was given using channel properties
router_host
and router_port
. All outgoing
traffic is sent via this TCP socket to the Router which distributes it to all
connected TUNNELs in this group. Incoming traffic received from Router will
simply be passed up the stack.
A TUNNEL layer can be used to penetrate a firewall, most firewalls allow creating TCP connections to the outside world, however, they do not permit outside hosts to initiate a TCP connection to a host inside the firewall. Therefore, the connection created by the inside host is reused by Router to send traffic from an outside host to a host inside the firewall.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.jgroups.protocols.TP |
---|
TP.ProbeHandler, TP.ProtocolAdapter |
Field Summary |
---|
Fields inherited from class org.jgroups.protocols.TP |
---|
bind_addr, channel_name, discard_incompatible_packets, global_thread_factory, local_addr, members, persistent_ports, persistent_ports_file, pm, pm_expiry_time, thread_naming_pattern, timer, timer_thread_factory, view |
Fields inherited from class org.jgroups.stack.Protocol |
---|
down_prot, log, props, stack, stats, up_prot |
Constructor Summary | |
---|---|
TUNNEL()
|
Method Summary | |
---|---|
java.lang.String |
getInfo()
|
java.lang.String |
getName()
|
long |
getReconnectInterval()
|
java.lang.String |
getRouterHost()
|
int |
getRouterPort()
|
java.lang.Object |
handleDownEvent(Event evt)
|
void |
init()
Called after instance has been created (null constructor) and before protocol is started. |
void |
postUnmarshalling(Message msg,
Address dest,
Address src,
boolean multicast)
|
void |
postUnmarshallingList(Message msg,
Address dest,
boolean multicast)
|
void |
sendToAllMembers(byte[] data,
int offset,
int length)
Send to all members in the group. |
void |
sendToSingleMember(Address dest,
byte[] data,
int offset,
int length)
Send to all members in the group. |
boolean |
setProperties(java.util.Properties props)
Setup the Protocol instance acording to the configuration string |
void |
setReconnectInterval(long reconnect_interval)
|
void |
setRouterHost(java.lang.String router_host)
|
void |
setRouterPort(int router_port)
|
void |
start()
Creates the unicast and multicast sockets and starts the unicast and multicast receiver threads |
void |
stop()
This method is called on a Channel.disconnect() . |
java.lang.String |
toString()
debug only |
Methods inherited from class org.jgroups.stack.Protocol |
---|
downThreadEnabled, enableStats, getDownProtocol, getProperties, getProtocolStack, getTransport, getUpProtocol, printStats, providedDownServices, providedUpServices, requiredDownServices, requiredUpServices, setDownProtocol, setPropertiesInternal, setProtocolStack, setUpProtocol, statsEnabled, upThreadEnabled |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public TUNNEL()
Method Detail |
---|
public java.lang.String toString()
TP
toString
in class TP
public java.lang.String getRouterHost()
public void setRouterHost(java.lang.String router_host)
public int getRouterPort()
public void setRouterPort(int router_port)
public long getReconnectInterval()
public void setReconnectInterval(long reconnect_interval)
public java.lang.String getName()
getName
in class Protocol
public void init() throws java.lang.Exception
Protocol
init
in class TP
java.lang.Exception
- Thrown if protocol cannot be initialized successfully. This will cause the
ProtocolStack to fail, so the channel constructor will throw an exceptionpublic void start() throws java.lang.Exception
TP
start
in class TP
java.lang.Exception
- Thrown if protocol cannot be started successfully. This will cause the ProtocolStack
to fail, so Channel.connect(String)
will throw an exceptionpublic void stop()
Protocol
Channel.disconnect()
. Stops work (e.g. by closing multicast socket).
Will be called from top to bottom. This means that at the time of the method invocation the
neighbor protocol below is still working. This method will replace the
STOP, STOP_OK, CLEANUP and CLEANUP_OK events. The ProtocolStack guarantees that
when this method is called all messages in the down queue will have been flushed
stop
in class TP
public boolean setProperties(java.util.Properties props)
setProperties
in class TP
public java.lang.Object handleDownEvent(Event evt)
handleDownEvent
in class TP
public void sendToAllMembers(byte[] data, int offset, int length) throws java.lang.Exception
TP
sendToAllMembers
in class TP
data
- The data to be sent. This is not a copy, so don't modify it
java.lang.Exception
public void sendToSingleMember(Address dest, byte[] data, int offset, int length) throws java.lang.Exception
TP
sendToSingleMember
in class TP
dest
- Must be a non-null unicast addressdata
- The data to be sent. This is not a copy, so don't modify it
java.lang.Exception
public java.lang.String getInfo()
getInfo
in class TP
public void postUnmarshalling(Message msg, Address dest, Address src, boolean multicast)
postUnmarshalling
in class TP
public void postUnmarshallingList(Message msg, Address dest, boolean multicast)
postUnmarshallingList
in class TP
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |