PropertyHandler (Groovy 5.0.8)
Description: declaration: package: groovy.transform.options, class: PropertyHandler

Package groovy.transform.options

# Class PropertyHandler

java.lang.Object
groovy.transform.options.PropertyHandler

Direct Known Subclasses:
  `DefaultPropertyHandler`, `ImmutablePropertyHandler`

@Incubating public abstract class PropertyHandler extends Object
Used to provide custom property handling when getting, setting or initializing properties.

Since:
  2.5.0

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `static final ClassNode`
  `PROPERTY_OPTIONS_TYPE`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `PropertyHandler()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `static PropertyHandler`
  `createPropertyHandler(AbstractASTTransformation xform, GroovyClassLoader loader, ClassNode cNode)`
  `Statement`
  `createPropGetter(PropertyNode pNode)`
  Create the getter block used when reading the property including any defensive copying.
  `abstract Statement`
  `createPropInit(AbstractASTTransformation xform, AnnotationNode anno, ClassNode cNode, PropertyNode pNode, Parameter namedArgMap)`
  Create a statement that will initialize the property including any defensive copying.
  `Statement`
  `createPropSetter(PropertyNode pNode)`
  Create the setter block used when setting the property.
  `protected boolean`
  `isValidAttribute(AbstractASTTransformation xform, AnnotationNode anno, String memberName)`
  `abstract boolean`
  `validateAttributes(AbstractASTTransformation xform, AnnotationNode anno)`
  `boolean`
  `validateProperties(AbstractASTTransformation xform, BlockStatement body, ClassNode cNode, List<PropertyNode> props)`

  ### Methods inherited from class java.lang.Object

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

- ## Field Details

  - ### PROPERTY_OPTIONS_TYPE

    public static final ClassNode PROPERTY_OPTIONS_TYPE

- ## Constructor Details

  - ### PropertyHandler

    public PropertyHandler()

- ## Method Details

  - ### validateAttributes

    public abstract boolean validateAttributes(AbstractASTTransformation xform, AnnotationNode anno)

  - ### validateProperties

    public boolean validateProperties(AbstractASTTransformation xform, BlockStatement body, ClassNode cNode, List<PropertyNode> props)

  - ### createPropInit

    public abstract Statement createPropInit(AbstractASTTransformation xform, AnnotationNode anno, ClassNode cNode, PropertyNode pNode, Parameter namedArgMap)
    Create a statement that will initialize the property including any defensive copying. Null if no statement should be added.
    Parameters:
      `xform` - the transform being processed
      `anno` - the '@ImmutableBase' annotation node
      `cNode` - the classnode containing the property
      `pNode` - the property node to initialize
      `namedArgMap` - an "args" Map if the property value should come from a named arg map or null if not

  - ### createPropGetter

    public Statement createPropGetter(PropertyNode pNode)
    Create the getter block used when reading the property including any defensive copying.
    Parameters:
      `pNode` - the property node

  - ### createPropSetter

    public Statement createPropSetter(PropertyNode pNode)
    Create the setter block used when setting the property. Can be null for read-only properties.
    Parameters:
      `pNode` - the property node

  - ### isValidAttribute

    protected boolean isValidAttribute(AbstractASTTransformation xform, AnnotationNode anno, String memberName)

  - ### createPropertyHandler

    public static PropertyHandler createPropertyHandler(AbstractASTTransformation xform, GroovyClassLoader loader, ClassNode cNode)