org.exparity.beans.InstanceProperty Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of exparity-bean Show documentation
Show all versions of exparity-bean Show documentation
A Java library of bean utilities for manipulating and inspecting Java classes implementing the Java Beans standard
package org.exparity.beans;
import java.lang.reflect.Method;
import java.util.Arrays;
import java.util.Collection;
import java.util.Date;
import java.util.List;
import java.util.Map;
import java.util.Set;
import org.apache.commons.lang.StringUtils;
import org.apache.commons.lang.builder.EqualsBuilder;
import org.apache.commons.lang.builder.HashCodeBuilder;
import static org.exparity.beans.MethodUtils.genericArgs;
import static org.exparity.beans.Type.type;
/**
* Base type for all types in the BeanUtils library which represent a single property
*
* @author Stewart Bissett
*/
abstract class InstanceProperty {
private final Class declaringType;
private final String name;
private final Type type;
private final Class[] params;
@Deprecated
protected InstanceProperty(final String propertyName, final Method accessor, final Method mutator) {
this(accessor.getDeclaringClass(), propertyName, type(accessor.getReturnType()), genericArgs(accessor));
}
protected InstanceProperty(final Class declaringType, final String name, final Type type, final Class[] params) {
this.declaringType = declaringType;
this.name = name;
this.type = type;
this.params = params;
}
/**
* Return the name of the property
*/
public String getName() {
return name;
}
/**
* Test the name of the property to see if it matches the supplied name
*/
public boolean hasName(final String name) {
return StringUtils.equals(name, this.name);
}
/**
* Return the declaring type of the property
*/
public Class getDeclaringType() {
return declaringType;
}
/**
* Return the declaring type of the property
*/
public String getDeclaringTypeCanonicalName() {
return declaringType.getCanonicalName();
}
/**
* Return the declaring type of the property
*/
public String getDeclaringTypeSimpleName() {
return declaringType.getSimpleName();
}
/**
* Return the type of the property
*/
public Class getType() {
return type.getType();
}
/**
* Return the canonical name of the type
*/
public String getTypeCanonicalName() {
return type.canonicalName();
}
/**
* Return the canonical name of the type
*/
public String getTypeSimpleName() {
return type.simpleName();
}
/**
* Return the nth type parameter or throw {@link IllegalArgumentException} if there is no nth type parameter
*/
public Class getTypeParameter(final int n) {
if (params.length > n) {
return params[n];
} else {
throw new IllegalArgumentException("Unknown type parameter with index '" + n + "'");
}
}
/**
* Return the collection of type paramaters or an empty {@link List} if this property is not generic
*/
public List> getTypeParameters() {
return Arrays.asList(params);
}
public boolean hasAnyTypeParameters(final Class... types) {
for (Class type : types) {
for (Class param : this.params) {
if (type.isAssignableFrom(param)) {
return true;
}
}
}
return false;
}
public boolean hasTypeParameter(final Class type) {
for (Class param : this.params) {
if (type.isAssignableFrom(param)) {
return true;
}
}
return false;
}
/**
* Test if the property implements {@link Iterable}
*/
public boolean isIterable() {
return isType(Iterable.class);
}
/**
* Test if the property type is assignable from the supplied type
*
* @param type any type to check to see if this properties type is assignable to it
*/
public boolean isType(final Class type) {
return this.type.is(type);
}
/**
* Test if the property type is assignable from any one of the supplied types
*
* @param types types to check to see if this properties type is assignable to it
*/
public boolean isType(final Class... types) {
for (Class type : types) {
if (this.type.is(type)) {
return true;
}
}
return false;
}
/**
* Test if the property is a generic type
*/
public boolean isGeneric() {
return this.params.length > 0;
}
/**
* Test if the property is primitive
*/
public boolean isPrimitive() {
return type.isPrimitive();
}
/**
* Test if the property is an array
*/
public boolean isArray() {
return type.isArray();
}
/**
* Test if the property is a {@link String}
*/
public boolean isString() {
return isType(String.class);
}
/**
* Test if the property is an {@link Character} or char
*/
public boolean isCharacter() {
return isType(Character.class, char.class);
}
/**
* Test if the property is an {@link Byte} or char
*/
public boolean isByte() {
return isType(Byte.class, byte.class);
}
/**
* Test if the property is an {@link Integer} or int
*/
public boolean isInteger() {
return isType(Integer.class, int.class);
}
/**
* Test if the property is an {@link Double} or double
*/
public boolean isDouble() {
return isType(Double.class, double.class);
}
/**
* Test if the property is an {@link Float} or float
*/
public boolean isFloat() {
return isType(Float.class, float.class);
}
/**
* Test if the property is an {@link Short} or short
*/
public boolean isShort() {
return isType(Short.class, short.class);
}
/**
* Test if the property is an {@link Long} or long
*/
public boolean isLong() {
return isType(Long.class, long.class);
}
/**
* Test if the property is an {@link Boolean} or boolean
*/
public boolean isBoolean() {
return isType(Boolean.class, boolean.class);
}
/**
* Test if the property is an {@link Date} or long
*/
public boolean isDate() {
return isType(Date.class);
}
/**
* Test if the property implements {@link Map}
*/
public boolean isMap() {
return isType(Map.class);
}
/**
* Test if the property implements {@link List}
*/
public boolean isList() {
return isType(List.class);
}
/**
* Test if the property implements {@link Set}
*/
public boolean isSet() {
return isType(Set.class);
}
/**
* Test if the property implements {@link Collection}
*/
public boolean isCollection() {
return isType(Collection.class);
}
/**
* Test if the property is an enum
*/
public boolean isEnum() {
return type.isEnum();
}
@Override
public boolean equals(final Object obj) {
if (obj == this) {
return true;
}
if (!obj.getClass().equals(obj.getClass())) {
return false;
}
InstanceProperty rhs = (InstanceProperty) obj;
return new EqualsBuilder().append(declaringType, rhs.declaringType).append(name, rhs.name).isEquals();
}
@Override
public int hashCode() {
return new HashCodeBuilder(23, 35).append(declaringType).append(this.name).toHashCode();
}
@Override
public String toString() {
return getClass() + "[" + declaringType + "." + name + "]";
}
}