com.fasterxml.jackson.dataformat.xml.deser

Enum FromXmlParser.Feature

java.lang.Object

java.lang.Enum<FromXmlParser.Feature>

com.fasterxml.jackson.dataformat.xml.deser.FromXmlParser.Feature

All Implemented Interfaces:

com.fasterxml.jackson.core.FormatFeature, com.fasterxml.jackson.core.util.JacksonFeature, Serializable, Comparable<FromXmlParser.Feature>

Enclosing class:

FromXmlParser

public static enum FromXmlParser.Feature
extends Enum<FromXmlParser.Feature>
implements com.fasterxml.jackson.core.FormatFeature

Enumeration that defines all togglable features for XML parsers.

Enum Constant Summary

Enum Constants

Enum Constant and Description
EMPTY_ELEMENT_AS_NULL Feature that indicates whether XML Empty elements (ones where there are no separate start and end tags, but just one tag that ends with "/>") are exposed as JsonToken.VALUE_NULL) or not.
PROCESS_XSI_NIL Feature that indicates whether XML Schema Instance attribute xsi:nil will be processed automatically -- to indicate null values -- or not.

Method Summary

Modifier and Type	Method and Description
static int	collectDefaults() Method that calculates bit set (flags) of all features that are enabled by default.
boolean	enabledByDefault()
boolean	enabledIn(int flags)
int	getMask()
static FromXmlParser.Feature	valueOf(String name) Returns the enum constant of this type with the specified name.
static FromXmlParser.Feature[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

EMPTY_ELEMENT_AS_NULL

public static final FromXmlParser.Feature EMPTY_ELEMENT_AS_NULL

Feature that indicates whether XML Empty elements (ones where there are no separate start and end tags, but just one tag that ends with "/>") are exposed as JsonToken.VALUE_NULL) or not. If they are not returned as `null` tokens, they will be returned as JsonToken.VALUE_STRING tokens with textual value of "" (empty String).

Default setting was true (for backwards compatibility from 2.9 to 2.11 (inclusive) but was changed in 2.12 to be false (see [dataformat-xml#411] for details)

Since:

2.9

PROCESS_XSI_NIL

public static final FromXmlParser.Feature PROCESS_XSI_NIL

Feature that indicates whether XML Schema Instance attribute xsi:nil will be processed automatically -- to indicate null values -- or not. If enabled, xsi:nil attribute on any XML element will mark such elements as "null values" and any other attributes or child elements they might have to be ignored. If disabled this attribute will be exposed like any other attribute.

Default setting is true since processing was enabled in 2.12.

Since:

2.13

Method Detail

values

public static FromXmlParser.Feature[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (FromXmlParser.Feature c : FromXmlParser.Feature.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static FromXmlParser.Feature valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

collectDefaults

public static int collectDefaults()

Method that calculates bit set (flags) of all features that are enabled by default.

enabledByDefault

public boolean enabledByDefault()

Specified by:

enabledByDefault in interface com.fasterxml.jackson.core.FormatFeature

Specified by:

enabledByDefault in interface com.fasterxml.jackson.core.util.JacksonFeature

getMask

public int getMask()

Specified by:

getMask in interface com.fasterxml.jackson.core.FormatFeature

Specified by:

getMask in interface com.fasterxml.jackson.core.util.JacksonFeature

enabledIn

public boolean enabledIn(int flags)

Specified by:

enabledIn in interface com.fasterxml.jackson.core.FormatFeature

Specified by:

enabledIn in interface com.fasterxml.jackson.core.util.JacksonFeature