Java Socket shutdownOutput() method

The shutdownOutput() method of Java Socket class disables the output stream for the specified socket. If the socket output stream is written after invoking the shutdownOutput() method on the socket, the stream will throw an IOException.

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 JavaSocketShutdownOutputExample1  {
    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);
        //shutdownOutput() method disables the output stream for the specified socket.
        socket.shutdownOutput();
        //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());
        //isOutputShutdown() returns a boolean value ?true? if the write-half of the socket connection has been closed
        System.out.println("The socket is shutdown: "+socket.isOutputShutdown());
    }
}

Test it Now

Output:

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

Example 2

import java.io.IOException;
import java.net.*;
public class JavaSocketShutdownOutputExample2  {
    public static void main(String[] args) throws IOException {
        //calling the constructor of the socket class
        Socket socket = new Socket();
        //shutdownOutput() method disables the output stream for the specified socket.
        //the socket should be connected else it will throw an SocketException
        socket.shutdownOutput();
        //isOutputShutdown() returns if the write-half of the socket connection is closed.
        System.out.println("output is shutdown: "+socket.isOutputShutdown());
    }
 }

Test it Now

Output:

Exception in thread "main" java.net.SocketException: Socket is not connected
	at java.net.Socket.shutdownOutput(Socket.java:1553)
	at com.javaTpoint.JavaSocketShutdownOutputExample2.main(JavaSocketShutdownOutputExample2.java:10)

Next TopicJava Socket Class

← prev next →