Module jakarta.faces

Package com.sun.faces.application.annotation

Class JndiHandler

java.lang.Object

com.sun.faces.application.annotation.JndiHandler

public abstract class JndiHandler
extends Object

An abstract RuntimeAnnotationHandler that is capable of dealing with JNDI.

Field Summary

Fields

Modifier and Type	Field	Description
protected static final String	JAVA_COMP_ENV	Stores the java:comp/env/ prefix

Constructor Summary

Constructors

Constructor	Description
JndiHandler()

Method Summary

Modifier and Type	Method	Description
void	apply(FacesContext ctx, Object... params)	Apply the Annotation(s).
protected void	invokeMethod(FacesContext facesContext, Method method, Object instance, Object value)	Invoke the method.
Object	lookup(FacesContext facesContext, String name)	Look up the given object using its JNDI name.
void	setField(FacesContext facesContext, Field field, Object instance, Object value)	Set the field.

Methods inherited from class java.lang.Object

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

Field Details

JAVA_COMP_ENV

protected static final String JAVA_COMP_ENV

Stores the java:comp/env/ prefix

See Also:

• Constant Field Values

Constructor Details

JndiHandler

public JndiHandler()

Method Details

lookup

public Object lookup(FacesContext facesContext,
 String name)

Look up the given object using its JNDI name.

Parameters:

facesContext - the Faces context.

name - the JNDI name.

Returns:

the object, or null if an error occurs.

setField

public void setField(FacesContext facesContext,
 Field field,
 Object instance,
 Object value)

Set the field.

Parameters:

facesContext - the Faces context.

field - the field.

instance - the instance.

value - the value.

invokeMethod

protected void invokeMethod(FacesContext facesContext,
 Method method,
 Object instance,
 Object value)

Invoke the method.

Parameters:

facesContext - the Faces context.

method - the method.

instance - the instance.

value - the value.

apply

void apply(FacesContext ctx,
 Object... params)

Apply the Annotation(s). The act of doing so should affect the Faces runtime in some fashion (see the spec for the specific annotation types).

NOTE: when adding new types of components that can be annotated, the fact that we expose varargs here should be hidden. Type-safe methods should be added to AnnotationManager to clarify the contract.

Parameters:

ctx - the FacesContext for the current request

params - one or more arguments to the handler instance. The type and number may vary.