com.nimbusds.jwt

Class JWTClaimsSet

java.lang.Object

com.nimbusds.jwt.JWTClaimsSet

All Implemented Interfaces:

Serializable

@Immutable
public final class JWTClaimsSet
extends Object
implements Serializable

JSON Web Token (JWT) claims set. This class is immutable.

Supports all getRegisteredNames() registered claims} of the JWT specification:

• iss - Issuer
• sub - Subject
• aud - Audience
• exp - Expiration Time
• nbf - Not Before
• iat - Issued At
• jti - JWT ID

The set may also contain custom claims; these will be serialised and parsed along the registered ones.

Example JWT claims set:

 {
   "sub"                        : "joe",
   "exp"                        : 1300819380,
   "http://example.com/is_root" : true
 }
 

Example usage:

 JWTClaimsSet claimsSet = new JWTClaimsSet.Builder()
     .subject("joe")
     .expirationDate(new Date(1300819380 * 1000l)
     .claim("http://example.com/is_root", true)
     .build();
 

Version:

2016-04-10

Author:

Vladimir Dzhuvinov, Justin Richer

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JWTClaimsSet.Builder Builder for constructing JSON Web Token (JWT) claims sets.

Method Summary

Modifier and Type	Method and Description
List<String>	getAudience() Gets the audience (aud) clam.
Boolean	getBooleanClaim(String name) Gets the specified claim (registered or custom) as Boolean.
Object	getClaim(String name) Gets the specified claim (registered or custom).
Map<String,Object>	getClaims() Gets the claims (registered and custom).
Date	getDateClaim(String name) Gets the specified claim (registered or custom) as Date.
Double	getDoubleClaim(String name) Gets the specified claim (registered or custom) as Double.
Date	getExpirationTime() Gets the expiration time (exp) claim.
Float	getFloatClaim(String name) Gets the specified claim (registered or custom) as Float.
Integer	getIntegerClaim(String name) Gets the specified claim (registered or custom) as Integer.
String	getIssuer() Gets the issuer (iss) claim.
Date	getIssueTime() Gets the issued-at (iat) claim.
net.minidev.json.JSONObject	getJSONObjectClaim(String name) Gets the specified claim (registered or custom) as a JSONObject.
String	getJWTID() Gets the JWT ID (jti) claim.
Long	getLongClaim(String name) Gets the specified claim (registered or custom) as Long.
Date	getNotBeforeTime() Gets the not-before (nbf) claim.
static Set<String>	getRegisteredNames() Gets the registered JWT claim names.
String[]	getStringArrayClaim(String name) Gets the specified claims (registered or custom) as a String array.
String	getStringClaim(String name) Gets the specified claim (registered or custom) as String.
List<String>	getStringListClaim(String name) Gets the specified claims (registered or custom) as a List list of strings.
String	getSubject() Gets the subject (sub) claim.
static JWTClaimsSet	parse(net.minidev.json.JSONObject json) Parses a JSON Web Token (JWT) claims set from the specified JSON object representation.
static JWTClaimsSet	parse(String s) Parses a JSON Web Token (JWT) claims set from the specified JSON object string representation.
net.minidev.json.JSONObject	toJSONObject() Returns the JSON object representation of the claims set.
String	toString()
<T> T	toType(JWTClaimsSetTransformer<T> transformer) Returns a transformation of this JWT claims set.

Methods inherited from class java.lang.Object

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

Method Detail

getRegisteredNames

public static Set<String> getRegisteredNames()

Gets the registered JWT claim names.

Returns:

The registered claim names, as a unmodifiable set.

getIssuer

public String getIssuer()

Gets the issuer (iss) claim.

Returns:

The issuer claim, null if not specified.

getSubject

public String getSubject()

Gets the subject (sub) claim.

Returns:

The subject claim, null if not specified.

getAudience

public List<String> getAudience()

Gets the audience (aud) clam.

Returns:

The audience claim, empty list if not specified.

getExpirationTime

public Date getExpirationTime()

Gets the expiration time (exp) claim.

Returns:

The expiration time, null if not specified.

getNotBeforeTime

public Date getNotBeforeTime()

Gets the not-before (nbf) claim.

Returns:

The not-before claim, null if not specified.

getIssueTime

public Date getIssueTime()

Gets the issued-at (iat) claim.

Returns:

The issued-at claim, null if not specified.

getJWTID

public String getJWTID()

Gets the JWT ID (jti) claim.

Returns:

The JWT ID claim, null if not specified.

getClaim

public Object getClaim(String name)

Gets the specified claim (registered or custom).

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

getStringClaim

public String getStringClaim(String name)
                      throws ParseException

Gets the specified claim (registered or custom) as String.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getStringArrayClaim

public String[] getStringArrayClaim(String name)
                             throws ParseException

Gets the specified claims (registered or custom) as a String array.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getStringListClaim

public List<String> getStringListClaim(String name)
                                throws ParseException

Gets the specified claims (registered or custom) as a List list of strings.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getBooleanClaim

public Boolean getBooleanClaim(String name)
                        throws ParseException

Gets the specified claim (registered or custom) as Boolean.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getIntegerClaim

public Integer getIntegerClaim(String name)
                        throws ParseException

Gets the specified claim (registered or custom) as Integer.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getLongClaim

public Long getLongClaim(String name)
                  throws ParseException

Gets the specified claim (registered or custom) as Long.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getDateClaim

public Date getDateClaim(String name)
                  throws ParseException

Gets the specified claim (registered or custom) as Date. The claim may be represented by a Date object or a number of a seconds since the Unix epoch.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getFloatClaim

public Float getFloatClaim(String name)
                    throws ParseException

Gets the specified claim (registered or custom) as Float.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getDoubleClaim

public Double getDoubleClaim(String name)
                      throws ParseException

Gets the specified claim (registered or custom) as Double.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getJSONObjectClaim

public net.minidev.json.JSONObject getJSONObjectClaim(String name)
                                               throws ParseException

Gets the specified claim (registered or custom) as a JSONObject.

Parameters:

name - The name of the claim. Must not be null.

Returns:

The value of the claim, null if not specified.

Throws:

ParseException - If the claim value is not of the required type.

getClaims

public Map<String,Object> getClaims()

Gets the claims (registered and custom).

Note that the registered claims Expiration-Time (exp), Not-Before-Time (nbf) and Issued-At (iat) will be returned as java.util.Date instances.

Returns:

The claims, as an unmodifiable map, empty map if none.

toJSONObject

public net.minidev.json.JSONObject toJSONObject()

Returns the JSON object representation of the claims set. The claims are serialised according to their insertion order.

Returns:

The JSON object representation.

toString

public String toString()

Overrides:

toString in class Object

toType

public <T> T toType(JWTClaimsSetTransformer<T> transformer)

Returns a transformation of this JWT claims set.

Type Parameters:

T - Type of the result.

Parameters:

transformer - The JWT claims set transformer. Must not be null.

Returns:

The transformed JWT claims set.

parse

public static JWTClaimsSet parse(net.minidev.json.JSONObject json)
                          throws ParseException

Parses a JSON Web Token (JWT) claims set from the specified JSON object representation.

Parameters:

json - The JSON object to parse. Must not be null.

Returns:

The JWT claims set.

Throws:

ParseException - If the specified JSON object doesn't represent a valid JWT claims set.

parse

public static JWTClaimsSet parse(String s)
                          throws ParseException

Parses a JSON Web Token (JWT) claims set from the specified JSON object string representation.

Parameters:

s - The JSON object string to parse. Must not be null.

Returns:

The JWT claims set.

Throws:

ParseException - If the specified JSON object string doesn't represent a valid JWT claims set.