com.cedarsoftware.util.io

Class MetaUtils

java.lang.Object

com.cedarsoftware.util.io.MetaUtils

public class MetaUtils
extends Object

This utility class has the methods mostly related to reflection related code.

Author:

John DeRegnaucourt ([email protected])
Copyright (c) Cedar Software LLC

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.*

Constructor Summary

Constructors

Constructor and Description
MetaUtils()

Method Summary

Modifier and Type	Method and Description
static Map<String,Field>	getDeepDeclaredFields(Class c)
static int	getDistance(Class a, Class b)
static Field	getField(Class c, String field) Return an instance of of the Java Field class corresponding to the passed in field name.
static boolean	isLogicalPrimitive(Class c)
static boolean	isPrimitive(Class c)
static void	setUseUnsafe(boolean state)

Methods inherited from class java.lang.Object

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

Constructor Detail

MetaUtils

public MetaUtils()

Method Detail

setUseUnsafe

public static void setUseUnsafe(boolean state)

getField

public static Field getField(Class c,
                             String field)

Return an instance of of the Java Field class corresponding to the passed in field name.

Parameters:

c - class containing the field / field name

field - String name of a field on the class.

Returns:

Field instance if the field with the corresponding name is found, null otherwise.

getDeepDeclaredFields

public static Map<String,Field> getDeepDeclaredFields(Class c)

Parameters:

c - Class instance

Returns:

ClassMeta which contains fields of class. The results are cached internally for performance when called again with same Class.

getDistance

public static int getDistance(Class a,
                              Class b)

Parameters:

a - Class source class

b - Class target class

Returns:

inheritance distance between two classes, or Integer.MAX_VALUE if they are not related. Each step upward in the inheritance from one class to the next (calling class.getSuperclass()) is counted as 1.

isPrimitive

public static boolean isPrimitive(Class c)

Parameters:

c - Class to test

Returns:

boolean true if the passed in class is a Java primitive, false otherwise. The Wrapper classes Integer, Long, Boolean, etc. are consider primitives by this method.

isLogicalPrimitive

public static boolean isLogicalPrimitive(Class c)

Parameters:

c - Class to test

Returns:

boolean true if the passed in class is a 'logical' primitive. A logical primitive is defined as all Java primitives, the primitive wrapper classes, String, Number, and Class. The reason these are considered 'logical' primitives is that they are immutable and therefore can be written without references in JSON content (making the JSON more readable - less @id / @ref), without breaking the semantics (shape) of the object graph being written.