Java Socket shutdownInput() method

The shutdownInput() method of Java Socket class places the input stream for the specified socket at the end of the stream. When this method is invoked on the socket, the stream's available method returns 0, and its read methods return -1 (end of stream).

Syntax

Parameter

Return

Throws

IOException - if an I/O error occurs while shutting down the given socket

Example 1

import java.io.IOException;
import java.net.*;
public class JavaSocketShutDownInputExample1  {
    public static void main(String[] args) throws IOException {
        //calling the constructor of the socket class
        Socket socket = new Socket();
        InetAddress inetAddress=InetAddress.getByName("localhost");
        //the port should be greater or equal to 0, else it will throw an error
        int port=1085;
        //calling the constructor of the SocketAddress class
        SocketAddress socketAddress=new InetSocketAddress(inetAddress, port);
        //binding the socket with inetAddress and port
        socket.bind(socketAddress);
        //the connection will not establish without binding the socket with bind() method
        socket.connect(socketAddress);
        //shutdownInput() places the input stream for the specified socket at the end of the stream
        socket.shutdownInput();
        //isConnected() method returns the connected state of the socket
        System.out.println("The socket is connected: "+socket.isConnected());
        //isBound() method returns the binding state of the socket
        System.out.println("The socket is bounded: "+socket.isBound());
        //isInputShutdown() returns if the read-half of the socket connection is closed or not.
        System.out.println("Input is shutdown: "+socket.isInputShutdown());
    }
}

Test it Now

Output:

Output
The socket is connected: true
The socket is bounded: true
Input is shutdown: true

Example 2

import java.io.IOException;
import java.net.*;
public class JavaSocketShutDownInputExample2  {
    public static void main(String[] args) throws IOException {
        //calling the constructor of the socket class
        Socket socket = new Socket();
        InetAddress inetAddress=InetAddress.getByName("localhost");
        //the port should be greater or equal to 0, else it will throw an error
        int port=1085;
        //calling the constructor of the SocketAddress class
        SocketAddress socketAddress=new InetSocketAddress(inetAddress, port);
        //binding the socket with inetAddress and port
        socket.bind(socketAddress);
        //the connection will not establish without binding the socket with bind() method
        socket.connect(socketAddress);
        //shutdownInput() places the input stream for the specified socket at the end of the stream
        socket.shutdownInput();
        //socket is closed
        socket.close();
        //isConnected() method returns the connected state of the socket
        //It will continue to return the connection state that was prior to being closed.
        System.out.println("The socket is connected: "+socket.isConnected());
        //isBound() method returns the binding state of the socket
        System.out.println("The socket is bounded: "+socket.isBound());
        //isInputShutdown() returns if the read-half of the socket connection is closed or not.
        System.out.println("Input is shutdown: "+socket.isInputShutdown());
    }
}

Test it Now

Output:

The socket is connected: true
The socket is bounded: true
Input is shutdown: true

Example 3

import java.io.IOException;
import java.net.*;
public class JavaSocketShutDownInputExample3  {
    public static void main(String[] args) throws IOException {
        //calling the constructor of the socket class
        Socket socket = new Socket();
        //the socket should be connected
        //shutting down the input
        socket.shutdownInput();
        //isInputShutdown() returns a Boolean value indicating if the read-half of the socket connection is closed.
        System.out.println("Input is shutdown: "+socket.isInputShutdown());
    }
}

Test it Now

Output:

Exception in thread "main" java.net.SocketException: Socket is not connected
	at java.net.Socket.shutdownInput(Socket.java:1523)
	at com.javaTpoint.JavaSocketShutdownInputExample3.main(JavaSocketShutdownInputExample3.java:11)

Next TopicJava Socket Class

← prev next →