Package org.apache.juneau.oapi

Class OpenApiSerializerSession.Builder

java.lang.Object

org.apache.juneau.ContextSession.Builder

org.apache.juneau.BeanSession.Builder

org.apache.juneau.BeanTraverseSession.Builder

org.apache.juneau.serializer.SerializerSession.Builder

org.apache.juneau.serializer.WriterSerializerSession.Builder

org.apache.juneau.uon.UonSerializerSession.Builder

org.apache.juneau.oapi.OpenApiSerializerSession.Builder

Enclosing class:

OpenApiSerializerSession

public static class OpenApiSerializerSession.Builder
extends UonSerializerSession.Builder

Builder class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder(OpenApiSerializer ctx)	Constructor

Method Summary

Modifier and Type	Method	Description
<T> OpenApiSerializerSession.Builder	apply(Class<T> type, Consumer<T> apply)	Applies a consumer to this builder if it's the specified type.
OpenApiSerializerSession	build()	Build the object.
OpenApiSerializerSession.Builder	debug(Boolean value)	Debug mode.
OpenApiSerializerSession.Builder	encoding(boolean value)	Overrides the encoding setting for this session.
OpenApiSerializerSession.Builder	fileCharset(Charset value)	File charset.
OpenApiSerializerSession.Builder	javaMethod(Method value)	The java method that called this serializer, usually the method in a REST servlet.
OpenApiSerializerSession.Builder	locale(Locale value)	The session locale.
OpenApiSerializerSession.Builder	localeDefault(Locale value)	Same as BeanSession.Builder.locale(Locale) but doesn't overwrite the value if it is already set.
OpenApiSerializerSession.Builder	mediaType(MediaType value)	The session media type.
OpenApiSerializerSession.Builder	mediaTypeDefault(MediaType value)	Same as BeanSession.Builder.mediaType(MediaType) but doesn't overwrite the value if it is already set.
OpenApiSerializerSession.Builder	properties(Map<String,Object> value)	Session properties.
OpenApiSerializerSession.Builder	property(String key, Object value)	Adds a property to this session.
OpenApiSerializerSession.Builder	resolver(VarResolverSession value)	String variable resolver.
OpenApiSerializerSession.Builder	schema(HttpPartSchema value)	HTTP-part schema.
OpenApiSerializerSession.Builder	schemaDefault(HttpPartSchema value)	Same as SerializerSession.Builder.schema(HttpPartSchema) but doesn't overwrite the value if it is already set.
OpenApiSerializerSession.Builder	streamCharset(Charset value)	Output stream charset.
OpenApiSerializerSession.Builder	timeZone(TimeZone value)	The session timezone.
OpenApiSerializerSession.Builder	timeZoneDefault(TimeZone value)	Same as BeanSession.Builder.timeZone(TimeZone) but doesn't overwrite the value if it is already set.
OpenApiSerializerSession.Builder	unmodifiable()	Create an unmodifiable session.
OpenApiSerializerSession.Builder	uriContext(UriContext value)	URI context bean.
OpenApiSerializerSession.Builder	useWhitespace(Boolean value)	Use whitespace.

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

protected Builder(OpenApiSerializer ctx)

Constructor

Parameters:

ctx - The context creating this session.

Method Details

build

public OpenApiSerializerSession build()

Description copied from class: BeanSession.Builder

Build the object.

Overrides:

build in class UonSerializerSession.Builder

Returns:

The built object.

apply

public <T> OpenApiSerializerSession.Builder apply(Class<T> type,
 Consumer<T> apply)

Description copied from class: ContextSession.Builder

Applies a consumer to this builder if it's the specified type.

Overrides:

apply in class UonSerializerSession.Builder

Type Parameters:

T - The expected type.

Parameters:

type - The expected type.

apply - The consumer to apply.

Returns:

This object.

debug

public OpenApiSerializerSession.Builder debug(Boolean value)

Description copied from class: ContextSession.Builder

Debug mode.

Enables the following additional information during parsing:

• When bean setters throws exceptions, the exception includes the object stack information in order to determine how that method was invoked.

If not specified, defaults to Context.Builder.debug().

See Also:

• BeanConfig.debug()
• Context.Builder.debug()

Overrides:

debug in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
Can be null. Value will be ignored.

Returns:

This object.

properties

public OpenApiSerializerSession.Builder properties(Map<String,Object> value)

Description copied from class: ContextSession.Builder

Session properties.

Session properties are generic key-value pairs that can be passed through the session and made available to any customized serializers/parsers or swaps.

Overrides:

properties in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
Can be null.

Returns:

This object.

property

public OpenApiSerializerSession.Builder property(String key,
 Object value)

Description copied from class: ContextSession.Builder

Adds a property to this session.

Overrides:

property in class UonSerializerSession.Builder

Parameters:

key - The property key.

value - The property value.

Returns:

This object.

unmodifiable

public OpenApiSerializerSession.Builder unmodifiable()

Description copied from class: ContextSession.Builder

Create an unmodifiable session.

The created ContextSession object will be unmodifiable which makes it suitable for caching and reuse.

Overrides:

unmodifiable in class UonSerializerSession.Builder

Returns:

This object.

locale

public OpenApiSerializerSession.Builder locale(Locale value)

Description copied from class: BeanSession.Builder

The session locale.

Specifies the default locale for serializer and parser sessions.

If not specified, defaults to BeanContext.Builder.locale(Locale).

See Also:

• BeanConfig.locale()
• BeanContext.Builder.locale(Locale)

Overrides:

locale in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
If null, then the locale defined on the context is used.

Returns:

This object.

localeDefault

public OpenApiSerializerSession.Builder localeDefault(Locale value)

Description copied from class: BeanSession.Builder

Same as BeanSession.Builder.locale(Locale) but doesn't overwrite the value if it is already set.

Overrides:

localeDefault in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
If null, then the locale defined on the context is used.

Returns:

This object.

mediaType

public OpenApiSerializerSession.Builder mediaType(MediaType value)

Description copied from class: BeanSession.Builder

The session media type.

Specifies the default media type value for serializer and parser sessions.

If not specified, defaults to BeanContext.Builder.mediaType(MediaType).

See Also:

• BeanConfig.mediaType()
• BeanContext.Builder.mediaType(MediaType)

Overrides:

mediaType in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
Can be null.

Returns:

This object.

mediaTypeDefault

public OpenApiSerializerSession.Builder mediaTypeDefault(MediaType value)

Description copied from class: BeanSession.Builder

Same as BeanSession.Builder.mediaType(MediaType) but doesn't overwrite the value if it is already set.

Overrides:

mediaTypeDefault in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
If null, then the locale defined on the context is used.

Returns:

This object.

timeZone

public OpenApiSerializerSession.Builder timeZone(TimeZone value)

Description copied from class: BeanSession.Builder

The session timezone.

Specifies the default timezone for serializer and parser sessions.

If not specified, defaults to BeanContext.Builder.timeZone(TimeZone).

See Also:

• BeanConfig.timeZone()
• BeanContext.Builder.timeZone(TimeZone)

Overrides:

timeZone in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
Can be null.

Returns:

This object.

timeZoneDefault

public OpenApiSerializerSession.Builder timeZoneDefault(TimeZone value)

Description copied from class: BeanSession.Builder

Same as BeanSession.Builder.timeZone(TimeZone) but doesn't overwrite the value if it is already set.

Overrides:

timeZoneDefault in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
If null, then the locale defined on the context is used.

Returns:

This object.

javaMethod

public OpenApiSerializerSession.Builder javaMethod(Method value)

Description copied from class: SerializerSession.Builder

The java method that called this serializer, usually the method in a REST servlet.

Overrides:

javaMethod in class UonSerializerSession.Builder

Parameters:

value - The new property value.
Can be null.

Returns:

This object.

resolver

public OpenApiSerializerSession.Builder resolver(VarResolverSession value)

Description copied from class: SerializerSession.Builder

String variable resolver.

If not specified, defaults to session created by VarResolver.DEFAULT.

Overrides:

resolver in class UonSerializerSession.Builder

Parameters:

value - The new property value.
Can be null.

Returns:

This object.

schema

public OpenApiSerializerSession.Builder schema(HttpPartSchema value)

Description copied from class: SerializerSession.Builder

HTTP-part schema.

Used for schema-based serializers and parsers to define additional formatting.

Overrides:

schema in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
Can be null.

Returns:

This object.

schemaDefault

public OpenApiSerializerSession.Builder schemaDefault(HttpPartSchema value)

Description copied from class: SerializerSession.Builder

Same as SerializerSession.Builder.schema(HttpPartSchema) but doesn't overwrite the value if it is already set.

Overrides:

schemaDefault in class UonSerializerSession.Builder

Parameters:

value - The new value for this property.
If null, then the locale defined on the context is used.

Returns:

This object.

uriContext

public OpenApiSerializerSession.Builder uriContext(UriContext value)

Description copied from class: SerializerSession.Builder

URI context bean.

Bean used for resolution of URIs to absolute or root-relative form.

If not specified, defaults to Serializer.Builder.uriContext(UriContext).

Overrides:

uriContext in class UonSerializerSession.Builder

Parameters:

value - The new property value.
Can be null.

Returns:

This object.

fileCharset

public OpenApiSerializerSession.Builder fileCharset(Charset value)

Description copied from class: WriterSerializerSession.Builder

File charset.

The character set to use for writing Files to the file system.

Used when passing in files to Serializer.serialize(Object, Object).

If not specified, defaults to the JVM system default charset.

Overrides:

fileCharset in class UonSerializerSession.Builder

Parameters:

value - The new property value.
Can be null.

Returns:

This object.

streamCharset

public OpenApiSerializerSession.Builder streamCharset(Charset value)

Description copied from class: WriterSerializerSession.Builder

Output stream charset.

The character set to use when writing to OutputStreams.

Used when passing in output streams and byte arrays to Serializer.serialize(Object, Object).

If not specified, defaults to UTF-8.

Overrides:

streamCharset in class UonSerializerSession.Builder

Parameters:

value - The new property value.
Can be null.

Returns:

This object.

useWhitespace

public OpenApiSerializerSession.Builder useWhitespace(Boolean value)

Description copied from class: WriterSerializerSession.Builder

Use whitespace.

If true, whitespace is added to the output to improve readability.

Overrides:

useWhitespace in class UonSerializerSession.Builder

Parameters:

value - The new property value.
Can be null.

Returns:

This object.

encoding

public OpenApiSerializerSession.Builder encoding(boolean value)

Description copied from class: UonSerializerSession.Builder

Overrides the encoding setting for this session.

Overrides:

encoding in class UonSerializerSession.Builder

Parameters:

value - The new value for this setting.

Returns:

This object.