Package org.apache.juneau.jsonschema

Class JsonSchemaGeneratorSession

java.lang.Object

org.apache.juneau.ContextSession

org.apache.juneau.BeanSession

org.apache.juneau.BeanTraverseSession

org.apache.juneau.jsonschema.JsonSchemaGeneratorSession

public class JsonSchemaGeneratorSession
extends BeanTraverseSession

Session object that lives for the duration of a single use of JsonSchemaSerializer.

Notes:

• This class is not thread safe and is typically discarded after one use.

See Also:

• JSON-Schema Support

Nested Class Summary

Nested Classes

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

Field Summary

Fields inherited from class org.apache.juneau.BeanTraverseSession

indent

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
JsonSchemaGeneratorSession	addBeanDef(String id, JsonMap def)	Adds a schema definition to this session.
static JsonSchemaGeneratorSession.Builder	create(JsonSchemaGenerator ctx)	Creates a new builder for this object.
protected final Set<TypeCategory>	getAddDescriptionsTo()	Add descriptions to types.
protected final Set<TypeCategory>	getAddExamplesTo()	Add examples.
String	getBeanDefId(ClassMeta<?> cm)	Returns the definition ID for the specified class.
protected final BeanDefMapper	getBeanDefMapper()	Bean schema definition mapper.
Map<String,JsonMap>	getBeanDefs()	Returns the definitions that were gathered during this session.
URI	getBeanDefUri(String id)	Returns the definition URI for the specified class.
URI	getBeanDefUri(ClassMeta<?> cm)	Returns the definition URI for the specified class.
protected final List<Pattern>	getIgnoreTypes()	Ignore types from schema definitions.
JsonSchemaBeanPropertyMeta	getJsonSchemaBeanPropertyMeta(BeanPropertyMeta bpm)	Returns the language-specific metadata on the specified bean property.
JsonSchemaClassMeta	getJsonSchemaClassMeta(ClassMeta<?> cm)	Returns the language-specific metadata on the specified class.
JsonMap	getSchema(Object o)	Returns the JSON-schema for the specified object.
JsonMap	getSchema(Type type)	Returns the JSON-schema for the specified type.
JsonMap	getSchema(ClassMeta<?> cm)	Returns the JSON-schema for the specified type.
protected final boolean	isAllowNestedDescriptions()	Allow nested descriptions.
protected final boolean	isAllowNestedExamples()	Allow nested examples.
protected final boolean	isUseBeanDefs()	Use bean definitions.

Methods inherited from class org.apache.juneau.BeanTraverseSession

getInitialDepth, getLastLocation, getMaxDepth, getOptionalType, getOptionalValue, getStack, isDetectRecursions, isIgnoreRecursions, isOptional, isRoot, onError, pop, properties, push, setCurrentClass, setCurrentProperty, willExceedDepth, willRecurse

Methods inherited from class org.apache.juneau.BeanSession

_class, addWarning, convertToMemberType, convertToMemberType, convertToType, convertToType, convertToType, create, getArgsClassMeta, getBeanClassVisibility, getBeanConstructorVisibility, getBeanDictionary, getBeanFieldVisibility, getBeanMeta, getBeanMethodVisibility, getBeanRegistry, getBeanTypePropertyName, getBeanTypePropertyName, getClassMeta, getClassMeta, getClassMetaForObject, getClassMetaForObject, getLocale, getMediaType, getNamePropertyName, getNotBeanClasses, getNotBeanPackagesNames, getNotBeanPackagesPrefixes, getPropertyNamer, getSwaps, getTimeZone, getTimeZoneId, isBean, isBean, isBeanMapPutReturnsOldValue, isBeansRequireDefaultConstructor, isBeansRequireSerializable, isBeansRequireSettersForGetters, isBeansRequireSomeProperties, isFindFluentSetters, isIgnoreInvocationExceptionsOnGetters, isIgnoreInvocationExceptionsOnSetters, isIgnoreMissingSetters, isIgnoreUnknownBeanProperties, isIgnoreUnknownNullBeanProperties, isSortProperties, isUseEnumNames, isUseInterfaceProxies, isUseJavaBeanIntrospector, newBean, newBean, newBeanMap, newBeanMap, newGenericMap, object, string, toArray, toBeanMap, toBeanMap, toBeanMap

Methods inherited from class org.apache.juneau.ContextSession

checkForWarnings, getContext, getSessionProperties, getWarnings, isDebug, toString

Methods inherited from class java.lang.Object

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

Constructor Details

JsonSchemaGeneratorSession

protected JsonSchemaGeneratorSession(JsonSchemaGeneratorSession.Builder builder)

Constructor.

Parameters:

builder - The builder for this object.

Method Details

create

public static JsonSchemaGeneratorSession.Builder create(JsonSchemaGenerator ctx)

Creates a new builder for this object.

Parameters:

ctx - The context creating this session.

Returns:

A new builder.

getSchema

public JsonMap getSchema(Object o)
                  throws BeanRecursionException,
SerializeException

Returns the JSON-schema for the specified object.

Parameters:

o - The object.
Can either be a POJO or a Class/Type.

Returns:

The schema for the type.

Throws:

BeanRecursionException - Bean recursion occurred.

SerializeException - Error occurred.

getSchema

public JsonMap getSchema(Type type)
                  throws BeanRecursionException,
SerializeException

Returns the JSON-schema for the specified type.

Parameters:

type - The object type.

Returns:

The schema for the type.

Throws:

BeanRecursionException - Bean recursion occurred.

SerializeException - Error occurred.

getSchema

public JsonMap getSchema(ClassMeta<?> cm)
                  throws BeanRecursionException,
SerializeException

Returns the JSON-schema for the specified type.

Parameters:

cm - The object type.

Returns:

The schema for the type.

Throws:

BeanRecursionException - Bean recursion occurred.

SerializeException - Error occurred.

getBeanDefId

public String getBeanDefId(ClassMeta<?> cm)

Returns the definition ID for the specified class.

Parameters:

cm - The class to get the definition ID of.

Returns:

The definition ID for the specified class.

getBeanDefUri

public URI getBeanDefUri(ClassMeta<?> cm)

Returns the definition URI for the specified class.

Parameters:

cm - The class to get the definition URI of.

Returns:

The definition URI for the specified class.

getBeanDefUri

public URI getBeanDefUri(String id)

Returns the definition URI for the specified class.

Parameters:

id - The definition ID to get the definition URI of.

Returns:

The definition URI for the specified class.

getBeanDefs

public Map<String,JsonMap> getBeanDefs()

Returns the definitions that were gathered during this session.

This map is modifiable and affects the map in the session.

Returns:

The definitions that were gathered during this session, or null if JsonSchemaGenerator.Builder.useBeanDefs() was not enabled.

addBeanDef

public JsonSchemaGeneratorSession addBeanDef(String id,
 JsonMap def)

Adds a schema definition to this session.

Parameters:

id - The definition ID.

def - The definition schema.

Returns:

This object.

getAddDescriptionsTo

protected final Set<TypeCategory> getAddDescriptionsTo()

Add descriptions to types.

Returns:

Set of categories of types that descriptions should be automatically added to generated schemas.

See Also:

• JsonSchemaGenerator.Builder.addDescriptionsTo(TypeCategory...)

getAddExamplesTo

protected final Set<TypeCategory> getAddExamplesTo()

Add examples.

Returns:

Set of categories of types that examples should be automatically added to generated schemas.

See Also:

• JsonSchemaGenerator.Builder.addExamplesTo(TypeCategory...)

isAllowNestedDescriptions

protected final boolean isAllowNestedDescriptions()

Allow nested descriptions.

Returns:

true if nested descriptions are allowed in schema definitions.

See Also:

• JsonSchemaGenerator.Builder.allowNestedDescriptions()

isAllowNestedExamples

protected final boolean isAllowNestedExamples()

Allow nested examples.

Returns:

true if nested examples are allowed in schema definitions.

See Also:

• JsonSchemaGenerator.Builder.allowNestedExamples()

getBeanDefMapper

protected final BeanDefMapper getBeanDefMapper()

Bean schema definition mapper.

Returns:

Interface to use for converting Bean classes to definition IDs and URIs.

See Also:

• JsonSchemaGenerator.Builder.beanDefMapper(Class)

getIgnoreTypes

protected final List<Pattern> getIgnoreTypes()

Ignore types from schema definitions.

Returns:

Custom schema information for particular class types.

See Also:

• JsonSchemaGenerator.Builder.ignoreTypes(String...)

isUseBeanDefs

protected final boolean isUseBeanDefs()

Use bean definitions.

Returns:

true if schemas on beans will be serialized with '$ref' tags.

See Also:

• JsonSchemaGenerator.Builder.useBeanDefs()

getJsonSchemaClassMeta

public JsonSchemaClassMeta getJsonSchemaClassMeta(ClassMeta<?> cm)

Returns the language-specific metadata on the specified class.

Parameters:

cm - The class to return the metadata on.

Returns:

The metadata.

getJsonSchemaBeanPropertyMeta

public JsonSchemaBeanPropertyMeta getJsonSchemaBeanPropertyMeta(BeanPropertyMeta bpm)

Returns the language-specific metadata on the specified bean property.

Parameters:

bpm - The bean property to return the metadata on.

Returns:

The metadata.