public class HtmlDocSerializerBuilder extends HtmlStrippedDocSerializerBuilder
Constructor and Description |
---|
HtmlDocSerializerBuilder()
Constructor, default settings.
|
HtmlDocSerializerBuilder(PropertyStore ps)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
HtmlDocSerializerBuilder |
add(Map<String,Object> properties)
Adds multiple free-form configuration properties on this object without first clearing out any previous values.
|
HtmlDocSerializerBuilder |
addBeanTypes()
|
HtmlDocSerializerBuilder |
addKeyValueTableHeaders()
|
HtmlDocSerializerBuilder |
addNamespaceUrisToRoot()
|
HtmlDocSerializerBuilder |
addRootType()
|
HtmlDocSerializerBuilder |
addTo(String name,
Object value)
Adds a free-form value to a SET property.
|
HtmlDocSerializerBuilder |
annotations(Annotation... values)
|
HtmlDocSerializerBuilder |
appendTo(String name,
Object value)
Adds a free-form value to the end of a LIST property.
|
HtmlDocSerializerBuilder |
apply(PropertyStore copyFrom)
Copies the settings from the specified property store into this builder.
|
HtmlDocSerializerBuilder |
applyAnnotations(AnnotationList al,
VarResolverSession r)
Applies a set of annotations to this property store.
|
HtmlDocSerializerBuilder |
applyAnnotations(Class<?>... fromClasses)
Applies any of the various
|
HtmlDocSerializerBuilder |
applyAnnotations(Method... fromMethods)
Applies any of the various
|
HtmlDocSerializerBuilder |
aside(String[] value)
|
HtmlDocSerializerBuilder |
asideFloat(Float value)
|
HtmlDocSerializerBuilder |
beanClassVisibility(Visibility value)
|
HtmlDocSerializerBuilder |
beanConstructorVisibility(Visibility value)
|
HtmlDocSerializerBuilder |
beanFieldVisibility(Visibility value)
|
HtmlDocSerializerBuilder |
beanInterceptor(Class<?> on,
Class<? extends BeanInterceptor<?>> value)
Bean interceptor.
|
HtmlDocSerializerBuilder |
beanMapPutReturnsOldValue()
|
HtmlDocSerializerBuilder |
beanMethodVisibility(Visibility value)
|
HtmlDocSerializerBuilder |
beansDontRequireSomeProperties()
|
HtmlDocSerializerBuilder |
beansRequireDefaultConstructor()
|
HtmlDocSerializerBuilder |
beansRequireSerializable()
|
HtmlDocSerializerBuilder |
beansRequireSettersForGetters()
|
HtmlDocSerializerBuilder |
bpi(Class<?> beanClass,
String properties)
Bean property includes.
|
HtmlDocSerializerBuilder |
bpi(Map<String,Object> values)
Bean property includes.
|
HtmlDocSerializerBuilder |
bpi(String beanClassName,
String properties)
Bean property includes.
|
HtmlDocSerializerBuilder |
bpro(Class<?> beanClass,
String properties)
Read-only bean properties.
|
HtmlDocSerializerBuilder |
bpro(Map<String,Object> values)
Read-only bean properties.
|
HtmlDocSerializerBuilder |
bpro(String beanClassName,
String properties)
Read-only bean properties.
|
HtmlDocSerializerBuilder |
bpwo(Class<?> beanClass,
String properties)
Write-only bean properties.
|
HtmlDocSerializerBuilder |
bpwo(Map<String,Object> values)
Write-only bean properties.
|
HtmlDocSerializerBuilder |
bpwo(String beanClassName,
String properties)
Write-only bean properties.
|
HtmlDocSerializerBuilder |
bpx(Class<?> beanClass,
String properties)
Bean property excludes.
|
HtmlDocSerializerBuilder |
bpx(Map<String,Object> values)
Bean property excludes.
|
HtmlDocSerializerBuilder |
bpx(String beanClassName,
String properties)
Bean property excludes.
|
HtmlDocSerializer |
build()
Build the object.
|
HtmlDocSerializerBuilder |
debug()
|
HtmlDocSerializerBuilder |
defaultNamespace(String value)
|
HtmlDocSerializerBuilder |
detectRecursions()
|
HtmlDocSerializerBuilder |
dictionary(Object... values)
|
HtmlDocSerializerBuilder |
dictionaryOn(Class<?> on,
Class<?>... values)
|
HtmlDocSerializerBuilder |
dontAutoDetectNamespaces()
|
HtmlDocSerializerBuilder |
dontDetectLabelParameters()
|
HtmlDocSerializerBuilder |
dontDetectLinksInStrings()
Strings . |
HtmlDocSerializerBuilder |
dontIgnorePropertiesWithoutSetters()
|
HtmlDocSerializerBuilder |
dontIgnoreTransientFields()
|
HtmlDocSerializerBuilder |
dontIgnoreUnknownNullBeanProperties()
|
HtmlDocSerializerBuilder |
dontUseInterfaceProxies()
|
HtmlDocSerializerBuilder |
enableNamespaces()
|
<T> HtmlDocSerializerBuilder |
example(Class<T> pojoClass,
T o)
|
<T> HtmlDocSerializerBuilder |
exampleJson(Class<T> pojoClass,
String json)
|
HtmlDocSerializerBuilder |
fileCharset(Charset value)
|
HtmlDocSerializerBuilder |
fluentSetters()
|
HtmlDocSerializerBuilder |
fluentSetters(Class<?> on)
|
HtmlDocSerializerBuilder |
footer(String[] value)
|
HtmlDocSerializerBuilder |
head(String[] value)
|
HtmlDocSerializerBuilder |
header(String[] value)
|
HtmlDocSerializerBuilder |
ignoreInvocationExceptionsOnGetters()
|
HtmlDocSerializerBuilder |
ignoreInvocationExceptionsOnSetters()
|
HtmlDocSerializerBuilder |
ignoreRecursions()
|
HtmlDocSerializerBuilder |
ignoreUnknownBeanProperties()
|
HtmlDocSerializerBuilder |
implClass(Class<?> interfaceClass,
Class<?> implClass)
|
HtmlDocSerializerBuilder |
implClasses(Map<Class<?>,Class<?>> values)
|
HtmlDocSerializerBuilder |
initialDepth(int value)
|
HtmlDocSerializerBuilder |
interfaceClass(Class<?> on,
Class<?> value)
Identifies a class to be used as the interface class for the specified class and all subclasses.
|
HtmlDocSerializerBuilder |
interfaces(Class<?>... value)
Identifies a set of interfaces.
|
HtmlDocSerializerBuilder |
keepNullProperties()
|
HtmlDocSerializerBuilder |
labelParameter(String value)
|
HtmlDocSerializerBuilder |
listener(Class<? extends SerializerListener> value)
|
HtmlDocSerializerBuilder |
locale(Locale value)
|
HtmlDocSerializerBuilder |
maxDepth(int value)
|
HtmlDocSerializerBuilder |
maxIndent(int value)
|
HtmlDocSerializerBuilder |
mediaType(MediaType value)
|
HtmlDocSerializerBuilder |
namespaces(Namespace... values)
|
HtmlDocSerializerBuilder |
namespaces(String... values)
|
HtmlDocSerializerBuilder |
nav(String[] value)
|
HtmlDocSerializerBuilder |
navlinks_replace(String[] value)
|
HtmlDocSerializerBuilder |
navlinks(String[] value)
HtmlDocSerializer.HTMLDOC_navlinks property. |
HtmlDocSerializerBuilder |
noResultsMessage(String value)
|
HtmlDocSerializerBuilder |
notBeanClasses(Object... values)
|
HtmlDocSerializerBuilder |
notBeanPackages(Object... values)
|
HtmlDocSerializerBuilder |
nowrap()
|
HtmlDocSerializerBuilder |
nowrap(boolean value)
|
HtmlDocSerializerBuilder |
ns()
|
HtmlDocSerializerBuilder |
prependTo(String name,
Object value)
Adds a free-form value to the beginning of a LIST property.
|
HtmlDocSerializerBuilder |
propertyNamer(Class<?> on,
Class<? extends PropertyNamer> value)
Bean property namer
|
HtmlDocSerializerBuilder |
propertyNamer(Class<? extends PropertyNamer> value)
|
HtmlDocSerializerBuilder |
putAllTo(String name,
Object value)
Adds or overwrites multiple free-form entries in a MAP property.
|
HtmlDocSerializerBuilder |
putTo(String name,
String key,
Object value)
Adds or overwrites a free-form entry in a MAP property.
|
HtmlDocSerializerBuilder |
quoteChar(char value)
|
HtmlDocSerializerBuilder |
removeFrom(String name,
Object value)
Removes a free-form value from a SET, LIST, or MAP property.
|
HtmlDocSerializerBuilder |
script_replace(String[] value)
|
HtmlDocSerializerBuilder |
script(String[] value)
HtmlDocSerializer.HTMLDOC_script property. |
HtmlDocSerializerBuilder |
set(Map<String,Object> properties)
Sets multiple free-form configuration properties on this object replacing all previous values.
|
HtmlDocSerializerBuilder |
set(String name,
Object value)
Sets a free-form configuration property on this object.
|
HtmlDocSerializerBuilder |
sortCollections()
|
HtmlDocSerializerBuilder |
sortMaps()
|
HtmlDocSerializerBuilder |
sortProperties()
|
HtmlDocSerializerBuilder |
sortProperties(Class<?>... on)
Sort bean properties.
|
HtmlDocSerializerBuilder |
sq()
|
HtmlDocSerializerBuilder |
stopClass(Class<?> on,
Class<?> value)
Identifies a stop class for the annotated class.
|
HtmlDocSerializerBuilder |
streamCharset(Charset value)
|
HtmlDocSerializerBuilder |
style_replace(String[] value)
|
HtmlDocSerializerBuilder |
style(String[] value)
HtmlDocSerializer.HTMLDOC_style property. |
HtmlDocSerializerBuilder |
stylesheet_replace(String[] value)
|
HtmlDocSerializerBuilder |
stylesheet(String[] value)
HtmlDocSerializer.HTMLDOC_stylesheet property. |
HtmlDocSerializerBuilder |
swaps(Object... values)
|
HtmlDocSerializerBuilder |
template(Class<?> value)
|
HtmlDocSerializerBuilder |
timeZone(TimeZone value)
|
HtmlDocSerializerBuilder |
trimEmptyCollections()
|
HtmlDocSerializerBuilder |
trimEmptyMaps()
|
HtmlDocSerializerBuilder |
trimStrings()
|
HtmlDocSerializerBuilder |
typeName(Class<?> on,
String value)
An identifying name for this class.
|
HtmlDocSerializerBuilder |
typePropertyName(Class<?> on,
String value)
|
HtmlDocSerializerBuilder |
typePropertyName(String value)
|
HtmlDocSerializerBuilder |
uriAnchorText(AnchorText value)
|
HtmlDocSerializerBuilder |
uriContext(UriContext value)
|
HtmlDocSerializerBuilder |
uriRelativity(UriRelativity value)
|
HtmlDocSerializerBuilder |
uriResolution(UriResolution value)
|
HtmlDocSerializerBuilder |
useEnumNames()
|
HtmlDocSerializerBuilder |
useJavaBeanIntrospector()
|
HtmlDocSerializerBuilder |
useWhitespace()
|
HtmlDocSerializerBuilder |
widgets(Class<? extends HtmlWidget>... values)
|
HtmlDocSerializerBuilder |
widgets(HtmlWidget... values)
|
HtmlDocSerializerBuilder |
widgetsReplace(Class<? extends HtmlWidget>... values)
|
HtmlDocSerializerBuilder |
widgetsReplace(HtmlWidget... values)
|
HtmlDocSerializerBuilder |
ws()
|
addKeyValueTableHeaders, detectLabelParameters, detectLinksInStrings, uriAnchorText
addNamespaceUrisToRoot, autoDetectNamespaces, enableNamespaces, xsNamespace, xsNamespace
useWhitespace
addBeanTypes, addRootType, dontTrimNullProperties, keepNullProperties, sortCollections, sortMaps, trimEmptyCollections, trimEmptyMaps, trimNullProperties, trimStrings
detectRecursions, ignoreRecursions
beanDictionary, beanDictionary, beanDictionaryRemove, beanDictionaryRemove, beanDictionaryReplace, beanDictionaryReplace, beanFilters, beanFiltersRemove, beanFiltersReplace, beanMapPutReturnsOldValue, beansRequireDefaultConstructor, beansRequireSerializable, beansRequireSettersForGetters, beansRequireSomeProperties, debug, excludeProperties, excludeProperties, excludeProperties, fluentSetters, ignoreInvocationExceptionsOnGetters, ignoreInvocationExceptionsOnSetters, ignorePropertiesWithoutSetters, ignoreTransientFields, ignoreUnknownBeanProperties, ignoreUnknownNullBeanProperties, includeProperties, includeProperties, includeProperties, pojoSwaps, pojoSwapsRemove, pojoSwapsReplace, sortProperties, useEnumNames, useInterfaceProxies, useJavaBeanIntrospector
build, getPropertyStore, getPropertyStoreBuilder, peek, peek
public HtmlDocSerializerBuilder()
public HtmlDocSerializerBuilder(PropertyStore ps)
ps
- The initial configuration settings for this builder.public HtmlDocSerializer build()
ContextBuilder
build
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder aside(String[] value)
Allows you to specify the contents of the aside section on the HTML page. The aside section floats on the right of the page for providing content supporting the serialized content of the page.
By default, the aside section is empty.
value
- The new value for this property.public HtmlDocSerializerBuilder asideFloat(Float value)
HTMLDOC_asideFloat
AsideFloat
AsideFloat.DEFAULT
Allows you to position the aside contents of the page around the main contents.
By default, the aside section is floated to the right.
value
- The new value for this property.public HtmlDocSerializerBuilder footer(String[] value)
Allows you to specify the contents of the footer section on the HTML page.
By default, the footer section is empty.
value
- The new value for this property.public HtmlDocSerializerBuilder head(String[] value)
Adds the specified HTML content to the head section of the page.
value
- The new value for this property.public HtmlDocSerializerBuilder header(String[] value)
Allows you to override the contents of the header section on the HTML page. The header section normally contains the title and description at the top of the page.
value
- The new value for this property.public HtmlDocSerializerBuilder nav(String[] value)
Allows you to override the contents of the nav section on the HTML page. The nav section normally contains the page links at the top of the page.
When this property is specified, the HtmlDocSerializer.HTMLDOC_navlinks
property is ignored.
value
- The new value for this property.public HtmlDocSerializerBuilder navlinks_replace(String[] value)
Adds a list of hyperlinks immediately under the title and description but above the content of the page.
This can be used to provide convenient hyperlinks when viewing the REST interface from a browser.
The value is an array of strings with two possible values:
Relative URLs are considered relative to the servlet path.
For example, if the servlet path is UriResolver
such as
value
- The new value for this property.public HtmlDocSerializerBuilder navlinks(String[] value)
HtmlDocSerializer.HTMLDOC_navlinks
property.value
- The value to add to this property.public HtmlDocSerializerBuilder noResultsMessage(String value)
Allows you to specify the string message used when trying to serialize an empty array or empty list.
A value of
value
- The new value for this property.public HtmlDocSerializerBuilder nowrap(boolean value)
Adds
value
- The new value for this property.
public HtmlDocSerializerBuilder nowrap()
Adds
public HtmlDocSerializerBuilder script_replace(String[] value)
Adds the specified Javascript code to the HTML page.
value
- The new value for this property.public HtmlDocSerializerBuilder script(String[] value)
HtmlDocSerializer.HTMLDOC_script
property.value
- The value to add to this property.public HtmlDocSerializerBuilder style_replace(String[] value)
Adds the specified CSS instructions to the HTML page.
value
- The new value for this property.public HtmlDocSerializerBuilder style(String[] value)
HtmlDocSerializer.HTMLDOC_style
property.value
- The value to add to this property.public HtmlDocSerializerBuilder stylesheet_replace(String[] value)
Adds a link to the specified stylesheet URL.
Note that this stylesheet is controlled by the
annotation.
value
- The new value for this property.public HtmlDocSerializerBuilder stylesheet(String[] value)
HtmlDocSerializer.HTMLDOC_stylesheet
property.value
- The value to add to this property.public HtmlDocSerializerBuilder template(Class<?> value)
Specifies the template to use for serializing the page.
By default, the BasicHtmlDocTemplate
class is used to construct the contents of the HTML page, but
can be overridden with your own custom implementation class.
value
- The new value for this property.public HtmlDocSerializerBuilder widgets(Class<? extends HtmlWidget>... values)
Defines widgets that can be used in conjunction with string variables of the form
values
- The values to add to this setting.public HtmlDocSerializerBuilder widgetsReplace(Class<? extends HtmlWidget>... values)
Same as widgets(Class...)
but replaces any previous values.
values
- The values to set on this setting.public HtmlDocSerializerBuilder widgets(HtmlWidget... values)
Same as widgets(Class...)
except input is pre-constructed instances.
values
- The values to add to this setting.public HtmlDocSerializerBuilder widgetsReplace(HtmlWidget... values)
Same as widgets(HtmlWidget...)
except allows you to overwrite the previous value.
values
- The values to add to this setting.public HtmlDocSerializerBuilder add(Map<String,Object> properties)
ContextBuilder
Identical in function to ContextBuilder.set(String, Object)
but allows you to specify multiple values at once.
add
in class HtmlStrippedDocSerializerBuilder
properties
- The properties to set on this class.
public HtmlDocSerializerBuilder addTo(String name, Object value)
ContextBuilder
SET properties are those properties with one of the following type parts:
For example, the BeanContext.BEAN_notBeanClasses
property which has the value
addTo
in class HtmlStrippedDocSerializerBuilder
name
- The property name.value
- The new value to add to the SET property.
public HtmlDocSerializerBuilder appendTo(String name, Object value)
ContextBuilder
LIST properties are those properties with one of the following type parts:
For example, the BeanContext.BEAN_swaps
property which has the value
appendTo
in class HtmlStrippedDocSerializerBuilder
name
- The property name.value
- The new value to add to the LIST property.
public HtmlDocSerializerBuilder apply(PropertyStore copyFrom)
ContextBuilder
apply
in class HtmlStrippedDocSerializerBuilder
copyFrom
- The property store whose settings are being copied.public HtmlDocSerializerBuilder applyAnnotations(Class<?>... fromClasses)
ContextBuilder
Any annotations found that themselves are annotated with PropertyStoreApply
will be resolved and
applied as properties to this builder. These annotations include:
BeanConfig
CsvConfig
HtmlConfig
HtmlDocConfig
JsoConfig
JsonConfig
JsonSchemaConfig
MsgPackConfig
OpenApiConfig
ParserConfig
PlainTextConfig
SerializerConfig
SoapXmlConfig
UonConfig
UrlEncodingConfig
XmlConfig
Annotations on classes are appended in the following order:
The default var resolver VarResolver.DEFAULT
is used to resolve any variables in annotation field values.
applyAnnotations
in class HtmlStrippedDocSerializerBuilder
fromClasses
- The classes on which the annotations are defined.public HtmlDocSerializerBuilder applyAnnotations(Method... fromMethods)
ContextBuilder
Any annotations found that themselves are annotated with PropertyStoreApply
will be resolved and
applied as properties to this builder. These annotations include:
BeanConfig
CsvConfig
HtmlConfig
HtmlDocConfig
JsoConfig
JsonConfig
JsonSchemaConfig
MsgPackConfig
OpenApiConfig
ParserConfig
PlainTextConfig
SerializerConfig
SoapXmlConfig
UonConfig
UrlEncodingConfig
XmlConfig
Annotations on methods are appended in the following order:
The default var resolver VarResolver.DEFAULT
is used to resolve any variables in annotation field values.
applyAnnotations
in class HtmlStrippedDocSerializerBuilder
fromMethods
- The methods on which the annotations are defined.public HtmlDocSerializerBuilder applyAnnotations(AnnotationList al, VarResolverSession r)
ContextBuilder
The AnnotationList
object is an ordered list of annotations and the classes/methods/packages they were found on.
applyAnnotations
in class HtmlStrippedDocSerializerBuilder
al
- The list of all annotations annotated with PropertyStoreApply
.r
- The string resolver for resolving variables in annotation values.public HtmlDocSerializerBuilder debug()
ContextBuilder
Enables the following additional information during serialization:
BeanTraverseContext.BEANTRAVERSE_detectRecursions
.
Enables the following additional information during parsing:
debug
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder locale(Locale value)
ContextBuilder
Specifies the default locale for serializer and parser sessions when not specified via SessionArgs.locale(Locale)
.
Typically used for POJO swaps that need to deal with locales such as swaps that convert PojoSwap.swap(BeanSession, Object)
and
PojoSwap.unswap(BeanSession, Object, ClassMeta, String)
methods.
locale
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.public HtmlDocSerializerBuilder mediaType(MediaType value)
ContextBuilder
Specifies the default media type for serializer and parser sessions when not specified via SessionArgs.mediaType(MediaType)
.
Typically used for POJO swaps that need to serialize the same POJO classes differently depending on
the specific requested media type. For example, a swap could handle a request for media types
mediaType
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.public HtmlDocSerializerBuilder prependTo(String name, Object value)
ContextBuilder
LIST properties are those properties with one of the following type parts:
For example, the BeanContext.BEAN_swaps
property which has the value
prependTo
in class HtmlStrippedDocSerializerBuilder
name
- The property name.value
- The new value to add to the LIST property.
public HtmlDocSerializerBuilder putAllTo(String name, Object value)
ContextBuilder
MAP properties are those properties with one of the following type parts:
For example, the BeanContext.BEAN_implClasses
property which has the value
putAllTo
in class HtmlStrippedDocSerializerBuilder
name
- The property name.value
- Either a JSON Object string or a Map
whose valid value types depend on the property type:
public HtmlDocSerializerBuilder putTo(String name, String key, Object value)
ContextBuilder
MAP properties are those properties with one of the following type parts:
For example, the BeanContext.BEAN_implClasses
property which has the value
putTo
in class HtmlStrippedDocSerializerBuilder
name
- The property name.key
- The property value map key.value
- The property value map value.
public HtmlDocSerializerBuilder removeFrom(String name, Object value)
ContextBuilder
removeFrom
in class HtmlStrippedDocSerializerBuilder
name
- The property name.value
- The property value in the SET/LIST/MAP property.public HtmlDocSerializerBuilder set(Map<String,Object> properties)
ContextBuilder
Identical in function to ContextBuilder.set(String, Object)
but allows you to specify multiple values at once.
set
in class HtmlStrippedDocSerializerBuilder
properties
- The properties to set on this class.
public HtmlDocSerializerBuilder set(String name, Object value)
ContextBuilder
Provides the ability to specify configuration property values in a generic fashion.
Property names must have the following format that identify their datatype...
...where the parts consist of the following...
For example,
Property values get 'normalized' when they get set.
For example, calling PropertyStore
class to be comparable
and useful in determining whether a cached instance of a context object can be returned.
As a general rule, builders don't typically have "unsetter" methods. For example, once you've set strict
mode on the
set
in class HtmlStrippedDocSerializerBuilder
name
- The property name.value
- The property value.
public HtmlDocSerializerBuilder timeZone(TimeZone value)
ContextBuilder
Specifies the default time zone for serializer and parser sessions when not specified via SessionArgs.timeZone(TimeZone)
.
Typically used for POJO swaps that need to deal with timezones such as swaps that convert PojoSwap.swap(BeanSession, Object)
and
PojoSwap.unswap(BeanSession, Object, ClassMeta, String)
methods.
timeZone
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.public HtmlDocSerializerBuilder annotations(Annotation... values)
BeanContextBuilder
Defines annotations to apply to specific classes and methods.
Allows you to dynamically apply Juneau annotations typically applied directly to classes and methods. Useful in cases where you want to use the functionality of the annotation on beans and bean properties but do not have access to the code to do so.
As a rule, any Juneau annotation with an
The following example shows the equivalent methods for applying the @Bean
annotation:
In general, the underlying framework uses this method when it finds dynamically applied annotations on config annotations. However, concrete implementations of annotations are also provided that can be passed directly into builder classes like so:
The following is the list of concrete annotations provided that can be constructed and passed into the builder class:
BeanAnnotation
BeancAnnotation
BeanIgnoreAnnotation
BeanpAnnotation
ExampleAnnotation
NamePropertyAnnotation
ParentPropertyAnnotation
SwapAnnotation
UriAnnotation
CsvAnnotation
HtmlAnnotation
JsoAnnotation
JsonAnnotation
SchemaAnnotation
MsgPackAnnotation
OpenApiAnnotation
PlainTextAnnotation
SoapXmlAnnotation
UonAnnotation
UrlEncodingAnnotation
XmlAnnotation
The syntax for the
annotations
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this property.public HtmlDocSerializerBuilder beanClassVisibility(Visibility value)
BeanContextBuilder
Classes are not considered beans unless they meet the minimum visibility requirements.
For example, if the visibility is
@Bean
annotation can be used on a non-public bean class to override this setting.
@BeanIgnore
annotation can also be used on a public bean class to ignore it as a bean.
beanClassVisibility
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
Visibility.PUBLIC
.public HtmlDocSerializerBuilder beanConstructorVisibility(Visibility value)
BeanContextBuilder
Only look for constructors with the specified minimum visibility.
This setting affects the logic for finding no-arg constructors for bean. Normally, only
@Beanc
annotation can also be used to expose a non-public constructor.
@BeanIgnore
annotation can also be used on a public bean constructor to ignore it.
beanConstructorVisibility
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
Visibility.PUBLIC
.public HtmlDocSerializerBuilder beanFieldVisibility(Visibility value)
BeanContextBuilder
Only look for bean fields with the specified minimum visibility.
This affects which fields on a bean class are considered bean properties. Normally only
Bean fields can be ignored as properties entirely by setting the value to Visibility.NONE
@Beanp
annotation can also be used to expose a non-public field.
@BeanIgnore
annotation can also be used on a public bean field to ignore it as a bean property.
beanFieldVisibility
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
Visibility.PUBLIC
.public HtmlDocSerializerBuilder beanInterceptor(Class<?> on, Class<? extends BeanInterceptor<?>> value)
BeanContextBuilder
Bean interceptors can be used to intercept calls to getters and setters and alter their values in transit.
beanInterceptor
in class HtmlStrippedDocSerializerBuilder
on
- The bean that the filter applies to.value
- The new value for this property.public HtmlDocSerializerBuilder beanMapPutReturnsOldValue()
BeanContextBuilder
When enabled, then the BeanMap.put()
method will return old property
values. Otherwise, it returns
Disabled by default because it introduces a slight performance penalty during serialization.
beanMapPutReturnsOldValue
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder beanMethodVisibility(Visibility value)
BeanContextBuilder
Only look for bean methods with the specified minimum visibility.
This affects which methods are detected as getters and setters on a bean class. Normally only
@Beanp
annotation can also be used to expose a non-public method.
@BeanIgnore
annotation can also be used on a public bean getter/setter to ignore it as a bean property.
beanMethodVisibility
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
Visibility.PUBLIC
public HtmlDocSerializerBuilder beansDontRequireSomeProperties()
BeanContextBuilder
When enabled, then a Java class must contain at least 1 property to be considered a bean.
Otherwise, the bean will be serialized as a string using the Object.toString()
method.
The @Bean
annotation can be used on a class to override this setting when
@Bean
annotation can be used on the class to force it to be recognized as a bean class
even if it has no properties.
beansDontRequireSomeProperties
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder beansRequireDefaultConstructor()
BeanContextBuilder
When enabled, a Java class must implement a default no-arg constructor to be considered a bean.
Otherwise, the bean will be serialized as a string using the Object.toString()
method.
@Bean
annotation can be used on a bean class to override this setting.
@BeanIgnore
annotation can also be used on a class to ignore it as a bean.
beansRequireDefaultConstructor
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder beansRequireSerializable()
BeanContextBuilder
When enabled, a Java class must implement the Serializable
interface to be considered a bean.
Otherwise, the bean will be serialized as a string using the Object.toString()
method.
@Bean
annotation can be used on a bean class to override this setting.
@BeanIgnore
annotation can also be used on a class to ignore it as a bean.
beansRequireSerializable
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder beansRequireSettersForGetters()
BeanContextBuilder
When enabled, ignore read-only properties (properties with getters but not setters).
@Beanp
annotation can be used on the getter to override this setting.
@BeanIgnore
annotation can also be used on getters to ignore them as bean properties.
beansRequireSettersForGetters
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder bpi(Map<String,Object> values)
BeanContextBuilder
Specifies the set and order of names of properties associated with bean classes.
For example, BeanContextBuilder.ignoreUnknownBeanProperties()
has been called.
This value is entirely optional if you simply want to expose all the getters and public fields on a class as bean properties. However, it's useful if you want certain getters to be ignored or you want the properties to be serialized in a particular order. Note that on IBM JREs, the property order is the same as the order in the source code, whereas on Oracle JREs, the order is entirely random.
Setting applies to specified class and all subclasses.
This method is functionally equivalent to the following code for each entry:
builder.annotations(
Bean.bpi()
- On an annotation on the bean class itself.
BeanConfig.bpi()
- On a bean config annotation (see BeanContextBuilder.annotations(Annotation...)
).
bpi
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this builder.
public HtmlDocSerializerBuilder bpi(Class<?> beanClass, String properties)
BeanContextBuilder
Specifies the set and order of names of properties associated with the bean class.
For example, BeanContextBuilder.ignoreUnknownBeanProperties()
has been called.
This value is entirely optional if you simply want to expose all the getters and public fields on a class as bean properties. However, it's useful if you want certain getters to be ignored or you want the properties to be serialized in a particular order. Note that on IBM JREs, the property order is the same as the order in the source code, whereas on Oracle JREs, the order is entirely random.
Setting applies to specified class and all subclasses.
This method is functionally equivalent to the following code:
builder.annotations(
Bean.bpi()
- On an annotation on the bean class itself.
BeanConfig.bpi()
- On a bean config annotation (see BeanContextBuilder.annotations(Annotation...)
).
bpi
in class HtmlStrippedDocSerializerBuilder
beanClass
- The bean class.properties
- Comma-delimited list of property names.public HtmlDocSerializerBuilder bpi(String beanClassName, String properties)
BeanContextBuilder
Specifies the set and order of names of properties associated with the bean class.
For example, BeanContextBuilder.ignoreUnknownBeanProperties()
has been called.
This value is entirely optional if you simply want to expose all the getters and public fields on a class as bean properties. However, it's useful if you want certain getters to be ignored or you want the properties to be serialized in a particular order. Note that on IBM JREs, the property order is the same as the order in the source code, whereas on Oracle JREs, the order is entirely random.
Setting applies to specified class and all subclasses.
This method is functionally equivalent to the following code:
builder.annotations(
Bean.bpi()
- On an annotation on the bean class itself.
BeanConfig.bpi()
- On a bean config annotation (see BeanContextBuilder.annotations(Annotation...)
).
bpi
in class HtmlStrippedDocSerializerBuilder
beanClassName
- The bean class name.
properties
- Comma-delimited list of property names.public HtmlDocSerializerBuilder bpro(Map<String,Object> values)
BeanContextBuilder
Specifies one or more properties on beans that are read-only despite having valid getters.
Serializers will serialize such properties as usual, but parsers will silently ignore them.
Note that this is different from the
This method is functionally equivalent to the following code for each entry:
builder.annotations(
bpro
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this builder.
public HtmlDocSerializerBuilder bpro(Class<?> beanClass, String properties)
BeanContextBuilder
Specifies one or more properties on a bean that are read-only despite having valid getters.
Serializers will serialize such properties as usual, but parsers will silently ignore them.
Note that this is different from the
This method is functionally equivalent to the following code:
builder.annotations(
bpro
in class HtmlStrippedDocSerializerBuilder
beanClass
- The bean class.properties
- Comma-delimited list of property names.public HtmlDocSerializerBuilder bpro(String beanClassName, String properties)
BeanContextBuilder
Specifies one or more properties on a bean that are read-only despite having valid getters.
Serializers will serialize such properties as usual, but parsers will silently ignore them.
Note that this is different from the
This method is functionally equivalent to the following code:
builder.annotations(
bpro
in class HtmlStrippedDocSerializerBuilder
beanClassName
- The bean class name.
properties
- Comma-delimited list of property names.public HtmlDocSerializerBuilder bpwo(Map<String,Object> values)
BeanContextBuilder
Specifies one or more properties on a bean that are write-only despite having valid setters.
Parsers will parse such properties as usual, but serializers will silently ignore them.
Note that this is different from the
This method is functionally equivalent to the following code for each entry:
builder.annotations(
bpwo
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this builder.
public HtmlDocSerializerBuilder bpwo(Class<?> beanClass, String properties)
BeanContextBuilder
Specifies one or more properties on a bean that are write-only despite having valid setters.
Parsers will parse such properties as usual, but serializers will silently ignore them.
Note that this is different from the
This method is functionally equivalent to the following code:
builder.annotations(
bpwo
in class HtmlStrippedDocSerializerBuilder
beanClass
- The bean class.properties
- Comma-delimited list of property names.public HtmlDocSerializerBuilder bpwo(String beanClassName, String properties)
BeanContextBuilder
Specifies one or more properties on a bean that are write-only despite having valid setters.
Parsers will parse such properties as usual, but serializers will silently ignore them.
Note that this is different from the
This method is functionally equivalent to the following code:
builder.annotations(
bpwo
in class HtmlStrippedDocSerializerBuilder
beanClassName
- The bean class name.
properties
- Comma-delimited list of property names.public HtmlDocSerializerBuilder bpx(Map<String,Object> values)
BeanContextBuilder
Specifies to exclude the specified list of properties for the specified bean classes.
Same as BeanContextBuilder.bpi(Map)
except you specify a list of bean property names that you want to exclude from
serialization.
Setting applies to specified class and all subclasses.
This method is functionally equivalent to the following code for each entry:
builder.annotations(
bpx
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this builder.
public HtmlDocSerializerBuilder bpx(Class<?> beanClass, String properties)
BeanContextBuilder
Specifies to exclude the specified list of properties for the specified bean class.
Same as BeanContextBuilder.bpi(Class, String)
except you specify a list of bean property names that you want to exclude from
serialization.
Setting applies to specified class and all subclasses.
This method is functionally equivalent to the following code:
builder.annotations(
bpx
in class HtmlStrippedDocSerializerBuilder
beanClass
- The bean class.properties
- Comma-delimited list of property names.public HtmlDocSerializerBuilder bpx(String beanClassName, String properties)
BeanContextBuilder
Specifies to exclude the specified list of properties for the specified bean class.
Same as BeanContextBuilder.bpx(String, String)
except you specify a list of bean property names that you want to exclude from
serialization.
Setting applies to specified class and all subclasses.
This method is functionally equivalent to the following code:
builder.annotations(
bpx
in class HtmlStrippedDocSerializerBuilder
beanClassName
- The bean class name.
properties
- Comma-delimited list of property names.public HtmlDocSerializerBuilder dictionary(Object... values)
BeanContextBuilder
The list of classes that make up the bean dictionary in this bean context.
A dictionary is a name/class mapping used to find class types during parsing when they cannot be inferred
through reflection. The names are defined through the @Bean(typeName)
annotation defined
on the bean class. For example, if a class
This setting tells the parsers which classes to look for when resolving
Values can consist of any of the following types:
@Bean(typeName)
.
BeanDictionaryList
containing a collection of bean classes with type name annotations.
BeanDictionaryMap
containing a mapping of type names to classes without type name annotations.
Another option is to use the Bean.dictionary()
annotation on the POJO class itself:
A typical usage is to allow for HTML documents to be parsed back into HTML beans:
dictionary
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this property.public HtmlDocSerializerBuilder dictionaryOn(Class<?> on, Class<?>... values)
BeanContextBuilder
This is identical to BeanContextBuilder.dictionary(Object...)
, but specifies a dictionary within the context of
a single class as opposed to globally.
This is functionally equivalent to the Bean.dictionary()
annotation.
dictionaryOn
in class HtmlStrippedDocSerializerBuilder
on
- The class that the dictionary values apply to.values
- The new values for this property.public HtmlDocSerializerBuilder dontIgnorePropertiesWithoutSetters()
BeanContextBuilder
When enabled, trying to set a value on a bean property without a setter will silently be ignored.
Otherwise, a BeanRuntimeException
is thrown.
@BeanIgnore
annotation can also be used on getters and fields to ignore them.
dontIgnorePropertiesWithoutSetters
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder dontIgnoreTransientFields()
BeanContextBuilder
When enabled, methods and fields marked as
@Beanp
annotation can also be used on transient fields to keep them from being ignored.
dontIgnoreTransientFields
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder dontIgnoreUnknownNullBeanProperties()
BeanContextBuilder
When enabled, trying to set a BeanRuntimeException
is thrown.
dontIgnoreUnknownNullBeanProperties
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder dontUseInterfaceProxies()
BeanContextBuilder
When enabled, interfaces will be instantiated as proxy classes through the use of an
InvocationHandler
if there is no other way of instantiating them.
Otherwise, throws a BeanRuntimeException
.
dontUseInterfaceProxies
in class HtmlStrippedDocSerializerBuilder
public <T> HtmlDocSerializerBuilder example(Class<T> pojoClass, T o)
BeanContextBuilder
Specifies an example of the specified class.
Examples are used in cases such as POJO examples in Swagger documents.
Setting applies to specified class and all subclasses.
POJO examples can also be defined on classes via the following:
@Example
.
@Example
with zero arguments or one BeanSession
argument.
BeanSession
argument.
example
in class HtmlStrippedDocSerializerBuilder
pojoClass
- The POJO class.o
- An instance of the POJO class used for examples.public <T> HtmlDocSerializerBuilder exampleJson(Class<T> pojoClass, String json)
BeanContextBuilder
Specifies an example in JSON of the specified class.
Examples are used in cases such as POJO examples in Swagger documents.
Setting applies to specified class and all subclasses.
POJO examples can also be defined on classes via the following:
@Example
.
@Example
with zero arguments or one BeanSession
argument.
BeanSession
argument.
exampleJson
in class HtmlStrippedDocSerializerBuilder
T
- The POJO class type.pojoClass
- The POJO class.json
- The simple JSON representation of the example.public HtmlDocSerializerBuilder fluentSetters()
BeanContextBuilder
When enabled, fluent setters are detected on beans during parsing.
Fluent setters must have the following attributes:
@Beanp
annotation can also be used on methods to individually identify them as fluent setters.
@Bean.fluentSetters()
annotation can also be used on classes to specify to look for fluent setters.
fluentSetters
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder fluentSetters(Class<?> on)
BeanContextBuilder
Identical to BeanContextBuilder.fluentSetters()
but enables it on a specific class only.
Bean.fluentSetters()
annotation.
fluentSetters
in class HtmlStrippedDocSerializerBuilder
on
- The class that this applies to.public HtmlDocSerializerBuilder ignoreInvocationExceptionsOnGetters()
BeanContextBuilder
When enabled, errors thrown when calling bean getter methods will silently be ignored.
Otherwise, a BeanRuntimeException
is thrown.
ignoreInvocationExceptionsOnGetters
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder ignoreInvocationExceptionsOnSetters()
BeanContextBuilder
When enabled, errors thrown when calling bean setter methods will silently be ignored.
Otherwise, a BeanRuntimeException
is thrown.
ignoreInvocationExceptionsOnSetters
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder ignoreUnknownBeanProperties()
BeanContextBuilder
When enabled, trying to set a value on a non-existent bean property will silently be ignored.
Otherwise, a BeanRuntimeException
is thrown.
ignoreUnknownBeanProperties
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder implClass(Class<?> interfaceClass, Class<?> implClass)
BeanContextBuilder
For interfaces and abstract classes this method can be used to specify an implementation class for the interface/abstract class so that instances of the implementation class are used when instantiated (e.g. during a parse).
implClass
in class HtmlStrippedDocSerializerBuilder
interfaceClass
- The interface class.implClass
- The implementation class.public HtmlDocSerializerBuilder implClasses(Map<Class<?>,Class<?>> values)
BeanContextBuilder
For interfaces and abstract classes this method can be used to specify an implementation class for the interface/abstract class so that instances of the implementation class are used when instantiated (e.g. during a parse).
implClasses
in class HtmlStrippedDocSerializerBuilder
values
- The new value for this property.public HtmlDocSerializerBuilder interfaceClass(Class<?> on, Class<?> value)
BeanContextBuilder
When specified, only the list of properties defined on the interface class will be used during serialization. Additional properties on subclasses will be ignored.
This annotation can be used on the parent class so that it filters to all child classes, or can be set individually on the child classes.
@Bean(interfaceClass)
annotation is the equivalent annotation-based solution.
interfaceClass
in class HtmlStrippedDocSerializerBuilder
on
- The class that the interface class applies to.value
- The new value for this property.public HtmlDocSerializerBuilder interfaces(Class<?>... value)
BeanContextBuilder
When specified, only the list of properties defined on the interface class will be used during serialization of implementation classes. Additional properties on subclasses will be ignored.
This annotation can be used on the parent class so that it filters to all child classes, or can be set individually on the child classes.
@Bean(interfaceClass)
annotation is the equivalent annotation-based solution.
interfaces
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.public HtmlDocSerializerBuilder notBeanClasses(Object... values)
BeanContextBuilder
List of classes that should not be treated as beans even if they appear to be bean-like.
Not-bean classes are converted to
Values can consist of any of the following types:
@BeanIgnore
annotation can also be used on classes to prevent them from being recognized as beans.
notBeanClasses
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this property.
public HtmlDocSerializerBuilder notBeanPackages(Object... values)
BeanContextBuilder
Used as a convenient way of defining the BeanContextBuilder.notBeanClasses(Object...)
property for entire packages.
Any classes within these packages will be serialized to strings using Object.toString()
.
Note that you can specify suffix patterns to include all subpackages.
Values can consist of any of the following types:
notBeanPackages
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this property.
Package
objects.
public HtmlDocSerializerBuilder propertyNamer(Class<? extends PropertyNamer> value)
BeanContextBuilder
The class to use for calculating bean property names.
Predefined classes:
PropertyNamerDefault
- Default.
PropertyNamerDLC
- Dashed-lower-case names.
PropertyNamerULC
- Dashed-upper-case names.
propertyNamer
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this setting.
PropertyNamerDefault
.public HtmlDocSerializerBuilder propertyNamer(Class<?> on, Class<? extends PropertyNamer> value)
BeanContextBuilder
Same as BeanContextBuilder.propertyNamer(Class)
but allows you to specify a namer for a specific class.
propertyNamer
in class HtmlStrippedDocSerializerBuilder
on
- The class that the namer applies to.value
- The new value for this setting.
PropertyNamerDefault
.public HtmlDocSerializerBuilder sortProperties()
BeanContextBuilder
When enabled, all bean properties will be serialized and access in alphabetical order. Otherwise, the natural order of the bean properties is used which is dependent on the JVM vendor. On IBM JVMs, the bean properties are ordered based on their ordering in the Java file. On Oracle JVMs, the bean properties are not ordered (which follows the official JVM specs).
This property is disabled by default so that IBM JVM users don't have to use @Bean
annotations
to force bean properties to be in a particular order and can just alter the order of the fields/methods
in the Java file.
@Bean.sort()
annotation can also be used to sort properties on just a single class.
sortProperties
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder sortProperties(Class<?>... on)
BeanContextBuilder
Same as BeanContextBuilder.sortProperties()
but allows you to specify individual bean classes instead of globally.
sortProperties
in class HtmlStrippedDocSerializerBuilder
on
- The bean classes to sort properties on.public HtmlDocSerializerBuilder stopClass(Class<?> on, Class<?> value)
BeanContextBuilder
Identical in purpose to the stop class specified by Introspector.getBeanInfo(Class, Class)
.
Any properties in the stop class or in its base classes will be ignored during analysis.
For example, in the following class hierarchy, instances of
stopClass
in class HtmlStrippedDocSerializerBuilder
on
- The class on which the stop class is being applied.value
- The new value for this property.public HtmlDocSerializerBuilder swaps(Object... values)
BeanContextBuilder
Swaps are used to "swap out" non-serializable classes with serializable equivalents during serialization, and "swap in" the non-serializable class during parsing.
An example of a swap would be a
Multiple swaps can be associated with a single class.
When multiple swaps are applicable to the same class, the media type pattern defined by
PojoSwap.forMediaTypes()
or @Swap(mediaTypes)
are used to come up with the best match.
Values can consist of any of the following types:
PojoSwap
.
PojoSwap
.
SurrogateSwap
.
swaps
in class HtmlStrippedDocSerializerBuilder
values
- The values to add to this property.
PojoSwap
.
SurrogateSwap
.
public HtmlDocSerializerBuilder typeName(Class<?> on, String value)
BeanContextBuilder
The name is used to identify the class type during parsing when it cannot be inferred through reflection.
For example, if a bean property is of type
It is also used to specify element names in XML.
Bean(typeName)
annotation.
typeName
in class HtmlStrippedDocSerializerBuilder
on
- The class the type name is being defined on.value
- The new value for this property.public HtmlDocSerializerBuilder typePropertyName(String value)
BeanContextBuilder
This specifies the name of the bean property used to store the dictionary name of a bean type so that the parser knows the data type to reconstruct.
typePropertyName
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder typePropertyName(Class<?> on, String value)
BeanContextBuilder
Same as BeanContextBuilder.typePropertyName(String)
except targets a specific bean class instead of globally.
typePropertyName
in class HtmlStrippedDocSerializerBuilder
on
- The class the type property name applies to.value
- The new value for this property.
public HtmlDocSerializerBuilder useEnumNames()
BeanContextBuilder
When enabled, enums are always serialized by name, not using Object.toString()
.
useEnumNames
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder useJavaBeanIntrospector()
BeanContextBuilder
Using the built-in Java bean introspector will not pick up fields or non-standard getters/setters.
Most @Bean
annotations will be ignored.
useJavaBeanIntrospector
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder detectRecursions()
BeanTraverseBuilder
When enabled, specifies that recursions should be checked for during traversal.
Recursions can occur when traversing models that aren't true trees but rather contain loops.
In general, unchecked recursions cause stack-overflow-errors.
These show up as BeanRecursionException
with the message
detectRecursions
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder ignoreRecursions()
BeanTraverseBuilder
When enabled, when we encounter the same object when traversing a tree, we set the value to
For example, if a model contains the links A->B->C->A, then the JSON generated will look like
the following when
{A:{B:{C:
ignoreRecursions
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder initialDepth(int value)
BeanTraverseBuilder
The initial indentation level at the root.
Useful when constructing document fragments that need to be indented at a certain level when whitespace is enabled.
initialDepth
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder maxDepth(int value)
BeanTraverseBuilder
When enabled, abort traversal if specified depth is reached in the POJO tree.
If this depth is exceeded, an exception is thrown.
This prevents stack overflows from occurring when trying to traverse models with recursive references.
maxDepth
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder addBeanTypes()
SerializerBuilder
When enabled,
This is used to recreate the correct objects during parsing if the object types cannot be inferred.
For example, when serializing a
Note the differences between the following settings:
SerializerBuilder.addRootType()
- Affects whether SerializerBuilder.addBeanTypes()
- Affects whether
addBeanTypes
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder addRootType()
SerializerBuilder
When enabled,
When disabled, it is assumed that the parser knows the exact Java POJO type being parsed, and therefore top-level type information that might normally be included to determine the data type will not be serialized.
For example, when serializing a top-level POJO with a @Bean(typeName)
value, a
Note the differences between the following settings:
SerializerBuilder.addRootType()
- Affects whether SerializerBuilder.addBeanTypes()
- Affects whether
addRootType
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder keepNullProperties()
SerializerBuilder
When enabled, null bean values will be serialized to the output.
keepNullProperties
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder listener(Class<? extends SerializerListener> value)
SerializerBuilder
Class used to listen for errors and warnings that occur during serialization.
listener
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.public HtmlDocSerializerBuilder sortCollections()
SerializerBuilder
When enabled, copies and sorts the contents of arrays and collections before serializing them.
Note that this introduces a performance penalty since it requires copying the existing collection.
sortCollections
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder sortMaps()
SerializerBuilder
When enabled, copies and sorts the contents of maps by their keys before serializing them.
Note that this introduces a performance penalty.
sortMaps
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder trimEmptyCollections()
SerializerBuilder
When enabled, empty lists and arrays will not be serialized.
Note that enabling this setting has the following effects on parsing:
trimEmptyCollections
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder trimEmptyMaps()
SerializerBuilder
When enabled, empty map values will not be serialized to the output.
Note that enabling this setting has the following effects on parsing:
trimEmptyMaps
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder trimStrings()
SerializerBuilder
When enabled, string values will be trimmed of whitespace using String.trim()
before being serialized.
trimStrings
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder uriContext(UriContext value)
SerializerBuilder
Bean used for resolution of URIs to absolute or root-relative form.
uriContext
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.public HtmlDocSerializerBuilder uriRelativity(UriRelativity value)
SerializerBuilder
Defines what relative URIs are relative to when serializing any of the following:
Possible values are:
UriRelativity.RESOURCE
- Relative URIs should be considered relative to the servlet URI.
UriRelativity.PATH_INFO
- Relative URIs should be considered relative to the request URI.
See SerializerBuilder.uriContext(UriContext)
for examples.
uriRelativity
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
UriRelativity.RESOURCE
public HtmlDocSerializerBuilder uriResolution(UriResolution value)
SerializerBuilder
Defines the resolution level for URIs when serializing any of the following:
Possible values are:
UriResolution.ABSOLUTE
- Resolve to an absolute URL (e.g. UriResolution.ROOT_RELATIVE
- Resolve to a root-relative URL (e.g. UriResolution.NONE
- Don't do any URL resolution.
See SerializerBuilder.uriContext(UriContext)
for examples.
uriResolution
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
UriResolution.NONE
public HtmlDocSerializerBuilder fileCharset(Charset value)
WriterSerializerBuilder
The character set to use for writing
Used when passing in files to Serializer.serialize(Object, Object)
.
fileCharset
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder maxIndent(int value)
WriterSerializerBuilder
Specifies the maximum indentation level in the serialized document.
maxIndent
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder quoteChar(char value)
WriterSerializerBuilder
Specifies the character to use for quoting attributes and values.
quoteChar
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder sq()
WriterSerializerBuilder
Specifies to use single quotes for quoting attributes and values.
sq
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder streamCharset(Charset value)
WriterSerializerBuilder
The character set to use when writing to
Used when passing in output streams and byte arrays to Serializer.serialize(Object, Object)
.
streamCharset
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder useWhitespace()
WriterSerializerBuilder
When enabled, whitespace is added to the output to improve readability.
useWhitespace
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder ws()
WriterSerializerBuilder
When enabled, whitespace is added to the output to improve readability.
ws
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder addNamespaceUrisToRoot()
XmlSerializerBuilder
Shortcut for calling addNamespaceUrisToRoot(
.
addNamespaceUrisToRoot
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder defaultNamespace(String value)
XmlSerializerBuilder
Specifies the default namespace URI for this document.
defaultNamespace
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder dontAutoDetectNamespaces()
XmlSerializerBuilder
Detect namespace usage before serialization.
dontAutoDetectNamespaces
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder enableNamespaces()
XmlSerializerBuilder
Shortcut for calling enableNamespaces(
.
enableNamespaces
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder namespaces(String... values)
XmlSerializerBuilder
The default list of namespaces associated with this serializer.
namespaces
in class HtmlStrippedDocSerializerBuilder
values
- The new value for this property.public HtmlDocSerializerBuilder namespaces(Namespace... values)
XmlSerializerBuilder
The default list of namespaces associated with this serializer.
namespaces
in class HtmlStrippedDocSerializerBuilder
values
- The new value for this property.public HtmlDocSerializerBuilder ns()
XmlSerializerBuilder
Shortcut for calling enableNamespaces(
.
ns
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder addKeyValueTableHeaders()
HtmlSerializerBuilder
Shortcut for calling addKeyValueTableHeaders(
.
addKeyValueTableHeaders
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder dontDetectLabelParameters()
HtmlSerializerBuilder
If the URL has a label parameter (e.g.
dontDetectLabelParameters
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder dontDetectLinksInStrings()
HtmlSerializerBuilder
Strings
.
If a string looks like a URL (e.g. starts with HtmlSerializer.HTML_uriAnchorText
.
dontDetectLinksInStrings
in class HtmlStrippedDocSerializerBuilder
public HtmlDocSerializerBuilder labelParameter(String value)
HtmlSerializerBuilder
The parameter name to look for when resolving link labels via HtmlSerializer.HTML_detectLabelParameters
.
labelParameter
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
public HtmlDocSerializerBuilder uriAnchorText(AnchorText value)
HtmlSerializerBuilder
When creating anchor tags (e.g.
)
in HTML, this setting defines what to set the inner text to.
uriAnchorText
in class HtmlStrippedDocSerializerBuilder
value
- The new value for this property.
AnchorText.TO_STRING
.Copyright © 2016–2020 The Apache Software Foundation. All rights reserved.