manifold.json.rt.extensions.java.net.URL

Class ManUrlExt

java.lang.Object

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

public class ManUrlExt
extends java.lang.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 java.lang.String	encode(java.lang.String urlPart) Convenience method to encode a URL string and not have to handle the UnsupportedEncodingException.
static byte[]	getBinaryContent(java.net.URL thiz)
static java.lang.Object	getCsvContent(java.net.URL thiz)
static java.lang.Object	getJsonContent(java.net.URL thiz)
static java.lang.String	getTextContent(java.net.URL thiz)
static java.lang.Object	getXmlContent(java.net.URL thiz)
static java.lang.Object	getYamlContent(java.net.URL thiz)
static java.net.URL	makeUrl(java.lang.String url, java.lang.Object jsonValue) Make a JSON-compatible URL with the arguments from the jsonValue.
static java.lang.Object	sendCsvRequest(java.net.URL url, java.net.Proxy proxy, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout)
static java.lang.Object	sendCsvRequest(java.net.URL url, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout) Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a CSV response.
static java.lang.Object	sendJsonRequest(java.net.URL url, java.net.Proxy proxy, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout)
static java.lang.Object	sendJsonRequest(java.net.URL url, java.lang.String httpMethod, java.lang.Object jsonValue) Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a JSON response.
static java.lang.Object	sendJsonRequest(java.net.URL url, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout)
static java.lang.String	sendPlainTextRequest(java.net.URL url, java.net.Proxy proxy, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout)
static java.lang.String	sendPlainTextRequest(java.net.URL url, java.lang.String httpMethod, java.lang.Object jsonValue) Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a plain text response.
static java.lang.String	sendPlainTextRequest(java.net.URL url, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout)
static java.lang.Object	sendXmlRequest(java.net.URL url, java.net.Proxy proxy, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout)
static java.lang.Object	sendXmlRequest(java.net.URL url, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout) Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a XML response.
static java.lang.Object	sendYamlRequest(java.net.URL url, java.net.Proxy proxy, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout)
static java.lang.Object	sendYamlRequest(java.net.URL url, java.lang.String httpMethod, java.lang.Object jsonValue) Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a YAML response.
static java.lang.Object	sendYamlRequest(java.net.URL url, java.lang.String httpMethod, java.lang.Object jsonValue, java.util.Map<java.lang.String,java.lang.String> headers, int timeout)

Methods inherited from class java.lang.Object

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

Constructor Detail

ManUrlExt

public ManUrlExt()

Method Detail

makeUrl

public static java.net.URL makeUrl(java.lang.String url,
                                   java.lang.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 java.lang.String encode(java.lang.String urlPart)

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

sendJsonRequest

public static java.lang.Object sendJsonRequest(java.net.URL url,
                                               java.lang.String httpMethod,
                                               java.lang.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 java.lang.Object sendJsonRequest(java.net.URL url,
                                               java.lang.String httpMethod,
                                               java.lang.Object jsonValue,
                                               java.util.Map<java.lang.String,java.lang.String> headers,
                                               int timeout)

sendJsonRequest

public static java.lang.Object sendJsonRequest(java.net.URL url,
                                               java.net.Proxy proxy,
                                               java.lang.String httpMethod,
                                               java.lang.Object jsonValue,
                                               java.util.Map<java.lang.String,java.lang.String> headers,
                                               int timeout)

sendYamlRequest

public static java.lang.Object sendYamlRequest(java.net.URL url,
                                               java.lang.String httpMethod,
                                               java.lang.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 java.lang.Object sendYamlRequest(java.net.URL url,
                                               java.lang.String httpMethod,
                                               java.lang.Object jsonValue,
                                               java.util.Map<java.lang.String,java.lang.String> headers,
                                               int timeout)

sendYamlRequest

public static java.lang.Object sendYamlRequest(java.net.URL url,
                                               java.net.Proxy proxy,
                                               java.lang.String httpMethod,
                                               java.lang.Object jsonValue,
                                               java.util.Map<java.lang.String,java.lang.String> headers,
                                               int timeout)

sendXmlRequest

public static java.lang.Object sendXmlRequest(java.net.URL url,
                                              java.lang.String httpMethod,
                                              java.lang.Object jsonValue,
                                              java.util.Map<java.lang.String,java.lang.String> headers,
                                              int timeout)

Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a XML 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 bindings value parsed from the XML response.

See Also:

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

sendXmlRequest

public static java.lang.Object sendXmlRequest(java.net.URL url,
                                              java.net.Proxy proxy,
                                              java.lang.String httpMethod,
                                              java.lang.Object jsonValue,
                                              java.util.Map<java.lang.String,java.lang.String> headers,
                                              int timeout)

sendCsvRequest

public static java.lang.Object sendCsvRequest(java.net.URL url,
                                              java.lang.String httpMethod,
                                              java.lang.Object jsonValue,
                                              java.util.Map<java.lang.String,java.lang.String> headers,
                                              int timeout)

Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a CSV 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 bindings value parsed from the CSV response.

See Also:

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

sendCsvRequest

public static java.lang.Object sendCsvRequest(java.net.URL url,
                                              java.net.Proxy proxy,
                                              java.lang.String httpMethod,
                                              java.lang.Object jsonValue,
                                              java.util.Map<java.lang.String,java.lang.String> headers,
                                              int timeout)

sendPlainTextRequest

public static java.lang.String sendPlainTextRequest(java.net.URL url,
                                                    java.lang.String httpMethod,
                                                    java.lang.Object jsonValue)

Use HTTP GET, POST, PUT, or PATCH to send JSON bindings to a URL with a plain text 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 java.lang.String sendPlainTextRequest(java.net.URL url,
                                                    java.lang.String httpMethod,
                                                    java.lang.Object jsonValue,
                                                    java.util.Map<java.lang.String,java.lang.String> headers,
                                                    int timeout)

sendPlainTextRequest

public static java.lang.String sendPlainTextRequest(java.net.URL url,
                                                    java.net.Proxy proxy,
                                                    java.lang.String httpMethod,
                                                    java.lang.Object jsonValue,
                                                    java.util.Map<java.lang.String,java.lang.String> headers,
                                                    int timeout)

getTextContent

public static java.lang.String getTextContent(java.net.URL thiz)

Returns:

The full text content of this URL's stream.

getBinaryContent

public static byte[] getBinaryContent(java.net.URL thiz)

Returns:

The full binary content of this URL's stream.

getJsonContent

public static java.lang.Object getJsonContent(java.net.URL thiz)

Returns:

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

getYamlContent

public static java.lang.Object getYamlContent(java.net.URL thiz)

Returns:

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

getXmlContent

public static java.lang.Object getXmlContent(java.net.URL thiz)

Returns:

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

getCsvContent

public static java.lang.Object getCsvContent(java.net.URL thiz)

Returns:

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