net.java.html.json

Class Models

java.lang.Object

net.java.html.json.Models

public final class Models
extends Object

Information about and operations for classes generated by the @Model annotation.

Author:

Jaroslav Tulach

Method Summary

Modifier and Type	Method and Description
static void	applyBindings(Object model) Apply bindings of a model class to overall page.
static void	applyBindings(Object model, String targetId) Apply bindings of a model class.
static <T> List<T>	asList(T... values) Wrap provided values into mutable list.
static <Model> Model	bind(Model model, BrwsrCtx context) Binds given model to another context.
static <M> M	fromRaw(BrwsrCtx ctx, Class<M> model, Object jsonObject) Converts an existing, raw, JSON object into a model class.
static boolean	isModel(Class<?> clazz) Finds out whether given class is a model class - e.g. has been generated by @Model annotation.
static <M> M	parse(BrwsrCtx c, Class<M> model, InputStream is) Generic method to parse content of a model class from a stream.
static <M> void	parse(BrwsrCtx c, Class<M> model, InputStream is, Collection<? super M> collectTo) Generic method to parse stream, that can possibly contain array of specified objects.
static Object	toRaw(Object model) Converts an existing model into its associated, raw JSON object.

Methods inherited from class java.lang.Object

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

Method Detail

isModel

public static boolean isModel(Class<?> clazz)

Finds out whether given class is a model class - e.g. has been generated by @Model annotation.

Parameters:

clazz - the class to test

Returns:

true, if clazz was generated by Model annotation

Since:

0.2

bind

public static <Model> Model bind(Model model,
                                 BrwsrCtx context)

Binds given model to another context.

Type Parameters:

Model - class defined by Model annotation

Parameters:

model - instance of a model defined by Model annotation

context - context to which the model should be bound

Returns:

new instance of model bound to new context

Throws:

IllegalArgumentException - in case the instance is not generated by model interface

Since:

0.4

parse

public static <M> M parse(BrwsrCtx c,
                          Class<M> model,
                          InputStream is)
                   throws IOException

Generic method to parse content of a model class from a stream.

Type Parameters:

M - type of the model class

Parameters:

c - context of the technology to use for reading

model - the model class generated by Model annotation

is - input stream with data

Returns:

new instance of the model class

Throws:

IOException - throw when reading from is faces problems

Since:

0.2

parse

public static <M> void parse(BrwsrCtx c,
                             Class<M> model,
                             InputStream is,
                             Collection<? super M> collectTo)
                      throws IOException

Generic method to parse stream, that can possibly contain array of specified objects.

Type Parameters:

M - the type of the individal JSON object

Parameters:

c - context of the technology to use for reading

model - the model class generated by Model annotation

is - input stream with data

collectTo - collection to add the individual model instances to. If the stream contains an object, one instance will be added, if it contains an array, the number of array items will be added to the collection

Throws:

IOException - thrown when an I/O problem appears

Since:

0.8.3

fromRaw

public static <M> M fromRaw(BrwsrCtx ctx,
                            Class<M> model,
                            Object jsonObject)

Converts an existing, raw, JSON object into a model class.

Type Parameters:

M - the type of the model class

Parameters:

ctx - context of the technology to use for converting

model - the model class

jsonObject - original instance of the JSON object

Returns:

new instance of the model class

Since:

0.7

toRaw

public static Object toRaw(Object model)

Converts an existing model into its associated, raw JSON object. The object may, but does not have to, be the same instance as the model object.

Parameters:

model - the model object (can be null to initialize the associated Technology)

Returns:

the raw JSON object associated with the model (null if the model parameter was null)

Throws:

IllegalArgumentException - if the model is not instance of a class generated by model annotation processor.

Since:

0.7

applyBindings

public static void applyBindings(Object model)

Apply bindings of a model class to overall page. In ko4j mode, it binds the model values to the currently active page.

Parameters:

model - instance of a class

Throws:

IllegalArgumentException - if the model is not instance of a class generated by model annotation processor.

Since:

0.7

applyBindings

public static void applyBindings(Object model,
                                 String targetId)

Apply bindings of a model class. In ko4j mode, it binds the model values to an element on currently active page.

Parameters:

model - instance of a class

targetId - the id of the element to apply the binding to

Throws:

IllegalArgumentException - if the model is not instance of a class generated by model annotation processor.

Since:

1.1

asList

public static <T> List<T> asList(T... values)

Wrap provided values into mutable list.

Type Parameters:

T - type of the values and resulting list

Parameters:

values - the values, if any

Returns:

full features implementation of mutable and extendable list

Since:

1.5