org.bbottema.javareflection.BeanUtils Maven / Gradle / Ivy
Show all versions of java-reflection Show documentation
package org.bbottema.javareflection;
import lombok.experimental.UtilityClass;
import org.bbottema.javareflection.util.commonslang25.StringUtils;
import org.bbottema.javareflection.model.FieldWrapper;
import org.bbottema.javareflection.model.InvokableObject;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.util.Arrays;
import java.util.EnumSet;
import java.util.HashMap;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;
/**
* A {@link Field} shorthand utility class used to collect fields from classes meeting Java Bean restrictions/requirements.
*
* With this utility class you can perform field lookups, by combining lookup restriction criteria.
*
* Example
* "find all fields on a class Apple, not looking at its super classes, which should be protected, have a getter method, but not a setter
* method"
*
*
* FieldUtils.collectFields(Apple.class, Apple.class, EnumSet.of(Visibility.PROTECTED),
* EnumSet.of(BeanRestriction.YES_GETTER, BeanRestriction.NO_SETTER));
*
*
* @see #collectFields(Class, Class, EnumSet, EnumSet)
*/
@UtilityClass
public final class BeanUtils {
/**
* Determines what visibility modifiers a field is allowed to have in {@link BeanUtils#collectFields(Class, Class, EnumSet, EnumSet)}.
*/
public enum Visibility {
/**
* Visibility flag that corresponds with java's keyword private.
*/
PRIVATE(Modifier.PRIVATE),
/**
* Visibility flag that corresponds with java's visibility modifier default (package protected).
*/
DEFAULT(-1), // no Java equivalent
/**
* Visibility flag that corresponds with java's keyword protected.
*/
PROTECTED(Modifier.PROTECTED),
/**
* Visibility flag that corresponds with java's keyword public.
*/
PUBLIC(Modifier.PUBLIC);
private final int modifierFlag;
Visibility(final int modifierFlag) {
this.modifierFlag = modifierFlag;
}
}
/**
* Indicates whether a field needs a Bean setter or getter, exactly none or any combination thereof. Determines what kind of fields are
* potential collection candidates.
*/
public enum BeanRestriction {
/**
* Restriction flag that indicates a getter method is required.
*/
YES_GETTER,
/**
* Restriction flag that indicates a setter method is required.
*/
YES_SETTER,
/**
* Restriction flag that indicates no setter must be available.
*/
NO_SETTER,
/**
* Restriction flag that indicates a getter must be available.
*/
NO_GETTER
}
/**
* Verifies is a given method occurs as setter or getter in the declaring class chain.
*
* Lookup can be configured to check only against specific visibility.
*
* @param method The method to match against getters/setters of a certain visibility
* @param boundaryMarker The last class> or interface implementing class that methods are matched against. Can
* be used to prevent matching methods on a super class.
* @param visibility A set of visibility requirements (ie. {@link Visibility#PROTECTED} indicates a *field* for which getter/setter are checked
* is allowed to have protected visibility). Note: the visibility modifiers for methods are ignored.
* @return Whether given method is a setter / getter within given restriction boundaries.
*/
@SuppressWarnings({"unused", "WeakerAccess"})
public static boolean isBeanMethod(final Method method, final Class boundaryMarker,
final EnumSet visibility) {
Map, List> fields = collectFields(method.getDeclaringClass(), boundaryMarker, visibility,
EnumSet.noneOf(BeanRestriction.class));
for (List fieldWrappers : fields.values()) {
for (FieldWrapper fieldWrapper : fieldWrappers) {
if (method.equals(fieldWrapper.getGetter()) || method.equals(fieldWrapper.getSetter())) {
return true;
}
}
}
return false;
}
/**
* Returns a pool of {@link Field} wrappers including optional relevant setter/getter methods, collected from the given class tested
* against the given visibility and Bean restriction requirements.
*
* The returned fields are mapped against the classes they were found on, since field names can be declared multiple times with the same
* name.
*
* @param _class The class (and chain) to harvest fields from.
* @param boundaryMarker The last class> or interface implementing class that fields are collected from. Can
* be used to prevent finding fields on a super class.
* @param visibility A set of visibility requirements (ie. {@link Visibility#PROTECTED} indicates a field is allowed to have
* protected visibility).
* @param beanRestrictions A set of Bean restriction requirements indicating a field should or shouldn't have a setter, getter or both.
* @return A Map per class in the chain with the fields declared by that class.
* @see #meetsVisibilityRequirements(Field, EnumSet)
* @see #resolveBeanProperty(Field, EnumSet)
*/
@SuppressWarnings("WeakerAccess")
@NotNull
public static Map, List> collectFields(final Class _class, final Class boundaryMarker,
final EnumSet visibility, final EnumSet beanRestrictions) {
final Map, List> fields = new HashMap<>();
final Field[] allFields = _class.getDeclaredFields();
final List filteredFields = new LinkedList<>();
for (final Field field : allFields) {
if (meetsVisibilityRequirements(field, visibility)) {
final FieldWrapper property = resolveBeanProperty(field, beanRestrictions);
if (property != null) {
filteredFields.add(property);
}
}
}
fields.put(_class, filteredFields);
// determine if we need to look deeper
final List> interfaces = Arrays.asList(_class.getInterfaces());
if (!_class.equals(boundaryMarker) && !interfaces.contains(boundaryMarker)) {
fields.putAll(collectFields(_class.getSuperclass(), boundaryMarker, visibility, beanRestrictions));
}
return fields;
}
/**
* Determines if the visibility modifiers of a given {@link Field} is included in the set of flags.
*
* @param field The field who's visibility modifiers we want to test.
* @param visibility List of {@link Visibility} flags to test against.
* @return Whether a given field has one of the specified visibility flags.
*/
static boolean meetsVisibilityRequirements(final Field field, final EnumSet visibility) {
final int m = field.getModifiers();
for (Visibility visibilityModifier : visibility) {
if (visibilityModifier != Visibility.DEFAULT) {
if ((m & visibilityModifier.modifierFlag) != 0) {
return true;
}
} else {
if (!Modifier.isPrivate(m) && !Modifier.isProtected(m) && !Modifier.isPublic(m)) {
return true;
}
}
}
return false;
}
/**
* Determines if a given Field meets the specified Bean restriction requirements and returns the field as a BeanProperty
* with optional getter/setter.
*
* @param field The field to test.
* @param beanRestrictions The Bean restrictions to apply (should/shouldn't have setter/getter).
* @return Whether the field fits the restrictions.
*/
@Nullable
static FieldWrapper resolveBeanProperty(final Field field, final EnumSet beanRestrictions) {
if (beanRestrictions.containsAll(EnumSet.of(BeanRestriction.NO_GETTER, BeanRestriction.YES_GETTER)) //
|| beanRestrictions.containsAll(EnumSet.of(BeanRestriction.NO_SETTER, BeanRestriction.YES_SETTER))) {
throw new IllegalArgumentException("cannot both include and exclude a setter/getter requirement");
}
// since PropertyUtilsBean#getPropertyDescriptors(...) doesn't detect setters without getters (Bean convention)
// we'll just find setter/getters manually
final String setterName = "set" + StringUtils.capitalize(field.getName());
final String getterName;
if (field.getType().equals(boolean.class)) {
getterName = "is" + StringUtils.capitalize(field.getName());
} else {
getterName = "get" + StringUtils.capitalize(field.getName());
}
final InvokableObject iWriteMethod = MethodUtils.findSimpleCompatibleMethod(field.getDeclaringClass(), setterName, field.getType());
final InvokableObject iReadMethod = MethodUtils.findSimpleCompatibleMethod(field.getDeclaringClass(), getterName);
if (!((iReadMethod != null && beanRestrictions.contains(BeanRestriction.NO_GETTER)) //
|| (iReadMethod == null && beanRestrictions.contains(BeanRestriction.YES_GETTER)) //
|| (iWriteMethod != null && beanRestrictions.contains(BeanRestriction.NO_SETTER)) //
|| (iWriteMethod == null && beanRestrictions.contains(BeanRestriction.YES_SETTER)))) {
Method readMethod = iReadMethod != null ? iReadMethod.getMethod() : null;
Method writeMethod = iWriteMethod != null ? iWriteMethod.getMethod() : null;
return new FieldWrapper(field, readMethod, writeMethod);
} else {
return null;
}
}
}