de.alpharogroup.net.socket

Class SocketExtensions

java.lang.Object

de.alpharogroup.net.socket.SocketExtensions

public class SocketExtensions
extends Object

Helper class for handling Sockets.

Version:

1.0

Author:

Asterios Raptis

Constructor Summary

Constructors

Constructor and Description
SocketExtensions()

Method Summary

Modifier and Type	Method and Description
static boolean	available(int port) Checks if the given port at localhost is available.
static boolean	available(String host, int port) Checks if the given port at the given host is available.
static void	close(Socket clientSocket) Close the given Socket.
static boolean	closeClientSocket(Socket clientSocket) Closes the given client socket.
static boolean	closeServerSocket(ServerSocket serverSocket) Closes the given ServerSocket.
static Socket	newSocket(String host, int port) Factory method for a socket.
static Object	readObject(InetAddress inetAddress, int port) Reads an object from the given socket InetAddress.
static Object	readObject(int port) Reads an object from the given port.
static Object	readObject(Socket clientSocket) Reads an object from the given socket object.
static Object	readObject(String serverName, int port) Reads an object from the given socket InetAddress.
static void	writeObject(InetAddress inetAddress, int port, Object objectToSend) Writes the given Object to the given InetAddress who listen to the given port.
static void	writeObject(Socket socket, int port, Object objectToSend) Writes the given Object to the given Socket who listen to the given port.
static void	writeObject(String serverName, int port, Object objectToSend) Writes the given Object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SocketExtensions

public SocketExtensions()

Method Detail

available

public static boolean available(int port)

Checks if the given port at localhost is available.

Parameters:

port - the port number.

Returns:

If the given port at the given host is available true, otherwise false.

available

public static boolean available(String host,
                                int port)

Checks if the given port at the given host is available. Note: Socket will be closed after the test.

Parameters:

host - the host name.

port - the port number.

Returns:

If the given port at the given host is available true, otherwise false.

close

public static void close(Socket clientSocket)
                  throws IOException

Close the given Socket.

Parameters:

clientSocket - the client socket

Throws:

IOException - Signals that an I/O exception has occurred.

closeClientSocket

public static boolean closeClientSocket(Socket clientSocket)

Closes the given client socket.

Parameters:

clientSocket - The client socket to close.

Returns:

Returns true if the client socket is closed otherwise false.

closeServerSocket

public static boolean closeServerSocket(ServerSocket serverSocket)

Closes the given ServerSocket.

Parameters:

serverSocket - The ServerSocket to close.

Returns:

Returns true if the ServerSocket is closed otherwise false.

newSocket

public static Socket newSocket(String host,
                               int port)
                        throws IOException

Factory method for a socket.

Parameters:

host - the host name.

port - the port number.

Returns:

The created Socket.

Throws:

IOException - is thrown if the port is not available or other network errors.

readObject

public static Object readObject(InetAddress inetAddress,
                                int port)
                         throws IOException,
                                ClassNotFoundException

Reads an object from the given socket InetAddress.

Parameters:

inetAddress - the InetAddress to read.

port - The port to read.

Returns:

the object

Throws:

IOException - Signals that an I/O exception has occurred.

ClassNotFoundException - the class not found exception

readObject

public static Object readObject(Socket clientSocket)
                         throws IOException,
                                ClassNotFoundException

Reads an object from the given socket object.

Parameters:

clientSocket - the socket to read.

Returns:

the object

Throws:

IOException - Signals that an I/O exception has occurred.

ClassNotFoundException - the class not found exception

readObject

public static Object readObject(int port)
                         throws IOException,
                                ClassNotFoundException

Reads an object from the given port.

Parameters:

port - the port

Returns:

the object

Throws:

IOException - Signals that an I/O exception has occurred.

ClassNotFoundException - the class not found exception

readObject

public static Object readObject(String serverName,
                                int port)
                         throws IOException,
                                ClassNotFoundException

Reads an object from the given socket InetAddress.

Parameters:

serverName - The Name from the address to read.

port - The port to read.

Returns:

the object

Throws:

IOException - Signals that an I/O exception has occurred.

ClassNotFoundException - the class not found exception

writeObject

public static void writeObject(InetAddress inetAddress,
                               int port,
                               Object objectToSend)
                        throws IOException

Writes the given Object to the given InetAddress who listen to the given port.

Parameters:

inetAddress - the inet address

port - The port who listen the receiver.

objectToSend - The Object to send.

Throws:

IOException - Signals that an I/O exception has occurred.

writeObject

public static void writeObject(Socket socket,
                               int port,
                               Object objectToSend)
                        throws IOException

Writes the given Object to the given Socket who listen to the given port.

Parameters:

socket - The Socket to the receiver.

port - The port who listen the receiver.

objectToSend - The Object to send.

Throws:

IOException - Signals that an I/O exception has occurred.

writeObject

public static void writeObject(String serverName,
                               int port,
                               Object objectToSend)
                        throws IOException

Writes the given Object.

Parameters:

serverName - The Name from the receiver(Server).

port - The port who listen the receiver.

objectToSend - The Object to send.

Throws:

IOException - Signals that an I/O exception has occurred.