com.fasterxml.jackson.annotation.JsonAnySetter Maven / Gradle / Ivy
package com.fasterxml.jackson.annotation;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* Marker annotation that can be used to define a logical "any setter" mutator --
* either using non-static
* two-argument method (first argument name of property, second value
* to set) or a field (of type {@link java.util.Map} or POJO) -
* to be used as a "fallback" handler
* for all otherwise unrecognized properties found from JSON content.
* It is similar to {@code javax.xml.bind.annotation.XmlAnyElement}
* in behavior; and can only be used to denote a single property
* per type.
*
* If used, all otherwise unmapped key-value pairs from JSON Object values
* are added using mutator.
*
* NOTE: ability to annotate fields was added in version 2.8; earlier only
* methods could be annotated.
*
* NOTE: ability to annotate (constructor) parameters was added in version 2.17.
*/
@Target({ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@JacksonAnnotation
public @interface JsonAnySetter
{
/**
* Optional argument that defines whether this annotation is active
* or not. The only use for value 'false' if for overriding purposes.
* Overriding may be necessary when used
* with "mix-in annotations" (aka "annotation overrides").
* For most cases, however, default value of "true" is just fine
* and should be omitted.
*
* @return True if annotation is enabled (normal case); false if it is to
* be ignored (only useful for mix-in annotations to "mask" annotation)
*
* @since 2.9
*/
boolean enabled() default true;
}