org.apache.jasper.runtime

Class ProtectedFunctionMapper

Implemented Interfaces:
FunctionMapper

public final class ProtectedFunctionMapper
extends java.lang.Object
implements FunctionMapper

Maps EL functions to their Java method counterparts. Keeps the actual Method objects protected so that JSP pages can't indirectly do reflection.
Authors:
Mark Roth
Kin-man Chung

Method Summary

static ProtectedFunctionMapper
getInstance()
Generated Servlet and Tag Handler implementations call this method to retrieve an instance of the ProtectedFunctionMapper.
static ProtectedFunctionMapper
getMapForFunction(String fnQName, Class c, String methodName, Class[] args)
Creates an instance for this class, and stores the Method for the given EL function prefix and name.
void
mapFunction(String fnQName, Class c, String methodName, Class[] args)
Stores a mapping from the given EL function prefix and name to the given Java method.
Method
resolveFunction(String prefix, String localName)
Resolves the specified local name and prefix into a Java.lang.Method.

Method Details

getInstance

public static ProtectedFunctionMapper getInstance()
Generated Servlet and Tag Handler implementations call this method to retrieve an instance of the ProtectedFunctionMapper. This is necessary since generated code does not have access to create instances of classes in this package.
Returns:
A new protected function mapper.

getMapForFunction

public static ProtectedFunctionMapper getMapForFunction(String fnQName,
                                                        Class c,
                                                        String methodName,
                                                        Class[] args)
Creates an instance for this class, and stores the Method for the given EL function prefix and name. This method is used for the case when there is only one function in the EL expression.
Parameters:
fnQName - The EL function qualified name (including prefix)
c - The class containing the Java method
methodName - The name of the Java method
args - The arguments of the Java method

mapFunction

public void mapFunction(String fnQName,
                        Class c,
                        String methodName,
                        Class[] args)
Stores a mapping from the given EL function prefix and name to the given Java method.
Parameters:
fnQName - The EL function qualified name (including prefix)
c - The class containing the Java method
methodName - The name of the Java method
args - The arguments of the Java method

resolveFunction

public Method resolveFunction(String prefix,
                              String localName)
Resolves the specified local name and prefix into a Java.lang.Method. Returns null if the prefix and local name are not found.
Parameters:
prefix - the prefix of the function
localName - the short name of the function
Returns:
the result of the method mapping. Null means no entry found.

Copyright ?? 2000-2004 Apache Software Foundation. All Rights Reserved.