Package com.fasterxml.jackson.annotation
Class JsonIgnoreProperties.Value
java.lang.Object
com.fasterxml.jackson.annotation.JsonIgnoreProperties.Value
- All Implemented Interfaces:
JacksonAnnotationValue<JsonIgnoreProperties>
,Serializable
- Enclosing class:
- JsonIgnoreProperties
public static class JsonIgnoreProperties.Value
extends Object
implements JacksonAnnotationValue<JsonIgnoreProperties>, Serializable
Helper class used to contain information from a single
JsonIgnoreProperties
annotation, as well as to provide possible overrides from non-annotation sources.- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected final boolean
protected final boolean
Names of properties to ignore.protected final boolean
protected final boolean
protected static final JsonIgnoreProperties.Value
Default instance has no explicitly ignored fields, does not ignore unknowns, does not explicitly allow getters/setters (that is, ignorals apply to both), but does use merging for combining overrides with base settings -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic JsonIgnoreProperties.Value
construct
(Set<String> ignored, boolean ignoreUnknown, boolean allowGetters, boolean allowSetters, boolean merge) Factory method that may be used (although is NOT the recommended way) to construct an instance from a full set of properties.static JsonIgnoreProperties.Value
empty()
Accessor for default instances which has "empty" settings; that is: No explicitly defined fields to ignore Does not ignore unknown fields Does not "allow" getters if property ignored (that is, ignorals apply to both setter and getter) Does not "allow" setters if property ignored (that is, ignorals apply to both setter and getter) Does use merge when combining overrides to base settings, such that `true` settings for any of the properties results in `true`, and names of fields are combined (union)boolean
Method called to find names of properties to ignore when used for serialization: functionally same asgetIgnored()
ifgetAllowSetters()
is false (that is, there is "allowSetters=false" or equivalent), otherwise returns emptySet
.Method called to find names of properties to ignore when used for serialization: functionally same asgetIgnored()
ifgetAllowGetters()
is false (that is, there is "allowGetters=false" or equivalent), otherwise returns emptySet
.static JsonIgnoreProperties.Value
forIgnoredProperties
(String... propNames) static JsonIgnoreProperties.Value
forIgnoredProperties
(Set<String> propNames) static JsonIgnoreProperties.Value
forIgnoreUnknown
(boolean state) static JsonIgnoreProperties.Value
from
(JsonIgnoreProperties src) boolean
boolean
boolean
boolean
getMerge()
int
hashCode()
static JsonIgnoreProperties.Value
merge
(JsonIgnoreProperties.Value base, JsonIgnoreProperties.Value overrides) Helper method that will try to combine values from twoJsonIgnoreProperties.Value
instances, using one as base settings, and the other as overrides to use instead of base values when defined; base values are only use if override does not specify a value (matching value is null or logically missing).static JsonIgnoreProperties.Value
mergeAll
(JsonIgnoreProperties.Value... values) protected Object
toString()
valueFor()
Introspection method that may be used to find actual annotation that may be used as the source for value instance.withIgnored
(String... ignored) withIgnored
(Set<String> ignored) withOverrides
(JsonIgnoreProperties.Value overrides) Mutant factory method that merges values of this value with given override values, so that any explicitly defined inclusion in overrides has precedence over settings of this value instance.
-
Field Details
-
EMPTY
Default instance has no explicitly ignored fields, does not ignore unknowns, does not explicitly allow getters/setters (that is, ignorals apply to both), but does use merging for combining overrides with base settings -
_ignored
Names of properties to ignore. -
_ignoreUnknown
protected final boolean _ignoreUnknown -
_allowGetters
protected final boolean _allowGetters -
_allowSetters
protected final boolean _allowSetters -
_merge
protected final boolean _merge
-
-
Constructor Details
-
Value
-
-
Method Details
-
from
-
construct
public static JsonIgnoreProperties.Value construct(Set<String> ignored, boolean ignoreUnknown, boolean allowGetters, boolean allowSetters, boolean merge) Factory method that may be used (although is NOT the recommended way) to construct an instance from a full set of properties. Most users would be better off starting byempty()
instance and using `withXxx()`/`withoutXxx()` methods, as this factory method may need to be changed if new properties are added inJsonIgnoreProperties
annotation. -
empty
Accessor for default instances which has "empty" settings; that is:- No explicitly defined fields to ignore
- Does not ignore unknown fields
- Does not "allow" getters if property ignored (that is, ignorals apply to both setter and getter)
- Does not "allow" setters if property ignored (that is, ignorals apply to both setter and getter)
- Does use merge when combining overrides to base settings, such that `true` settings for any of the properties results in `true`, and names of fields are combined (union)
-
merge
public static JsonIgnoreProperties.Value merge(JsonIgnoreProperties.Value base, JsonIgnoreProperties.Value overrides) Helper method that will try to combine values from twoJsonIgnoreProperties.Value
instances, using one as base settings, and the other as overrides to use instead of base values when defined; base values are only use if override does not specify a value (matching value is null or logically missing). Note that one or both of value instances may be `null`, directly; if both are `null`, result will also be `null`; otherwise never null. -
mergeAll
-
forIgnoredProperties
-
forIgnoredProperties
-
forIgnoreUnknown
-
withOverrides
Mutant factory method that merges values of this value with given override values, so that any explicitly defined inclusion in overrides has precedence over settings of this value instance. If no overrides exist will returnthis
instance; otherwise newJsonIgnoreProperties.Value
with changed inclusion values. -
withIgnored
-
withIgnored
-
withoutIgnored
-
withIgnoreUnknown
-
withoutIgnoreUnknown
-
withAllowGetters
-
withoutAllowGetters
-
withAllowSetters
-
withoutAllowSetters
-
withMerge
-
withoutMerge
-
valueFor
Description copied from interface:JacksonAnnotationValue
Introspection method that may be used to find actual annotation that may be used as the source for value instance.- Specified by:
valueFor
in interfaceJacksonAnnotationValue<JsonIgnoreProperties>
- Returns:
- Annotation class for which instances of this value class are created
-
readResolve
-
getIgnored
-
findIgnoredForSerialization
Method called to find names of properties to ignore when used for serialization: functionally same asgetIgnored()
ifgetAllowGetters()
is false (that is, there is "allowGetters=false" or equivalent), otherwise returns emptySet
. -
findIgnoredForDeserialization
Method called to find names of properties to ignore when used for serialization: functionally same asgetIgnored()
ifgetAllowSetters()
is false (that is, there is "allowSetters=false" or equivalent), otherwise returns emptySet
. -
getIgnoreUnknown
public boolean getIgnoreUnknown() -
getAllowGetters
public boolean getAllowGetters() -
getAllowSetters
public boolean getAllowSetters() -
getMerge
public boolean getMerge() -
toString
-
hashCode
public int hashCode() -
equals
-