org.wicketeer.modelfactory

Class ModelFactory

java.lang.Object

org.wicketeer.modelfactory.ModelFactory

public final class ModelFactory
extends Object

Entry point for creating refactoring safe PropertyModels. Usage: IModel<String> stringModel = model(from(person).getProfile().getName()); where person can be an instance of Person class or an IModel<Person>.

Method Summary

Modifier and Type	Method and Description
static <T> T	from(org.apache.wicket.model.IModel<? extends T> model, Class<T> type) In cases where you need to hint the Type of the model passed, ecause it cannot be reflected, you can use this method and provide the model objects expected type as parameter.
static <T> T	from(org.apache.wicket.model.IModel<T> model) Proxies the Model-Object's type in order to be able to call methods on it to create the property path later-on used by model().
static <T> T	from(T value) Proxies the given object in order to be able to call methods on it to create the property path later-on used by model().
static <T> T	fromClass(Class<T> clazz) starts recording from a class.
static boolean	hasRootReference()
static <T> org.apache.wicket.model.IModel<T>	model(T path) creates an actual PropertyModel from the path expressed by the given object.
static String	path(Object path)

Methods inherited from class java.lang.Object

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

Method Detail

from

public static <T> T from(T value)
                  throws NullPointerException

Proxies the given object in order to be able to call methods on it to create the property path later-on used by model().

Type Parameters:

T - the type of the parameter

Parameters:

value - the object to be proxied

Returns:

a proxy of the value-object

Throws:

NullPointerException - if the given object is null

from

public static <T> T from(org.apache.wicket.model.IModel<T> model)
                  throws NullPointerException

Proxies the Model-Object's type in order to be able to call methods on it to create the property path later-on used by model().

Type Parameters:

T - type of the model parameter

Parameters:

model - the model from which to create a proxy

Returns:

a proxy of an object of Type T

Throws:

NullPointerException - if the model is null

model

public static <T> org.apache.wicket.model.IModel<T> model(T path)

creates an actual PropertyModel from the path expressed by the given object.

Type Parameters:

T - client-defined type

Parameters:

path - the object initially created by a from-call

Returns:

the actual Model

path

public static String path(Object path)

Parameters:

path - the object initially created by a from-call

Returns:

a string denoting the property path expressed by the path object

fromClass

public static <T> T fromClass(Class<T> clazz)

starts recording from a class. this will return a proxy of Type clazz, that should be evaluated by path(x), rather than model(x). A common usecase is to evaluate to a path expression, that is used in subsequent PropertyModel constructions. new PropertyModel(myModel, ModelFactory.path(x));

Type Parameters:

T - client-defined type

Parameters:

clazz - the type of the proxy to create

Returns:

proxy of type clazz

from

public static <T> T from(org.apache.wicket.model.IModel<? extends T> model,
                         Class<T> type)
                  throws NullPointerException

In cases where you need to hint the Type of the model passed, ecause it cannot be reflected, you can use this method and provide the model objects expected type as parameter.

Type Parameters:

T - type of the model parameter

Parameters:

model - the model from which to create a proxy

type - the type of the object backed by the model

Returns:

proxy for property path generation

Throws:

NullPointerException - if the model or the type is null

hasRootReference

public static boolean hasRootReference()
                                throws IllegalStateException

Returns:

true if current invocation sequence recording was started from a root reference (in contrast to being start with fromClass(Class).

Throws:

IllegalStateException - if not currently in recording thread (either from() has not been called, of model() has already been called