Module org.shredzone.acme4j

Package 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	Description
protected HttpURLConnection	conn
protected final HttpConnector	httpConnector

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the Connection, releasing all resources.
Optional<ZonedDateTime>	getExpiration()	Returns the expiration date of the resource, if present.
Optional<ZonedDateTime>	getLastModified()	Returns the content of the last-modified header, if present.
Collection<URL>	getLinks(String relation)	Gets one or more relation links from the header.
URL	getLocation()	Gets a location from the Location header.
String	getNonce()	Gets the nonce from the nonce header.
void	handleRetryAfter(String message)	Throws an AcmeRetryAfterException if the last status was HTTP Accepted and a Retry-After header was received.
List<X509Certificate>	readCertificates()	Reads a certificate and its issuers.
JSON	readJsonResponse()	Reads a server response as JSON data.
void	resetNonce(Session session)	Resets the session nonce, by fetching a new one.
int	sendCertificateRequest(URL url, Login login)	Sends a signed POST-as-GET request for a certificate resource.
protected int	sendRequest(URL url, Session session, String accept, ZonedDateTime ifModifiedSince)	Sends an unsigned GET request.
int	sendRequest(URL url, Session session, ZonedDateTime ifModifiedSince)	Sends a simple GET request.
int	sendSignedPostAsGetRequest(URL url, Login login)	Sends a signed POST-as-GET request.
int	sendSignedRequest(URL url, JSONBuilder claims, Login login)	Sends a signed POST request.
int	sendSignedRequest(URL url, JSONBuilder claims, Session session, KeyPair keypair)	Sends a signed POST request.
protected int	sendSignedRequest(URL url, JSONBuilder claims, Session session, KeyPair keypair, URL accountLocation, String accept)	Sends a signed POST request.

Methods inherited from class java.lang.Object

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

Field Details

httpConnector

protected final HttpConnector httpConnector

conn

@Nullable
protected HttpURLConnection conn

Constructor Details

DefaultConnection

public DefaultConnection(HttpConnector httpConnector)

Creates a new DefaultConnection.

Parameters:

httpConnector - HttpConnector to be used for HTTP connections

Method Details

resetNonce

public void resetNonce(Session session)
                throws AcmeException

Description copied from interface: Connection

Resets the session nonce, by fetching a new one.

Specified by:

resetNonce in interface Connection

Parameters:

session - Session instance to fetch a nonce for

Throws:

AcmeException

sendRequest

public int sendRequest(URL url,
 Session session,
 @Nullable
 ZonedDateTime ifModifiedSince)
                throws AcmeException

Description copied from interface: Connection

Sends a simple GET request.

If the response code was not HttpURLConnection.HTTP_OK, an AcmeException matching the error is raised.

Specified by:

sendRequest in interface Connection

Parameters:

url - URL to send the request to.

session - Session instance to be used for tracking

ifModifiedSince - ZonedDateTime to be sent as "If-Modified-Since" header, or null if this header is not to be used

Returns:

HTTP status that was returned

Throws:

AcmeException

sendCertificateRequest

public int sendCertificateRequest(URL url,
 Login login)
                           throws AcmeException

Description copied from interface: Connection

Sends a signed POST-as-GET request for a certificate resource. Requires a Login for the session and KeyPair. The Login account location is sent in a "kid" protected header.

If the server does not return a 200 class status code, an AcmeException is raised matching the error.

Specified by:

sendCertificateRequest in interface Connection

Parameters:

url - URL to send the request to.

login - Login instance to be used for signing and tracking.

Returns:

HTTP 200 class status that was returned

Throws:

AcmeException

sendSignedPostAsGetRequest

public int sendSignedPostAsGetRequest(URL url,
 Login login)
                               throws AcmeException

Description copied from interface: Connection

Sends a signed POST-as-GET request. Requires a Login for the session and KeyPair. The Login account location is sent in a "kid" protected header.

If the server does not return a 200 class status code, an AcmeException is raised matching the error.

Specified by:

sendSignedPostAsGetRequest in interface Connection

Parameters:

url - URL to send the request to.

login - Login instance to be used for signing and tracking.

Returns:

HTTP 200 class status that was returned

Throws:

AcmeException

sendSignedRequest

public int sendSignedRequest(URL url,
 JSONBuilder claims,
 Login login)
                      throws AcmeException

Description copied from interface: Connection

Sends a signed POST request. Requires a Login for the session and KeyPair. The Login account location is sent in a "kid" protected header.

If the server does not return a 200 class status code, an AcmeException is raised matching the error.

Specified by:

sendSignedRequest in interface Connection

Parameters:

url - URL to send the request to.

claims - JSONBuilder containing claims.

login - Login instance to be used for signing and tracking.

Returns:

HTTP 200 class status that was returned

Throws:

AcmeException

sendSignedRequest

public int sendSignedRequest(URL url,
 JSONBuilder claims,
 Session session,
 KeyPair keypair)
                      throws AcmeException

Description copied from interface: Connection

Sends a signed POST request. Only requires a Session. The KeyPair is sent in a "jwk" protected header field.

If the server does not return a 200 class status code, an AcmeException is raised matching the error.

Specified by:

sendSignedRequest in interface Connection

Parameters:

url - URL to send the request to.

claims - JSONBuilder containing claims.

session - Session instance to be used for tracking.

keypair - KeyPair to be used for signing.

Returns:

HTTP 200 class status that was returned

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

readCertificates

public List<X509Certificate> readCertificates()
                                       throws AcmeException

Description copied from interface: Connection

Reads a certificate and its issuers.

Specified by:

readCertificates in interface Connection

Returns:

List of X.509 certificate and chain 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

getNonce

@Nullable
public String getNonce()

Description copied from interface: Connection

Gets the nonce from the nonce header.

Specified by:

getNonce in interface Connection

Returns:

Base64 encoded nonce, or null if no nonce header was set

getLocation

@Nullable
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

getLastModified

public Optional<ZonedDateTime> getLastModified()

Description copied from interface: Connection

Returns the content of the last-modified header, if present.

Specified by:

getLastModified in interface Connection

Returns:

Date in the Last-Modified header, or empty if the server did not provide this information.

getExpiration

public Optional<ZonedDateTime> getExpiration()

Description copied from interface: Connection

Returns the expiration date of the resource, if present.

Specified by:

getExpiration in interface Connection

Returns:

Expiration date, either from the Cache-Control or Expires header. If empty, the server did not provide an expiration date, or forbid caching.

getLinks

public Collection<URL> getLinks(String relation)

Description copied from interface: Connection

Gets one or more relation links from the header. The result is expected to be an URL.

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

Specified by:

getLinks in interface Connection

Parameters:

relation - Link relation

Returns:

Collection of links. Empty if there was no such relation.

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

sendRequest

protected int sendRequest(URL url,
 Session session,
 String accept,
 @Nullable
 ZonedDateTime ifModifiedSince)
                   throws AcmeException

Sends an unsigned GET request.

Parameters:

url - URL to send the request to.

session - Session instance to be used for signing and tracking

accept - Accept header

ifModifiedSince - Set an If-Modified-Since header with the given date. If set, an NOT_MODIFIED response is accepted as valid.

Returns:

HTTP 200 class status that was returned

Throws:

AcmeException

sendSignedRequest

protected int sendSignedRequest(URL url,
 @Nullable
 JSONBuilder claims,
 Session session,
 KeyPair keypair,
 @Nullable
 URL accountLocation,
 String accept)
                         throws AcmeException

Sends a signed POST request.

Parameters:

url - URL to send the request to.

claims - JSONBuilder containing claims. null for POST-as-GET request.

session - Session instance to be used for signing and tracking

keypair - KeyPair to be used for signing

accountLocation - If set, the account location is set as "kid" header. If null, the public key is set as "jwk" header.

accept - Accept header

Returns:

HTTP 200 class status that was returned

Throws:

AcmeException