Package org.apache.commons.ognl
Class OgnlRuntime
java.lang.Object
org.apache.commons.ognl.OgnlRuntime
Utility class used by internal OGNL API to do various things like:
- Handles majority of reflection logic / caching.
- Utility methods for casting strings / various numeric types used by
OgnlExpressionCompiler
.invalid input: '<'/li. - Core runtime configuration point for setting/using global
TypeConverter
/OgnlExpressionCompiler
/NullHandler
instances / etc..
-
Field Summary
FieldsModifier and TypeFieldDescription(package private) static OgnlCache
private static OgnlExpressionCompiler
Expression compiler used byOgnl.compileExpression(OgnlContext, Object, String)
calls.static final String
Java beans standard get method prefix.private static final int
Prefix padding for hexadecimal numbers to HEX_LENGTH.static final int
JavaBeans IndexedPropertystatic final int
Not an indexed propertystatic final int
OGNL ObjectIndexedPropertystatic final String
Java beans standard isboolean getter prefix. static final Object[]
static final Object
Token returned by TypeConverter for no conversion possiblestatic final Object
Constant expression used to indicate that a given method / property couldn't be found during reflection operations.private static final String
Returned bygetUniqueDescriptor()
when the object isnull
.static final String
Constant string representation of null string.private static final NumericCasts
Constant strings for casting different primitive types.private static final NumericDefaults
private static final NumericLiterals
Numeric primitive literal string expressions.private static final NumericValues
Constant strings for getting the primitive value of different native types on the genericNumber
object interface.private static final PrimitiveDefaults
private static final PrimitiveTypes
private static final PrimitiveWrapperClasses
Used to provide primitive type equivalent conversions into and out of native / object types.private static SecurityManager
static final String
Java beans standard set method prefix. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
areArgsCompatible
(Object[] args, Class<?>[] classes) Tells whether the given array of objects is compatible with the given array of classes---that is, whether the given array of objects can be passed as arguments to a method or constructor whose parameter types are the given array of classes.static boolean
areArgsCompatible
(Object[] args, Class<?>[] classes, Method method) static Object
callAppropriateMethod
(OgnlContext context, Object source, Object target, String methodName, String propertyName, List<Method> methods, Object[] args) static Object
callConstructor
(OgnlContext context, String className, Object[] args) static Object
callMethod
(OgnlContext context, Object target, String methodName, Object[] args) Invokes the specified method against the target object.static Object
callStaticMethod
(OgnlContext context, String className, String methodName, Object[] args) static Class
<?> classForName
(OgnlContext context, String className) static void
Clears all of the cached reflection information normally used to improve the speed of expressions that operate on the same classes or are executed multiple times.static void
compileExpression
(OgnlContext context, Node expression, Object root) static Class<?>[]
findParameterTypes
(Class<?> type, Method method) static Method
getAppropriateMethod
(OgnlContext context, Object source, Object target, String propertyName, List<Method> methods, Object[] args, Object[] actualArgs) Gets the appropriate method to be called for the given target, method name and arguments.static Class
<?> getArgClass
(Object arg) Gets the class for a method argument that is appropriate for looking up methods by reflection, by looking for the standard primitive wrapper classes and exchanging for them their underlying primitive class objects.static String
Returns the base name (the class name without the package name prepended) of the object given.static String
getChildSource
(OgnlContext context, Object target, Node child) Attempts to get the java source string represented by the specific child expression via theJavaSource.toGetSourceString(OgnlContext, Object)
interface method.static String
getChildSource
(OgnlContext context, Object target, Node child, boolean forceConversion) Attempts to get the java source string represented by the specific child expression via theJavaSource.toGetSourceString(OgnlContext, Object)
interface method.static String
getClassBaseName
(Class<?> clazz) Returns the base name (the class name without the package name prepended) of the class given.static String
getClassName
(Class<?> clazz, boolean fullyQualified) static String
getClassName
(Object object, boolean fullyQualified) static String
getClassPackageName
(Class<?> clazz) Returns the package name of the class given.static OgnlExpressionCompiler
getCompiler
(OgnlContext ognlContext) static List
<Constructor<?>> getConstructors
(Class<?> targetClass) static Constructor
<?> getConvertedConstructorAndArgs
(OgnlContext context, Object target, List<Constructor<?>> constructors, Object[] args, Object[] newArgs) static Method
getConvertedMethodAndArgs
(OgnlContext context, Object target, String propertyName, List<Method> methods, Object[] args, Object[] newArgs) static Object
getConvertedType
(OgnlContext context, Object target, Member member, String propertyName, Object value, Class<?> type) static boolean
getConvertedTypes
(OgnlContext context, Object target, Member member, String propertyName, Class<?>[] parameterTypes, Object[] args, Object[] newArgs) getDeclaredMethods
(Class<?> targetClass, String propertyName, boolean findSets) static ElementsAccessor
getElementsAccessor
(Class<?> clazz) static Field
static Object
getFieldValue
(OgnlContext context, Object target, String propertyName) static Object
getFieldValue
(OgnlContext context, Object target, String propertyName, boolean checkAccessAndExistence) static Method
getGetMethod
(OgnlContext unused, Class<?> targetClass, String propertyName) static Object
getIndexedProperty
(OgnlContext context, Object source, String name, Object index) static int
getIndexedPropertyType
(OgnlContext context, Class<?> sourceClass, String name) Determines the index property type, if any.static Method
getMethod
(OgnlContext context, Class<?> target, String name, Node[] children, boolean includeStatic) static MethodAccessor
getMethodAccessor
(Class<?> clazz) getMethods
(Class<?> targetClass, boolean staticMethods) getMethods
(Class<?> targetClass, String name, boolean staticMethods) static Object
getMethodValue
(OgnlContext context, Object target, String propertyName) static Object
getMethodValue
(OgnlContext context, Object target, String propertyName, boolean checkAccessAndExistence) If the checkAccessAndExistence flag is true this method will check to see if the method exists and if it is accessible according to the context's MemberAccess.static NullHandler
getNullHandler
(Class<?> clazz) static String
getNumericCast
(Class<? extends Number> type) static Object
getNumericDefaultValue
(Class<?> forClass) static String
getNumericLiteral
(Class<? extends Number> type) static String
getNumericValueGetter
(Class<?> type) static String
getPackageName
(Object object) Returns the package name of the object's class.static Class<?>[]
getParameterTypes
(Constructor<?> constructor) Returns the parameter types of the given method.static Class<?>[]
getParameterTypes
(Method method) Returns the parameter types of the given method.static Permission
getPermission
(Method method) Permission will be named "invoke.invalid input: '<'declaring-class>.invalid input: '<'method-name>".static String
getPointerString
(int num) Returns a "pointer" string in the usual format for these things - 0x. static String
getPointerString
(Object object) Returns a "pointer" string in the usual format for these things - 0xfor the object given. static Object
getPrimitiveDefaultValue
(Class<?> forClass) static Class
<?> getPrimitiveWrapperClass
(Class<?> primitiveClass) static PropertyDescriptor
getProperty
(Class<?> target, String name) static Object
getProperty
(OgnlContext context, Object source, Object name) static PropertyAccessor
getPropertyAccessor
(Class<?> clazz) static PropertyDescriptor
getPropertyDescriptor
(Class<?> targetClass, String propertyName) This method returns a PropertyDescriptor for the given class and property name using a Map lookup (using getPropertyDescriptorsMap()).static PropertyDescriptor
getPropertyDescriptorFromArray
(Class<?> targetClass, String name) Gets the property descriptor with the given name for the target class given.static Map
<String, PropertyDescriptor> getPropertyDescriptors
(Class<?> targetClass) This method returns the property descriptors for the given class as a Map.static PropertyDescriptor[]
getPropertyDescriptorsArray
(Class<?> targetClass) static Method
getReadMethod
(Class<?> target, String name) Finds the best possible match for a method on the specified target class with a matching name.static Method
getReadMethod
(Class<?> target, String name, int numParms) static SecurityManager
Gets the SecurityManager that OGNL uses to determine permissions for invoking methods.static Method
getSetMethod
(OgnlContext context, Class<?> targetClass, String propertyName) static Object
getStaticField
(OgnlContext context, String className, String fieldName) static Class
<?> Gets the "target" class of an object for looking up accessors that are registered on the target.static String
getUniqueDescriptor
(Object object) Returns a unique descriptor string that includes the object's class' base name and a unique integer identifier.static String
getUniqueDescriptor
(Object object, boolean fullyQualified) Returns a unique descriptor string that includes the object's class and a unique integer identifier.static Method
getWriteMethod
(Class<?> target, String name) static Method
getWriteMethod
(Class<?> target, String name, int numParms) static boolean
hasField
(OgnlContext context, Object target, Class<?> inClass, String propertyName) static boolean
hasGetMethod
(OgnlContext context, Object target, Class<?> targetClass, String propertyName) static boolean
hasGetProperty
(OgnlContext context, Object target, Object oname) static boolean
hasSetMethod
(OgnlContext context, Object target, Class<?> targetClass, String propertyName) static boolean
hasSetProperty
(OgnlContext context, Object target, Object oname) static Object
invokeMethod
(Object target, Method method, Object[] argsArray) static boolean
static boolean
isFieldAccessible
(OgnlContext context, Object target, Class<?> inClass, String propertyName) static boolean
isFieldAccessible
(OgnlContext context, Object target, Field field, String propertyName) static boolean
isInstance
(OgnlContext context, Object value, String className) static boolean
isMethodAccessible
(OgnlContext context, Object target, Method method, String propertyName) static boolean
isMethodCallable
(Method method) Convenience used to check if a method is volatile or synthetic so as to avoid calling un-callable methods.static boolean
isMoreSpecific
(Class<?>[] classes1, Class<?>[] classes2) Tells whether the first array of classes is more specific than the second.static boolean
isTypeCompatible
(Object object, Class<?> clazz) Tells whether the given object is compatible with the given class ---that is, whether the given object can be passed as an argument to a method or constructor whose parameter type is the given class.static void
setClassCacheInspector
(ClassCacheInspector inspector) Registers the specifiedClassCacheInspector
with all class reflection based internal caches.static void
setCompiler
(OgnlExpressionCompiler compiler) static void
setElementsAccessor
(Class<?> clazz, ElementsAccessor accessor) static boolean
setFieldValue
(OgnlContext context, Object target, String propertyName, Object value) static void
setIndexedProperty
(OgnlContext context, Object source, String name, Object index, Object value) static void
setMethodAccessor
(Class<?> clazz, MethodAccessor accessor) static boolean
setMethodValue
(OgnlContext context, Object target, String propertyName, Object value) static boolean
setMethodValue
(OgnlContext context, Object target, String propertyName, Object value, boolean checkAccessAndExistence) static void
setNullHandler
(Class<?> clazz, NullHandler handler) static void
setProperty
(OgnlContext context, Object target, Object name, Object value) static void
setPropertyAccessor
(Class<?> clazz, PropertyAccessor accessor) static void
setSecurityManager
(SecurityManager securityManager) Sets the SecurityManager that OGNL uses to determine permissions for invoking methods.static boolean
shouldConvertNumericTypes
(OgnlContext context) Compares theOgnlContext.getCurrentType()
andOgnlContext.getPreviousType()
class types on the stack to determine if a numeric expression should force object conversion.static <T> Object[]
Utility to convert a List into an Object[] array.
-
Field Details
-
NotFound
Constant expression used to indicate that a given method / property couldn't be found during reflection operations. -
NoArguments
-
NoConversionPossible
Token returned by TypeConverter for no conversion possible -
INDEXED_PROPERTY_NONE
public static final int INDEXED_PROPERTY_NONENot an indexed property- See Also:
-
INDEXED_PROPERTY_INT
public static final int INDEXED_PROPERTY_INTJavaBeans IndexedProperty- See Also:
-
INDEXED_PROPERTY_OBJECT
public static final int INDEXED_PROPERTY_OBJECTOGNL ObjectIndexedProperty- See Also:
-
NULL_STRING
Constant string representation of null string. -
SET_PREFIX
Java beans standard set method prefix.- See Also:
-
GET_PREFIX
Java beans standard get method prefix.- See Also:
-
IS_PREFIX
Java beans standard isboolean getter prefix. - See Also:
-
HEX_PADDING
Prefix padding for hexadecimal numbers to HEX_LENGTH. -
HEX_LENGTH
private static final int HEX_LENGTH- See Also:
-
NULL_OBJECT_STRING
Returned bygetUniqueDescriptor()
when the object isnull
.- See Also:
-
cache
-
primitiveTypes
-
primitiveDefaults
-
securityManager
-
compiler
Expression compiler used byOgnl.compileExpression(OgnlContext, Object, String)
calls. -
primitiveWrapperClasses
Used to provide primitive type equivalent conversions into and out of native / object types. -
numericCasts
Constant strings for casting different primitive types. -
numericValues
Constant strings for getting the primitive value of different native types on the genericNumber
object interface. (or the less generic BigDecimal/BigInteger types) -
numericLiterals
Numeric primitive literal string expressions. -
numericDefaults
-
-
Constructor Details
-
OgnlRuntime
public OgnlRuntime()
-
-
Method Details
-
clearCache
public static void clearCache()Clears all of the cached reflection information normally used to improve the speed of expressions that operate on the same classes or are executed multiple times.Warning: Calling this too often can be a huge performance drain on your expressions - use with care.
-
getNumericValueGetter
-
getPrimitiveWrapperClass
-
getNumericCast
-
getNumericLiteral
-
setCompiler
-
getCompiler
-
compileExpression
public static void compileExpression(OgnlContext context, Node expression, Object root) throws Exception - Throws:
Exception
-
getTargetClass
Gets the "target" class of an object for looking up accessors that are registered on the target. If the object is a Class object this will return the Class itself, else it will return object's getClass() result. -
getBaseName
Returns the base name (the class name without the package name prepended) of the object given. -
getClassBaseName
Returns the base name (the class name without the package name prepended) of the class given. -
getClassName
-
getClassName
-
getPackageName
Returns the package name of the object's class. -
getClassPackageName
Returns the package name of the class given. -
getPointerString
Returns a "pointer" string in the usual format for these things - 0x. -
getPointerString
Returns a "pointer" string in the usual format for these things - 0xfor the object given. This will always return a unique value for each object. -
getUniqueDescriptor
Returns a unique descriptor string that includes the object's class and a unique integer identifier. If fullyQualified is true then the class name will be fully qualified to include the package name, else it will be just the class' base name. -
getUniqueDescriptor
Returns a unique descriptor string that includes the object's class' base name and a unique integer identifier. -
toArray
Utility to convert a List into an Object[] array. If the list is zero elements this will return a constant array; toArray() on List always returns a new object and this is wasteful for our purposes. -
getParameterTypes
Returns the parameter types of the given method.- Throws:
CacheException
-
findParameterTypes
Finds the appropriate parameter types for the givenMethod
andClass
instance of the type the method is associated with. Correctly finds generic types if running in >= 1.5 jre as well.- Parameters:
type
- The class type the method is being executed against.method
- The method to find types for.- Returns:
- Array of parameter types for the given method.
- Throws:
CacheException
-
getParameterTypes
Returns the parameter types of the given method.- Parameters:
constructor
-- Returns:
- Throws:
CacheException
-
getSecurityManager
Gets the SecurityManager that OGNL uses to determine permissions for invoking methods.- Returns:
- SecurityManager for OGNL
-
setSecurityManager
Sets the SecurityManager that OGNL uses to determine permissions for invoking methods.- Parameters:
securityManager
- SecurityManager to set
-
getPermission
Permission will be named "invoke.invalid input: '<'declaring-class>.invalid input: '<'method-name>".- Parameters:
method
-- Returns:
- Throws:
CacheException
-
invokeMethod
public static Object invokeMethod(Object target, Method method, Object[] argsArray) throws InvocationTargetException, IllegalAccessException, CacheException -
getArgClass
Gets the class for a method argument that is appropriate for looking up methods by reflection, by looking for the standard primitive wrapper classes and exchanging for them their underlying primitive class objects. Other classes are passed through unchanged.- Parameters:
arg
- an object that is being passed to a method- Returns:
- the class to use to look up the method
-
isTypeCompatible
Tells whether the given object is compatible with the given class ---that is, whether the given object can be passed as an argument to a method or constructor whose parameter type is the given class. If object is null this will return true because null is compatible with any type. -
areArgsCompatible
Tells whether the given array of objects is compatible with the given array of classes---that is, whether the given array of objects can be passed as arguments to a method or constructor whose parameter types are the given array of classes. -
areArgsCompatible
-
isMoreSpecific
Tells whether the first array of classes is more specific than the second. Assumes that the two arrays are of the same length. -
classForName
public static Class<?> classForName(OgnlContext context, String className) throws ClassNotFoundException - Throws:
ClassNotFoundException
-
isInstance
public static boolean isInstance(OgnlContext context, Object value, String className) throws OgnlException - Throws:
OgnlException
-
getPrimitiveDefaultValue
-
getNumericDefaultValue
-
getConvertedType
-
getConvertedTypes
-
getConvertedMethodAndArgs
-
getConvertedConstructorAndArgs
public static Constructor<?> getConvertedConstructorAndArgs(OgnlContext context, Object target, List<Constructor<?>> constructors, Object[] args, Object[] newArgs) -
getAppropriateMethod
public static Method getAppropriateMethod(OgnlContext context, Object source, Object target, String propertyName, List<Method> methods, Object[] args, Object[] actualArgs) Gets the appropriate method to be called for the given target, method name and arguments. If successful this method will return the Method within the target that can be called and the converted arguments in actualArgs. If unsuccessful this method will return null and the actualArgs will be empty.- Parameters:
context
- The current execution context.source
- Target object to run against or method name.target
- Instance of object to be run against.propertyName
- Name of property to get method of.methods
- List of current known methods.args
- Arguments originally passed in.actualArgs
- Converted arguments.- Returns:
- Best method match or null if none could be found.
-
callAppropriateMethod
public static Object callAppropriateMethod(OgnlContext context, Object source, Object target, String methodName, String propertyName, List<Method> methods, Object[] args) throws MethodFailedException - Throws:
MethodFailedException
-
callStaticMethod
public static Object callStaticMethod(OgnlContext context, String className, String methodName, Object[] args) throws OgnlException - Throws:
OgnlException
-
callMethod
public static Object callMethod(OgnlContext context, Object target, String methodName, Object[] args) throws OgnlException Invokes the specified method against the target object.- Parameters:
context
- The current execution context.target
- The object to invoke the method on.methodName
- Name of the method - as in "getValue" or "add", etc..args
- Optional arguments needed for method.- Returns:
- Result of invoking method.
- Throws:
OgnlException
- For lots of different reasons.
-
callConstructor
public static Object callConstructor(OgnlContext context, String className, Object[] args) throws OgnlException - Throws:
OgnlException
-
getMethodValue
public static Object getMethodValue(OgnlContext context, Object target, String propertyName) throws OgnlException, IllegalAccessException, NoSuchMethodException, IntrospectionException -
getMethodValue
public static Object getMethodValue(OgnlContext context, Object target, String propertyName, boolean checkAccessAndExistence) throws OgnlException, IllegalAccessException, NoSuchMethodException, IntrospectionException If the checkAccessAndExistence flag is true this method will check to see if the method exists and if it is accessible according to the context's MemberAccess. If neither test passes this will return NotFound. -
setMethodValue
public static boolean setMethodValue(OgnlContext context, Object target, String propertyName, Object value) throws OgnlException, IllegalAccessException, NoSuchMethodException, IntrospectionException -
setMethodValue
public static boolean setMethodValue(OgnlContext context, Object target, String propertyName, Object value, boolean checkAccessAndExistence) throws OgnlException, IllegalAccessException, NoSuchMethodException, IntrospectionException -
getConstructors
-
getMethods
- Parameters:
targetClass
-staticMethods
- if true (false) returns only the (non-)static methods- Returns:
- Returns the map of methods for a given class
-
getMethods
-
getFields
-
getField
-
getFieldValue
public static Object getFieldValue(OgnlContext context, Object target, String propertyName) throws NoSuchFieldException - Throws:
NoSuchFieldException
-
getFieldValue
public static Object getFieldValue(OgnlContext context, Object target, String propertyName, boolean checkAccessAndExistence) throws NoSuchFieldException - Throws:
NoSuchFieldException
-
setFieldValue
public static boolean setFieldValue(OgnlContext context, Object target, String propertyName, Object value) throws OgnlException - Throws:
OgnlException
-
isFieldAccessible
public static boolean isFieldAccessible(OgnlContext context, Object target, Class<?> inClass, String propertyName) -
isFieldAccessible
public static boolean isFieldAccessible(OgnlContext context, Object target, Field field, String propertyName) -
hasField
public static boolean hasField(OgnlContext context, Object target, Class<?> inClass, String propertyName) -
getStaticField
public static Object getStaticField(OgnlContext context, String className, String fieldName) throws OgnlException - Throws:
OgnlException
-
getDeclaredMethods
public static List<Method> getDeclaredMethods(Class<?> targetClass, String propertyName, boolean findSets) - Parameters:
targetClass
-propertyName
-findSets
-- Returns:
- Returns the list of (g)setter of a class for a given property name
-
isMethodCallable
Convenience used to check if a method is volatile or synthetic so as to avoid calling un-callable methods.- Parameters:
method
- The method to check.- Returns:
- True if the method should be callable, false otherwise.
-
getGetMethod
public static Method getGetMethod(OgnlContext unused, Class<?> targetClass, String propertyName) throws IntrospectionException, OgnlException - Throws:
IntrospectionException
OgnlException
-
isMethodAccessible
public static boolean isMethodAccessible(OgnlContext context, Object target, Method method, String propertyName) -
hasGetMethod
public static boolean hasGetMethod(OgnlContext context, Object target, Class<?> targetClass, String propertyName) throws IntrospectionException, OgnlException - Throws:
IntrospectionException
OgnlException
-
getSetMethod
public static Method getSetMethod(OgnlContext context, Class<?> targetClass, String propertyName) throws IntrospectionException, OgnlException - Throws:
IntrospectionException
OgnlException
-
hasSetMethod
public static boolean hasSetMethod(OgnlContext context, Object target, Class<?> targetClass, String propertyName) throws IntrospectionException, OgnlException - Throws:
IntrospectionException
OgnlException
-
hasGetProperty
public static boolean hasGetProperty(OgnlContext context, Object target, Object oname) throws IntrospectionException, OgnlException - Throws:
IntrospectionException
OgnlException
-
hasSetProperty
public static boolean hasSetProperty(OgnlContext context, Object target, Object oname) throws IntrospectionException, OgnlException - Throws:
IntrospectionException
OgnlException
-
getPropertyDescriptors
public static Map<String,PropertyDescriptor> getPropertyDescriptors(Class<?> targetClass) throws IntrospectionException, OgnlException This method returns the property descriptors for the given class as a Map.- Parameters:
targetClass
- The class to get the descriptors for.- Returns:
- Map map of property descriptors for class.
- Throws:
IntrospectionException
- on errors usingIntrospector
.OgnlException
- On general errors.
-
getPropertyDescriptor
public static PropertyDescriptor getPropertyDescriptor(Class<?> targetClass, String propertyName) throws IntrospectionException, OgnlException This method returns a PropertyDescriptor for the given class and property name using a Map lookup (using getPropertyDescriptorsMap()).- Parameters:
targetClass
- a target class.propertyName
- a property name.- Returns:
- the PropertyDescriptor for the given targetClass and propertyName.
- Throws:
IntrospectionException
OgnlException
-
getPropertyDescriptorsArray
public static PropertyDescriptor[] getPropertyDescriptorsArray(Class<?> targetClass) throws IntrospectionException, OgnlException - Throws:
IntrospectionException
OgnlException
-
getPropertyDescriptorFromArray
public static PropertyDescriptor getPropertyDescriptorFromArray(Class<?> targetClass, String name) throws IntrospectionException, OgnlException Gets the property descriptor with the given name for the target class given.- Parameters:
targetClass
- Class for which property descriptor is desiredname
- Name of property- Returns:
- PropertyDescriptor of the named property or null if the class has no property with the given name
- Throws:
IntrospectionException
OgnlException
-
setMethodAccessor
-
getMethodAccessor
- Throws:
OgnlException
-
setPropertyAccessor
-
getPropertyAccessor
- Throws:
OgnlException
-
getElementsAccessor
- Throws:
OgnlException
-
setElementsAccessor
-
getNullHandler
- Throws:
OgnlException
-
setNullHandler
-
getProperty
public static Object getProperty(OgnlContext context, Object source, Object name) throws OgnlException - Throws:
OgnlException
-
setProperty
public static void setProperty(OgnlContext context, Object target, Object name, Object value) throws OgnlException - Throws:
OgnlException
-
getIndexedPropertyType
public static int getIndexedPropertyType(OgnlContext context, Class<?> sourceClass, String name) throws OgnlException Determines the index property type, if any. ReturnsINDEXED_PROPERTY_NONE
if the property is not index-accessible as determined by OGNL or JavaBeans. If it is indexable then this will return whether it is a JavaBeans indexed property, conforming to the indexed property patterns (returnsINDEXED_PROPERTY_INT
) or if it conforms to the OGNL arbitrary object indexable (returnsINDEXED_PROPERTY_OBJECT
).- Throws:
OgnlException
-
getIndexedProperty
public static Object getIndexedProperty(OgnlContext context, Object source, String name, Object index) throws OgnlException - Throws:
OgnlException
-
setIndexedProperty
public static void setIndexedProperty(OgnlContext context, Object source, String name, Object index, Object value) throws OgnlException - Throws:
OgnlException
-
setClassCacheInspector
Registers the specifiedClassCacheInspector
with all class reflection based internal caches. This may have a significant performance impact so be careful using this in production scenarios.- Parameters:
inspector
- The inspector instance that will be registered with all internal cache instances.
-
getMethod
public static Method getMethod(OgnlContext context, Class<?> target, String name, Node[] children, boolean includeStatic) throws Exception - Throws:
Exception
-
getReadMethod
Finds the best possible match for a method on the specified target class with a matching name.The name matched will also try different combinations like
is + name, has + name, get + name, etc..
- Parameters:
target
- The class to find a matching method against.name
- The name of the method.- Returns:
- The most likely matching
Method
, or null if none could be found.
-
getReadMethod
-
getWriteMethod
-
getWriteMethod
-
getProperty
-
isBoolean
-
shouldConvertNumericTypes
Compares theOgnlContext.getCurrentType()
andOgnlContext.getPreviousType()
class types on the stack to determine if a numeric expression should force object conversion. Normally used in conjunction with theforceConversion
parameter ofgetChildSource(OgnlContext, Object, Node, boolean)
.- Parameters:
context
- The current context.- Returns:
- True, if the class types on the stack wouldn't be comparable in a pure numeric expression such as
o1 >= o2
.
-
getChildSource
public static String getChildSource(OgnlContext context, Object target, Node child) throws OgnlException Attempts to get the java source string represented by the specific child expression via theJavaSource.toGetSourceString(OgnlContext, Object)
interface method.- Parameters:
context
- The ognl context to pass to the child.target
- The current object target to use.child
- The child expression.- Returns:
- The result of calling
JavaSource.toGetSourceString(OgnlContext, Object)
plus additional enclosures ofOgnlOps.convertValue(Object, Class, boolean)
for conversions. - Throws:
OgnlException
- Mandatory exception throwing catching.. (blehh)
-
getChildSource
public static String getChildSource(OgnlContext context, Object target, Node child, boolean forceConversion) throws OgnlException Attempts to get the java source string represented by the specific child expression via theJavaSource.toGetSourceString(OgnlContext, Object)
interface method.- Parameters:
context
- The ognl context to pass to the child.target
- The current object target to use.child
- The child expression.forceConversion
- If true, forcesOgnlOps.convertValue(Object, Class)
conversions on the objects.- Returns:
- The result of calling
JavaSource.toGetSourceString(OgnlContext, Object)
plus additional enclosures ofOgnlOps.convertValue(Object, Class, boolean)
for conversions. - Throws:
OgnlException
- Mandatory exception throwing catching.. (blehh)
-