com.nimbusds.jose.util

Class JSONObjectUtils

java.lang.Object

com.nimbusds.jose.util.JSONObjectUtils

public class JSONObjectUtils
extends Object

JSON object helper methods for parsing and typed retrieval of member values.

Version:

2015-04-15

Author:

Vladimir Dzhuvinov

Method Summary

Modifier and Type	Method and Description
static boolean	getBoolean(net.minidev.json.JSONObject o, String key) Gets a boolean member of a JSON object.
static double	getDouble(net.minidev.json.JSONObject o, String key) Gets a number member of a JSON object as double.
static float	getFloat(net.minidev.json.JSONObject o, String key) Gets a number member of a JSON object float.
static int	getInt(net.minidev.json.JSONObject o, String key) Gets an number member of a JSON object as int.
static net.minidev.json.JSONArray	getJSONArray(net.minidev.json.JSONObject o, String key) Gets a JSON array member of a JSON object.
static net.minidev.json.JSONObject	getJSONObject(net.minidev.json.JSONObject o, String key) Gets a JSON object member of a JSON object.
static long	getLong(net.minidev.json.JSONObject o, String key) Gets a number member of a JSON object as long.
static String	getString(net.minidev.json.JSONObject o, String key) Gets a string member of a JSON object.
static String[]	getStringArray(net.minidev.json.JSONObject o, String key) Gets a string array member of a JSON object.
static List<String>	getStringList(net.minidev.json.JSONObject o, String key) Gets a string list member of a JSON object
static URI	getURI(net.minidev.json.JSONObject o, String key) Gets a string member of a JSON object as java.net.URI.
static net.minidev.json.JSONObject	parse(String s) Parses a JSON object.
static net.minidev.json.JSONObject	parseJSONObject(String s) Deprecated.

Methods inherited from class java.lang.Object

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

Method Detail

parse

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

Parses a JSON object.

Specific JSON to Java entity mapping (as per JSON Smart):

• JSON true|false map to java.lang.Boolean.
• JSON numbers map to java.lang.Number.
  • JSON integer numbers map to long.
  • JSON fraction numbers map to double.
• JSON strings map to java.lang.String.
• JSON arrays map to net.minidev.json.JSONArray.
• JSON objects map to net.minidev.json.JSONObject.

Parameters:

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

Returns:

The JSON object.

Throws:

ParseException - If the string cannot be parsed to a valid JSON object.

parseJSONObject

@Deprecated
public static net.minidev.json.JSONObject parseJSONObject(String s)
                                                               throws ParseException

Deprecated.

Use parse(String) instead.

Parameters:

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

Returns:

The JSON object.

Throws:

ParseException - If the string cannot be parsed to a valid JSON object.

getBoolean

public static boolean getBoolean(net.minidev.json.JSONObject o,
                                 String key)
                          throws ParseException

Gets a boolean member of a JSON object.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getInt

public static int getInt(net.minidev.json.JSONObject o,
                         String key)
                  throws ParseException

Gets an number member of a JSON object as int.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getLong

public static long getLong(net.minidev.json.JSONObject o,
                           String key)
                    throws ParseException

Gets a number member of a JSON object as long.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getFloat

public static float getFloat(net.minidev.json.JSONObject o,
                             String key)
                      throws ParseException

Gets a number member of a JSON object float.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getDouble

public static double getDouble(net.minidev.json.JSONObject o,
                               String key)
                        throws ParseException

Gets a number member of a JSON object as double.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getString

public static String getString(net.minidev.json.JSONObject o,
                               String key)
                        throws ParseException

Gets a string member of a JSON object.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getURI

public static URI getURI(net.minidev.json.JSONObject o,
                         String key)
                  throws ParseException

Gets a string member of a JSON object as java.net.URI.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getJSONArray

public static net.minidev.json.JSONArray getJSONArray(net.minidev.json.JSONObject o,
                                                      String key)
                                               throws ParseException

Gets a JSON array member of a JSON object.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getStringArray

public static String[] getStringArray(net.minidev.json.JSONObject o,
                                      String key)
                               throws ParseException

Gets a string array member of a JSON object.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getStringList

public static List<String> getStringList(net.minidev.json.JSONObject o,
                                         String key)
                                  throws ParseException

Gets a string list member of a JSON object

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.

getJSONObject

public static net.minidev.json.JSONObject getJSONObject(net.minidev.json.JSONObject o,
                                                        String key)
                                                 throws ParseException

Gets a JSON object member of a JSON object.

Parameters:

o - The JSON object. Must not be null.

key - The JSON object member key. Must not be null.

Returns:

The member value.

Throws:

ParseException - If the value is missing, null or not of the expected type.