Package org.apache.hadoop.hdfs.net

Interface Peer

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable

All Known Implementing Classes:

BasicInetPeer, DomainPeer, EncryptedPeer, NioInetPeer

@Private
public interface Peer
extends java.io.Closeable

Represents a connection to a peer.

Method Summary

Modifier and Type	Method	Description
void	close()	Close the peer.
org.apache.hadoop.net.unix.DomainSocket	getDomainSocket()
java.io.InputStream	getInputStream()
java.nio.channels.ReadableByteChannel	getInputStreamChannel()
java.lang.String	getLocalAddressString()
java.io.OutputStream	getOutputStream()
int	getReceiveBufferSize()
java.lang.String	getRemoteAddressString()
boolean	getTcpNoDelay()
boolean	hasSecureChannel()	Return true if the channel is secure.
boolean	isClosed()
boolean	isLocal()
void	setReadTimeout(int timeoutMs)	Set the read timeout on this peer.
void	setWriteTimeout(int timeoutMs)	Set the write timeout on this peer.

Method Detail

getInputStreamChannel

java.nio.channels.ReadableByteChannel getInputStreamChannel()

Returns:

The input stream channel associated with this peer, or null if it has none.

setReadTimeout

void setReadTimeout(int timeoutMs)
             throws java.io.IOException

Set the read timeout on this peer.

Parameters:

timeoutMs - The timeout in milliseconds.

Throws:

java.io.IOException

getReceiveBufferSize

int getReceiveBufferSize()
                  throws java.io.IOException

Returns:

The receive buffer size.

Throws:

java.io.IOException

getTcpNoDelay

boolean getTcpNoDelay()
               throws java.io.IOException

Returns:

True if TCP_NODELAY is turned on.

Throws:

java.io.IOException

setWriteTimeout

void setWriteTimeout(int timeoutMs)
              throws java.io.IOException

Set the write timeout on this peer. Note: this is not honored for BasicInetPeer. See BasicInetPeer.setWriteTimeout(int) for details.

Parameters:

timeoutMs - The timeout in milliseconds.

Throws:

java.io.IOException

isClosed

boolean isClosed()

Returns:

true only if the peer is closed.

close

void close()
    throws java.io.IOException

Close the peer. It's safe to re-close a Peer that is already closed.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException

getRemoteAddressString

java.lang.String getRemoteAddressString()

Returns:

A string representing the remote end of our connection to the peer.

getLocalAddressString

java.lang.String getLocalAddressString()

Returns:

A string representing the local end of our connection to the peer.

getInputStream

java.io.InputStream getInputStream()
                            throws java.io.IOException

Returns:

An InputStream associated with the Peer. This InputStream will be valid until you close this peer with Peer#close.

Throws:

java.io.IOException

getOutputStream

java.io.OutputStream getOutputStream()
                              throws java.io.IOException

Returns:

An OutputStream associated with the Peer. This OutputStream will be valid until you close this peer with Peer#close.

Throws:

java.io.IOException

isLocal

boolean isLocal()

Returns:

True if the peer resides on the same computer as we.

getDomainSocket

org.apache.hadoop.net.unix.DomainSocket getDomainSocket()

Returns:

The DomainSocket associated with the current peer, or null if there is none.

hasSecureChannel

boolean hasSecureChannel()

Return true if the channel is secure.

Returns:

True if our channel to this peer is not susceptible to man-in-the-middle attacks.