sirius.web.services

Class JSONCall

java.lang.Object

sirius.web.services.JSONCall

public class JSONCall
extends Object

Simple call to send JSON to a server (URL) and receive JSON back.

Method Summary

Modifier and Type	Method and Description
void	addHeader(String name, String value) Adds a custom header field to the call
com.alibaba.fastjson.JSONObject	getInput() Provides access to the JSON answer of the call.
JSONStructuredOutput	getOutput() Can be used to generate the JSON request.
void	getPlainInput() Returns the response of the call as plain text.
static JSONCall	to(URL url) Creates a new JSONCall for the given url with Content-Type 'application/json'.
static JSONCall	to(URL url, String contentType) Creates a new JSONCall for the given url.

Methods inherited from class java.lang.Object

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

Method Detail

to

public static JSONCall to(URL url)
                   throws IOException

Creates a new JSONCall for the given url with Content-Type 'application/json'.

Parameters:

url - the target URL to call

Returns:

an JSONCall which can be used to send and receive JSON

Throws:

IOException - in case of an IO error

to

public static JSONCall to(URL url,
                          String contentType)
                   throws IOException

Creates a new JSONCall for the given url.

Parameters:

url - the target URL to call

contentType - the Content-Type to use

Returns:

a new instance to perform the xml call

Throws:

IOException - in case of an IO error

addHeader

public void addHeader(String name,
                      String value)

Adds a custom header field to the call

Parameters:

name - name of the field

value - value of the field

getOutput

public JSONStructuredOutput getOutput()
                               throws IOException

Can be used to generate the JSON request.

Returns:

the an input which can be used to generate an XML document which is sent to the URL

Throws:

IOException - in case of an IO error while sending the JSON document

getInput

public com.alibaba.fastjson.JSONObject getInput()
                                         throws IOException

Provides access to the JSON answer of the call.

Returns:

the JSON result of the call

Throws:

IOException - in case of an IO error while receiving the result

getPlainInput

public void getPlainInput()
                   throws IOException

Returns the response of the call as plain text.

Throws:

IOException - in case of an IO error while receiving the result