manifold.api.json

Class JsonImplBase

java.lang.Object

manifold.api.json.JsonImplBase

All Implemented Interfaces:

IJsonIO

public class JsonImplBase
extends Object
implements IJsonIO

Base class for generated *.impl.Foo json classes (primarily for Java use-case)

Field Summary

Fields

Modifier and Type	Field and Description
protected Bindings	_bindings

Fields inherited from interface manifold.api.json.IJsonIO

TYPE

Constructor Summary

Constructors

Constructor and Description
JsonImplBase()
JsonImplBase(Bindings bindings)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
protected Bindings	getBindings()
protected Bindings	getBindings(Object value)
Bindings	getJsonContent(String url) Fetch the content of the specified URL as a Json object.
String	getTextContent(String url) Using this Json as input fetch the content of the specified URL as a String.
int	hashCode()
void	load(Bindings bindings) Implement this method to control loading from the Json bindings.
URL	makeUrl(String url) Make a JSON-friendly URL with the arguments derived from this Json object.
Bindings	postForJsonContent(URL url) Use http POST to pass arguments and get the full content of this URL as a JSON object.
String	postForTextContent(URL url) Use http POST to pass this json to the URL and get back the full content as a String.
void	save(Bindings bindings) Implement this method to control saving to a Json bindings.
protected List	unwrapList(List list)
protected List	wrapList(List list, java.util.function.Function<Bindings,? extends JsonImplBase> ctor)

Methods inherited from class java.lang.Object

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

Methods inherited from interface manifold.api.json.IJsonIO

isSimpleType, isSimpleType, loadFields, read, read, readList, readList, saveFields, write, write, writeList

Field Detail

_bindings

protected Bindings _bindings

Constructor Detail

JsonImplBase

public JsonImplBase()

JsonImplBase

public JsonImplBase(Bindings bindings)

Method Detail

getBindings

protected Bindings getBindings()

getBindings

protected Bindings getBindings(Object value)

wrapList

protected List wrapList(List list,
                        java.util.function.Function<Bindings,? extends JsonImplBase> ctor)

unwrapList

protected List unwrapList(List list)

makeUrl

public URL makeUrl(String url)

Make a JSON-friendly URL with the arguments derived from this Json object.

If an argument is a Gosu Dynamic Expando or a javax.script.Bindings or a List, it is transformed to JSON. Otherwise, the argument is coerced to a String. All arguments are URL encoded.

Note the resulting URL is intended to be used for an http GET invocation via the TextContent and JsonContent properties. Do not use the resulting URL for a POST invocation, instead separately construct a URL and call postForTextContent() or postForJsonContent().

See Also:

postForTextContent(URL), postForJsonContent(URL)

getTextContent

public String getTextContent(String url)

Using this Json as input fetch the content of the specified URL as a String. If this is an http URL, fetches the content using the GET method.

Returns:

The full content of the specified URL coerced to a String.

getJsonContent

public Bindings getJsonContent(String url)

Fetch the content of the specified URL as a Json object. If this is an http URL, fetches the content using the GET method.

Returns:

If the content of this URL is a Json document, a Json object reflecting the document.

See Also:

getTextContent(java.lang.String), postForJsonContent(URL)

postForTextContent

public String postForTextContent(URL url)

Use http POST to pass this json to the URL and get back the full content as a String.

If an argument is a Gosu Dynamic Expando or a javax.script.Bindings or a List, it is transformed to JSON. Otherwise, the argument is coerced to a String. All arguments are URL encoded.

Returns:

The full content of this URL coerced to a String.

See Also:

postForJsonContent(URL)

postForJsonContent

public Bindings postForJsonContent(URL url)

Use http POST to pass arguments and get the full content of this URL as a JSON object.

If an argument is a Gosu Dynamic Expando or a javax.script.Bindings or a List, it is transformed to JSON. Otherwise, the argument is coerced to a String. All arguments are URL encoded.

Returns:

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

See Also:

postForTextContent(URL)

load

public void load(Bindings bindings)

Description copied from interface: IJsonIO

Implement this method to control loading from the Json bindings. The default behavior simply loads values corresponding with your class's field values.

The bindings is just a simple map with name value pairs, which usually maps directly to your class's fields. But anything goes; you can read and write anything from/to the Bindings.

Use #read() etc. to read proper Json data.

Specified by:

load in interface IJsonIO

save

public void save(Bindings bindings)

Description copied from interface: IJsonIO

Implement this method to control saving to a Json bindings. The default behavior simply saves all your class's non-transient instance fields.

Basically, the bindings is a simple map where you write name/value pairs representing your class's format. Typically you save just your field values, but you can save anything you like.

Use #write(String, Object, Bindings) etc. to write proper Json data.

Specified by:

save in interface IJsonIO

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object