io.jsonwebtoken

Interface Claims

All Superinterfaces:

ClaimsMutator<Claims>, Map<String,Object>

All Known Implementing Classes:

DefaultClaims

public interface Claims
extends Map<String,Object>, ClaimsMutator<Claims>

A JWT Claims set.

This is ultimately a JSON map and any values can be added to it, but JWT standard names are provided as type-safe getters and setters for convenience.

Because this interface extends Map<String, Object>, if you would like to add your own properties, you simply use map methods, for example:

 claims.put("someKey", "someValue");
 

Creation

It is easiest to create a Claims instance by calling one of the JWTs.claims() factory methods.

Since:

0.1

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
static String	AUDIENCE JWT Audience claims parameter name: "aud"
static String	EXPIRATION JWT Expiration claims parameter name: "exp"
static String	ID JWT JWT ID claims parameter name: "jti"
static String	ISSUED_AT JWT Issued At claims parameter name: "iat"
static String	ISSUER JWT Issuer claims parameter name: "iss"
static String	NOT_BEFORE JWT Not Before claims parameter name: "nbf"
static String	SUBJECT JWT Subject claims parameter name: "sub"

Method Summary

Modifier and Type	Method and Description
<T> T	get(String claimName, Class<T> requiredType)
String	getAudience() Returns the JWT aud (audience) value or null if not present.
Date	getExpiration() Returns the JWT exp (expiration) timestamp or null if not present.
String	getId() Returns the JWTs jti (JWT ID) value or null if not present.
Date	getIssuedAt() Returns the JWT iat (issued at) timestamp or null if not present.
String	getIssuer() Returns the JWT iss (issuer) value or null if not present.
Date	getNotBefore() Returns the JWT nbf (not before) timestamp or null if not present.
String	getSubject() Returns the JWT sub (subject) value or null if not present.
Claims	setAudience(String aud) Sets the JWT aud (audience) value.
Claims	setExpiration(Date exp) Sets the JWT exp (expiration) timestamp.
Claims	setId(String jti) Sets the JWT jti (JWT ID) value.
Claims	setIssuedAt(Date iat) Sets the JWT iat (issued at) timestamp.
Claims	setIssuer(String iss) Sets the JWT iss (issuer) value.
Claims	setNotBefore(Date nbf) Sets the JWT nbf (not before) timestamp.
Claims	setSubject(String sub) Sets the JWT sub (subject) value.

Methods inherited from interface java.util.Map

clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Field Detail

ISSUER

static final String ISSUER

JWT Issuer claims parameter name: "iss"

See Also:

Constant Field Values

SUBJECT

static final String SUBJECT

JWT Subject claims parameter name: "sub"

See Also:

Constant Field Values

AUDIENCE

static final String AUDIENCE

JWT Audience claims parameter name: "aud"

See Also:

Constant Field Values

EXPIRATION

static final String EXPIRATION

JWT Expiration claims parameter name: "exp"

See Also:

Constant Field Values

NOT_BEFORE

static final String NOT_BEFORE

JWT Not Before claims parameter name: "nbf"

See Also:

Constant Field Values

ISSUED_AT

static final String ISSUED_AT

JWT Issued At claims parameter name: "iat"

See Also:

Constant Field Values

ID

static final String ID

JWT JWT ID claims parameter name: "jti"

See Also:

Constant Field Values

Method Detail

getIssuer

String getIssuer()

Returns the JWT iss (issuer) value or null if not present.

Returns:

the JWT iss value or null if not present.

setIssuer

Claims setIssuer(String iss)

Sets the JWT iss (issuer) value. A null value will remove the property from the JSON map.

Specified by:

setIssuer in interface ClaimsMutator<Claims>

Parameters:

iss - the JWT iss value or null to remove the property from the JSON map.

Returns:

the Claims instance for method chaining.

getSubject

String getSubject()

Returns the JWT sub (subject) value or null if not present.

Returns:

the JWT sub value or null if not present.

setSubject

Claims setSubject(String sub)

Sets the JWT sub (subject) value. A null value will remove the property from the JSON map.

Specified by:

setSubject in interface ClaimsMutator<Claims>

Parameters:

sub - the JWT sub value or null to remove the property from the JSON map.

Returns:

the Claims instance for method chaining.

getAudience

String getAudience()

Returns the JWT aud (audience) value or null if not present.

Returns:

the JWT aud value or null if not present.

setAudience

Claims setAudience(String aud)

Sets the JWT aud (audience) value. A null value will remove the property from the JSON map.

Specified by:

setAudience in interface ClaimsMutator<Claims>

Parameters:

aud - the JWT aud value or null to remove the property from the JSON map.

Returns:

the Claims instance for method chaining.

getExpiration

Date getExpiration()

Returns the JWT exp (expiration) timestamp or null if not present.

A JWT obtained after this timestamp should not be used.

Returns:

the JWT exp value or null if not present.

setExpiration

Claims setExpiration(Date exp)

Sets the JWT exp (expiration) timestamp. A null value will remove the property from the JSON map.

A JWT obtained after this timestamp should not be used.

Specified by:

setExpiration in interface ClaimsMutator<Claims>

Parameters:

exp - the JWT exp value or null to remove the property from the JSON map.

Returns:

the Claims instance for method chaining.

getNotBefore

Date getNotBefore()

Returns the JWT nbf (not before) timestamp or null if not present.

A JWT obtained before this timestamp should not be used.

Returns:

the JWT nbf value or null if not present.

setNotBefore

Claims setNotBefore(Date nbf)

Sets the JWT nbf (not before) timestamp. A null value will remove the property from the JSON map.

A JWT obtained before this timestamp should not be used.

Specified by:

setNotBefore in interface ClaimsMutator<Claims>

Parameters:

nbf - the JWT nbf value or null to remove the property from the JSON map.

Returns:

the Claims instance for method chaining.

getIssuedAt

Date getIssuedAt()

Returns the JWT iat (issued at) timestamp or null if not present.

If present, this value is the timestamp when the JWT was created.

Returns:

the JWT nbf value or null if not present.

setIssuedAt

Claims setIssuedAt(Date iat)

Sets the JWT iat (issued at) timestamp. A null value will remove the property from the JSON map.

The value is the timestamp when the JWT was created.

Specified by:

setIssuedAt in interface ClaimsMutator<Claims>

Parameters:

iat - the JWT iat value or null to remove the property from the JSON map.

Returns:

the Claims instance for method chaining.

getId

String getId()

Returns the JWTs jti (JWT ID) value or null if not present.

This value is a CaSe-SenSiTiVe unique identifier for the JWT. If available, this value is expected to be assigned in a manner that ensures that there is a negligible probability that the same value will be accidentally assigned to a different data object. The ID can be used to prevent the JWT from being replayed.

Returns:

the JWT jti value or null if not present.

setId

Claims setId(String jti)

Sets the JWT jti (JWT ID) value. A null value will remove the property from the JSON map.

This value is a CaSe-SenSiTiVe unique identifier for the JWT. If specified, this value MUST be assigned in a manner that ensures that there is a negligible probability that the same value will be accidentally assigned to a different data object. The ID can be used to prevent the JWT from being replayed.

Specified by:

setId in interface ClaimsMutator<Claims>

Parameters:

jti - the JWT jti value or null to remove the property from the JSON map.

Returns:

the Claims instance for method chaining.

get

<T> T get(String claimName,
          Class<T> requiredType)