+ * Java 8 have TLS 1.2 enabled by default. java 7 - no, you should invoke this method or turn TLS>=1.1 somehow + * else
+ * + * @throws java.security.NoSuchAlgorithmException in case your jvm doesn't support TLSv1.1 or higher + * @throws java.security.KeyManagementException unexpected Exception from + * {@link SSLContext#init(javax.net.ssl.KeyManager[], javax.net.ssl.TrustManager[], java.security.SecureRandom)} + * @throws java.io.IOException unexpected Exception from {@link javax.net.ssl.SSLSocketFactory#createSocket()} + */ + public static void initTLSv11orUpper() throws NoSuchAlgorithmException, KeyManagementException, IOException { + final SSLSocket socket = (SSLSocket) SSLContext.getDefault().getSocketFactory().createSocket(); + if (isTLSv11orUpperEnabled(socket)) { + return; + } + final String[] supportedProtocols = socket.getSupportedProtocols(); + Arrays.sort(supportedProtocols); + for (int i = supportedProtocols.length - 1; i >= 0; i--) { + final String supportedProtocol = supportedProtocols[i]; + if (supportedProtocol.startsWith("TLSv1.")) { + final SSLContext context = SSLContext.getInstance(supportedProtocol); + context.init(null, null, null); + SSLContext.setDefault(context); + return; + } + } + + throw new NoSuchAlgorithmException("for Salesforce API to work you need jvm with TLS 1.1 or higher support"); + } + + @Override + public ClientAuthentication getClientAuthentication() { + return RequestBodyAuthenticationScheme.instance(); + } +} diff --git a/scribejava-apis/src/main/java/com/github/scribejava/apis/SapoApi.java b/scribejava-apis/src/main/java/com/github/scribejava/apis/SapoApi.java deleted file mode 100644 index de21a248e..000000000 --- a/scribejava-apis/src/main/java/com/github/scribejava/apis/SapoApi.java +++ /dev/null @@ -1,37 +0,0 @@ -package com.github.scribejava.apis; - -import com.github.scribejava.core.builder.api.DefaultApi10a; -import com.github.scribejava.core.model.Token; -import com.github.scribejava.core.model.Verb; - -public class SapoApi extends DefaultApi10a { - - private static final String AUTHORIZE_URL = "https://id.sapo.pt/oauth/authorize?oauth_token=%s"; - private static final String ACCESS_URL = "https://id.sapo.pt/oauth/access_token"; - private static final String REQUEST_URL = "https://id.sapo.pt/oauth/request_token"; - - @Override - public String getAccessTokenEndpoint() { - return ACCESS_URL; - } - - @Override - public String getRequestTokenEndpoint() { - return REQUEST_URL; - } - - @Override - public String getAuthorizationUrl(Token requestToken) { - return String.format(AUTHORIZE_URL, requestToken.getToken()); - } - - @Override - public Verb getRequestTokenVerb() { - return Verb.GET; - } - - @Override - public Verb getAccessTokenVerb() { - return Verb.GET; - } -} diff --git a/scribejava-apis/src/main/java/com/github/scribejava/apis/SimpleGeoApi.java b/scribejava-apis/src/main/java/com/github/scribejava/apis/SimpleGeoApi.java deleted file mode 100644 index d5b2d50f8..000000000 --- a/scribejava-apis/src/main/java/com/github/scribejava/apis/SimpleGeoApi.java +++ /dev/null @@ -1,27 +0,0 @@ -package com.github.scribejava.apis; - -import com.github.scribejava.core.builder.api.DefaultApi10a; -import com.github.scribejava.core.model.Token; - -/** - * @author Pablo Fernandez - */ -public class SimpleGeoApi extends DefaultApi10a { - - private static final String ENDPOINT = "these are not used since SimpleGeo uses 2 legged OAuth"; - - @Override - public String getRequestTokenEndpoint() { - return ENDPOINT; - } - - @Override - public String getAccessTokenEndpoint() { - return ENDPOINT; - } - - @Override - public String getAuthorizationUrl(final Token requestToken) { - return ENDPOINT; - } -} diff --git a/scribejava-apis/src/main/java/com/github/scribejava/apis/SinaWeiboApi.java b/scribejava-apis/src/main/java/com/github/scribejava/apis/SinaWeiboApi.java index 7f796eb47..9d69a9afc 100644 --- a/scribejava-apis/src/main/java/com/github/scribejava/apis/SinaWeiboApi.java +++ b/scribejava-apis/src/main/java/com/github/scribejava/apis/SinaWeiboApi.java @@ -1,13 +1,23 @@ package com.github.scribejava.apis; import com.github.scribejava.core.builder.api.DefaultApi10a; -import com.github.scribejava.core.model.Token; public class SinaWeiboApi extends DefaultApi10a { private static final String REQUEST_TOKEN_URL = "http://api.t.sina.com.cn/oauth/request_token"; private static final String ACCESS_TOKEN_URL = "http://api.t.sina.com.cn/oauth/access_token"; - private static final String AUTHORIZE_URL = "http://api.t.sina.com.cn/oauth/authorize?oauth_token=%s"; + private static final String AUTHORIZE_URL = "http://api.t.sina.com.cn/oauth/authorize"; + + protected SinaWeiboApi() { + } + + private static class InstanceHolder { + private static final SinaWeiboApi INSTANCE = new SinaWeiboApi(); + } + + public static SinaWeiboApi instance() { + return InstanceHolder.INSTANCE; + } @Override public String getRequestTokenEndpoint() { @@ -20,7 +30,7 @@ public String getAccessTokenEndpoint() { } @Override - public String getAuthorizationUrl(Token requestToken) { - return String.format(AUTHORIZE_URL, requestToken.getToken()); + public String getAuthorizationBaseUrl() { + return AUTHORIZE_URL; } } diff --git a/scribejava-apis/src/main/java/com/github/scribejava/apis/SinaWeiboApi20.java b/scribejava-apis/src/main/java/com/github/scribejava/apis/SinaWeiboApi20.java index 8f1ce73b2..19aa9f356 100644 --- a/scribejava-apis/src/main/java/com/github/scribejava/apis/SinaWeiboApi20.java +++ b/scribejava-apis/src/main/java/com/github/scribejava/apis/SinaWeiboApi20.java @@ -1,44 +1,37 @@ package com.github.scribejava.apis; import com.github.scribejava.core.builder.api.DefaultApi20; -import com.github.scribejava.core.extractors.AccessTokenExtractor; -import com.github.scribejava.core.extractors.JsonTokenExtractor; -import com.github.scribejava.core.model.OAuthConfig; -import com.github.scribejava.core.model.OAuthConstants; -import com.github.scribejava.core.model.Verb; -import com.github.scribejava.core.utils.OAuthEncoder; +import com.github.scribejava.core.oauth2.bearersignature.BearerSignature; +import com.github.scribejava.core.oauth2.bearersignature.BearerSignatureURIQueryParameter; /** * SinaWeibo OAuth 2.0 api. */ public class SinaWeiboApi20 extends DefaultApi20 { - private static final String AUTHORIZE_URL = "https://api.weibo.com/oauth2/authorize?client_id=%s&redirect_uri=%s&response_type=code"; - private static final String SCOPED_AUTHORIZE_URL = AUTHORIZE_URL + "&scope=%s"; + protected SinaWeiboApi20() { + } - @Override - public Verb getAccessTokenVerb() { - return Verb.POST; + private static class InstanceHolder { + private static final SinaWeiboApi20 INSTANCE = new SinaWeiboApi20(); } - @Override - public AccessTokenExtractor getAccessTokenExtractor() { - return new JsonTokenExtractor(); + public static SinaWeiboApi20 instance() { + return InstanceHolder.INSTANCE; } @Override public String getAccessTokenEndpoint() { - return "https://api.weibo.com/oauth2/access_token?grant_type=" + OAuthConstants.AUTHORIZATION_CODE; + return "https://api.weibo.com/oauth2/access_token"; + } + + @Override + protected String getAuthorizationBaseUrl() { + return "https://api.weibo.com/oauth2/authorize"; } @Override - public String getAuthorizationUrl(OAuthConfig config) { - // Append scope if present - if (config.hasScope()) { - return String.format(SCOPED_AUTHORIZE_URL, config.getApiKey(), OAuthEncoder.encode(config.getCallback()), OAuthEncoder.encode(config. - getScope())); - } else { - return String.format(AUTHORIZE_URL, config.getApiKey(), OAuthEncoder.encode(config.getCallback())); - } + public BearerSignature getBearerSignature() { + return BearerSignatureURIQueryParameter.instance(); } } diff --git a/scribejava-apis/src/main/java/com/github/scribejava/apis/SkyrockApi.java b/scribejava-apis/src/main/java/com/github/scribejava/apis/SkyrockApi.java index 74c368ca0..beb956a4a 100644 --- a/scribejava-apis/src/main/java/com/github/scribejava/apis/SkyrockApi.java +++ b/scribejava-apis/src/main/java/com/github/scribejava/apis/SkyrockApi.java @@ -1,21 +1,30 @@ package com.github.scribejava.apis; import com.github.scribejava.core.builder.api.DefaultApi10a; -import com.github.scribejava.core.model.Token; /** * OAuth API for Skyrock. * - * @author Nicolas Quiénot * @see Skyrock.com API */ public class SkyrockApi extends DefaultApi10a { private static final String API_ENDPOINT = "https://api.skyrock.com/v2"; private static final String REQUEST_TOKEN_RESOURCE = "/oauth/initiate"; - private static final String AUTHORIZE_URL = "/oauth/authorize?oauth_token=%s"; + private static final String AUTHORIZE_URL = "/oauth/authorize"; private static final String ACCESS_TOKEN_RESOURCE = "/oauth/token"; + protected SkyrockApi() { + } + + private static class InstanceHolder { + private static final SkyrockApi INSTANCE = new SkyrockApi(); + } + + public static SkyrockApi instance() { + return InstanceHolder.INSTANCE; + } + @Override public String getAccessTokenEndpoint() { return API_ENDPOINT + ACCESS_TOKEN_RESOURCE; @@ -27,7 +36,7 @@ public String getRequestTokenEndpoint() { } @Override - public String getAuthorizationUrl(Token requestToken) { - return String.format(API_ENDPOINT + AUTHORIZE_URL, requestToken.getToken()); + public String getAuthorizationBaseUrl() { + return API_ENDPOINT + AUTHORIZE_URL; } } diff --git a/scribejava-apis/src/main/java/com/github/scribejava/apis/SlackApi.java b/scribejava-apis/src/main/java/com/github/scribejava/apis/SlackApi.java new file mode 100644 index 000000000..4d834fff1 --- /dev/null +++ b/scribejava-apis/src/main/java/com/github/scribejava/apis/SlackApi.java @@ -0,0 +1,37 @@ +package com.github.scribejava.apis; + +import com.github.scribejava.apis.slack.SlackJsonTokenExtractor; +import com.github.scribejava.core.builder.api.DefaultApi20; + +/** + * Slack.com API + */ +public class SlackApi extends DefaultApi20 { + + protected SlackApi() { + } + + private static class InstanceHolder { + + private static final SlackApi INSTANCE = new SlackApi(); + } + + public static SlackApi instance() { + return SlackApi.InstanceHolder.INSTANCE; + } + + @Override + public String getAccessTokenEndpoint() { + return "https://slack.com/api/oauth.v2.access"; + } + + @Override + protected String getAuthorizationBaseUrl() { + return "https://slack.com/oauth/v2/authorize"; + } + + @Override + public SlackJsonTokenExtractor getAccessTokenExtractor() { + return SlackJsonTokenExtractor.instance(); + } +} diff --git a/scribejava-apis/src/main/java/com/github/scribejava/apis/SohuWeiboApi.java b/scribejava-apis/src/main/java/com/github/scribejava/apis/SohuWeiboApi.java deleted file mode 100644 index 6d56d5906..000000000 --- a/scribejava-apis/src/main/java/com/github/scribejava/apis/SohuWeiboApi.java +++ /dev/null @@ -1,26 +0,0 @@ -package com.github.scribejava.apis; - -import com.github.scribejava.core.builder.api.DefaultApi10a; -import com.github.scribejava.core.model.Token; - -public class SohuWeiboApi extends DefaultApi10a { - - private static final String REQUEST_TOKEN_URL = "http://api.t.sohu.com/oauth/request_token"; - private static final String ACCESS_TOKEN_URL = "http://api.t.sohu.com/oauth/access_token"; - private static final String AUTHORIZE_URL = "http://api.t.sohu.com/oauth/authorize?oauth_token=%s"; - - @Override - public String getRequestTokenEndpoint() { - return REQUEST_TOKEN_URL; - } - - @Override - public String getAccessTokenEndpoint() { - return ACCESS_TOKEN_URL; - } - - @Override - public String getAuthorizationUrl(Token requestToken) { - return String.format(AUTHORIZE_URL, requestToken.getToken()); - } -} diff --git a/scribejava-apis/src/main/java/com/github/scribejava/apis/StackExchangeApi.java b/scribejava-apis/src/main/java/com/github/scribejava/apis/StackExchangeApi.java new file mode 100644 index 000000000..3ba195460 --- /dev/null +++ b/scribejava-apis/src/main/java/com/github/scribejava/apis/StackExchangeApi.java @@ -0,0 +1,46 @@ +package com.github.scribejava.apis; + +import com.github.scribejava.core.builder.api.DefaultApi20; +import com.github.scribejava.core.extractors.OAuth2AccessTokenExtractor; +import com.github.scribejava.core.extractors.TokenExtractor; +import com.github.scribejava.core.model.OAuth2AccessToken; +import com.github.scribejava.core.oauth2.bearersignature.BearerSignature; +import com.github.scribejava.core.oauth2.bearersignature.BearerSignatureURIQueryParameter; + +/** + * Stack Exchange authentication via OAuth 2.0 (stackoverflow.com, + * askubuntu.com, etc.). + */ +public class StackExchangeApi extends DefaultApi20 { + + protected StackExchangeApi() { + } + + private static class InstanceHolder { + private static final StackExchangeApi INSTANCE = new StackExchangeApi(); + } + + public static StackExchangeApi instance() { + return InstanceHolder.INSTANCE; + } + + @Override + public String getAccessTokenEndpoint() { + return "https://stackexchange.com/oauth/access_token"; + } + + @Override + protected String getAuthorizationBaseUrl() { + return "https://stackexchange.com/oauth"; + } + + @Override + public TokenExtractor+ * MUST be present and set to "true". The parameter is used to differentiate from previous versions of the protocol. + *
+ */ + private final boolean oauthCallbackConfirmed; + + public OAuth1RequestToken(String token, String tokenSecret) { + this(token, tokenSecret, null); + } + + public OAuth1RequestToken(String token, String tokenSecret, String rawResponse) { + this(token, tokenSecret, true, rawResponse); + } + + public OAuth1RequestToken(String token, String tokenSecret, boolean oauthCallbackConfirmed, String rawResponse) { + super(token, tokenSecret, rawResponse); + this.oauthCallbackConfirmed = oauthCallbackConfirmed; + } + + /** + * The temporary credentials identifier. + * + * @return oauth_token + */ + @Override + public String getToken() { + return super.getToken(); + } + + /** + * The temporary credentials shared-secret. + * + * @return oauth_token_secret + */ + @Override + public String getTokenSecret() { + return super.getTokenSecret(); + } + + public boolean isOauthCallbackConfirmed() { + return oauthCallbackConfirmed; + } + + @Override + public int hashCode() { + int hash = 7; + hash = 83 * hash + Objects.hashCode(getToken()); + hash = 83 * hash + Objects.hashCode(getTokenSecret()); + hash = 83 * hash + (oauthCallbackConfirmed ? 1 : 0); + return hash; + } + + @Override + public boolean equals(Object obj) { + if (this == obj) { + return true; + } + if (obj == null) { + return false; + } + if (getClass() != obj.getClass()) { + return false; + } + final OAuth1RequestToken other = (OAuth1RequestToken) obj; + if (oauthCallbackConfirmed != other.isOauthCallbackConfirmed()) { + return false; + } + if (!Objects.equals(getToken(), other.getToken())) { + return false; + } + return Objects.equals(getTokenSecret(), other.getTokenSecret()); + } +} diff --git a/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth1Token.java b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth1Token.java new file mode 100644 index 000000000..3d02f49aa --- /dev/null +++ b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth1Token.java @@ -0,0 +1,38 @@ +package com.github.scribejava.core.model; + +import com.github.scribejava.core.utils.Preconditions; + +/** + * Represents an abstract OAuth 1 Token (either request or access token) + */ +public abstract class OAuth1Token extends Token { + + private static final long serialVersionUID = 6285873427974823019L; + + private final String token; + + private final String tokenSecret; + + public OAuth1Token(String token, String tokenSecret, String rawResponse) { + super(rawResponse); + Preconditions.checkNotNull(token, "oauth_token can't be null"); + Preconditions.checkNotNull(tokenSecret, "oauth_token_secret can't be null"); + this.token = token; + this.tokenSecret = tokenSecret; + } + + public String getToken() { + return token; + } + + public String getTokenSecret() { + return tokenSecret; + } + + /** + * @return true if the token is empty (oauth_token = "", oauth_token_secret = "") + */ + public boolean isEmpty() { + return "".equals(token) && "".equals(tokenSecret); + } +} diff --git a/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2AccessToken.java b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2AccessToken.java new file mode 100644 index 000000000..f02bc57c6 --- /dev/null +++ b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2AccessToken.java @@ -0,0 +1,132 @@ +package com.github.scribejava.core.model; + +import com.github.scribejava.core.utils.Preconditions; +import java.util.Objects; + +/** + * Represents an OAuth 2 Access token. + * http://tools.ietf.org/html/rfc6749#section-5.1 + * + * @see OAuth 2 Access Token Specification + */ +public class OAuth2AccessToken extends Token { + + private static final long serialVersionUID = 8901381135476613449L; + + /** + * access_token + *+ * REQUIRED. The access token issued by the authorization server.
+ */ + private String accessToken; + + /** + * token_type + *+ * REQUIRED. The type of the token issued as described in http://tools.ietf.org/html/rfc6749#section-7.1 Value is + * case insensitive.
+ */ + private String tokenType; + + /** + * expires_in + *+ * RECOMMENDED. The lifetime in seconds of the access token. For example, the value "3600" denotes that the access + * token will expire in one hour from the time the response was generated. If omitted, the authorization server + * SHOULD provide the expiration time via other means or document the default value.
+ */ + private Integer expiresIn; + + /** + * refresh_token + *+ * OPTIONAL. The refresh token, which can be used to obtain new access tokens using the same authorization grant as + * described in http://tools.ietf.org/html/rfc6749#section-6
+ */ + private String refreshToken; + + /** + * scope + *+ * OPTIONAL, if identical to the scope requested by the client; otherwise, REQUIRED. The scope of the access token + * as described by http://tools.ietf.org/html/rfc6749#section-3.3
+ */ + private String scope; + + public OAuth2AccessToken(String accessToken) { + this(accessToken, null); + } + + public OAuth2AccessToken(String accessToken, String rawResponse) { + this(accessToken, null, null, null, null, rawResponse); + } + + public OAuth2AccessToken(String accessToken, String tokenType, Integer expiresIn, String refreshToken, String scope, + String rawResponse) { + super(rawResponse); + Preconditions.checkNotNull(accessToken, "access_token can't be null"); + this.accessToken = accessToken; + this.tokenType = tokenType; + this.expiresIn = expiresIn; + this.refreshToken = refreshToken; + this.scope = scope; + } + + public String getAccessToken() { + return accessToken; + } + + public String getTokenType() { + return tokenType; + } + + public Integer getExpiresIn() { + return expiresIn; + } + + public String getRefreshToken() { + return refreshToken; + } + + public String getScope() { + return scope; + } + + @Override + public int hashCode() { + int hash = 7; + hash = 41 * hash + Objects.hashCode(accessToken); + hash = 41 * hash + Objects.hashCode(tokenType); + hash = 41 * hash + Objects.hashCode(expiresIn); + hash = 41 * hash + Objects.hashCode(refreshToken); + hash = 41 * hash + Objects.hashCode(scope); + return hash; + } + + @Override + public boolean equals(Object obj) { + if (this == obj) { + return true; + } + if (obj == null) { + return false; + } + if (getClass() != obj.getClass()) { + return false; + } + final OAuth2AccessToken other = (OAuth2AccessToken) obj; + if (!Objects.equals(accessToken, other.getAccessToken())) { + return false; + } + if (!Objects.equals(tokenType, other.getTokenType())) { + return false; + } + if (!Objects.equals(refreshToken, other.getRefreshToken())) { + return false; + } + if (!Objects.equals(scope, other.getScope())) { + return false; + } + return Objects.equals(expiresIn, other.getExpiresIn()); + } +} diff --git a/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2AccessTokenErrorResponse.java b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2AccessTokenErrorResponse.java new file mode 100644 index 000000000..5c4a65a19 --- /dev/null +++ b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2AccessTokenErrorResponse.java @@ -0,0 +1,39 @@ +package com.github.scribejava.core.model; + +import com.github.scribejava.core.oauth2.OAuth2Error; +import java.io.IOException; + +import java.net.URI; + +/** + * Representing "5.2. Error Response" + */ +public class OAuth2AccessTokenErrorResponse extends OAuthResponseException { + + private static final long serialVersionUID = 2309424849700276816L; + + private final OAuth2Error error; + private final String errorDescription; + private final URI errorUri; + + public OAuth2AccessTokenErrorResponse(OAuth2Error error, String errorDescription, URI errorUri, + Response rawResponse) throws IOException { + super(rawResponse); + this.error = error; + this.errorDescription = errorDescription; + this.errorUri = errorUri; + } + + public OAuth2Error getError() { + return error; + } + + public String getErrorDescription() { + return errorDescription; + } + + public URI getErrorUri() { + return errorUri; + } + +} diff --git a/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2Authorization.java b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2Authorization.java new file mode 100644 index 000000000..8c99f395b --- /dev/null +++ b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuth2Authorization.java @@ -0,0 +1,43 @@ +package com.github.scribejava.core.model; + +/** + * represents Authorization Response http://tools.ietf.org/html/rfc6749#section-4.1.2 + * + * If the resource owner grants the access request, the authorization server issues an authorization code and delivers + * it to the client by adding the following parameters to the query component of the redirection URI using the + * "application/x-www-form-urlencoded" format. + * + */ +public class OAuth2Authorization { + + /** + * REQUIRED. The authorization code generated by the authorization server. The authorization code MUST expire + * shortly after it is issued to mitigate the risk of leaks. A maximum authorization code lifetime of 10 minutes is + * RECOMMENDED. The client MUST NOT use the authorization code more than once. If an authorization code is used more + * than once, the authorization server MUST deny the request and SHOULD revoke (when possible) all tokens previously + * issued based on that authorization code. The authorization code is bound to the client identifier and redirection + * URI. + */ + private String code; + /** + * REQUIRED if the "state" parameter was present in the client authorization request. The exact value received from + * the client. + */ + private String state; + + public String getCode() { + return code; + } + + public void setCode(String code) { + this.code = code; + } + + public String getState() { + return state; + } + + public void setState(String state) { + this.state = state; + } +} diff --git a/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuthAsyncRequestCallback.java b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuthAsyncRequestCallback.java index 10f398fc4..7719314d2 100644 --- a/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuthAsyncRequestCallback.java +++ b/scribejava-core/src/main/java/com/github/scribejava/core/model/OAuthAsyncRequestCallback.java @@ -2,6 +2,11 @@ public interface OAuthAsyncRequestCallback
+ * This response may contain a non-null body stream of the HttpUrlConnection. If so, this body must be closed to avoid
+ * leaking resources. Use either {@link #getBody()} or {@link #close()} to close the body.
+ */
+public class Response implements Closeable {
- private int code;
- private String message;
+ private final int code;
+ private final String message;
+ private final Mapnull if the message can not be discerned from the response (not valid HTTP)
+ * Obtains the HTTP status message. Returns null if the message can not be discerned from the response
+ * (not valid HTTP)
*
* @return the status message
*/
@@ -106,17 +112,43 @@ public Map