org.jgroups.protocols.BasicTCP Maven / Gradle / Ivy
Go to download
This artifact provides a single jar that contains all classes required to use remote EJB and JMS, including
all dependencies. It is intended for use by those not using maven, maven users should just import the EJB and
JMS BOM's instead (shaded JAR's cause lots of problems with maven, as it is very easy to inadvertently end up
with different versions on classes on the class path).
The newest version!
package org.jgroups.protocols;
import org.jgroups.Address;
import org.jgroups.Event;
import org.jgroups.Global;
import org.jgroups.PhysicalAddress;
import org.jgroups.annotations.LocalAddress;
import org.jgroups.annotations.Property;
import org.jgroups.blocks.cs.Receiver;
import org.jgroups.conf.AttributeType;
import java.net.InetAddress;
import java.util.Collection;
import java.util.HashSet;
import java.util.Set;
/**
* Shared base class for TCP protocols
* @author Scott Marlow
* @author Bela Ban
*/
public abstract class BasicTCP extends TP implements Receiver {
/* ----------------------------------------- Properties -------------------------------------------------- */
@Property(description="Reaper interval in msec. Default is 0 (no reaping)",type=AttributeType.TIME)
protected long reaper_interval; // time in msecs between connection reaps
@Property(description="Max time connection can be idle before being reaped (in ms)",type=AttributeType.TIME)
protected long conn_expire_time; // max time a conn can be idle before being reaped
@Property(description="Receiver buffer size in bytes",type=AttributeType.BYTES)
protected int recv_buf_size;
@Property(description="Send buffer size in bytes",type=AttributeType.BYTES)
protected int send_buf_size;
@Property(description="Max time allowed for a socket creation in connection table",type=AttributeType.TIME)
protected int sock_conn_timeout=2000; // max time in millis for a socket creation in connection table
@Property(description="Max time to block on reading of peer address",type=AttributeType.TIME)
protected int peer_addr_read_timeout=1000; // max time to block on reading of peer address
@Property(description="The max number of bytes a message can have. If greater, an exception will be " +
"thrown. 0 disables this", type=AttributeType.BYTES)
protected int max_length;
@Property(description="Should TCP no delay flag be turned on")
protected boolean tcp_nodelay=true; // https://issues.redhat.com/browse/JGRP-2781
@Property(description="SO_LINGER in seconds. Default of -1 disables it")
protected int linger=-1; // SO_LINGER (number of seconds, -1 disables it)
@Property(description="Wait for an ack from the server when a connection is established " +
"(https://issues.redhat.com/browse/JGRP-2684)")
protected boolean use_acks;
@LocalAddress
@Property(name="client_bind_addr",
description="The address of a local network interface which should be used by client sockets to bind to. " +
"The following special values are also recognized: GLOBAL, SITE_LOCAL, LINK_LOCAL and NON_LOOPBACK",
systemProperty={Global.TCP_CLIENT_BIND_ADDR},writable=false)
protected InetAddress client_bind_addr;
@Property(description="The local port a client socket should bind to. If 0, an ephemeral port will be picked.")
protected int client_bind_port;
@Property(description="If true, client sockets will not explicitly bind to bind_addr but will defer to the native socket")
protected boolean defer_client_bind_addr;
@Property(description="Log a stack trace when a connection is closed")
protected boolean log_details=true;
/* --------------------------------------------- Fields ------------------------------------------------------ */
protected BasicTCP() {
super();
}
public boolean supportsMulticasting() {return false;}
public long getReaperInterval() {return reaper_interval;}
public BasicTCP setReaperInterval(long interval) {this.reaper_interval=interval; return this;}
public BasicTCP reaperInterval(long interval) {this.reaper_interval=interval; return this;}
public long getConnExpireTime() {return conn_expire_time;}
public BasicTCP setConnExpireTime(long time) {this.conn_expire_time=time; return this;}
public int getRecvBufSize() {return recv_buf_size;}
public BasicTCP setRecvBufSize(int r) {this.recv_buf_size=r; return this;}
public int getSendBufSize() {return send_buf_size;}
public BasicTCP setSendBufSize(int s) {this.send_buf_size=s; return this;}
public int getSockConnTimeout() {return sock_conn_timeout;}
public BasicTCP setSockConnTimeout(int s) {this.sock_conn_timeout=s; return this;}
public int getMaxLength() {return max_length;}
public BasicTCP setMaxLength(int len) {max_length=len; return this;}
public int getPeerAddrReadTimeout() {return peer_addr_read_timeout;}
public BasicTCP setPeerAddrReadTimeout(int p) {this.peer_addr_read_timeout=p; return this;}
public boolean tcpNodelay() {return tcp_nodelay;}
public BasicTCP tcpNodelay(boolean t) {this.tcp_nodelay=t; return this;}
public int getLinger() {return linger;}
public BasicTCP setLinger(int l) {this.linger=l; return this;}
public boolean useAcks() {return use_acks;}
public BasicTCP useAcks(boolean f) {use_acks=f; return this;}
public InetAddress getClientBindAddr() {return client_bind_addr;}
public BasicTCP setClientBindAddr(InetAddress c) {this.client_bind_addr=c; return this;}
public int getClientBindPort() {return client_bind_port;}
public BasicTCP setClientBindPort(int c) {this.client_bind_port=c; return this;}
public boolean deferClientBindAddr() {return defer_client_bind_addr;}
public BasicTCP deferClientBindAddr(boolean d) {this.defer_client_bind_addr=d; return this;}
public boolean logDetails() {return log_details;}
public BasicTCP logDetails(boolean l) {log_details=l; return this;}
public void init() throws Exception {
super.init();
if(bind_port <= 0) {
Discovery discovery_prot=stack.findProtocol(Discovery.class);
if(discovery_prot != null && !discovery_prot.isDynamic())
throw new IllegalArgumentException("bind_port cannot be set to " + bind_port +
", as no dynamic discovery protocol (e.g. MPING or TCPGOSSIP) has been detected.");
}
if(reaper_interval > 0 || conn_expire_time > 0) {
if(conn_expire_time == 0 && reaper_interval > 0) {
log.warn("reaper interval (%d) set, but not conn_expire_time, disabling reaping", reaper_interval);
reaper_interval=0;
}
else if(conn_expire_time > 0 && reaper_interval == 0) {
reaper_interval=conn_expire_time / 2;
log.warn("conn_expire_time (%d) is set but reaper_interval is 0; setting it to %d", conn_expire_time, reaper_interval);
}
}
}
public void sendUnicast(PhysicalAddress dest, byte[] data, int offset, int length) throws Exception {
send(dest, data, offset, length);
}
public String getInfo() {
return String.format("connections: %s\n", printConnections());
}
public abstract String printConnections();
public abstract void send(Address dest, byte[] data, int offset, int length) throws Exception;
public abstract void retainAll(Collection members);
@Override
public Object down(Event evt) {
Object ret=super.down(evt);
if(evt.getType() == Event.VIEW_CHANGE) {
Set physical_mbrs=new HashSet<>();
for(Address addr: members) {
PhysicalAddress physical_addr=getPhysicalAddressFromCache(addr);
if(physical_addr != null)
physical_mbrs.add(physical_addr);
}
retainAll(physical_mbrs); // remove all connections which are not members
}
return ret;
}
}