◐ Shell
clean mode source ↗

Java - HttpURLConnection Class



Java HttpURLConnection Class

java.net.HttpURLConnection, is an abstract class which represents the HTTP-specific URL connection. Instances of this class can be used both to read from and to write to the resource referenced by the URL.

For example −

  • If you connect to a URL whose protocol is HTTP, the URL.openConnection() method returns an HttpURLConnection object.

Steps to make a connection to a URL

Following are the steps to make a connectiion to the URL and start processing.

  • Invoke URL.openConnection() method to get HttpURLConnection object of an HTTP based URL.

  • Update setup parameters and general request properties as required using connection object various setter methods.

  • Create a connection to remote object using connect() method of connection object.

  • Once remote object is available, access the content/headers of the remote object.

HttpURLConnection Class Declaration

public abstract class HttpURLConnection
   extends URLConnection

HttpURLConnection Class Fields

Sr.No. Field & Description
1

protected int chunkLength

The chunk-length when using chunked encoding streaming mode for output.
2

protected int fixedContentLength

The fixed content-length when using fixed-length streaming mode.
3

protected long fixedContentLengthLong

The fixed content-length when using fixed-length streaming mode.
4

static int HTTP_ACCEPTED

HTTP Status-Code 202: Accepted.
5

static int HTTP_BAD_GATEWAY

HTTP Status-Code 502: Bad Gateway.
6

static int HTTP_BAD_METHOD

HTTP Status-Code 405: Method Not Allowed.
7

static int HTTP_BAD_REQUEST

HTTP Status-Code 400: Bad Request.
8

static int HTTP_CLIENT_TIMEOUT

HTTP Status-Code 408: Request Time-Out.
9

static int HTTP_CONFLICT

HTTP Status-Code 409: Conflict.
10

static int HTTP_CREATED

HTTP Status-Code 201: Created.
11

static int HTTP_ENTITY_TOO_LARGE

HTTP Status-Code 413: Request Entity Too Large.
12

static int HTTP_FORBIDDEN

HTTP Status-Code 403: Forbidden.
13

static int HTTP_GATEWAY_TIMEOUT

HTTP Status-Code 504: Gateway Timeout.
14

static int HTTP_GONE

HTTP Status-Code 410: Gone.
15

static int HTTP_INTERNAL_ERROR

HTTP Status-Code 500: Internal Server Error.
16

static int HTTP_LENGTH_REQUIRED

HTTP Status-Code 411: Length Required.
17

static int HTTP_MOVED_PERM

HTTP Status-Code 301: Moved Permanently.
18

static int HTTP_MOVED_TEMP

HTTP Status-Code 302: Temporary Redirect.
19

static int HTTP_MULT_CHOICE

HTTP Status-Code 300: Multiple Choices.
20

static int HTTP_NO_CONTENT

HTTP Status-Code 204: No Content.
21

static int HTTP_NOT_ACCEPTABLE

HTTP Status-Code 406: Not Acceptable.
22

static int HTTP_NOT_AUTHORITATIVE

HTTP Status-Code 203: Non-Authoritative Information.
23

static int HTTP_NOT_FOUND

HTTP Status-Code 404: Not Found.
24

static int HTTP_NOT_IMPLEMENTED

HTTP Status-Code 501: Not Implemented.
25

static int HTTP_NOT_MODIFIED

HTTP Status-Code 304: Not Modified.
26

static int HTTP_OK

HTTP Status-Code 200: OK.
27

static int HTTP_PARTIAL

HTTP Status-Code 206: Partial Content.
28

static int HTTP_PAYMENT_REQUIRED

HTTP Status-Code 402: Payment Required.
29

static int HTTP_PRECON_FAILED

HTTP Status-Code 412: Precondition Failed.
30

static int HTTP_PROXY_AUTH

HTTP Status-Code 407: Proxy Authentication Required.
31

static int HTTP_REQ_TOO_LONG

HTTP Status-Code 414: Request-URI Too Large.
32

static int HTTP_RESET

HTTP Status-Code 205: Reset Content.
33

static int HTTP_SEE_OTHER

HTTP Status-Code 303: See Other.
34

static int HTTP_UNAUTHORIZED

HTTP Status-Code 401: Unauthorized.
35

static int HTTP_UNAVAILABLE

HTTP Status-Code 503: Service Unavailable.
36

static int HTTP_UNSUPPORTED_TYPE

HTTP Status-Code 415: Unsupported Media Type.
37

static int HTTP_USE_PROXY

HTTP Status-Code 305: Use Proxy.
38

static int HTTP_VERSION

HTTP Status-Code 505: HTTP Version Not Supported.
39

protected boolean instanceFollowRedirects

If true, the protocol will automatically follow redirects.
40

protected String method

The HTTP method (GET,POST,PUT,etc.).
41

protected int responseCode

An int representing the three digit HTTP Status-Code.
42

protected String responseMessage

The HTTP response message.

HttpURLConnection Class Methods

The HttpURLConnection class has many methods for setting or determining information about the connection, including the following −

Extends

This class extends following classes

  • java.lang.Object

  • java.net.URLConnection

Example of Java HttpURLConnection Class

The following HttpURLConnection program connects to a URL entered from the command line.

If the URL represents an HTTP resource, the connection is cast to HttpURLConnection, and the data in the resource is read one line at a time.

package com.tutorialspoint;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;

public class HttpUrlConnectionDemo {
   public static void main(String [] args) {
      try {
         URL url = new URL("https://www.tutorialspoint.com");
         URLConnection urlConnection = url.openConnection();
         HttpURLConnection connection = null;
         if(urlConnection instanceof HttpURLConnection) {
            connection = (HttpURLConnection) urlConnection;
         }else {
            System.out.println("Please enter an HTTP URL.");
            return;
         }
         
         BufferedReader in = new BufferedReader(
            new InputStreamReader(connection.getInputStream()));
         String urlString = "";
         String current;
         
         while((current = in.readLine()) != null) {
            urlString += current;
         }
         System.out.println(urlString);
      } catch (IOException e) {
         e.printStackTrace();
      }
   }
}

A sample run of this program will produce the following result −

Output

$ java HttpURLConnection

.....a complete HTML content of home page of tutorialspoint.com.....