com.alibaba.fastjson2

Class JSONFactory

java.lang.Object

com.alibaba.fastjson2.JSONFactory

public final class JSONFactory
extends java.lang.Object

JSONFactory is the core factory class for creating JSON readers and writers, as well as managing global configuration for fastjson2.

Since:

2.0.59

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	JSONFactory.CacheItem
static class	JSONFactory.Conf
static interface	JSONFactory.JSONPathCompiler
(package private) static interface	JSONFactory.JSONReaderUTF16Creator
(package private) static interface	JSONFactory.JSONReaderUTF8Creator
(package private) static class	JSONFactory.NameCacheEntry
(package private) static class	JSONFactory.NameCacheEntry2

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static ObjectReader<JSONArray>	ARRAY_READER
(package private) static java.util.concurrent.atomic.AtomicReferenceFieldUpdater<JSONFactory.CacheItem,byte[]>	BYTES_UPDATER
(package private) static char[]	CA
(package private) static JSONFactory.CacheItem[]	CACHE_ITEMS
(package private) static int	CACHE_THRESHOLD
(package private) static java.util.concurrent.atomic.AtomicReferenceFieldUpdater<JSONFactory.CacheItem,char[]>	CHARS_UPDATER
static java.lang.String	CREATOR
(package private) static java.util.function.Supplier<java.util.List>	defaultArraySupplier
(package private) static int	defaultDecimalMaxScale
(package private) static JSONFactory.JSONPathCompiler	defaultJSONPathCompiler
(package private) static int	defaultMaxLevel
(package private) static ObjectReaderProvider	defaultObjectReaderProvider
(package private) static java.util.function.Supplier<java.util.Map>	defaultObjectSupplier
(package private) static ObjectWriterProvider	defaultObjectWriterProvider
(package private) static long	defaultReaderFeatures
(package private) static java.lang.String	defaultReaderFormat
(package private) static java.time.ZoneId	defaultReaderZoneId
(package private) static boolean	defaultSkipTransient
(package private) static boolean	defaultWriterAlphabetic
(package private) static long	defaultWriterFeatures
(package private) static java.lang.String	defaultWriterFormat
(package private) static java.time.ZoneId	defaultWriterZoneId
(package private) static int[]	DIGITS2
(package private) static boolean	disableArrayMapping
(package private) static boolean	disableAutoType
(package private) static boolean	disableJSONB
(package private) static boolean	disableReferenceDetect
(package private) static boolean	disableSmartMatch
(package private) static double[]	DOUBLE_10_POW
(package private) static float[]	FLOAT_10_POW
(package private) static java.lang.Throwable	initErrorLast
private static boolean	jsonFieldDefaultValueCompatMode
(package private) static java.lang.ThreadLocal<JSONFactory.JSONPathCompiler>	jsonPathCompilerLocal
(package private) static JSONFactory.NameCacheEntry[]	NAME_CACHE
(package private) static JSONFactory.NameCacheEntry2[]	NAME_CACHE2
(package private) static byte[]	NIBBLES
(package private) static ObjectReader<JSONObject>	OBJECT_READER
static PropertyAccessorFactory	PROPERTY_ACCESSOR_FACTORY
static java.lang.String	PROPERTY_AUTO_TYPE_ACCEPT
static java.lang.String	PROPERTY_AUTO_TYPE_BEFORE_HANDLER
static java.lang.String	PROPERTY_AUTO_TYPE_HANDLER
static java.lang.String	PROPERTY_DENY_PROPERTY
(package private) static java.lang.ThreadLocal<ObjectReaderCreator>	readerCreatorLocal
(package private) static java.lang.ThreadLocal<ObjectReaderProvider>	readerProviderLocal
(package private) static boolean	useGsonAnnotation
(package private) static boolean	useJacksonAnnotation
(package private) static java.lang.ThreadLocal<ObjectWriterCreator>	writerCreatorLocal

Constructor Summary

Constructors

Constructor and Description
JSONFactory()

Method Summary

Modifier and Type	Method and Description
static JSONReader.Context	createReadContext() Creates a new JSON reader context with default settings.
static JSONReader.Context	createReadContext(Filter filter, JSONReader.Feature... features)
static JSONReader.Context	createReadContext(JSONReader.Feature... features) Creates a new JSON reader context with the specified features.
static JSONReader.Context	createReadContext(long features) Creates a new JSON reader context with the specified features.
static JSONReader.Context	createReadContext(ObjectReaderProvider provider, JSONReader.Feature... features)
static JSONReader.Context	createReadContext(java.util.function.Supplier<java.util.Map> objectSupplier, JSONReader.Feature... features)
static JSONReader.Context	createReadContext(java.util.function.Supplier<java.util.Map> objectSupplier, java.util.function.Supplier<java.util.List> arraySupplier, JSONReader.Feature... features)
static JSONReader.Context	createReadContext(SymbolTable symbolTable)
static JSONReader.Context	createReadContext(SymbolTable symbolTable, JSONReader.Feature... features)
static JSONWriter.Context	createWriteContext() Creates a new JSON writer context with default settings.
static JSONWriter.Context	createWriteContext(JSONWriter.Feature... features) Creates a new JSON writer context with the specified features.
static JSONWriter.Context	createWriteContext(ObjectWriterProvider provider, JSONWriter.Feature... features) Creates a new JSON writer context with the specified provider and features.
static ObjectReaderCreator	getContextReaderCreator() Gets the object reader creator for the current thread context.
static ObjectWriterCreator	getContextWriterCreator() Gets the object writer creator for the current thread context.
static java.util.function.Supplier<java.util.List>	getDefaultArraySupplier() Gets the default array supplier used when creating JSON arrays.
static JSONFactory.JSONPathCompiler	getDefaultJSONPathCompiler() Gets the default JSONPath compiler.
static int	getDefaultMaxLevel()
static ObjectReaderProvider	getDefaultObjectReaderProvider() Gets the default object reader provider.
static java.util.function.Supplier<java.util.Map>	getDefaultObjectSupplier() Gets the default object supplier used when creating JSON objects.
static ObjectWriterProvider	getDefaultObjectWriterProvider() Gets the default object writer provider.
static long	getDefaultReaderFeatures() Gets the default reader features.
static java.lang.String	getDefaultReaderFormat() Gets the default reader format string.
static java.time.ZoneId	getDefaultReaderZoneId() Gets the default reader zone ID.
static long	getDefaultWriterFeatures() Gets the default writer features.
static java.lang.String	getDefaultWriterFormat() Gets the default writer format string.
static java.time.ZoneId	getDefaultWriterZoneId() Gets the default writer zone ID.
static ObjectReader	getObjectReader(java.lang.reflect.Type type, long features)
static ObjectWriter	getObjectWriter(java.lang.reflect.Type type, long features)
static java.lang.String	getProperty(java.lang.String key)
private static boolean	getPropertyBool(java.util.Properties properties, java.lang.String name, boolean defaultValue)
private static int	getPropertyInt(java.util.Properties properties, java.lang.String name, int defaultValue)
static boolean	isDefaultSkipTransient() Checks if transient fields are skipped by default.
static boolean	isDefaultWriterAlphabetic() Checks if the default writer uses alphabetic ordering.
static boolean	isDisableArrayMapping() Checks if array mapping is disabled.
static boolean	isDisableAutoType() Checks if auto type support is disabled.
static boolean	isDisableJSONB() Checks if JSONB format is disabled.
static boolean	isDisableReferenceDetect() Checks if reference detection is disabled.
static boolean	isDisableSmartMatch() Checks if smart matching is disabled.
static boolean	isJSONFieldDefaultValueCompatMode()
static boolean	isUseGsonAnnotation()
static boolean	isUseJacksonAnnotation()
static void	setContextJSONPathCompiler(JSONFactory.JSONPathCompiler compiler) Sets the JSONPath compiler for the current thread context.
static void	setContextObjectReaderProvider(ObjectReaderProvider creator) Sets the object reader provider for the current thread context.
static void	setContextReaderCreator(ObjectReaderCreator creator) Sets the object reader creator for the current thread context.
static void	setContextWriterCreator(ObjectWriterCreator creator) Sets the object writer creator for the current thread context.
static void	setDefaultArraySupplier(java.util.function.Supplier<java.util.List> arraySupplier) Sets the default array supplier used when creating JSON arrays.
static void	setDefaultMaxLevel(int maxLevel)
static void	setDefaultObjectSupplier(java.util.function.Supplier<java.util.Map> objectSupplier) Sets the default object supplier used when creating JSON objects.
static void	setDefaultSkipTransient(boolean skipTransient) Sets whether transient fields should be skipped by default.
static void	setDefaultWriterAlphabetic(boolean defaultWriterAlphabetic) Sets whether the default writer should use alphabetic ordering.
static void	setDisableArrayMapping(boolean disableArrayMapping) Sets whether array mapping should be disabled.
static void	setDisableAutoType(boolean disableAutoType) Sets whether auto type support should be disabled.
static void	setDisableJSONB(boolean disableJSONB) Sets whether JSONB format should be disabled.
static void	setDisableReferenceDetect(boolean disableReferenceDetect) Sets whether reference detection should be disabled.
static void	setDisableSmartMatch(boolean disableSmartMatch) Sets whether smart matching should be disabled.
static void	setJSONFieldDefaultValueCompatMode(boolean compatMode)
static void	setUseGsonAnnotation(boolean useGsonAnnotation)
static void	setUseJacksonAnnotation(boolean useJacksonAnnotation)

Methods inherited from class java.lang.Object

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

Field Detail

initErrorLast

static volatile java.lang.Throwable initErrorLast

CREATOR

public static final java.lang.String CREATOR

PROPERTY_DENY_PROPERTY

public static final java.lang.String PROPERTY_DENY_PROPERTY

See Also:

Constant Field Values

PROPERTY_AUTO_TYPE_ACCEPT

public static final java.lang.String PROPERTY_AUTO_TYPE_ACCEPT

See Also:

Constant Field Values

PROPERTY_AUTO_TYPE_HANDLER

public static final java.lang.String PROPERTY_AUTO_TYPE_HANDLER

See Also:

Constant Field Values

PROPERTY_AUTO_TYPE_BEFORE_HANDLER

public static final java.lang.String PROPERTY_AUTO_TYPE_BEFORE_HANDLER

See Also:

Constant Field Values

useJacksonAnnotation

static boolean useJacksonAnnotation

useGsonAnnotation

static boolean useGsonAnnotation

defaultReaderFeatures

static long defaultReaderFeatures

defaultReaderFormat

static java.lang.String defaultReaderFormat

defaultReaderZoneId

static java.time.ZoneId defaultReaderZoneId

defaultWriterFeatures

static long defaultWriterFeatures

defaultWriterFormat

static java.lang.String defaultWriterFormat

defaultWriterZoneId

static java.time.ZoneId defaultWriterZoneId

defaultWriterAlphabetic

static boolean defaultWriterAlphabetic

defaultSkipTransient

static boolean defaultSkipTransient

disableReferenceDetect

static final boolean disableReferenceDetect

disableArrayMapping

static final boolean disableArrayMapping

disableJSONB

static final boolean disableJSONB

disableAutoType

static final boolean disableAutoType

disableSmartMatch

static final boolean disableSmartMatch

defaultObjectSupplier

static java.util.function.Supplier<java.util.Map> defaultObjectSupplier

defaultArraySupplier

static java.util.function.Supplier<java.util.List> defaultArraySupplier

NAME_CACHE

static final JSONFactory.NameCacheEntry[] NAME_CACHE

NAME_CACHE2

static final JSONFactory.NameCacheEntry2[] NAME_CACHE2

defaultDecimalMaxScale

static int defaultDecimalMaxScale

defaultMaxLevel

static int defaultMaxLevel

PROPERTY_ACCESSOR_FACTORY

public static final PropertyAccessorFactory PROPERTY_ACCESSOR_FACTORY

CA

static final char[] CA

DIGITS2

static final int[] DIGITS2

FLOAT_10_POW

static final float[] FLOAT_10_POW

DOUBLE_10_POW

static final double[] DOUBLE_10_POW

jsonFieldDefaultValueCompatMode

private static volatile boolean jsonFieldDefaultValueCompatMode

CACHE_ITEMS

static final JSONFactory.CacheItem[] CACHE_ITEMS

CACHE_THRESHOLD

static final int CACHE_THRESHOLD

See Also:

Constant Field Values

CHARS_UPDATER

static final java.util.concurrent.atomic.AtomicReferenceFieldUpdater<JSONFactory.CacheItem,char[]> CHARS_UPDATER

BYTES_UPDATER

static final java.util.concurrent.atomic.AtomicReferenceFieldUpdater<JSONFactory.CacheItem,byte[]> BYTES_UPDATER

defaultObjectWriterProvider

static final ObjectWriterProvider defaultObjectWriterProvider

defaultObjectReaderProvider

static final ObjectReaderProvider defaultObjectReaderProvider

defaultJSONPathCompiler

static final JSONFactory.JSONPathCompiler defaultJSONPathCompiler

readerCreatorLocal

static final java.lang.ThreadLocal<ObjectReaderCreator> readerCreatorLocal

readerProviderLocal

static final java.lang.ThreadLocal<ObjectReaderProvider> readerProviderLocal

writerCreatorLocal

static final java.lang.ThreadLocal<ObjectWriterCreator> writerCreatorLocal

jsonPathCompilerLocal

static final java.lang.ThreadLocal<JSONFactory.JSONPathCompiler> jsonPathCompilerLocal

ARRAY_READER

static final ObjectReader<JSONArray> ARRAY_READER

OBJECT_READER

static final ObjectReader<JSONObject> OBJECT_READER

NIBBLES

static final byte[] NIBBLES

Constructor Detail

JSONFactory

public JSONFactory()

Method Detail

getProperty

public static java.lang.String getProperty(java.lang.String key)

getPropertyBool

private static boolean getPropertyBool(java.util.Properties properties,
                                       java.lang.String name,
                                       boolean defaultValue)

getPropertyInt

private static int getPropertyInt(java.util.Properties properties,
                                  java.lang.String name,
                                  int defaultValue)

isUseJacksonAnnotation

public static boolean isUseJacksonAnnotation()

isUseGsonAnnotation

public static boolean isUseGsonAnnotation()

setUseJacksonAnnotation

public static void setUseJacksonAnnotation(boolean useJacksonAnnotation)

setUseGsonAnnotation

public static void setUseGsonAnnotation(boolean useGsonAnnotation)

isJSONFieldDefaultValueCompatMode

public static boolean isJSONFieldDefaultValueCompatMode()

setJSONFieldDefaultValueCompatMode

public static void setJSONFieldDefaultValueCompatMode(boolean compatMode)

getDefaultMaxLevel

public static int getDefaultMaxLevel()

setDefaultMaxLevel

public static void setDefaultMaxLevel(int maxLevel)

setDefaultObjectSupplier

public static void setDefaultObjectSupplier(java.util.function.Supplier<java.util.Map> objectSupplier)

Sets the default object supplier used when creating JSON objects.

Parameters:

objectSupplier - the supplier for creating Map instances

Since:

2.0.15

setDefaultArraySupplier

public static void setDefaultArraySupplier(java.util.function.Supplier<java.util.List> arraySupplier)

Sets the default array supplier used when creating JSON arrays.

Parameters:

arraySupplier - the supplier for creating List instances

Since:

2.0.15

getDefaultObjectSupplier

public static java.util.function.Supplier<java.util.Map> getDefaultObjectSupplier()

Gets the default object supplier used when creating JSON objects.

Returns:

the supplier for creating Map instances

getDefaultArraySupplier

public static java.util.function.Supplier<java.util.List> getDefaultArraySupplier()

Gets the default array supplier used when creating JSON arrays.

Returns:

the supplier for creating List instances

createWriteContext

public static JSONWriter.Context createWriteContext()

Creates a new JSON writer context with default settings.

Returns:

a new JSONWriter.Context instance

createWriteContext

public static JSONWriter.Context createWriteContext(ObjectWriterProvider provider,
                                                    JSONWriter.Feature... features)

Creates a new JSON writer context with the specified provider and features.

Parameters:

provider - the object writer provider

features - the features to enable

Returns:

a new JSONWriter.Context instance

createWriteContext

public static JSONWriter.Context createWriteContext(JSONWriter.Feature... features)

Creates a new JSON writer context with the specified features.

Parameters:

features - the features to enable

Returns:

a new JSONWriter.Context instance

createReadContext

public static JSONReader.Context createReadContext()

Creates a new JSON reader context with default settings.

Returns:

a new JSONReader.Context instance

createReadContext

public static JSONReader.Context createReadContext(long features)

Creates a new JSON reader context with the specified features.

Parameters:

features - the features to enable

Returns:

a new JSONReader.Context instance

createReadContext

public static JSONReader.Context createReadContext(JSONReader.Feature... features)

Creates a new JSON reader context with the specified features.

Parameters:

features - the features to enable

Returns:

a new JSONReader.Context instance

createReadContext

public static JSONReader.Context createReadContext(Filter filter,
                                                   JSONReader.Feature... features)

createReadContext

public static JSONReader.Context createReadContext(ObjectReaderProvider provider,
                                                   JSONReader.Feature... features)

createReadContext

public static JSONReader.Context createReadContext(SymbolTable symbolTable)

createReadContext

public static JSONReader.Context createReadContext(SymbolTable symbolTable,
                                                   JSONReader.Feature... features)

createReadContext

public static JSONReader.Context createReadContext(java.util.function.Supplier<java.util.Map> objectSupplier,
                                                   JSONReader.Feature... features)

createReadContext

public static JSONReader.Context createReadContext(java.util.function.Supplier<java.util.Map> objectSupplier,
                                                   java.util.function.Supplier<java.util.List> arraySupplier,
                                                   JSONReader.Feature... features)

getObjectReader

public static ObjectReader getObjectReader(java.lang.reflect.Type type,
                                           long features)

getObjectWriter

public static ObjectWriter getObjectWriter(java.lang.reflect.Type type,
                                           long features)

getDefaultObjectWriterProvider

public static ObjectWriterProvider getDefaultObjectWriterProvider()

Gets the default object writer provider.

Returns:

the default ObjectWriterProvider instance

getDefaultObjectReaderProvider

public static ObjectReaderProvider getDefaultObjectReaderProvider()

Gets the default object reader provider.

Returns:

the default ObjectReaderProvider instance

getDefaultJSONPathCompiler

public static JSONFactory.JSONPathCompiler getDefaultJSONPathCompiler()

Gets the default JSONPath compiler.

Returns:

the default JSONPathCompiler instance

setContextReaderCreator

public static void setContextReaderCreator(ObjectReaderCreator creator)

Sets the object reader creator for the current thread context.

Parameters:

creator - the ObjectReaderCreator to set

setContextObjectReaderProvider

public static void setContextObjectReaderProvider(ObjectReaderProvider creator)

Sets the object reader provider for the current thread context.

Parameters:

creator - the ObjectReaderProvider to set

getContextReaderCreator

public static ObjectReaderCreator getContextReaderCreator()

Gets the object reader creator for the current thread context.

Returns:

the ObjectReaderCreator for the current thread, or null if not set

setContextJSONPathCompiler

public static void setContextJSONPathCompiler(JSONFactory.JSONPathCompiler compiler)

Sets the JSONPath compiler for the current thread context.

Parameters:

compiler - the JSONPathCompiler to set

setContextWriterCreator

public static void setContextWriterCreator(ObjectWriterCreator creator)

Sets the object writer creator for the current thread context.

Parameters:

creator - the ObjectWriterCreator to set

getContextWriterCreator

public static ObjectWriterCreator getContextWriterCreator()

Gets the object writer creator for the current thread context.

Returns:

the ObjectWriterCreator for the current thread, or null if not set

getDefaultReaderFeatures

public static long getDefaultReaderFeatures()

Gets the default reader features.

Returns:

the default reader features as a long value

getDefaultReaderZoneId

public static java.time.ZoneId getDefaultReaderZoneId()

Gets the default reader zone ID.

Returns:

the default ZoneId for readers

getDefaultReaderFormat

public static java.lang.String getDefaultReaderFormat()

Gets the default reader format string.

Returns:

the default format string for readers

getDefaultWriterFeatures

public static long getDefaultWriterFeatures()

Gets the default writer features.

Returns:

the default writer features as a long value

getDefaultWriterZoneId

public static java.time.ZoneId getDefaultWriterZoneId()

Gets the default writer zone ID.

Returns:

the default ZoneId for writers

getDefaultWriterFormat

public static java.lang.String getDefaultWriterFormat()

Gets the default writer format string.

Returns:

the default format string for writers

isDefaultWriterAlphabetic

public static boolean isDefaultWriterAlphabetic()

Checks if the default writer uses alphabetic ordering.

Returns:

true if alphabetic ordering is enabled, false otherwise

setDefaultWriterAlphabetic

public static void setDefaultWriterAlphabetic(boolean defaultWriterAlphabetic)

Sets whether the default writer should use alphabetic ordering.

Parameters:

defaultWriterAlphabetic - true to enable alphabetic ordering, false to disable

isDisableReferenceDetect

public static boolean isDisableReferenceDetect()

Checks if reference detection is disabled.

Returns:

true if reference detection is disabled, false otherwise

isDisableAutoType

public static boolean isDisableAutoType()

Checks if auto type support is disabled.

Returns:

true if auto type is disabled, false otherwise

isDisableJSONB

public static boolean isDisableJSONB()

Checks if JSONB format is disabled.

Returns:

true if JSONB is disabled, false otherwise

isDisableArrayMapping

public static boolean isDisableArrayMapping()

Checks if array mapping is disabled.

Returns:

true if array mapping is disabled, false otherwise

setDisableReferenceDetect

public static void setDisableReferenceDetect(boolean disableReferenceDetect)

Sets whether reference detection should be disabled.

Parameters:

disableReferenceDetect - true to disable reference detection, false to enable

setDisableArrayMapping

public static void setDisableArrayMapping(boolean disableArrayMapping)

Sets whether array mapping should be disabled.

Parameters:

disableArrayMapping - true to disable array mapping, false to enable

setDisableJSONB

public static void setDisableJSONB(boolean disableJSONB)

Sets whether JSONB format should be disabled.

Parameters:

disableJSONB - true to disable JSONB, false to enable

setDisableAutoType

public static void setDisableAutoType(boolean disableAutoType)

Sets whether auto type support should be disabled.

Parameters:

disableAutoType - true to disable auto type, false to enable

isDisableSmartMatch

public static boolean isDisableSmartMatch()

Checks if smart matching is disabled.

Returns:

true if smart matching is disabled, false otherwise

setDisableSmartMatch

public static void setDisableSmartMatch(boolean disableSmartMatch)

Sets whether smart matching should be disabled.

Parameters:

disableSmartMatch - true to disable smart matching, false to enable

isDefaultSkipTransient

public static boolean isDefaultSkipTransient()

Checks if transient fields are skipped by default.

Returns:

true if transient fields are skipped, false otherwise

setDefaultSkipTransient

public static void setDefaultSkipTransient(boolean skipTransient)

Sets whether transient fields should be skipped by default.

Parameters:

skipTransient - true to skip transient fields, false to include them