org.shredzone.acme4j.connector

Class DefaultConnection

java.lang.Object

org.shredzone.acme4j.connector.DefaultConnection

All Implemented Interfaces:

AutoCloseable, Connection

public class DefaultConnection
extends Object
implements Connection

Default implementation of Connection.

Field Summary

Fields

Modifier and Type	Field and Description
protected HttpURLConnection	conn
protected HttpConnector	httpConnector

Constructor Summary

Constructors

Constructor and Description
DefaultConnection(HttpConnector httpConnector) Creates a new DefaultConnection.

Method Summary

Modifier and Type	Method and Description
int	accept(int... httpStatus) Checks if the HTTP response status is in the given list of acceptable HTTP states, otherwise raises an AcmeException matching the error.
void	close() Closes the Connection, releasing all resources.
URL	getLink(String relation) Gets a relation link from the header.
URI	getLinkAsURI(String relation) Gets a relation link from the header.
URL	getLocation() Gets a location from the Location header.
void	handleRetryAfter(String message) Throws an AcmeRetryAfterException if the last status was HTTP Accepted and a Retry-After header was received.
X509Certificate	readCertificate() Reads a certificate.
JSON	readJsonResponse() Reads a server response as JSON data.
void	sendRequest(URL url, Session session) Sends a simple GET request.
void	sendSignedRequest(URL url, JSONBuilder claims, Session session) Sends a signed POST request.
void	updateSession(Session session) Updates a Session by evaluating the HTTP response header.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

httpConnector

protected final HttpConnector httpConnector

conn

protected HttpURLConnection conn

Constructor Detail

DefaultConnection

public DefaultConnection(HttpConnector httpConnector)

Creates a new DefaultConnection.

Parameters:

httpConnector - HttpConnector to be used for HTTP connections

Method Detail

sendRequest

public void sendRequest(URL url,
                        Session session)
                 throws AcmeException

Description copied from interface: Connection

Sends a simple GET request.

Specified by:

sendRequest in interface Connection

Parameters:

url - URL to send the request to.

session - Session instance to be used for tracking

Throws:

AcmeException

sendSignedRequest

public void sendSignedRequest(URL url,
                              JSONBuilder claims,
                              Session session)
                       throws AcmeException

Description copied from interface: Connection

Sends a signed POST request.

Specified by:

sendSignedRequest in interface Connection

Parameters:

url - URL to send the request to.

claims - JSONBuilder containing claims. Must not be null.

session - Session instance to be used for signing and tracking

Throws:

AcmeException

accept

public int accept(int... httpStatus)
           throws AcmeException

Description copied from interface: Connection

Checks if the HTTP response status is in the given list of acceptable HTTP states, otherwise raises an AcmeException matching the error.

Specified by:

accept in interface Connection

Parameters:

httpStatus - Acceptable HTTP states

Returns:

Actual HTTP status that was accepted

Throws:

AcmeException

readJsonResponse

public JSON readJsonResponse()
                      throws AcmeException

Description copied from interface: Connection

Reads a server response as JSON data.

Specified by:

readJsonResponse in interface Connection

Returns:

The JSON response

Throws:

AcmeException

readCertificate

public X509Certificate readCertificate()
                                throws AcmeException

Description copied from interface: Connection

Reads a certificate.

Specified by:

readCertificate in interface Connection

Returns:

X509Certificate that was read.

Throws:

AcmeException

handleRetryAfter

public void handleRetryAfter(String message)
                      throws AcmeException

Description copied from interface: Connection

Throws an AcmeRetryAfterException if the last status was HTTP Accepted and a Retry-After header was received.

Specified by:

handleRetryAfter in interface Connection

Parameters:

message - Message to be sent along with the AcmeRetryAfterException

Throws:

AcmeException

updateSession

public void updateSession(Session session)

Description copied from interface: Connection

Updates a Session by evaluating the HTTP response header.

Specified by:

updateSession in interface Connection

Parameters:

session - Session instance to be updated

getLocation

public URL getLocation()

Description copied from interface: Connection

Gets a location from the Location header.

Relative links are resolved against the last request's URL.

Specified by:

getLocation in interface Connection

Returns:

Location URL, or null if no Location header was set

getLink

public URL getLink(String relation)

Description copied from interface: Connection

Gets a relation link from the header.

Relative links are resolved against the last request's URL. If there is more than one relation, the first one is returned.

Specified by:

getLink in interface Connection

Parameters:

relation - Link relation

Returns:

Link URL, or null if there was no such relation link

getLinkAsURI

public URI getLinkAsURI(String relation)

Description copied from interface: Connection

Gets a relation link from the header.

Relative links are resolved against the last request's URL. If there is more than one relation, the first one is returned.

Specified by:

getLinkAsURI in interface Connection

Parameters:

relation - Link relation

Returns:

Link URI, or null if there was no such relation link

close

public void close()

Description copied from interface: Connection

Closes the Connection, releasing all resources.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Connection