Package org.shredzone.acme4j.toolbox

Class TestUtils

java.lang.Object

org.shredzone.acme4j.toolbox.TestUtils

public final class TestUtils
extends Object

Some utility methods for unit tests.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ACCOUNT_URL
static final String	ACME_SERVER_URI
static final String	CERT_ISSUER
static final String	D_E
static final String	D_KTY
static final String	D_N
static final String	D_THUMBPRINT
static final NetworkSettings	DEFAULT_NETWORK_SETTINGS
static final String	DUMMY_NONCE
static final String	E
static final String	KTY
static final String	N
static final String	THUMBPRINT

Method Summary

Modifier and Type	Method	Description
static List<X509Certificate>	createCertificate(String resource)	Creates a standard certificate chain for testing.
static KeyPair	createDomainKeyPair()	Creates a standard domain key pair for testing.
static KeyPair	createECKeyPair(String name)	Creates a random ECC key pair with the given curve name.
static KeyPair	createKeyPair()	Creates a standard account KeyPair for testing.
static Problem	createProblem(URI type, String detail, URL instance)	Creates a Problem with the given type and details.
static SecretKey	createSecretKey(String algorithm)	Creates a HMAC key using the given hash algorithm.
static JSON	getJSON(String key)	Reads a JSON string from json test files and parses it.
static byte[]	getResourceAsByteArray(String name)	Reads a resource as byte array.
static Login	login()	Creates a Login instance.
static void	main(String... args)	Generates a new keypair for unit tests, and return its N, E, KTY and THUMBPRINT parameters to be set in the TestUtils class.
static Session	session()	Creates a Session instance.
static Session	session(AcmeProvider provider)	Creates a Session instance.
static URL	url(String url)	Creates an URL from a String.

Methods inherited from class java.lang.Object

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

Field Details

N

public static final String N

See Also:

• Constant Field Values

E

public static final String E

See Also:

• Constant Field Values

KTY

public static final String KTY

See Also:

• Constant Field Values

THUMBPRINT

public static final String THUMBPRINT

See Also:

• Constant Field Values

D_N

public static final String D_N

See Also:

• Constant Field Values

D_E

public static final String D_E

See Also:

• Constant Field Values

D_KTY

public static final String D_KTY

See Also:

• Constant Field Values

D_THUMBPRINT

public static final String D_THUMBPRINT

See Also:

• Constant Field Values

ACME_SERVER_URI

public static final String ACME_SERVER_URI

See Also:

• Constant Field Values

ACCOUNT_URL

public static final String ACCOUNT_URL

See Also:

• Constant Field Values

DUMMY_NONCE

public static final String DUMMY_NONCE

CERT_ISSUER

public static final String CERT_ISSUER

See Also:

• Constant Field Values

DEFAULT_NETWORK_SETTINGS

public static final NetworkSettings DEFAULT_NETWORK_SETTINGS

Method Details

getResourceAsByteArray

public static byte[] getResourceAsByteArray(String name)
                                     throws IOException

Reads a resource as byte array.

Parameters:

name - Resource name

Returns:

Resource content as byte array.

Throws:

IOException

getJSON

public static JSON getJSON(String key)

Reads a JSON string from json test files and parses it.

Parameters:

key - JSON resource

Returns:

Parsed JSON resource

session

public static Session session()

Creates a Session instance. It uses ACME_SERVER_URI as server URI.

login

public static Login login()

Creates a Login instance. It uses ACME_SERVER_URI as server URI, ACCOUNT_URL as account URL, and a random key pair.

url

public static URL url(String url)

Creates an URL from a String. Only throws a runtime exception if the URL is malformed.

Parameters:

url - URL to use

Returns:

URL object

session

public static Session session(AcmeProvider provider)

Creates a Session instance. It uses ACME_SERVER_URI as server URI.

Parameters:

provider - AcmeProvider to be used in this session

createKeyPair

public static KeyPair createKeyPair()
                             throws IOException

Creates a standard account KeyPair for testing. The key pair is read from a test resource and is guaranteed not to change between test runs.

The constants N, E, KTY and THUMBPRINT are related to the returned key pair and can be used for asserting results.

Returns:

KeyPair for testing

Throws:

IOException

createDomainKeyPair

public static KeyPair createDomainKeyPair()
                                   throws IOException

Creates a standard domain key pair for testing. This keypair is read from a test resource and is guaranteed not to change between test runs.

The constants D_N, D_E, D_KTY and D_THUMBPRINT are related to the returned key pair and can be used for asserting results.

Returns:

KeyPair for testing

Throws:

IOException

createECKeyPair

public static KeyPair createECKeyPair(String name)
                               throws IOException

Creates a random ECC key pair with the given curve name.

Parameters:

name - Curve name

Returns:

KeyPair for testing

Throws:

IOException

createSecretKey

public static SecretKey createSecretKey(String algorithm)
                                 throws IOException

Creates a HMAC key using the given hash algorithm.

Parameters:

algorithm - Name of the hash algorithm to be used

Returns:

SecretKey for testing

Throws:

IOException

createCertificate

public static List<X509Certificate> createCertificate(String resource)
                                               throws IOException

Creates a standard certificate chain for testing. This certificate is read from a test resource and is guaranteed not to change between test runs.

Parameters:

resource - Name of the resource

Returns:

List of X509Certificate for testing

Throws:

IOException

createProblem

public static Problem createProblem(URI type,
 String detail,
 @Nullable
 URL instance)

Creates a Problem with the given type and details.

Parameters:

type - Problem type

detail - Problem details

instance - Instance, or null

Returns:

Created Problem object

main

public static void main(String... args)
                 throws Exception

Generates a new keypair for unit tests, and return its N, E, KTY and THUMBPRINT parameters to be set in the TestUtils class.

Throws:

Exception