com.fasterxml.jackson.core.util

Class JacksonFeatureSet<F extends JacksonFeature>

java.lang.Object

com.fasterxml.jackson.core.util.JacksonFeatureSet<F>

public final class JacksonFeatureSet<F extends JacksonFeature>
extends java.lang.Object

Container similar to EnumSet meant for storing sets of JacksonFeatures (usually Enums): main difference being that these sets are immutable. Also only supports relatively small sets of features: specifically, up to 31 features.

Since:

2.12

Method Summary

Modifier and Type	Method and Description
int	asBitmask() Accessor for underlying bitmask
static <F extends JacksonFeature> JacksonFeatureSet<F>	fromBitmask(int bitmask)
static <F extends JacksonFeature> JacksonFeatureSet<F>	fromDefaults(F[] allFeatures) "Default" factory which will calculate settings based on default-enabled status of all features.
boolean	isEnabled(F feature) Main accessor for checking whether given feature is enabled in this feature set.
JacksonFeatureSet<F>	with(F feature) Mutant factory for getting a set in which specified feature is enabled: will either return this instance (if no change), or newly created set (if there is change).
JacksonFeatureSet<F>	without(F feature) Mutant factory for getting a set in which specified feature is disabled: will either return this instance (if no change), or newly created set (if there is change).

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

fromDefaults

public static <F extends JacksonFeature> JacksonFeatureSet<F> fromDefaults(F[] allFeatures)

"Default" factory which will calculate settings based on default-enabled status of all features.

Type Parameters:

F - Self-reference type for convenience

Parameters:

allFeatures - Set of all features (enabled or disabled): usually from Enum.values()

Returns:

Feature set instance constructed

fromBitmask

public static <F extends JacksonFeature> JacksonFeatureSet<F> fromBitmask(int bitmask)

with

public JacksonFeatureSet<F> with(F feature)

Mutant factory for getting a set in which specified feature is enabled: will either return this instance (if no change), or newly created set (if there is change).

Parameters:

feature - Feature to enable in set returned

Returns:

Newly created set of state of feature changed; this if not

without

public JacksonFeatureSet<F> without(F feature)

Mutant factory for getting a set in which specified feature is disabled: will either return this instance (if no change), or newly created set (if there is change).

Parameters:

feature - Feature to disable in set returned

Returns:

Newly created set of state of feature changed; this if not

isEnabled

public boolean isEnabled(F feature)

Main accessor for checking whether given feature is enabled in this feature set.

Parameters:

feature - Feature to check

Returns:

True if feature is enabled in this set; false otherwise

asBitmask

public int asBitmask()

Accessor for underlying bitmask

Returns:

Bitmask of enabled features