Interface HttpConnection

  • All Known Implementing Classes:
    JDKHttpConnection

    public interface HttpConnection
    The interface of connections used during HTTP communication. This interface is that subset of the interface exposed by HttpURLConnection which is used by JGit
    Since:
    3.3
    • Field Detail

      • HTTP_NOT_FOUND

        static final int HTTP_NOT_FOUND
        See Also:
        HttpURLConnection.HTTP_NOT_FOUND, Constant Field Values
      • HTTP_UNAUTHORIZED

        static final int HTTP_UNAUTHORIZED
        See Also:
        HttpURLConnection.HTTP_UNAUTHORIZED, Constant Field Values
      • HTTP_FORBIDDEN

        static final int HTTP_FORBIDDEN
        See Also:
        HttpURLConnection.HTTP_FORBIDDEN, Constant Field Values
    • Method Detail

      • getResponseCode

        int getResponseCode()
                     throws java.io.IOException
        Returns:
        the HTTP Status-Code, or -1
        Throws:
        java.io.IOException
        See Also:
        HttpURLConnection.getResponseCode()
      • getURL

        java.net.URL getURL()
        Returns:
        the URL.
        See Also:
        URLConnection.getURL()
      • getResponseMessage

        java.lang.String getResponseMessage()
                                     throws java.io.IOException
        Returns:
        the HTTP response message, or null
        Throws:
        java.io.IOException
        See Also:
        HttpURLConnection.getResponseMessage()
      • getHeaderFields

        java.util.Map<java.lang.String,​java.util.List<java.lang.String>> getHeaderFields()
        Returns:
        a Map of header fields
        See Also:
        URLConnection.getHeaderFields()
      • setRequestProperty

        void setRequestProperty​(java.lang.String key,
                                java.lang.String value)
        Parameters:
        key - the keyword by which the request is known (e.g., " Accept").
        value - the value associated with it.
        See Also:
        URLConnection.setRequestProperty(String, String)
      • setRequestMethod

        void setRequestMethod​(java.lang.String method)
                       throws java.net.ProtocolException
        Parameters:
        method - the HTTP method
        Throws:
        java.net.ProtocolException - if the method cannot be reset or if the requested method isn't valid for HTTP.
        See Also:
        HttpURLConnection.setRequestMethod(String)
      • setUseCaches

        void setUseCaches​(boolean usecaches)
        Parameters:
        usecaches - a boolean indicating whether or not to allow caching
        See Also:
        URLConnection.setUseCaches(boolean)
      • setConnectTimeout

        void setConnectTimeout​(int timeout)
        Parameters:
        timeout - an int that specifies the connect timeout value in milliseconds
        See Also:
        URLConnection.setConnectTimeout(int)
      • setReadTimeout

        void setReadTimeout​(int timeout)
        Parameters:
        timeout - an int that specifies the timeout value to be used in milliseconds
        See Also:
        URLConnection.setReadTimeout(int)
      • getContentType

        java.lang.String getContentType()
        Returns:
        the content type of the resource that the URL references, or null if not known.
        See Also:
        URLConnection.getContentType()
      • getInputStream

        java.io.InputStream getInputStream()
                                    throws java.io.IOException
        Returns:
        an input stream that reads from this open connection.
        Throws:
        java.io.IOException - if an I/O error occurs while creating the input stream.
        See Also:
        URLConnection.getInputStream()
      • getHeaderField

        java.lang.String getHeaderField​(java.lang.String name)
        Parameters:
        name - the name of a header field.
        Returns:
        the value of the named header field, or null if there is no such field in the header.
        See Also:
        URLConnection.getHeaderField(String)
      • getContentLength

        int getContentLength()
        Returns:
        the content length of the resource that this connection's URL references, -1 if the content length is not known, or if the content length is greater than Integer.MAX_VALUE.
        See Also:
        URLConnection.getContentLength()
      • setInstanceFollowRedirects

        void setInstanceFollowRedirects​(boolean followRedirects)
        Parameters:
        followRedirects - a boolean indicating whether or not to follow HTTP redirects.
        See Also:
        HttpURLConnection.setInstanceFollowRedirects(boolean)
      • setDoOutput

        void setDoOutput​(boolean dooutput)
        Parameters:
        dooutput - the new value.
        See Also:
        URLConnection.setDoOutput(boolean)
      • setFixedLengthStreamingMode

        void setFixedLengthStreamingMode​(int contentLength)
        Parameters:
        contentLength - The number of bytes which will be written to the OutputStream.
        See Also:
        HttpURLConnection.setFixedLengthStreamingMode(int)
      • getOutputStream

        java.io.OutputStream getOutputStream()
                                      throws java.io.IOException
        Returns:
        an output stream that writes to this connection.
        Throws:
        java.io.IOException
        See Also:
        URLConnection.getOutputStream()
      • setChunkedStreamingMode

        void setChunkedStreamingMode​(int chunklen)
        Parameters:
        chunklen - The number of bytes to write in each chunk. If chunklen is less than or equal to zero, a default value will be used.
        See Also:
        HttpURLConnection.setChunkedStreamingMode(int)
      • getRequestMethod

        java.lang.String getRequestMethod()
        Returns:
        the HTTP request method
        See Also:
        HttpURLConnection.getRequestMethod()
      • usingProxy

        boolean usingProxy()
        Returns:
        a boolean indicating if the connection is using a proxy.
        See Also:
        HttpURLConnection.usingProxy()
      • connect

        void connect()
              throws java.io.IOException
        Throws:
        java.io.IOException
        See Also:
        URLConnection.connect()
      • configure

        void configure​(javax.net.ssl.KeyManager[] km,
                       javax.net.ssl.TrustManager[] tm,
                       java.security.SecureRandom random)
                throws java.security.NoSuchAlgorithmException,
                       java.security.KeyManagementException
        Configure the connection so that it can be used for https communication.
        Parameters:
        km - the keymanager managing the key material used to authenticate the local SSLSocket to its peer
        tm - the trustmanager responsible for managing the trust material that is used when making trust decisions, and for deciding whether credentials presented by a peer should be accepted.
        random - the source of randomness for this generator or null. See SSLContext.init(KeyManager[], TrustManager[], SecureRandom)
        Throws:
        java.security.NoSuchAlgorithmException
        java.security.KeyManagementException
      • setHostnameVerifier

        void setHostnameVerifier​(javax.net.ssl.HostnameVerifier hostnameverifier)
                          throws java.security.NoSuchAlgorithmException,
                                 java.security.KeyManagementException
        Set the HostnameVerifier used during https communication
        Parameters:
        hostnameverifier -
        Throws:
        java.security.NoSuchAlgorithmException
        java.security.KeyManagementException