Class RequestIds

java.lang.Object

zeroecho.pki.server.http.RequestIds

public final class RequestIds
extends Object

Strict opaque request-correlation identity policy.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	HEADER	HTTP header carrying the opaque correlation identifier.

Method Summary

Modifier and Type	Method	Description
String	resolve(List<String> supplied)	Validates a supplied correlation identifier or generates a random one.

Methods inherited from class Object

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

Field Details

HEADER

public static final String HEADER

HTTP header carrying the opaque correlation identifier.

See Also:

• Constant Field Values

Method Details

resolve

public String resolve(List<String> supplied)

Validates a supplied correlation identifier or generates a random one. This identifier conveys no authentication or authorization.

Parameters:

supplied - header values; null or empty requests a fresh identifier

Returns:

the single supplied identifier or a new 144-bit URL-safe identifier

Throws:

IllegalArgumentException - if multiple values are supplied, or the value is not 16–128 ASCII letters, digits, underscores or hyphens

NullPointerException - if the sole supplied value is null