Package com.evolveum.midpoint.prism.impl.marshaller

Class PrismParserImplNoIO

java.lang.Object

com.evolveum.midpoint.prism.impl.marshaller.PrismParserImplNoIO

All Implemented Interfaces:

PrismParser, PrismParserNoIO

public class PrismParserImplNoIO
extends Object
implements PrismParserNoIO

Nested Class Summary

Nested classes/interfaces inherited from interface com.evolveum.midpoint.prism.PrismParser

PrismParser.ObjectHandler

Constructor Summary

Constructors

Constructor	Description
PrismParserImplNoIO(ParserSource source, String language, ParsingContext context, PrismContextImpl prismContext, ItemDefinition<?> itemDefinition, QName itemName, QName dataType, Class<?> dataClass)

Method Summary

Modifier and Type	Method	Description
@NotNull PrismParserNoIO	compat()	Switches the parser into "compatibility" (or relaxed) parsing mode.
@NotNull PrismParserNoIO	context(@NotNull ParsingContext context)	Provides a parsing context for the parser.
PrismParserNoIO	convertMissingTypes()
@NotNull PrismParserNoIO	definition(ItemDefinition<?> itemDefinition)	Tells parser which definition to use when parsing item (or an item value).
@NotNull PrismParserNoIO	fastAddOperations()	Does not check for existing values during parsing.
@NotNull PrismParserNoIO	json()	Sets the language of the parser to be JSON.
@NotNull PrismParserNoIO	language(@Nullable String language)	For string inputs: sets the data language that the parser will try to parse; null means auto-detect.
@NotNull PrismParserNoIO	name(QName itemName)	Tells parser what name to use for parsed item.
<O extends Objectable> @NotNull PrismObject<O>	parse()	Parses the input as a prism object.
<IV extends PrismValue,ID extends ItemDefinition<?>> Item<IV,ID>	parseItem()	Parses the input as a prism item.
Object	parseItemOrRealValue()	Parses either an item, or a real value.
<IV extends PrismValue> IV	parseItemValue()	Parses the input as a prism value.
@NotNull List<PrismObject<? extends Objectable>>	parseObjects()	Parses the input as a collection of prism objects.
void	parseObjectsIteratively(@NotNull PrismParser.ObjectHandler handler)	Currently implemented for JSON/YAML only.
<T> T	parseRealValue()	Parses a real value.
<T> T	parseRealValue(Class<T> clazz)	Parses a real value - either property or container value.
<T> javax.xml.bind.JAXBElement<T>	parseRealValueToJaxbElement()	Parses a real value and stores it into JAXBElement, using item name derived in the usual way.
RootXNodeImpl	parseToXNode()	Parses the input into RootXNode.
@NotNull PrismParserNoIO	strict()	Switches the parser into "strict" parsing mode.
@NotNull PrismParserNoIO	type(Class<?> typeClass)	Tells parser what data type to expect.
@NotNull PrismParserNoIO	type(QName typeName)	Tells parser what data type to expect.
@NotNull PrismParserNoIO	xml()	Sets the language of the parser to be XML.
@NotNull PrismParserNoIO	yaml()	Sets the language of the parser to be YAML.

Methods inherited from class java.lang.Object

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

Constructor Detail

PrismParserImplNoIO

public PrismParserImplNoIO(ParserSource source,
                           String language,
                           ParsingContext context,
                           PrismContextImpl prismContext,
                           ItemDefinition<?> itemDefinition,
                           QName itemName,
                           QName dataType,
                           Class<?> dataClass)

Method Detail

language

@NotNull
public @NotNull PrismParserNoIO language(@Nullable
                                         @Nullable String language)

Description copied from interface: PrismParser

For string inputs: sets the data language that the parser will try to parse; null means auto-detect. For other kinds of input (DOM and XNode) the language is fixed to XML or none, respectively.

Specified by:

language in interface PrismParser

Specified by:

language in interface PrismParserNoIO

Parameters:

language - The language

Returns:

Updated parser.

xml

@NotNull
public @NotNull PrismParserNoIO xml()

Description copied from interface: PrismParser

Sets the language of the parser to be XML.

Specified by:

xml in interface PrismParser

Specified by:

xml in interface PrismParserNoIO

Returns:

Updated parser.

json

@NotNull
public @NotNull PrismParserNoIO json()

Description copied from interface: PrismParser

Sets the language of the parser to be JSON.

Specified by:

json in interface PrismParser

Specified by:

json in interface PrismParserNoIO

Returns:

Updated parser.

yaml

@NotNull
public @NotNull PrismParserNoIO yaml()

Description copied from interface: PrismParser

Sets the language of the parser to be YAML.

Specified by:

yaml in interface PrismParser

Specified by:

yaml in interface PrismParserNoIO

Returns:

Updated parser.

context

@NotNull
public @NotNull PrismParserNoIO context(@NotNull
                                        @NotNull ParsingContext context)

Description copied from interface: PrismParser

Provides a parsing context for the parser. The context contains e.g. selection of strict/compat mode of operation (set by client) or a list of warnings (maintained by the parser).

Specified by:

context in interface PrismParser

Specified by:

context in interface PrismParserNoIO

Parameters:

context - The parsing context.

Returns:

Updated parser.

strict

@NotNull
public @NotNull PrismParserNoIO strict()

Description copied from interface: PrismParser

Switches the parser into "strict" parsing mode.

Specified by:

strict in interface PrismParser

Specified by:

strict in interface PrismParserNoIO

Returns:

Updated parser.

compat

@NotNull
public @NotNull PrismParserNoIO compat()

Description copied from interface: PrismParser

Switches the parser into "compatibility" (or relaxed) parsing mode. TODO description here

Specified by:

compat in interface PrismParser

Specified by:

compat in interface PrismParserNoIO

Returns:

Updated parser.

fastAddOperations

@NotNull
public @NotNull PrismParserNoIO fastAddOperations()

Description copied from interface: PrismParser

Does not check for existing values during parsing. To be used in situations where the data can be trusted to not contain duplicates - for example, when reading from the repository.

Specified by:

fastAddOperations in interface PrismParser

Specified by:

fastAddOperations in interface PrismParserNoIO

definition

@NotNull
public @NotNull PrismParserNoIO definition(ItemDefinition<?> itemDefinition)

Description copied from interface: PrismParser

Tells parser which definition to use when parsing item (or an item value). Optional.

Specified by:

definition in interface PrismParser

Specified by:

definition in interface PrismParserNoIO

Parameters:

itemDefinition - The definition

Returns:

Updated parser.

name

@NotNull
public @NotNull PrismParserNoIO name(QName itemName)

Description copied from interface: PrismParser

Tells parser what name to use for parsed item. Optional.

Specified by:

name in interface PrismParser

Specified by:

name in interface PrismParserNoIO

Parameters:

itemName - Item name to use.

Returns:

Updated parser.

type

@NotNull
public @NotNull PrismParserNoIO type(QName typeName)

Description copied from interface: PrismParser

Tells parser what data type to expect. Optional.

Specified by:

type in interface PrismParser

Specified by:

type in interface PrismParserNoIO

Parameters:

typeName - Data type to expect.

Returns:

Updated parser.

type

@NotNull
public @NotNull PrismParserNoIO type(Class<?> typeClass)

Description copied from interface: PrismParser

Tells parser what data type to expect. Optional.

Specified by:

type in interface PrismParser

Specified by:

type in interface PrismParserNoIO

Parameters:

typeClass - Data type to expect.

Returns:

Updated parser.

parse

@NotNull
public <O extends Objectable> @NotNull PrismObject<O> parse()
                                                     throws SchemaException

Description copied from interface: PrismParser

Parses the input as a prism object.

Specified by:

parse in interface PrismParser

Specified by:

parse in interface PrismParserNoIO

Returns:

The object.

Throws:

SchemaException

parseItem

public <IV extends PrismValue,ID extends ItemDefinition<?>> Item<IV,ID> parseItem()
                                                                                       throws SchemaException

Description copied from interface: PrismParser

Parses the input as a prism item. (Object, container, reference, value.) May return raw property values as part of the prism structure, if definitions are not known.

Specified by:

parseItem in interface PrismParser

Specified by:

parseItem in interface PrismParserNoIO

Returns:

The item.

Throws:

SchemaException

parseItemValue

public <IV extends PrismValue> IV parseItemValue()
                                          throws SchemaException

Description copied from interface: PrismParser

Parses the input as a prism value. (Container value, reference value, property value.) May return raw property values as part of the prism structure, if definitions are not known.

Specified by:

parseItemValue in interface PrismParser

Specified by:

parseItemValue in interface PrismParserNoIO

Returns:

The item.

Throws:

SchemaException

parseRealValue

public <T> T parseRealValue(Class<T> clazz)
                     throws SchemaException

Description copied from interface: PrismParser

Parses a real value - either property or container value.

Specified by:

parseRealValue in interface PrismParser

Specified by:

parseRealValue in interface PrismParserNoIO

Parameters:

clazz - Expected class of the data. May be null if unknown.

Returns:

Real value - POJO, Containerable, Objectable or Referencable.

Throws:

SchemaException

parseRealValue

public <T> T parseRealValue()
                     throws SchemaException

Description copied from interface: PrismParser

Parses a real value. The class is not supplied by the caller, so it has to be determined from the data source.

Specified by:

parseRealValue in interface PrismParser

Specified by:

parseRealValue in interface PrismParserNoIO

Returns:

Real value - POJO, Containerable, Objectable or Referencable.

Throws:

SchemaException

parseRealValueToJaxbElement

public <T> javax.xml.bind.JAXBElement<T> parseRealValueToJaxbElement()
                                                              throws SchemaException

Description copied from interface: PrismParser

Parses a real value and stores it into JAXBElement, using item name derived in the usual way.

Specified by:

parseRealValueToJaxbElement in interface PrismParser

Specified by:

parseRealValueToJaxbElement in interface PrismParserNoIO

Throws:

SchemaException

parseToXNode

public RootXNodeImpl parseToXNode()
                           throws SchemaException

Description copied from interface: PrismParser

Parses the input into RootXNode. This is a bit unusual approach, skipping the unmarshalling phase altogether. But it is useful at some places.

Specified by:

parseToXNode in interface PrismParser

Specified by:

parseToXNode in interface PrismParserNoIO

Returns:

RootXNode corresponding to the input.

Throws:

SchemaException

parseObjects

@NotNull
public @NotNull List<PrismObject<? extends Objectable>> parseObjects()
                                                              throws SchemaException

Description copied from interface: PrismParser

Parses the input as a collection of prism objects. For XML the input must be formatted as a collection of objects (TODO change this). For other languages the input may contain one or more objects.

Specified by:

parseObjects in interface PrismParser

Specified by:

parseObjects in interface PrismParserNoIO

Returns:

A list of objects.

Throws:

SchemaException

parseObjectsIteratively

public void parseObjectsIteratively(@NotNull
                                    @NotNull PrismParser.ObjectHandler handler)
                             throws SchemaException

Description copied from interface: PrismParser

Currently implemented for JSON/YAML only. For XML, use old Validator code.

Specified by:

parseObjectsIteratively in interface PrismParser

Specified by:

parseObjectsIteratively in interface PrismParserNoIO

Throws:

SchemaException

parseItemOrRealValue

public Object parseItemOrRealValue()
                            throws SchemaException

Description copied from interface: PrismParser

Parses either an item, or a real value. It depends on the type declaration or item name in the source data. 1) If explicit type is present, it is taken into account. If it corresponds to a prism item, the input is parsed as a prism item. Otherwise, it is parsed as a real value (containerable or simple POJO), if possible. 2) If there is no type, the item name is consulted. If it corresponds to a prism item, the input is parsed as a prism item. Otherwise, an exception is thrown. Pre-set parameters (itemDefinition, typeName, itemName) must NOT be present. Use with utmost care. If at all possible, avoid it.

Specified by:

parseItemOrRealValue in interface PrismParser

Specified by:

parseItemOrRealValue in interface PrismParserNoIO

Returns:

either prism item (Item) or a real value (Object)

Throws:

SchemaException

convertMissingTypes

public PrismParserNoIO convertMissingTypes()

Specified by:

convertMissingTypes in interface PrismParser

Specified by:

convertMissingTypes in interface PrismParserNoIO