Package com.evolveum.midpoint.schema.processor

Interface ResourceSchema

All Superinterfaces:

Cloneable, DebugDumpable, DefinitionSearchImplementation, DefinitionsStore, Freezable, GlobalDefinitionsStore, LayeredDefinition, PrismSchema

All Known Subinterfaces:

BareResourceSchema, CompleteResourceSchema

All Known Implementing Classes:

BareResourceSchemaImpl, CompleteResourceSchemaImpl, ResourceSchemaImpl

public interface ResourceSchema
extends PrismSchema, Cloneable, LayeredDefinition

A schema covering the whole resource. It contains object classes and types definitions and (experimental) association classes definitions. It refers to the NativeResourceSchema upon which it was built. This interface contains a lot of methods that try to find object type/class definition matching criteria. NOTE: There can be schemas that contain no refined definitions. Either the resource definition contains no `schemaHandling`, or we intentionally want to avoid them. See BareResourceSchema. NOTE: Resolution of definitions is a complex process. So it's delegated to ResourceObjectDefinitionResolver.

Author:

semancik

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	ResourceSchema.ResourceSchemaMutator

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

PrismSchema.PrismSchemaMutator

Field Summary

Fields

Modifier and Type	Field	Description
static final Trace	LOGGER

Fields inherited from interface com.evolveum.midpoint.util.DebugDumpable

INDENT_STRING

Method Summary

Modifier and Type	Method	Description
ResourceSchema	clone()
default @Nullable ResourceObjectDefinition	findDefaultDefinitionForKind(@NotNull ShadowKindType kind)	Returns the "default for kind" type definition for given kind.
default @NotNull ResourceObjectDefinition	findDefaultDefinitionForKindRequired(@NotNull ShadowKindType kind)	As findDefaultDefinitionForKind(ShadowKindType) but the definition must exist.
default ResourceObjectDefinition	findDefinitionForConstruction(@NotNull ConstructionType construction)	Finds a definition for ConstructionType.
default @NotNull ResourceObjectDefinition	findDefinitionForConstructionRequired(@NotNull ConstructionType constructionBean, @NotNull Supplier<String> contextSupplier)	As findDefinitionForConstruction(ConstructionType) but throws an exception if the definition is not there.
default @Nullable ResourceObjectDefinition	findDefinitionForObjectClass(@NotNull QName name)	Returns a type or class definition for a given object class: - if there's a "default for class" type defined, it is returned (this is a kind of pre-4.5 behavior) - otherwise, the object class definition is returned (if there's any)
default @NotNull ResourceObjectDefinition	findDefinitionForObjectClassRequired(@NotNull QName name)	As findDefinitionForObjectClass(QName) but throws an exception if there's no suitable definition.
default @Nullable ResourceObjectDefinition	findDefinitionForShadow(@NotNull ShadowType shadow)	Convenience variant of findDefinitionForShadow(ShadowType, Collection).
default @Nullable ResourceObjectDefinition	findDefinitionForShadow(@NotNull ShadowType shadow, @NotNull Collection<QName> additionalAuxObjectClassNames)	Returns appropriate ResourceObjectDefinition for given shadow.
default @Nullable ResourceObjectClassDefinition	findObjectClassDefinition(@NotNull QName name)	Returns ResourceObjectClassDefinition (raw or refined) for a given object class name.
default @NotNull ResourceObjectClassDefinition	findObjectClassDefinitionRequired(@NotNull QName name)	The same as findObjectClassDefinition(QName) but throws an exception if there's no such definition.
default @NotNull ResourceObjectClassDefinition	findObjectClassDefinitionRequired(@NotNull QName name, @NotNull Supplier<String> contextSupplier)
default @Nullable ResourceObjectDefinition	findObjectDefinition(@NotNull ResourceObjectTypeIdentification typeIdentification)	As findObjectDefinition(ShadowKindType, String) but with aggregate representation of type identification.
default @Nullable ResourceObjectDefinition	findObjectDefinition(@NotNull ShadowKindType kind, @NotNull String intent)	Returns the definition for known kind and intent.
default @Nullable ResourceObjectDefinition	findObjectDefinition(@NotNull ShadowKindType kind, @NotNull String intent, @Nullable QName objectClassName)	As findObjectDefinition(ShadowKindType, String) but checks the object class compatibility (if object class name is provided).
default @NotNull ResourceObjectDefinition	findObjectDefinitionRequired(@NotNull ResourceObjectTypeIdentification typeIdentification)	As findObjectDefinition(ResourceObjectTypeIdentification) but the definition must exist.
default @NotNull ResourceObjectDefinition	findObjectDefinitionRequired(@NotNull ShadowKindType kind, @NotNull String intent)	As findObjectDefinition(ShadowKindType, String) but the definition must exist.
ResourceSchema	forLayerImmutable(LayerType layer)	Returns a representation of the schema for given layer (immutable).
default @NotNull Collection<String>	getIntentsForKind(ShadowKindType kind)	TODO description
default @NotNull String	getNamespace()	All top-level definitions (types, items) are in this namespace.
@NotNull NativeResourceSchema	getNativeSchema()
default @NotNull Collection<ResourceObjectClassDefinition>	getObjectClassDefinitions()	Returns definitions for all the object classes.
default int	getObjectClassDefinitionsCount()
default @NotNull Collection<QName>	getObjectClassNames()	Returns names of all object classes mentioned in the "raw" resource definition.
default @Nullable ResourceObjectTypeDefinition	getObjectTypeDefinition(@NotNull ResourceObjectTypeIdentification identification)	Returns definition of the given type.
default @Nullable ResourceObjectTypeDefinition	getObjectTypeDefinition(@NotNull ShadowKindType kind, @NotNull String intent)	Returns definition of the given type.
default @NotNull Collection<ResourceObjectTypeDefinition>	getObjectTypeDefinitions()	Returns definitions for all the object types.
default @NotNull List<ResourceObjectTypeDefinition>	getObjectTypeDefinitions(@NotNull Predicate<ResourceObjectTypeDefinition> predicate)	Returns all matching object type definitions.
default @NotNull List<? extends ResourceObjectTypeDefinition>	getObjectTypeDefinitions(@Nullable ShadowKindType kind)	Returns definitions for all types with given kind.
default @NotNull Collection<ResourceObjectDefinition>	getResourceObjectDefinitions()	Returns definitions for all the object classes and types (currently that should be all definitions).
default boolean	isRaw()	Returns true if the schema contains no "refined" (type) definitions.
ResourceSchema.ResourceSchemaMutator	mutator()	Returns an interface to mutate this schema.
static @NotNull QName	qualifyTypeName(@NotNull String localPart)
Document	serializeNativeToXsd()
void	validate()	TODO description

Methods inherited from interface com.evolveum.midpoint.util.DebugDumpable

debugDump, debugDump, debugDumpLazily, debugDumpLazily

Methods inherited from interface com.evolveum.midpoint.prism.Freezable

checkImmutable, checkMutable, freeze, isImmutable

Methods inherited from interface com.evolveum.midpoint.prism.schema.GlobalDefinitionsStore

findComplexTypeDefinitionByCompileTimeClass, findComplexTypeDefinitionByType, findContainerDefinitionByCompileTimeClass, findContainerDefinitionByElementName, findContainerDefinitionByType, findItemDefinitionByCompileTimeClass, findItemDefinitionByElementName, findItemDefinitionByElementName, findItemDefinitionByType, findItemDefinitionByType, findItemDefinitionsByCompileTimeClass, findItemDefinitionsByElementName, findItemDefinitionsByElementName, findObjectDefinitionByCompileTimeClass, findObjectDefinitionByElementName, findObjectDefinitionByType, findPropertyDefinitionByElementName, findReferenceDefinitionByElementName, findSimpleTypeDefinitionByType, findTypeDefinitionByCompileTimeClass, findTypeDefinitionByType, findTypeDefinitionByType, findTypeDefinitionsByElementName, findTypeDefinitionsByType, findTypeDefinitionsByType

Methods inherited from interface com.evolveum.midpoint.schema.processor.LayeredDefinition

getCurrentLayer

Methods inherited from interface com.evolveum.midpoint.prism.schema.PrismSchema

builder, getComplexTypeDefinitions, getDefinitions, getDefinitions, getObjectDefinitions, getSourceDescription, getSubstitutions, isEmpty, isRuntime, serializeToXsd, size

Field Details

LOGGER

static final Trace LOGGER

Method Details

getResourceObjectDefinitions

@NotNull
default @NotNull Collection<ResourceObjectDefinition> getResourceObjectDefinitions()

Returns definitions for all the object classes and types (currently that should be all definitions).

getObjectClassDefinitions

@NotNull
default @NotNull Collection<ResourceObjectClassDefinition> getObjectClassDefinitions()

Returns definitions for all the object classes.

getObjectClassDefinitionsCount

default int getObjectClassDefinitionsCount()

getObjectTypeDefinitions

@NotNull
default @NotNull Collection<ResourceObjectTypeDefinition> getObjectTypeDefinitions()

Returns definitions for all the object types.

getObjectTypeDefinitions

@NotNull
default @NotNull List<? extends ResourceObjectTypeDefinition> getObjectTypeDefinitions(@Nullable
 @Nullable ShadowKindType kind)

Returns definitions for all types with given kind. (If null, returns all types.)

getObjectTypeDefinitions

@NotNull
default @NotNull List<ResourceObjectTypeDefinition> getObjectTypeDefinitions(@NotNull
 @NotNull Predicate<ResourceObjectTypeDefinition> predicate)

Returns all matching object type definitions.

getObjectTypeDefinition

@Nullable
default @Nullable ResourceObjectTypeDefinition getObjectTypeDefinition(@NotNull
 @NotNull ShadowKindType kind,
 @NotNull
 @NotNull String intent)

Returns definition of the given type. No hacks/guesses here.

getObjectTypeDefinition

@Nullable
default @Nullable ResourceObjectTypeDefinition getObjectTypeDefinition(@NotNull
 @NotNull ResourceObjectTypeIdentification identification)

Returns definition of the given type. No hacks/guesses here.

findDefaultDefinitionForKind

@Nullable
default @Nullable ResourceObjectDefinition findDefaultDefinitionForKind(@NotNull
 @NotNull ShadowKindType kind)

Returns the "default for kind" type definition for given kind. Applies `account/default` hack if nothing relevant can be found.

findDefaultDefinitionForKindRequired

@NotNull
default @NotNull ResourceObjectDefinition findDefaultDefinitionForKindRequired(@NotNull
 @NotNull ShadowKindType kind)

As findDefaultDefinitionForKind(ShadowKindType) but the definition must exist.

findObjectDefinition

@Nullable
default @Nullable ResourceObjectDefinition findObjectDefinition(@NotNull
 @NotNull ShadowKindType kind,
 @NotNull
 @NotNull String intent)

Returns the definition for known kind and intent. Applies `account/default` hack if nothing relevant can be found.

findObjectDefinitionRequired

@NotNull
default @NotNull ResourceObjectDefinition findObjectDefinitionRequired(@NotNull
 @NotNull ShadowKindType kind,
 @NotNull
 @NotNull String intent)

As findObjectDefinition(ShadowKindType, String) but the definition must exist.

findObjectDefinition

@Nullable
default @Nullable ResourceObjectDefinition findObjectDefinition(@NotNull
 @NotNull ResourceObjectTypeIdentification typeIdentification)

As findObjectDefinition(ShadowKindType, String) but with aggregate representation of type identification. Applies `account/default` hack if nothing relevant can be found.

findObjectDefinitionRequired

@NotNull
default @NotNull ResourceObjectDefinition findObjectDefinitionRequired(@NotNull
 @NotNull ResourceObjectTypeIdentification typeIdentification)

As findObjectDefinition(ResourceObjectTypeIdentification) but the definition must exist. Applies `account/default` hack if nothing relevant can be found.

findDefinitionForObjectClass

@Nullable
default @Nullable ResourceObjectDefinition findDefinitionForObjectClass(@NotNull
 @NotNull QName name)

Returns a type or class definition for a given object class: - if there's a "default for class" type defined, it is returned (this is a kind of pre-4.5 behavior) - otherwise, the object class definition is returned (if there's any)

findDefinitionForObjectClassRequired

@NotNull
default @NotNull ResourceObjectDefinition findDefinitionForObjectClassRequired(@NotNull
 @NotNull QName name)
                                                                        throws SchemaException

As findDefinitionForObjectClass(QName) but throws an exception if there's no suitable definition.

Throws:

SchemaException

findObjectClassDefinition

@Nullable
default @Nullable ResourceObjectClassDefinition findObjectClassDefinition(@NotNull
 @NotNull QName name)

Returns ResourceObjectClassDefinition (raw or refined) for a given object class name.

findObjectClassDefinitionRequired

@NotNull
default @NotNull ResourceObjectClassDefinition findObjectClassDefinitionRequired(@NotNull
 @NotNull QName name)
                                                                          throws SchemaException

The same as findObjectClassDefinition(QName) but throws an exception if there's no such definition.

Throws:

SchemaException

findObjectClassDefinitionRequired

@NotNull
default @NotNull ResourceObjectClassDefinition findObjectClassDefinitionRequired(@NotNull
 @NotNull QName name,
 @NotNull
 @NotNull Supplier<String> contextSupplier)
                                                                          throws SchemaException

Throws:

SchemaException

findObjectDefinition

@Nullable
default @Nullable ResourceObjectDefinition findObjectDefinition(@NotNull
 @NotNull ShadowKindType kind,
 @NotNull
 @NotNull String intent,
 @Nullable
 @Nullable QName objectClassName)

As findObjectDefinition(ShadowKindType, String) but checks the object class compatibility (if object class name is provided).

findDefinitionForConstruction

default ResourceObjectDefinition findDefinitionForConstruction(@NotNull
 @NotNull ConstructionType construction)

Finds a definition for ConstructionType. The method is different from the ones looking for kind/intent because here is a special handling of the default values.

findDefinitionForConstructionRequired

@NotNull
default @NotNull ResourceObjectDefinition findDefinitionForConstructionRequired(@NotNull
 @NotNull ConstructionType constructionBean,
 @NotNull
 @NotNull Supplier<String> contextSupplier)
                                                                         throws SchemaException

As findDefinitionForConstruction(ConstructionType) but throws an exception if the definition is not there.

Throws:

SchemaException

findDefinitionForShadow

@Nullable
default @Nullable ResourceObjectDefinition findDefinitionForShadow(@NotNull
 @NotNull ShadowType shadow,
 @NotNull
 @NotNull Collection<QName> additionalAuxObjectClassNames)
                                                            throws SchemaException

Returns appropriate ResourceObjectDefinition for given shadow. We are not too strict here. Unknown kind/intent values are ignored (treated like null). Incomplete classification is considered as kind=null, intent=null. Takes auxiliary object classes defined in the shadow, in the structural object definition, and those explicitly provided itself into account - by creating CompositeObjectDefinition in such cases.

Throws:

SchemaException

findDefinitionForShadow

@Nullable
default @Nullable ResourceObjectDefinition findDefinitionForShadow(@NotNull
 @NotNull ShadowType shadow)
                                                            throws SchemaException

Convenience variant of findDefinitionForShadow(ShadowType, Collection).

Throws:

SchemaException

getObjectClassNames

@NotNull
default @NotNull Collection<QName> getObjectClassNames()

Returns names of all object classes mentioned in the "raw" resource definition.

mutator

ResourceSchema.ResourceSchemaMutator mutator()

Returns an interface to mutate this schema.

Specified by:

mutator in interface PrismSchema

forLayerImmutable

ResourceSchema forLayerImmutable(LayerType layer)

Returns a representation of the schema for given layer (immutable).

getNamespace

@NotNull
default @NotNull String getNamespace()

Description copied from interface: PrismSchema

All top-level definitions (types, items) are in this namespace.

Specified by:

getNamespace in interface PrismSchema

validate

void validate()
       throws SchemaException

TODO description

Throws:

SchemaException

getIntentsForKind

@NotNull
default @NotNull Collection<String> getIntentsForKind(ShadowKindType kind)

TODO description

serializeNativeToXsd

Document serializeNativeToXsd()
                       throws SchemaException

Throws:

SchemaException

clone

ResourceSchema clone()

qualifyTypeName

@NotNull
static @NotNull QName qualifyTypeName(@NotNull
 @NotNull String localPart)

isRaw

default boolean isRaw()

Returns true if the schema contains no "refined" (type) definitions. BEWARE! Even schemas obtained via ResourceSchemaFactory.getCompleteSchema(ResourceType) method may seem raw, if there's no `schemaHandling` section. This should be perhaps fixed.

getNativeSchema

@NotNull
@NotNull NativeResourceSchema getNativeSchema()