Package org.simpleframework.xml.core

Class SetPart

  • All Implemented Interfaces:
    MethodPart
    class SetPart
extends java.lang.Object
implements MethodPart
    The SetPart object represents the setter method for a Java Bean property. This composes the set part of the method contact for an object. The set part contains the method that is used to set the value on an object and the annotation that tells the deserialization process how to deserialize the value.
    See Also:
    MethodContact

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private Cache<java.lang.annotation.Annotation> cache
      This cache contains the annotations present on the method.
      private java.lang.annotation.Annotation label
      This is the annotation for the set method provided.
      private java.lang.annotation.Annotation[] list
      This is the list of annotations associated with the method.
      private java.lang.reflect.Method method
      This method is used to set the value during deserialization.
      private java.lang.String name
      This represents the name of this set part instance.
      private MethodType type
      This represents the method type for the set part method.

    • Constructor Summary

      Constructors 
      Constructor Description
      SetPart​(MethodName method, java.lang.annotation.Annotation label, java.lang.annotation.Annotation[] list)
      Constructor for the SetPart object.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.annotation.Annotation getAnnotation()
      This is used to acquire the annotation that was used to label the method this represents.
      <T extends java.lang.annotation.Annotation>
      T      		 getAnnotation​(java.lang.Class<T> type)
      This is the annotation associated with the point of contact.
      java.lang.Class getDeclaringClass()
      This is the class that declares the contact.
      java.lang.Class getDependent()
      This is used to acquire the dependent class for the method part.
      java.lang.Class[] getDependents()
      This is used to acquire the dependent classes for the method part.
      java.lang.reflect.Method getMethod()
      This is used to acquire the method that can be used to invoke the Java Bean method on the object.
      MethodType getMethodType()
      This is the method type for the method part.
      java.lang.String getName()
      This provides the name of the method part as acquired from the method name.
      java.lang.Class getType()
      This is used to acquire the type for this method part.
      java.lang.String toString()
      This is used to describe the method as it exists within the owning class.

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • cache

        private final Cache<java.lang.annotation.Annotation> cache
        This cache contains the annotations present on the method.

      • list

        private final java.lang.annotation.Annotation[] list
        This is the list of annotations associated with the method.

      • label

        private final java.lang.annotation.Annotation label
        This is the annotation for the set method provided.

      • type

        private final MethodType type
        This represents the method type for the set part method.

      • method

        private final java.lang.reflect.Method method
        This method is used to set the value during deserialization.

      • name

        private final java.lang.String name
        This represents the name of this set part instance.

    • Constructor Detail

      • SetPart

        public SetPart​(MethodName method,
               java.lang.annotation.Annotation label,
               java.lang.annotation.Annotation[] list)
        Constructor for the SetPart object. This is used to create a method part that will provide a means for the deserialization process to set a value to a object.
        Parameters:
        method - the method that is used to set the value
        label - this describes how to deserialize the value
        list - this is the list of annotations on the method

    • Method Detail

      • getName

        public java.lang.String getName()
        This provides the name of the method part as acquired from the method name. The name represents the Java Bean property name of the method and is used to pair getter and setter methods.
        Specified by:
        getName in interface MethodPart
        Returns:
        this returns the Java Bean name of the method part

      • getType

        public java.lang.Class getType()
        This is used to acquire the type for this method part. This is used by the serializer to determine the schema class that is used to match the XML elements to the object details.
        Specified by:
        getType in interface MethodPart
        Returns:
        this returns the schema class for this method

      • getDependent

        public java.lang.Class getDependent()
        This is used to acquire the dependent class for the method part. The dependent type is the type that represents the generic type of the type. This is used when collections are annotated as it allows a default entry class to be taken from the generic information provided.
        Specified by:
        getDependent in interface MethodPart
        Returns:
        this returns the generic dependent for the type

      • getDependents

        public java.lang.Class[] getDependents()
        This is used to acquire the dependent classes for the method part. The dependent types are the types that represents the generic types of the type. This is used when collections are annotated as it allows a default entry classes to be taken from the generic information provided.
        Specified by:
        getDependents in interface MethodPart
        Returns:
        this returns the generic dependents for the type

      • getDeclaringClass

        public java.lang.Class getDeclaringClass()
        This is the class that declares the contact. The declaring class is where the method represented has been defined. This will typically be a class rather than an interface.
        Specified by:
        getDeclaringClass in interface MethodPart
        Returns:
        this returns the class the part is declared within

      • getAnnotation

        public java.lang.annotation.Annotation getAnnotation()
        This is used to acquire the annotation that was used to label the method this represents. This acts as a means to match the set method with the get method using an annotation comparison.
        Specified by:
        getAnnotation in interface MethodPart
        Returns:
        this returns the annotation used to mark the method

      • getAnnotation

        public <T extends java.lang.annotation.Annotation> T getAnnotation​(java.lang.Class<T> type)
        This is the annotation associated with the point of contact. This will be an XML annotation that describes how the contact should be serialized and deserialized from the object.
        Specified by:
        getAnnotation in interface MethodPart
        Parameters:
        type - this is the type of the annotation to acquire
        Returns:
        this provides the annotation associated with this

      • getMethodType

        public MethodType getMethodType()
        This is the method type for the method part. This is used in the scanning process to determine which type of method a instance represents, this allows set and get methods to be paired.
        Specified by:
        getMethodType in interface MethodPart
        Returns:
        the method type that this part represents

      • getMethod

        public java.lang.reflect.Method getMethod()
        This is used to acquire the method that can be used to invoke the Java Bean method on the object. If the method represented by this is inaccessible then this will set it as accessible.
        Specified by:
        getMethod in interface MethodPart
        Returns:
        returns the method used to interface with the object

      • toString

        public java.lang.String toString()
        This is used to describe the method as it exists within the owning class. This is used to provide error messages that can be used to debug issues that occur when processing a method. This returns the method as a generic string representation.
        Specified by:
        toString in interface MethodPart
        Overrides:
        toString in class java.lang.Object
        Returns:
        this returns a string representation of the method