Package org.apache.juneau

Class BeanTraverseContext

java.lang.Object

org.apache.juneau.Context

org.apache.juneau.BeanContextable

org.apache.juneau.BeanTraverseContext

Direct Known Subclasses:

JsonSchemaGenerator, Serializer

public abstract class BeanTraverseContext
extends BeanContextable

Parent class for all classes that traverse POJOs.

Description

Base class that serves as the parent class for all serializers and other classes that traverse POJOs.

Notes:

• This class is thread safe and reusable.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BeanTraverseContext.Builder	Builder class.

Field Summary

Fields inherited from class org.apache.juneau.BeanContextable

beanContext

Fields inherited from class org.apache.juneau.Context

CONTEXT_APPLY_FILTER

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BeanTraverseContext(BeanTraverseContext.Builder builder)	Constructor

Method Summary

Modifier and Type	Method	Description
abstract BeanTraverseContext.Builder	copy()	Creates a builder from this context object.
protected final boolean	getDetectRecursions()	Detect recursions flag (raw value).
protected final boolean	getIgnoreRecursions()	Ignore recursions flag (raw value).
final int	getInitialDepth()	Initial depth.
final int	getMaxDepth()	Max traversal depth.
final boolean	isDetectRecursions()	Automatically detect POJO recursions.
final boolean	isIgnoreRecursions()	Ignore recursion errors.
protected FluentMap<String,Object>	properties()	Returns the properties on this bean as a map for debugging.

Methods inherited from class org.apache.juneau.BeanContextable

getBeanContext

Methods inherited from class org.apache.juneau.Context

createBuilder, createSession, getAnnotationProvider, getSession, init, isDebug, toString

Methods inherited from class java.lang.Object

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

Constructor Details

BeanTraverseContext

protected BeanTraverseContext(BeanTraverseContext.Builder builder)

Constructor

Parameters:

builder - The builder for this object.

Method Details

copy

public abstract BeanTraverseContext.Builder copy()

Description copied from class: Context

Creates a builder from this context object.

Builders are used to define new contexts (e.g. serializers, parsers) based on existing configurations.

Overrides:

copy in class Context

Returns:

A new Builder object.

getInitialDepth

public final int getInitialDepth()

Initial depth.

Returns:

The initial indentation level at the root.

See Also:

• BeanTraverseContext.Builder.initialDepth(int)

getMaxDepth

public final int getMaxDepth()

Max traversal depth.

Returns:

The depth at which traversal is aborted if depth is reached in the POJO tree.
If this depth is exceeded, an exception is thrown.

See Also:

• BeanTraverseContext.Builder.maxDepth(int)

isDetectRecursions

public final boolean isDetectRecursions()

Automatically detect POJO recursions.

Returns:

true if recursions should be checked for during traversal.

See Also:

• BeanTraverseContext.Builder.detectRecursions()

isIgnoreRecursions

public final boolean isIgnoreRecursions()

Ignore recursion errors.

Returns:

true if when we encounter the same object when traversing a tree, we set the value to null.
Otherwise, an exception is thrown with the message "Recursion occurred, stack=...".

See Also:

• BeanTraverseContext.Builder.ignoreRecursions()

getDetectRecursions

protected final boolean getDetectRecursions()

Detect recursions flag (raw value).

Returns:

The detect recursions flag.

getIgnoreRecursions

protected final boolean getIgnoreRecursions()

Ignore recursions flag (raw value).

Returns:

The ignore recursions flag.

properties

protected FluentMap<String,Object> properties()

Description copied from class: Context

Returns the properties on this bean as a map for debugging.

Overrides:

properties in class BeanContextable

Returns:

The properties on this bean as a map for debugging.