Package org.eclipse.jgit.util
Class HttpSupport
- java.lang.Object
-
- org.eclipse.jgit.util.HttpSupport
-
public class HttpSupport extends java.lang.Object
Extra utilities to support usage of HTTP.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description private static class
HttpSupport.DummyHostnameVerifier
private static class
HttpSupport.DummyX509TrustManager
-
Field Summary
Fields Modifier and Type Field Description private static java.util.Set<java.lang.String>
configuredHttpsProtocols
static java.lang.String
ENCODING_GZIP
Thegzip
encoding value forHDR_ACCEPT_ENCODING
.static java.lang.String
ENCODING_X_GZIP
Thex-gzip
encoding value forHDR_ACCEPT_ENCODING
.static java.lang.String
HDR_ACCEPT
TheAccept
header.static java.lang.String
HDR_ACCEPT_ENCODING
TheAccept-Encoding
header.static java.lang.String
HDR_ACCEPT_RANGES
TheAccept-Ranges
header.static java.lang.String
HDR_AUTHORIZATION
TheAuthorization
header.static java.lang.String
HDR_CACHE_CONTROL
TheCache-Control
header.static java.lang.String
HDR_CONTENT_ENCODING
TheContent-Encoding
header.static java.lang.String
HDR_CONTENT_LENGTH
TheContent-Length
header.static java.lang.String
HDR_CONTENT_RANGE
TheContent-Range
header.static java.lang.String
HDR_CONTENT_TYPE
TheContent-Type
header.static java.lang.String
HDR_COOKIE
TheCookie
header.static java.lang.String
HDR_DATE
TheDate
header.static java.lang.String
HDR_ETAG
TheETag
header.static java.lang.String
HDR_EXPIRES
TheExpires
header.static java.lang.String
HDR_IF_MODIFIED_SINCE
TheIf-Modified-Since
header.static java.lang.String
HDR_IF_NONE_MATCH
TheIf-None-Match
header.static java.lang.String
HDR_IF_RANGE
TheIf-Range
header.static java.lang.String
HDR_LAST_MODIFIED
TheLast-Modified
header.static java.lang.String
HDR_LOCATION
TheLocation
header.static java.lang.String
HDR_PRAGMA
ThePragma
header.static java.lang.String
HDR_RANGE
TheRange
header.static java.lang.String
HDR_SERVER
TheServer
header.static java.lang.String
HDR_SET_COOKIE
TheSet-Cookie
header.static java.lang.String
HDR_SET_COOKIE2
TheSet-Cookie2
header.static java.lang.String
HDR_USER_AGENT
TheUser-Agent
header.static java.lang.String
HDR_WWW_AUTHENTICATE
TheWWW-Authenticate
header.private static org.slf4j.Logger
LOG
static java.lang.String
METHOD_GET
TheGET
HTTP method.static java.lang.String
METHOD_HEAD
TheHEAD
HTTP method.static java.lang.String
METHOD_POST
ThePOST
HTTP method.static java.lang.String
METHOD_PUT
ThePOST
HTTP method.static java.lang.String
TEXT_PLAIN
The standardtext/plain
MIME type.
-
Constructor Summary
Constructors Modifier Constructor Description private
HttpSupport()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static void
configureTLS(javax.net.ssl.SSLSocket socket)
Enables all supported TLS protocol versions on the socket given.static void
disableSslVerify(HttpConnection conn)
Disable SSL and hostname verification for given HTTP connectionstatic void
encode(java.lang.StringBuilder urlstr, java.lang.String key)
URL encode a value string into an output buffer.private static java.util.Set<java.lang.String>
getConfiguredProtocols()
private static java.lang.String
getProperty(java.lang.String property)
static java.net.Proxy
proxyFor(java.net.ProxySelector proxySelector, java.net.URL u)
Determine the proxy server (if any) needed to obtain a URL.static int
response(java.net.HttpURLConnection c)
Get the HTTP response code from the request.static int
response(HttpConnection c)
Get the HTTP response code from the request.static java.lang.String
responseHeader(HttpConnection c, java.lang.String headerName)
Extract a HTTP header from the response.
-
-
-
Field Detail
-
LOG
private static final org.slf4j.Logger LOG
-
METHOD_GET
public static final java.lang.String METHOD_GET
TheGET
HTTP method.- See Also:
- Constant Field Values
-
METHOD_HEAD
public static final java.lang.String METHOD_HEAD
TheHEAD
HTTP method.- Since:
- 4.3
- See Also:
- Constant Field Values
-
METHOD_PUT
public static final java.lang.String METHOD_PUT
ThePOST
HTTP method.- Since:
- 4.3
- See Also:
- Constant Field Values
-
METHOD_POST
public static final java.lang.String METHOD_POST
ThePOST
HTTP method.- See Also:
- Constant Field Values
-
HDR_CACHE_CONTROL
public static final java.lang.String HDR_CACHE_CONTROL
TheCache-Control
header.- See Also:
- Constant Field Values
-
HDR_PRAGMA
public static final java.lang.String HDR_PRAGMA
ThePragma
header.- See Also:
- Constant Field Values
-
HDR_USER_AGENT
public static final java.lang.String HDR_USER_AGENT
TheUser-Agent
header.- See Also:
- Constant Field Values
-
HDR_SERVER
public static final java.lang.String HDR_SERVER
TheServer
header.- Since:
- 4.0
- See Also:
- Constant Field Values
-
HDR_DATE
public static final java.lang.String HDR_DATE
TheDate
header.- See Also:
- Constant Field Values
-
HDR_EXPIRES
public static final java.lang.String HDR_EXPIRES
TheExpires
header.- See Also:
- Constant Field Values
-
HDR_ETAG
public static final java.lang.String HDR_ETAG
TheETag
header.- See Also:
- Constant Field Values
-
HDR_IF_NONE_MATCH
public static final java.lang.String HDR_IF_NONE_MATCH
TheIf-None-Match
header.- See Also:
- Constant Field Values
-
HDR_LAST_MODIFIED
public static final java.lang.String HDR_LAST_MODIFIED
TheLast-Modified
header.- See Also:
- Constant Field Values
-
HDR_IF_MODIFIED_SINCE
public static final java.lang.String HDR_IF_MODIFIED_SINCE
TheIf-Modified-Since
header.- See Also:
- Constant Field Values
-
HDR_ACCEPT
public static final java.lang.String HDR_ACCEPT
TheAccept
header.- See Also:
- Constant Field Values
-
HDR_CONTENT_TYPE
public static final java.lang.String HDR_CONTENT_TYPE
TheContent-Type
header.- See Also:
- Constant Field Values
-
HDR_CONTENT_LENGTH
public static final java.lang.String HDR_CONTENT_LENGTH
TheContent-Length
header.- See Also:
- Constant Field Values
-
HDR_CONTENT_ENCODING
public static final java.lang.String HDR_CONTENT_ENCODING
TheContent-Encoding
header.- See Also:
- Constant Field Values
-
HDR_CONTENT_RANGE
public static final java.lang.String HDR_CONTENT_RANGE
TheContent-Range
header.- See Also:
- Constant Field Values
-
HDR_ACCEPT_RANGES
public static final java.lang.String HDR_ACCEPT_RANGES
TheAccept-Ranges
header.- See Also:
- Constant Field Values
-
HDR_IF_RANGE
public static final java.lang.String HDR_IF_RANGE
TheIf-Range
header.- See Also:
- Constant Field Values
-
HDR_RANGE
public static final java.lang.String HDR_RANGE
TheRange
header.- See Also:
- Constant Field Values
-
HDR_ACCEPT_ENCODING
public static final java.lang.String HDR_ACCEPT_ENCODING
TheAccept-Encoding
header.- See Also:
- Constant Field Values
-
HDR_LOCATION
public static final java.lang.String HDR_LOCATION
TheLocation
header.- Since:
- 4.7
- See Also:
- Constant Field Values
-
ENCODING_GZIP
public static final java.lang.String ENCODING_GZIP
Thegzip
encoding value forHDR_ACCEPT_ENCODING
.- See Also:
- Constant Field Values
-
ENCODING_X_GZIP
public static final java.lang.String ENCODING_X_GZIP
Thex-gzip
encoding value forHDR_ACCEPT_ENCODING
.- Since:
- 4.6
- See Also:
- Constant Field Values
-
TEXT_PLAIN
public static final java.lang.String TEXT_PLAIN
The standardtext/plain
MIME type.- See Also:
- Constant Field Values
-
HDR_AUTHORIZATION
public static final java.lang.String HDR_AUTHORIZATION
TheAuthorization
header.- See Also:
- Constant Field Values
-
HDR_WWW_AUTHENTICATE
public static final java.lang.String HDR_WWW_AUTHENTICATE
TheWWW-Authenticate
header.- See Also:
- Constant Field Values
-
HDR_COOKIE
public static final java.lang.String HDR_COOKIE
TheCookie
header.- Since:
- 5.4
- See Also:
- Constant Field Values
-
HDR_SET_COOKIE
public static final java.lang.String HDR_SET_COOKIE
TheSet-Cookie
header.- Since:
- 5.4
- See Also:
- Constant Field Values
-
HDR_SET_COOKIE2
public static final java.lang.String HDR_SET_COOKIE2
TheSet-Cookie2
header.- Since:
- 5.4
- See Also:
- Constant Field Values
-
configuredHttpsProtocols
private static java.util.Set<java.lang.String> configuredHttpsProtocols
-
-
Method Detail
-
encode
public static void encode(java.lang.StringBuilder urlstr, java.lang.String key)
URL encode a value string into an output buffer.- Parameters:
urlstr
- the output buffer.key
- value which must be encoded to protected special characters.
-
response
public static int response(HttpConnection c) throws java.io.IOException
Get the HTTP response code from the request.Roughly the same as
c.getResponseCode()
but the ConnectException is translated to be more understandable.- Parameters:
c
- connection the code should be obtained from.- Returns:
- r HTTP status code, usually 200 to indicate success. See
HttpConnection
for other defined constants. - Throws:
java.io.IOException
- communications error prevented obtaining the response code.- Since:
- 3.3
-
response
public static int response(java.net.HttpURLConnection c) throws java.io.IOException
Get the HTTP response code from the request.Roughly the same as
c.getResponseCode()
but the ConnectException is translated to be more understandable.- Parameters:
c
- connection the code should be obtained from.- Returns:
- r HTTP status code, usually 200 to indicate success. See
HttpConnection
for other defined constants. - Throws:
java.io.IOException
- communications error prevented obtaining the response code.
-
responseHeader
public static java.lang.String responseHeader(HttpConnection c, java.lang.String headerName) throws java.io.IOException
Extract a HTTP header from the response.- Parameters:
c
- connection the header should be obtained from.headerName
- the header name- Returns:
- the header value
- Throws:
java.io.IOException
- communications error prevented obtaining the header.- Since:
- 4.7
-
proxyFor
public static java.net.Proxy proxyFor(java.net.ProxySelector proxySelector, java.net.URL u) throws java.net.ConnectException
Determine the proxy server (if any) needed to obtain a URL.- Parameters:
proxySelector
- proxy support for the caller.u
- location of the server caller wants to talk to.- Returns:
- proxy to communicate with the supplied URL.
- Throws:
java.net.ConnectException
- the proxy could not be computed as the supplied URL could not be read. This failure should never occur.
-
disableSslVerify
public static void disableSslVerify(HttpConnection conn) throws java.io.IOException
Disable SSL and hostname verification for given HTTP connection- Parameters:
conn
- aHttpConnection
object.- Throws:
java.io.IOException
- Since:
- 4.3
-
configureTLS
public static void configureTLS(javax.net.ssl.SSLSocket socket)
Enables all supported TLS protocol versions on the socket given. If system property "https.protocols" is set, only protocols specified there are enabled.This is primarily a mechanism to deal with using TLS on IBM JDK. IBM JDK returns sockets that support all TLS protocol versions but have only the one specified in the context enabled. Oracle or OpenJDK return sockets that have all available protocols enabled already, up to the one specified.
SSLContext.getInstance() OpenJDK IDM JDK "TLS" Supported: TLSv1, TLSV1.1, TLSv1.2 (+ TLSv1.3)
Enabled: TLSv1, TLSV1.1, TLSv1.2 (+ TLSv1.3)Supported: TLSv1, TLSV1.1, TLSv1.2
Enabled: TLSv1"TLSv1.2" Supported: TLSv1, TLSV1.1, TLSv1.2
Enabled: TLSv1, TLSV1.1, TLSv1.2Supported: TLSv1, TLSV1.1, TLSv1.2
Enabled: TLSv1.2- Parameters:
socket
- to configure- Since:
- 5.7
- See Also:
- Behavior of SSLContext.getInstance("TLS") on IBM JDK, Customizing JSSE about https.protocols
-
getConfiguredProtocols
private static java.util.Set<java.lang.String> getConfiguredProtocols()
-
getProperty
private static java.lang.String getProperty(java.lang.String property)
-
-