manifold.json.extensions.java.net.URL

Class ManUrlExt

java.lang.Object

manifold.json.extensions.java.net.URL.ManUrlExt

public class ManUrlExt
extends Object

Adds extension methods to URL for handling JSON, plain text, and binary content.

Constructor Summary

Constructors

Constructor and Description
ManUrlExt()

Method Summary

Modifier and Type	Method and Description
static String	encode(String urlPart) Convenience method to encode a URL string and not have to handle the UnsupportedEncodingException.
static byte[]	getBinaryContent(URL thiz)
static Object	getJsonContent(URL thiz)
static String	getTextContent(URL thiz)
static Object	getYamlContent(URL thiz)
static URL	makeUrl(String url, Object jsonValue) Make a JSON-compatible URL with the arguments from the jsonValue.
static Object	sendJsonRequest(URL url, String httpMethod, Object jsonValue) Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a JSON response.
static Object	sendJsonRequest(URL url, String httpMethod, Object jsonValue, Map<String,String> headers, int timeout)
static String	sendPlainTextRequest(URL url, String httpMethod, Object jsonValue) Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a YAML response.
static String	sendPlainTextRequest(URL url, String httpMethod, Object jsonValue, Map<String,String> headers, int timeout)
static Object	sendYamlRequest(URL url, String httpMethod, Object jsonValue) Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a YAML response.
static Object	sendYamlRequest(URL url, String httpMethod, Object jsonValue, Map<String,String> headers, int timeout)

Methods inherited from class java.lang.Object

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

Constructor Detail

ManUrlExt

public ManUrlExt()

Method Detail

makeUrl

public static URL makeUrl(String url,
                          Object jsonValue)

Make a JSON-compatible URL with the arguments from the jsonValue. Encodes the arguments in UTF-8 and appends them to the list using standard URL query delimiters.

If an individual argument is a Bindings or a List, it is transformed to JSON. Otherwise, the argument is coerced to a String and URL encoded.

encode

public static String encode(String urlPart)

Convenience method to encode a URL string and not have to handle the UnsupportedEncodingException.

sendJsonRequest

public static Object sendJsonRequest(URL url,
                                     String httpMethod,
                                     Object jsonValue)

Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a JSON response.

Parameters:

httpMethod - The HTTP method to use: "GET", "POST", "PUT", or "PATCH"

jsonValue - A JSON value to send (primitive/boxed type, String, List of JSON values, or Bindings of String/JSON value)

Returns:

A JSON value parsed from the JSON response.

See Also:

sendRequest(URL, String, Object, Map, int)

sendJsonRequest

public static Object sendJsonRequest(URL url,
                                     String httpMethod,
                                     Object jsonValue,
                                     Map<String,String> headers,
                                     int timeout)

sendYamlRequest

public static Object sendYamlRequest(URL url,
                                     String httpMethod,
                                     Object jsonValue)

Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a YAML response.

Parameters:

httpMethod - The HTTP method to use: "GET", "POST", "PUT", or "PATCH"

jsonValue - A JSON value to send (primitive/boxed type, String, List of JSON values, or Bindings of String/JSON value)

Returns:

A JSON value parsed from the YAML response.

See Also:

sendRequest(URL, String, Object, Map, int)

sendYamlRequest

public static Object sendYamlRequest(URL url,
                                     String httpMethod,
                                     Object jsonValue,
                                     Map<String,String> headers,
                                     int timeout)

sendPlainTextRequest

public static String sendPlainTextRequest(URL url,
                                          String httpMethod,
                                          Object jsonValue)

Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a YAML response.

Parameters:

httpMethod - The HTTP method to use: "GET", "POST", "PUT", or "PATCH"

jsonValue - A JSON value to send (primitive/boxed type, String, List of JSON values, or Bindings of String/JSON value)

Returns:

The raw response body as plain text

See Also:

sendRequest(URL, String, Object, Map, int)

sendPlainTextRequest

public static String sendPlainTextRequest(URL url,
                                          String httpMethod,
                                          Object jsonValue,
                                          Map<String,String> headers,
                                          int timeout)

getTextContent

public static String getTextContent(URL thiz)

Returns:

The full text content of this URL's stream.

getBinaryContent

public static byte[] getBinaryContent(URL thiz)

Returns:

The full binary content of this URL's stream.

getJsonContent

public static Object getJsonContent(URL thiz)

Returns:

A JSON object reflecting the contents of this URL, otherwise a RuntimeException results if the content is not a JSON document.

See Also:

Json.fromJson(String)

getYamlContent

public static Object getYamlContent(URL thiz)

Returns:

A YAML object reflecting the contents of this URL, otherwise a RuntimeException results if the content is not a YAML document.

See Also:

Yaml.fromYaml(String)