Package org.apache.juneau.rest.server.arg

Class RequestBeanSetters

java.lang.Object

org.apache.juneau.rest.server.arg.RequestBeanSetters

public final class RequestBeanSetters
extends Object

Resolves and caches the public no-arg constructor and per-getter setter Methods for a concrete (non-interface) @Request bean class.

RequestBeanArg resolves one of these once, when the @RestOp is registered (servlet init), instead of the historical per-request Class.getMethod lookup in RestRequest.newRequestBean. A getter with no matching setter, or a bean with no public no-arg constructor, now fails registration with an IllegalArgumentException naming the bean, the getter and the expected setter — not only the requests that happen to supply that parameter.

Example:

// A concrete request bean: public no-arg constructor plus a setter for every annotated getter. @Request public class MyQuery { private String foo; @Query public String getFoo() { return foo; } public void setFoo(String value) { foo = value; } } RequestBeanMeta meta = RequestBeanMeta.create(MyQuery.class, annotations); RequestBeanSetters setters = RequestBeanSetters.resolve(MyQuery.class, meta); MyQuery bean = setters.newInstance(); setters.set(bean, meta.getProperty("getFoo").getGetter(), "value");

Since:

10.0.0

Method Summary

Modifier and Type	Method	Description
<T> T	newInstance()	Instantiates the bean via its public no-arg constructor.
static RequestBeanSetters	resolve(Class<?> beanClass, RequestBeanMeta meta)	Resolves the constructor and setters for a concrete @Request bean class.
void	set(Object bean, Method getter, Object value)	Invokes the setter matching the specified getter on the specified bean.

Methods inherited from class java.lang.Object

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

Method Details

resolve

public static RequestBeanSetters resolve(Class<?> beanClass,
 RequestBeanMeta meta)

Resolves the constructor and setters for a concrete @Request bean class.

Parameters:

beanClass - The bean class. Must not be an interface.

meta - The metadata gathered from the class's annotated getters. Must not be null.

Returns:

A new RequestBeanSetters.

Throws:

IllegalArgumentException - If beanClass has no public no-arg constructor, or if any annotated getter has no matching setter.

newInstance

public <T> T newInstance()
                  throws ReflectiveOperationException

Instantiates the bean via its public no-arg constructor.

Type Parameters:

T - The bean type.

Returns:

A new, empty bean instance.

Throws:

ReflectiveOperationException - If instantiation fails.

set

public void set(Object bean,
 Method getter,
 Object value)
         throws ReflectiveOperationException

Invokes the setter matching the specified getter on the specified bean.

Parameters:

bean - The bean to populate. Must not be null.

getter - The getter identifying the property, as returned by RequestBeanPropertyMeta.getGetter().

value - The value to set. Callers skip absent (null) values rather than passing them here.

Throws:

ReflectiveOperationException - If the setter invocation fails.