JWTClaimsSet (Nimbus JOSE + JWT v5.1)

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:

2018-08-23

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.

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

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`List<String>`	`getAudience()` Gets the audience (`aud`) claim.
`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.
`URI`	`getURIClaim(String name)` Gets the specified claim (registered or custom) as a `URI`.
`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) claim.
    
    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.
  - getURIClaim
```
public URI getURIClaim(String name)
                throws ParseException
```
    Gets the specified claim (registered or custom) as a URI.
    
    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 couldn't be parsed to a URI.
  - 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.

Class JWTClaimsSet

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getRegisteredNames

getIssuer

getSubject

getAudience

getExpirationTime

getNotBeforeTime

getIssueTime

getJWTID

getClaim

getStringClaim

getStringArrayClaim

getStringListClaim

getURIClaim

getBooleanClaim

getIntegerClaim

getLongClaim

getDateClaim

getFloatClaim

getDoubleClaim

getJSONObjectClaim

getClaims

toJSONObject

toString

toType

parse

parse