Package org.apache.juneau.urlencoding

Class UrlEncodingParserSession.Builder

java.lang.Object

org.apache.juneau.ContextSession.Builder

org.apache.juneau.BeanSession.Builder

org.apache.juneau.parser.ParserSession.Builder

org.apache.juneau.parser.ReaderParserSession.Builder

org.apache.juneau.uon.UonParserSession.Builder

org.apache.juneau.urlencoding.UrlEncodingParserSession.Builder

Enclosing class:

UrlEncodingParserSession

public static class UrlEncodingParserSession.Builder
extends UonParserSession.Builder

Builder class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder(UrlEncodingParser ctx)	Constructor

Method Summary

Modifier and Type	Method	Description
<T> UrlEncodingParserSession.Builder	apply(Class<T> type, Consumer<T> apply)	Applies a consumer to this builder if it's the specified type.
UrlEncodingParserSession	build()	Build the object.
UrlEncodingParserSession.Builder	debug(Boolean value)	Debug mode.
UrlEncodingParserSession.Builder	decoding(boolean value)	Overrides the decoding flag on the context for this session.
UrlEncodingParserSession.Builder	fileCharset(Charset value)	File charset.
UrlEncodingParserSession.Builder	javaMethod(Method value)	The java method that called this serializer, usually the method in a REST servlet.
UrlEncodingParserSession.Builder	locale(Locale value)	The session locale.
UrlEncodingParserSession.Builder	mediaType(MediaType value)	The session media type.
UrlEncodingParserSession.Builder	mediaTypeDefault(MediaType value)	Same as BeanSession.Builder.mediaType(MediaType) but doesn't overwrite the value if it is already set.
UrlEncodingParserSession.Builder	outer(Object value)	The outer object for instantiating top-level non-static inner classes.
UrlEncodingParserSession.Builder	properties(Map<String,Object> value)	Session properties.
UrlEncodingParserSession.Builder	property(String key, Object value)	Adds a property to this session.
UrlEncodingParserSession.Builder	schema(HttpPartSchema value)	HTTP-part schema.
UrlEncodingParserSession.Builder	schemaDefault(HttpPartSchema value)	Same as ParserSession.Builder.schema(HttpPartSchema) but doesn't overwrite the value if it is already set.
UrlEncodingParserSession.Builder	streamCharset(Charset value)	Input stream charset.
UrlEncodingParserSession.Builder	timeZone(TimeZone value)	The session timezone.
UrlEncodingParserSession.Builder	timeZoneDefault(TimeZone value)	Same as BeanSession.Builder.timeZone(TimeZone) but doesn't overwrite the value if it is already set.
UrlEncodingParserSession.Builder	unmodifiable()	Create an unmodifiable session.

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

protected Builder(UrlEncodingParser ctx)

Constructor

Parameters:

ctx - The context creating this session.

Method Details

apply

public <T> UrlEncodingParserSession.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 UonParserSession.Builder

Type Parameters:

T - The expected type.

Parameters:

type - The expected type.
Cannot be null.

apply - The consumer to apply.
Cannot be null.

Returns:

This object.

build

public UrlEncodingParserSession build()

Description copied from class: BeanSession.Builder

Build the object.

Overrides:

build in class UonParserSession.Builder

Returns:

The built object.

debug

public UrlEncodingParserSession.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 UonParserSession.Builder

Parameters:

value - The new value for this property.
If null, defaults to Context.isDebug().

Returns:

This object.

decoding

public UrlEncodingParserSession.Builder decoding(boolean value)

Description copied from class: UonParserSession.Builder

Overrides the decoding flag on the context for this session.

Overrides:

decoding in class UonParserSession.Builder

Parameters:

value - The new value for this setting.

Returns:

This object.

fileCharset

public UrlEncodingParserSession.Builder fileCharset(Charset value)

Description copied from class: ReaderParserSession.Builder

File charset.

The character set to use for reading Files from the file system.

Used when passing in files to Parser.parse(Object, Class).

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

Overrides:

fileCharset in class UonParserSession.Builder

Parameters:

value - The new property value.
Can be null.

Returns:

This object.

javaMethod

public UrlEncodingParserSession.Builder javaMethod(Method value)

Description copied from class: ParserSession.Builder

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

Overrides:

javaMethod in class UonParserSession.Builder

Parameters:

value - The new property value.
Can be null.

Returns:

This object.

locale

public UrlEncodingParserSession.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 UonParserSession.Builder

Parameters:

value - The new value for this property.
If null defaults to BeanContext.getLocale()

Returns:

This object.

mediaType

public UrlEncodingParserSession.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 UonParserSession.Builder

Parameters:

value - The new value for this property.
If null defaults to BeanContext.getMediaType().

Returns:

This object.

mediaTypeDefault

public UrlEncodingParserSession.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 UonParserSession.Builder

Parameters:

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

Returns:

This object.

outer

public UrlEncodingParserSession.Builder outer(Object value)

Description copied from class: ParserSession.Builder

The outer object for instantiating top-level non-static inner classes.

Overrides:

outer in class UonParserSession.Builder

Parameters:

value - The new property value.
Can be null (no outer object will be used, suitable for static or top-level classes).

Returns:

This object.

properties

public UrlEncodingParserSession.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 UonParserSession.Builder

Parameters:

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

Returns:

This object.

property

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

Description copied from class: ContextSession.Builder

Adds a property to this session.

Overrides:

property in class UonParserSession.Builder

Parameters:

key - The property key.
Cannot be null.

value - The property value.
Can be null (removes the property).

Returns:

This object.

schema

public UrlEncodingParserSession.Builder schema(HttpPartSchema value)

Description copied from class: ParserSession.Builder

HTTP-part schema.

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

Overrides:

schema in class UonParserSession.Builder

Parameters:

value - The new value for this property.
Can be null (will not set the value, keeps existing schema or remains null).

Returns:

This object.

schemaDefault

public UrlEncodingParserSession.Builder schemaDefault(HttpPartSchema value)

Description copied from class: ParserSession.Builder

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

Overrides:

schemaDefault in class UonParserSession.Builder

Parameters:

value - The new value for this property.
If null, the value will not be set (keeps existing schema or remains null).

Returns:

This object.

streamCharset

public UrlEncodingParserSession.Builder streamCharset(Charset value)

Description copied from class: ReaderParserSession.Builder

Input stream charset.

The character set to use for converting InputStreams and byte arrays to readers.

Used when passing in input streams and byte arrays to Parser.parse(Object, Class).

If not specified, defaults to UTF-8.

Overrides:

streamCharset in class UonParserSession.Builder

Parameters:

value - The new property value.
Can be null (defaults to UTF-8).

Returns:

This object.

timeZone

public UrlEncodingParserSession.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 UonParserSession.Builder

Parameters:

value - The new value for this property.
If null defaults to BeanContext.getTimeZone().

Returns:

This object.

timeZoneDefault

public UrlEncodingParserSession.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 UonParserSession.Builder

Parameters:

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

Returns:

This object.

unmodifiable

public UrlEncodingParserSession.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 UonParserSession.Builder

Returns:

This object.