com.nimbusds.openid.connect.sdk.claims

Class ClaimsSet

java.lang.Object

com.nimbusds.openid.connect.sdk.claims.ClaimsSet

Direct Known Subclasses:

Address, IDTokenClaimsSet, UserInfo

public abstract class ClaimsSet
extends java.lang.Object

Claims set serialisable to a JSON object.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ClaimsSet() Creates a new empty claims set.
protected	ClaimsSet(net.minidev.json.JSONObject jsonObject) Creates a new claims set from the specified JSON object.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Boolean	getBooleanClaim(java.lang.String name) Gets a boolean-based claim.
java.lang.Object	getClaim(java.lang.String name) Gets a claim.
<T> T	getClaim(java.lang.String name, java.lang.Class<T> clazz) Gets a claim that casts to the specified class.
java.util.Date	getDateClaim(java.lang.String name) Gets a date / time based claim, represented as the number of seconds from 1970-01-01T0:0:0Z as measured in UTC until the date / time.
javax.mail.internet.InternetAddress	getEmailClaim(java.lang.String name) Gets an email string based claim.
<T> java.util.Map<com.nimbusds.langtag.LangTag,T>	getLangTaggedClaim(java.lang.String name, java.lang.Class<T> clazz) Returns a map of all instances, including language-tagged, of a claim with the specified base name.
java.lang.Number	getNumberClaim(java.lang.String name) Gets a number-based claim.
java.lang.String	getStringClaim(java.lang.String name) Gets a string-based claim.
java.lang.String	getStringClaim(java.lang.String name, com.nimbusds.langtag.LangTag langTag) Gets a string-based claim with an optional language tag.
java.util.List<java.lang.String>	getStringListClaim(java.lang.String name) Gets a string list based claim.
java.net.URI	getURIClaim(java.lang.String name) Gets an URI string based claim.
java.net.URL	getURLClaim(java.lang.String name) Gets an URL string based claim.
void	putAll(ClaimsSet other) Puts all claims from the specified other claims set.
void	setClaim(java.lang.String name, java.lang.Object value) Sets a claim.
void	setClaim(java.lang.String name, java.lang.Object value, com.nimbusds.langtag.LangTag langTag) Sets a claim with an optional language tag.
void	setDateClaim(java.lang.String name, java.util.Date value) Sets a date / time based claim, represented as the number of seconds from 1970-01-01T0:0:0Z as measured in UTC until the date / time.
void	setEmailClaim(java.lang.String name, javax.mail.internet.InternetAddress value) Sets an email string based claim.
void	setURIClaim(java.lang.String name, java.net.URI value) Sets an URI string based claim.
void	setURLClaim(java.lang.String name, java.net.URL value) Sets an URL string based claim.
net.minidev.json.JSONObject	toJSONObject() Gets the JSON object representation of this claims set.
com.nimbusds.jwt.JWTClaimsSet	toJWTClaimsSet() Gets the JSON Web Token (JWT) claims set for this claim set.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClaimsSet

protected ClaimsSet()

Creates a new empty claims set.

ClaimsSet

protected ClaimsSet(net.minidev.json.JSONObject jsonObject)

Creates a new claims set from the specified JSON object.

Parameters:

jsonObject - The JSON object. Must not be null.

Method Detail

putAll

public void putAll(ClaimsSet other)

Puts all claims from the specified other claims set.

Parameters:

other - The other claims set. Must not be null.

getClaim

public java.lang.Object getClaim(java.lang.String name)

Gets a claim.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified.

getClaim

public <T> T getClaim(java.lang.String name,
             java.lang.Class<T> clazz)

Gets a claim that casts to the specified class.

Parameters:

name - The claim name. Must not be null.

clazz - The Java class that the claim value should cast to. Must not be null.

Returns:

The claim value, null if not specified or casting failed.

getLangTaggedClaim

public <T> java.util.Map<com.nimbusds.langtag.LangTag,T> getLangTaggedClaim(java.lang.String name,
                                                                   java.lang.Class<T> clazz)

Returns a map of all instances, including language-tagged, of a claim with the specified base name.

Example JSON serialised claims set:

 {
   "month"    : "January",
   "month#de" : "Januar"
   "month#es" : "enero",
   "month#it" : "gennaio"
 }
 

The "month" claim instances as java.util.Map:

 null => "January" (no language tag)
 "de" => "Januar"
 "es" => "enero"
 "it" => "gennaio"
 

Parameters:

name - The claim name. Must not be null.

clazz - The Java class that the claim values should cast to. Must not be null.

Returns:

The matching language-tagged claim values, empty map if none. A null key indicates the value has no language tag (corresponds to the base name).

setClaim

public void setClaim(java.lang.String name,
            java.lang.Object value)

Sets a claim.

Parameters:

name - The claim name, with an optional language tag. Must not be null.

value - The claim value. Should serialise to a JSON entity. If null any existing claim with the same name will be removed.

setClaim

public void setClaim(java.lang.String name,
            java.lang.Object value,
            com.nimbusds.langtag.LangTag langTag)

Sets a claim with an optional language tag.

Parameters:

name - The claim name. Must not be null.

value - The claim value. Should serialise to a JSON entity. If null any existing claim with the same name and language tag (if any) will be removed.

langTag - The language tag of the claim value, null if not tagged.

getStringClaim

public java.lang.String getStringClaim(java.lang.String name)

Gets a string-based claim.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified or casting failed.

getStringClaim

public java.lang.String getStringClaim(java.lang.String name,
                              com.nimbusds.langtag.LangTag langTag)

Gets a string-based claim with an optional language tag.

Parameters:

name - The claim name. Must not be null.

langTag - The language tag of the claim value, null to get the non-tagged value.

Returns:

The claim value, null if not specified or casting failed.

getBooleanClaim

public java.lang.Boolean getBooleanClaim(java.lang.String name)

Gets a boolean-based claim.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified or casting failed.

getNumberClaim

public java.lang.Number getNumberClaim(java.lang.String name)

Gets a number-based claim.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified or casting failed.

getURLClaim

public java.net.URL getURLClaim(java.lang.String name)

Gets an URL string based claim.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified or parsing failed.

setURLClaim

public void setURLClaim(java.lang.String name,
               java.net.URL value)

Sets an URL string based claim.

Parameters:

name - The claim name. Must not be null.

value - The claim value. If null any existing claim with the same name will be removed.

getURIClaim

public java.net.URI getURIClaim(java.lang.String name)

Gets an URI string based claim.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified or parsing failed.

setURIClaim

public void setURIClaim(java.lang.String name,
               java.net.URI value)

Sets an URI string based claim.

Parameters:

name - The claim name. Must not be null.

value - The claim value. If null any existing claim with the same name will be removed.

getEmailClaim

public javax.mail.internet.InternetAddress getEmailClaim(java.lang.String name)

Gets an email string based claim.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified or parsing failed.

setEmailClaim

public void setEmailClaim(java.lang.String name,
                 javax.mail.internet.InternetAddress value)

Sets an email string based claim.

Parameters:

name - The claim name. Must not be null.

value - The claim value. If null any existing claim with the same name will be removed.

getDateClaim

public java.util.Date getDateClaim(java.lang.String name)

Gets a date / time based claim, represented as the number of seconds from 1970-01-01T0:0:0Z as measured in UTC until the date / time.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified or parsing failed.

setDateClaim

public void setDateClaim(java.lang.String name,
                java.util.Date value)

Sets a date / time based claim, represented as the number of seconds from 1970-01-01T0:0:0Z as measured in UTC until the date / time.

Parameters:

name - The claim name. Must not be null.

value - The claim value. If null any existing claim with the same name will be removed.

getStringListClaim

public java.util.List<java.lang.String> getStringListClaim(java.lang.String name)

Gets a string list based claim.

Parameters:

name - The claim name. Must not be null.

Returns:

The claim value, null if not specified or parsing failed.

toJSONObject

public net.minidev.json.JSONObject toJSONObject()

Gets the JSON object representation of this claims set.

Example:

 {
   "country"       : "USA",
   "country#en"    : "USA",
   "country#de_DE" : "Vereinigte Staaten",
   "country#fr_FR" : "Etats Unis"
 }
 

Returns:

The JSON object representation.

toJWTClaimsSet

public com.nimbusds.jwt.JWTClaimsSet toJWTClaimsSet()
                                             throws ParseException

Gets the JSON Web Token (JWT) claims set for this claim set.

Returns:

The JWT claims set.

Throws:

ParseException - If the conversion to a JWT claims set fails.