Subversion Repositories bacoAlunos

package genson.reflect;

import java.lang.annotation.Annotation;
import java.lang.reflect.Type;

/**
 * Represents a bean property, in practice it can be an object field, method (getter/setter) or
 * constructor parameter.
 *
 * @author eugen
 */
public abstract class BeanProperty {
  protected final 1.5.0/docs/api/java/lang/String.html">String name;
  protected final 1.5.0/docs/api/java/lang/reflect/Type.html">Type type;
  protected final Class<?> declaringClass;
  protected final Class<?> concreteClass;
  protected 5+0%2Fdocs%2Fapi+Annotation">Annotation[] annotations;
  protected final int modifiers;

  protected BeanProperty(1.5.0/docs/api/java/lang/String.html">String name, 1.5.0/docs/api/java/lang/reflect/Type.html">Type type, Class<?> declaringClass,
                         Class<?> concreteClass, 5+0%2Fdocs%2Fapi+Annotation">Annotation[] annotations, int modifiers) {
    this.name = name;
    this.type = type;
    this.declaringClass = declaringClass;
    this.concreteClass = concreteClass;
    this.annotations = annotations;
    this.modifiers = modifiers;
  }

  /**
   * @return The class in which this property is declared
   */
  public Class<?> getDeclaringClass() {
    return declaringClass;
  }

  /**
   * @return The final concrete class from which this property has been resolved.
   * For example if this property is defined in class Root but was resolved for class Child extends Root,
   * then getConcreteClass would return Child class and getDeclaringClass would return Root class.
   */
  public Class<?> getConcreteClass() { return concreteClass; }

  /**
   * The name of this property (not necessarily the original one).
   */
  public 1.5.0/docs/api/java/lang/String.html">String getName() {
    return name;
  }

  /**
   * @return the type of the property
   */
  public 1.5.0/docs/api/java/lang/reflect/Type.html">Type getType() {
    return type;
  }

  public Class<?> getRawClass() {
    return genson.reflect.TypeUtil.getRawClass(type);
  }

  public int getModifiers() {
    return modifiers;
  }

  public 1.5.0/docs/api/java/lang/String.html">String[] aliases() {
    genson.annotation.JsonProperty ann = getAnnotation(genson.annotation.JsonProperty.class);
    return ann != null ? ann.aliases() : new 1.5.0/docs/api/java/lang/String.html">String[]{};
  }

  public <T extends Annotation> T getAnnotation(Class<T> annotationClass) {
    for (5+0%2Fdocs%2Fapi+Annotation">Annotation ann : annotations)
      if (annotationClass.isInstance(ann)) return annotationClass.cast(ann);
    return null;
  }

  void updateBoth(BeanProperty otherBeanProperty) {

    // FIXME: we don't care for duplicate annotations as it should not change the behaviour - actually we do as it can change the behaviour...
    // an easy solution would be to forbid duplicate annotations, which can make sense.
    if (annotations.length > 0 || otherBeanProperty.annotations.length > 0) {
      5+0%2Fdocs%2Fapi+Annotation">Annotation[] mergedAnnotations = new 5+0%2Fdocs%2Fapi+Annotation">Annotation[annotations.length + otherBeanProperty.annotations.length];

      1.5.0/docs/api/java/lang/System.html">System.arraycopy(annotations, 0, mergedAnnotations, 0, annotations.length);
      1.5.0/docs/api/java/lang/System.html">System.arraycopy(otherBeanProperty.annotations, 0, mergedAnnotations, annotations.length, otherBeanProperty.annotations.length);

      if (otherBeanProperty.annotations.length > 0) this.annotations = mergedAnnotations;
      // update also the other bean property with the merged result.
      // This is easier rather than do it in one direction and then in the other one.
      if (annotations.length > 0) otherBeanProperty.annotations = mergedAnnotations;
    }
  }

  /**
   * Used to give priority to implementations, for example by default a method would have a higher
   * priority than a field because it can do some logic. The greater the priority value is the
   * more important is this BeanProperty.
   *
   * @return the priority of this BeanProperty
   */
  abstract int priority();

  abstract 1.5.0/docs/api/java/lang/String.html">String signature();
}