Interface MapPropertyInfo<T,​C>

  • All Superinterfaces:
    AnnotationSource, PropertyInfo<T,​C>
    All Known Subinterfaces:
    RuntimeMapPropertyInfo

    public interface MapPropertyInfo<T,​C>
    extends PropertyInfo<T,​C>
    Property that maps to the following schema fragment.
    
     <xs:complexType>
       <xs:sequence>
         <xs:element name="entry" minOccurs="0" maxOccurs="unbounded">
           <xs:complexType>
             <xs:sequence>
               <xs:element name="key"   type="XXXX"/>
               <xs:element name="value" type="YYYY"/>
             </xs:sequence>
           </xs:complexType>
         </xs:element>
       </xs:sequence>
     </xs:complexType>
     

    This property is used to represent a default binding of a Map property. (Map properties with adapters will be represented by ElementPropertyInfo.)

    Design Thinking Led to This

    I didn't like the idea of adding such a special-purpose PropertyInfo to a model. The alternative was to implicitly assume an adapter, and have internal representation of the Entry class ready. But the fact that the key type and the value type changes with the parameterization makes it very difficult to have such a class (especially inside Annotation Processing, where we can't even generate classes.)

    Author:
    Kohsuke Kawaguchi
    • Method Detail

      • getXmlName

        QName getXmlName()
        Gets the wrapper element name.
        Returns:
        always non-null.
      • isCollectionNillable

        boolean isCollectionNillable()
        Returns true if this property is nillable (meaning the absence of the value is treated as nil='true')

        This method is only used when this property is a collection.

      • getKeyType

        NonElement<T,​C> getKeyType()
        Type of the key of the map. K of HashMap<K,V>
        Returns:
        never null.
      • getValueType

        NonElement<T,​C> getValueType()
        Type of the value of the map. V of HashMap<K,V>
        Returns:
        never null.