ej.rest.web

Class JSONResource

java.lang.Object

ej.rest.web.Resty

ej.rest.web.AbstractResource

ej.rest.web.JSONResource

public class JSONResource
extends AbstractResource

A resource presentation in JSON format. You can ask Resty to parse the JSON into a JSONArray or a JSONObject. The JSONObject is similar to org.json.JSONObject and allows full access to the JSON. You can also access the JSON with a JSONPathQuery to extract only the parts you are interested in.

Nested Class Summary

Nested classes/interfaces inherited from class ej.rest.web.Resty

Resty.Option, Resty.Timeout

Field Summary

Fields inherited from class ej.rest.web.AbstractResource

inputStream, urlConnection

Fields inherited from class ej.rest.web.Resty

DEFAULT_USER_AGENT, MOZILLA, userAgent

Constructor Summary

Constructors

Constructor and Description
JSONResource(Resty.Option... options)

Method Summary

Modifier and Type	Method and Description
org.json.me.JSONArray	array() Parse and return JSON array.
java.lang.Object	get(JSONPathQuery aQuery) Gets the partial JSON object or attribute as specified in the path expression.
java.lang.Object	get(java.lang.String path) Gets the partial JSON object or attribute as specified in the path expression.
java.lang.String	getAcceptedTypes()
JSONResource	json(JSONPathQuery path) Execute the given path query on the json GET the returned URI expecting JSON
JSONResource	json(JSONPathQuery path, Content content) Execute the given path query on the json and POST to the returned URI expecting JSON
org.json.me.JSONObject	object() Parse and return JSON object.
TextResource	text(JSONPathQuery path) Execute the given path query on the json and use the returned string as an URI expecting text/*
org.json.me.JSONObject	toObject() Added for compatibility with Scala.
protected java.lang.Object	unmarshal() Transforming the JSON

Methods inherited from class ej.rest.web.AbstractResource

getUrlConnection, http, location, printResponseHeaders, status, stream

Methods inherited from class ej.rest.web.Resty

addAdditionalHeaders, addStandardHeaders, alwaysSend, bytes, bytes, bytes, bytes, chunked, chunked, content, content, content, content, createBinaryResource, createJSONResource, createTextResource, data, data, delete, doGET, dontSend, doPOSTOrPUT, fillResourceFromURL, form, form, getAdditionalHeaders, identifyAsMozilla, identifyAsResty, json, json, json, json, openConnection, path, put, setOptions, text, text, text, text, withHeader

Methods inherited from class java.lang.Object

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

Constructor Detail

JSONResource

public JSONResource(Resty.Option... options)

Method Detail

array

public org.json.me.JSONArray array()
                            throws java.io.IOException,
                                   org.json.me.JSONException

Parse and return JSON array. Parsing is done only once after which the inputStream is at EOF.

Throws:

java.io.IOException

org.json.me.JSONException

object

public org.json.me.JSONObject object()
                              throws java.io.IOException,
                                     org.json.me.JSONException

Parse and return JSON object. Parsing is done only once after which the inputStrem is at EOF.

Returns:

the JSON object

Throws:

java.io.IOException

org.json.me.JSONException

toObject

public org.json.me.JSONObject toObject()
                                throws java.io.IOException,
                                       org.json.me.JSONException

Added for compatibility with Scala. See Issue #2 at github.

Returns:

the JSONObject presentation

Throws:

java.io.IOException

org.json.me.JSONException - if data was no valid JSON

unmarshal

protected java.lang.Object unmarshal()
                              throws java.io.IOException,
                                     org.json.me.JSONException

Transforming the JSON

Throws:

java.io.IOException

org.json.me.JSONException

json

public JSONResource json(JSONPathQuery path)
                  throws java.lang.Exception

Execute the given path query on the json GET the returned URI expecting JSON

Parameters:

path - path to the URI to follow

Returns:

a new resource, as a result of getting it from the server in JSON format

Throws:

java.lang.Exception

org.json.me.JSONException

json

public JSONResource json(JSONPathQuery path,
                         Content content)
                  throws java.lang.Exception

Execute the given path query on the json and POST to the returned URI expecting JSON

Parameters:

path - path to the URI to follow

Returns:

a new resource, as a result of getting it from the server in JSON format

Throws:

java.lang.Exception

org.json.me.JSONException

text

public TextResource text(JSONPathQuery path)
                  throws java.lang.Exception

Execute the given path query on the json and use the returned string as an URI expecting text/*

Parameters:

path - path to the URI to follow

Returns:

a new resource, as a result of getting it from the server in text/plain format

Throws:

java.lang.Exception

org.json.me.JSONException

get

public java.lang.Object get(java.lang.String path)
                     throws java.lang.Exception

Gets the partial JSON object or attribute as specified in the path expression.

Throws:

java.lang.Exception

get

public java.lang.Object get(JSONPathQuery aQuery)
                     throws java.lang.Exception

Gets the partial JSON object or attribute as specified in the path expression.

Throws:

java.lang.Exception

getAcceptedTypes

public java.lang.String getAcceptedTypes()

Specified by:

getAcceptedTypes in class AbstractResource