@ConfigurableContext public class UonSerializer extends WriterSerializer implements HttpPartSerializer
Produces
The following shows a sample object defined in Javascript:
{
id: 1,
name:
Using the "strict" syntax defined in this document, the equivalent UON notation would be as follows:
(
Modifier and Type | Class and Description |
---|---|
static class |
UonSerializer.Encoding
Equivalent to
UonSerializer. . |
static class |
UonSerializer.Readable
Equivalent to
UonSerializer. . |
HttpPartSerializer.Null
Modifier and Type | Field and Description |
---|---|
static UonSerializer |
DEFAULT
Reusable instance of
UonSerializer , all default settings. |
static UonSerializer |
DEFAULT_ENCODING
Reusable instance of
UonSerializer.Encoding . |
static UonSerializer |
DEFAULT_READABLE
Reusable instance of
UonSerializer.Readable . |
static String |
UON_addBeanTypes
Configuration property: Add
|
static String |
UON_encoding
Configuration property: Encode non-valid URI characters.
|
static String |
UON_paramFormat
Configuration property: Format to use for query/form-data/header values.
|
WSERIALIZER_fileCharset, WSERIALIZER_maxIndent, WSERIALIZER_quoteChar, WSERIALIZER_streamCharset, WSERIALIZER_useWhitespace
SERIALIZER_addBeanTypes, SERIALIZER_addRootType, SERIALIZER_listener, SERIALIZER_sortCollections, SERIALIZER_sortMaps, SERIALIZER_trimEmptyCollections, SERIALIZER_trimEmptyMaps, SERIALIZER_trimNullProperties, SERIALIZER_trimStrings, SERIALIZER_uriContext, SERIALIZER_uriRelativity, SERIALIZER_uriResolution
BEANTRAVERSE_detectRecursions, BEANTRAVERSE_ignoreRecursions, BEANTRAVERSE_initialDepth, BEANTRAVERSE_maxDepth
BEAN_beanClassVisibility, BEAN_beanConstructorVisibility, BEAN_beanDictionary, BEAN_beanDictionary_add, BEAN_beanDictionary_remove, BEAN_beanFieldVisibility, BEAN_beanFilters, BEAN_beanFilters_add, BEAN_beanFilters_remove, BEAN_beanMapPutReturnsOldValue, BEAN_beanMethodVisibility, BEAN_beansRequireDefaultConstructor, BEAN_beansRequireSerializable, BEAN_beansRequireSettersForGetters, BEAN_beansRequireSomeProperties, BEAN_beanTypePropertyName, BEAN_debug, BEAN_examples, BEAN_excludeProperties, BEAN_fluentSetters, BEAN_ignoreInvocationExceptionsOnGetters, BEAN_ignoreInvocationExceptionsOnSetters, BEAN_ignorePropertiesWithoutSetters, BEAN_ignoreUnknownBeanProperties, BEAN_ignoreUnknownNullBeanProperties, BEAN_implClasses, BEAN_includeProperties, BEAN_locale, BEAN_mediaType, BEAN_notBeanClasses, BEAN_notBeanClasses_add, BEAN_notBeanClasses_remove, BEAN_notBeanPackages, BEAN_notBeanPackages_add, BEAN_notBeanPackages_remove, BEAN_pojoSwaps, BEAN_pojoSwaps_add, BEAN_pojoSwaps_remove, BEAN_propertyNamer, BEAN_sortProperties, BEAN_timeZone, BEAN_useEnumNames, BEAN_useInterfaceProxies, BEAN_useJavaBeanIntrospector, DEFAULT_SORTED
Constructor and Description |
---|
UonSerializer(PropertyStore ps)
Constructor.
|
UonSerializer(PropertyStore ps,
String produces,
String accept)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
UonSerializerBuilder |
builder()
Creates a builder from this context object.
|
static UonSerializerBuilder |
create()
Instantiates a new clean-slate
UonSerializerBuilder object. |
UonSerializerSession |
createPartSession()
Creates a new no-argument serializer session.
|
UonSerializerSession |
createPartSession(SerializerSessionArgs args)
Creates a new serializer session.
|
UonSerializerSession |
createSession()
Create a new bean session based on the properties defined on this context.
|
UonSerializerSession |
createSession(SerializerSessionArgs args)
Create the session object used for actual serialization of objects.
|
protected ParamFormat |
getParamFormat()
Configuration property: Format to use for query/form-data/header values.
|
protected boolean |
isAddBeanTypes()
Configuration property: Add
|
protected boolean |
isEncoding()
Configuration property: Encode non-valid URI characters.
|
String |
serialize(HttpPartSchema schema,
Object value)
Convenience method for creating a no-arg session and serializing a part with no specified part type.
|
String |
serialize(HttpPartType partType,
HttpPartSchema schema,
Object value)
Convenience method for creating a no-arg session and serializing a part.
|
ObjectMap |
toMap()
Returns the properties defined on this bean context as a simple map for debugging purposes.
|
getFileCharset, getMaxIndent, getQuoteChar, getStreamCharset, isUseWhitespace, isWriterSerializer, println, serialize, toString, toStringObject
createDefaultSessionArgs, getAcceptMediaTypes, getListener, getMediaTypeRanges, getPrimaryMediaType, getResponseContentType, getUriContext, getUriRelativity, getUriResolution, isAddRootType, isSortCollections, isSortMaps, isTrimEmptyCollections, isTrimEmptyMaps, isTrimNullProperties, isTrimStrings, serialize, serializeToString
createSession, getInitialDepth, getMaxDepth, isDetectRecursions, isIgnoreRecursions
_class, createBeanSession, createBeanSession, createDefaultBeanSessionArgs, createSession, dumpCacheStats, getBeanClassVisibility, getBeanConstructorVisibility, getBeanDictionaryClasses, getBeanFieldVisibility, getBeanFilters, getBeanMeta, getBeanMethodVisibility, getBeanRegistry, getBeanTypePropertyName, getClassMeta, getClassMeta, getClassMetaForObject, getExamples, getExcludeProperties, getExcludeProperties, getImplClassConstructor, getImplClasses, getIncludeProperties, getIncludeProperties, getLocale, getMediaType, getNotBeanClasses, getNotBeanPackagesNames, getNotBeanPackagesPrefixes, getPojoSwaps, getPropertyNamer, getTimeZone, hasSameCache, isBean, isBeanMapPutReturnsOldValue, isBeansRequireDefaultConstructor, isBeansRequireSerializable, isBeansRequireSettersForGetters, isBeansRequireSomeProperties, isDebug, isFluentSetters, isIgnoreInvocationExceptionsOnGetters, isIgnoreInvocationExceptionsOnSetters, isIgnorePropertiesWithoutSetters, isIgnoreUnknownBeanProperties, isIgnoreUnknownNullBeanProperties, isNotABean, isSortProperties, isUseEnumNames, isUseInterfaceProxies, isUseJavaBeanIntrospector, object, resolveClassMeta, string
equals, getArrayProperty, getArrayProperty, getBooleanProperty, getCdlProperty, getClassArrayProperty, getClassArrayProperty, getClassArrayProperty, getClassListProperty, getClassListProperty, getClassMapProperty, getClassMapProperty, getClassProperty, getClassSetProperty, getClassSetProperty, getInstanceArrayProperty, getInstanceArrayProperty, getInstanceArrayProperty, getInstanceProperty, getInstanceProperty, getInstanceProperty, getIntegerProperty, getListProperty, getListProperty, getLongProperty, getMapProperty, getProperty, getProperty, getPropertyKeys, getPropertyStore, getSetProperty, getSetProperty, getStringProperty, getStringPropertyWithNone, hashCode, identityCode, toString
public static final String UON_addBeanTypes
If
When present, this value overrides the Serializer.SERIALIZER_addBeanTypes
setting and is
provided to customize the behavior of specific serializers in a SerializerGroup
.
public static final String UON_encoding
UonSerializer
, UrlEncodingSerializer
Encode non-valid URI characters with
If
Set to
public static final String UON_paramFormat
ParamFormat
)
Specifies the format to use for URL GET parameter keys and values.
Possible values:
ParamFormat.UON
- Use UON notation for parameters.
ParamFormat.PLAINTEXT
- Use plain text for parameters.
public static final UonSerializer DEFAULT
UonSerializer
, all default settings.public static final UonSerializer DEFAULT_READABLE
UonSerializer.Readable
.public static final UonSerializer DEFAULT_ENCODING
UonSerializer.Encoding
.public UonSerializer(PropertyStore ps)
ps
- The property store containing all the settings for this object.public UonSerializer(PropertyStore ps, String produces, String accept)
ps
- The property store containing all the settings for this object.produces
- The media type that this serializer produces.accept
- The accept media types that the serializer can handle.
Can contain meta-characters per the
If empty, then assumes the only media type supported is
For example, if this serializer produces
The accept value can also contain q-values.
public UonSerializerBuilder builder()
Context
Builders are used to define new contexts (e.g. serializers, parsers) based on existing configurations.
builder
in class Serializer
public static UonSerializerBuilder create()
UonSerializerBuilder
object.
This is equivalent to simply calling
.
Note that this method creates a builder initialized to all default settings, whereas builder()
copies
the settings of the object called on.
UonSerializerBuilder
object.public UonSerializerSession createSession()
BeanContext
Use this method for creating sessions if you don't need to override any properties or locale/timezone currently set on this context.
createSession
in class WriterSerializer
public UonSerializerSession createSession(SerializerSessionArgs args)
Serializer
createSession
in class WriterSerializer
args
- Runtime arguments.
These specify session-level information such as locale and URI context.
It also include session-level properties that override the properties defined on the bean and serializer
contexts.public UonSerializerSession createPartSession(SerializerSessionArgs args)
HttpPartSerializer
createPartSession
in interface HttpPartSerializer
args
- The runtime arguments for the session.public UonSerializerSession createPartSession()
HttpPartSerializer
createPartSession
in interface HttpPartSerializer
public String serialize(HttpPartType partType, HttpPartSchema schema, Object value) throws SchemaValidationException, SerializeException
HttpPartSerializer
serialize
in interface HttpPartSerializer
partType
- The category of value being serialized.schema
- Schema information about the part.
value
- The value being serialized.SchemaValidationException
- If the output fails schema validation.SerializeException
- If a problem occurred while trying to parse the input.public String serialize(HttpPartSchema schema, Object value) throws SchemaValidationException, SerializeException
HttpPartSerializer
serialize
in interface HttpPartSerializer
schema
- Schema information about the part.
value
- The value being serialized.SchemaValidationException
- If the output fails schema validation.SerializeException
- If a problem occurred while trying to parse the input.protected final boolean isAddBeanTypes()
isAddBeanTypes
in class Serializer
UON_addBeanTypes
protected final boolean isEncoding()
UON_encoding
protected final ParamFormat getParamFormat()
UON_paramFormat
public ObjectMap toMap()
Context
toMap
in class WriterSerializer
Copyright © 2016–2019 The Apache Software Foundation. All rights reserved.