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 Bindings	getJsonContent(URL thiz)
static String	getTextContent(URL thiz)
static Bindings	getYamlContent(URL thiz)
static URL	makeUrl(String url, Bindings arguments) Make a JSON-compatible URL with the arguments from the Bindings.
static Bindings	postForJsonContent(URL url, Bindings arguments) Use HTTP POST to pass JSON bindings to this URL and get the full content as a JSON object.
static String	postForTextContent(URL url, Bindings arguments) Use HTTP POST to pass JSON bindings to this URL and get back the full content as a String.
static Bindings	postForYamlContent(URL url, Bindings arguments) Use HTTP POST to pass YAML bindings to this URL and get the full content as a YAML object.

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,
                          Bindings arguments)

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

If an 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.

postForTextContent

public static String postForTextContent(URL url,
                                        Bindings arguments)

Use HTTP POST to pass JSON bindings to this URL and get back the full content as a String.

Parameters:

arguments - A mapping of argument name to value, using JSON Schema as the format

Returns:

The full content of this URL coerced to a String.

See Also:

postForJsonContent(URL, Bindings)

postForJsonContent

public static Bindings postForJsonContent(URL url,
                                          Bindings arguments)

Use HTTP POST to pass JSON bindings to this URL and get the full content as a JSON object.

Parameters:

arguments - A mapping of argument name to value, using JSON Schema as the format

Returns:

The full content of this URL's stream as a JSON object.

See Also:

postForTextContent(URL, Bindings)

postForYamlContent

public static Bindings postForYamlContent(URL url,
                                          Bindings arguments)

Use HTTP POST to pass YAML bindings to this URL and get the full content as a YAML object.

Parameters:

arguments - A mapping of argument name to value, using JSON Schema as the format

Returns:

The full content of this URL's stream as a YAML object.

See Also:

postForTextContent(URL, Bindings)

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 Bindings 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 Bindings 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)