Class RepositoryCache
- java.lang.Object
-
- com.evolveum.midpoint.repo.cache.RepositoryCache
-
- All Implemented Interfaces:
Cache
,RepositoryService
@Component("cacheRepositoryService") public class RepositoryCache extends Object implements RepositoryService, Cache
Read-through write-through repository cache.This is an umbrella class providing RepositoryService and
Cache
interfaces. Majority of the work is delegated to operation handlers (and other classes).
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.evolveum.midpoint.repo.api.RepositoryService
RepositoryService.ModificationsSupplier<T extends ObjectType>
-
-
Field Summary
Fields Modifier and Type Field Description static String
CLASS_NAME_WITH_DOT
-
Fields inherited from interface com.evolveum.midpoint.repo.api.RepositoryService
ADD_DIAGNOSTIC_INFORMATION, ADD_OBJECT, ADVANCE_SEQUENCE, COUNT_CONTAINERS, COUNT_OBJECTS, DELETE_OBJECT, GET_OBJECT, GET_VERSION, HAS_CONFLICT, KEY_DIAG_DATA, KEY_ORIGINAL_OBJECT, MODIFY_OBJECT, MODIFY_OBJECT_DYNAMICALLY, OP_ADD_DIAGNOSTIC_INFORMATION, OP_ADD_OBJECT, OP_ADD_OBJECT_OVERWRITE, OP_ADVANCE_SEQUENCE, OP_COUNT_CONTAINERS, OP_COUNT_OBJECTS, OP_DELETE_OBJECT, OP_EXECUTE_QUERY_DIAGNOSTICS, OP_FETCH_EXT_ITEMS, OP_GET_OBJECT, OP_GET_VERSION, OP_HAS_CONFLICT, OP_IS_ANCESTOR, OP_IS_DESCENDANT, OP_MODIFY_OBJECT, OP_MODIFY_OBJECT_DYNAMICALLY, OP_REPOSITORY_SELF_TEST, OP_RETURN_UNUSED_VALUES_TO_SEQUENCE, OP_SEARCH_CONTAINERS, OP_SEARCH_OBJECTS, OP_SEARCH_OBJECTS_ITERATIVE, OP_SEARCH_OBJECTS_ITERATIVE_PAGE, OP_SEARCH_SHADOW_OWNER, OP_TEST_ORG_CLOSURE_CONSISTENCY, RETURN_UNUSED_VALUES_TO_SEQUENCE, SEARCH_CONTAINERS, SEARCH_OBJECTS, SEARCH_OBJECTS_ITERATIVE, SEARCH_SHADOW_OWNER
-
-
Constructor Summary
Constructors Constructor Description RepositoryCache()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description <T extends ObjectType>
voidaddDiagnosticInformation(Class<T> type, String oid, DiagnosticInformationType information, OperationResult parentResult)
Adds a diagnostic information, honoring cleanup rules (deleting obsolete records).<T extends ObjectType>
@NotNull StringaddObject(@NotNull PrismObject<T> object, RepoAddOptions options, @NotNull OperationResult parentResult)
Add new object.long
advanceSequence(String oid, OperationResult parentResult)
This operation is guaranteed to be atomic.void
applyFullTextSearchConfiguration(FullTextSearchConfigurationType fullTextSearch)
<T extends Containerable>
intcountContainers(Class<T> type, ObjectQuery query, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult)
<T extends ObjectType>
intcountObjects(Class<T> type, ObjectQuery query, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult)
Returns the number of objects that match specified criteria.ConflictWatcher
createAndRegisterConflictWatcher(@NotNull String oid)
<T extends ObjectType>
@NotNull DeleteObjectResultdeleteObject(Class<T> type, String oid, OperationResult parentResult)
Deletes object with specified OID.void
dumpContent()
static void
enterLocalCaches(CacheConfigurationManager mgr)
Enters thread-local caches.RepositoryQueryDiagResponse
executeQueryDiagnostics(RepositoryQueryDiagRequest request, OperationResult parentResult)
A bit of hack - execute arbitrary query, e.g.static void
exitLocalCaches()
Exits thread-local caches.FullTextSearchConfigurationType
getFullTextSearchConfiguration()
<T extends ObjectType>
@NotNull PrismObject<T>getObject(Class<T> type, String oid, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult)
Returns object for provided OID.PerformanceMonitor
getPerformanceMonitor()
RepositoryDiag
getRepositoryDiag()
Provide repository run-time configuration and diagnostic information.@NotNull String
getRepositoryType()
Returns short type identifier of the repository implementation.@NotNull Collection<SingleCacheStateInformationType>
getStateInformation()
<T extends ObjectType>
StringgetVersion(Class<T> type, String oid, OperationResult parentResult)
Returns object version for provided OID.boolean
hasConflict(ConflictWatcher watcher, OperationResult result)
void
invalidate(Class<?> type, String oid, CacheInvalidationContext context)
<O extends ObjectType>
booleanisAncestor(PrismObject<O> object, String descendantOrgOid)
Returns `true` if the `object` is above organization identified with `descendantOrgOid`.<O extends ObjectType>
booleanisDescendant(PrismObject<O> object, String ancestorOrgOid)
Returns `true` if the `object` is under the organization identified with `ancestorOrgOid`.<T extends ObjectType>
@NotNull ModifyObjectResult<T>modifyObject(@NotNull Class<T> type, @NotNull String oid, @NotNull Collection<? extends ItemDelta<?,?>> modifications, @NotNull OperationResult parentResult)
Modifies object using relative change description.<T extends ObjectType>
@NotNull ModifyObjectResult<T>modifyObject(@NotNull Class<T> type, @NotNull String oid, @NotNull Collection<? extends ItemDelta<?,?>> modifications, ModificationPrecondition<T> precondition, RepoModifyOptions options, @NotNull OperationResult parentResult)
<T extends ObjectType>
@NotNull ModifyObjectResult<T>modifyObject(@NotNull Class<T> type, @NotNull String oid, @NotNull Collection<? extends ItemDelta<?,?>> modifications, RepoModifyOptions options, @NotNull OperationResult parentResult)
<T extends ObjectType>
@NotNull ModifyObjectResult<T>modifyObjectDynamically(@NotNull Class<T> type, @NotNull String oid, @Nullable Collection<SelectorOptions<GetOperationOptions>> getOptions, @NotNull RepositoryService.ModificationsSupplier<T> modificationsSupplier, @Nullable RepoModifyOptions modifyOptions, @NotNull OperationResult parentResult)
Modifies an object dynamically.void
postInit(OperationResult result)
void
repositorySelfTest(OperationResult parentResult)
Runs a short, non-destructive repository self test.void
returnUnusedValuesToSequence(String oid, Collection<Long> unusedValues, OperationResult parentResult)
The sequence may ignore the values, e.g.<T extends Containerable>
SearchResultList<T>searchContainers(Class<T> type, ObjectQuery query, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult)
Search for "sub-object" structures, i.e.<T extends ObjectType>
@NotNull SearchResultList<PrismObject<T>>searchObjects(@NotNull Class<T> type, ObjectQuery query, Collection<SelectorOptions<GetOperationOptions>> options, @NotNull OperationResult parentResult)
Search for objects in the repository.<T extends ObjectType>
SearchResultMetadatasearchObjectsIterative(Class<T> type, ObjectQuery query, ResultHandler<T> handler, Collection<SelectorOptions<GetOperationOptions>> options, boolean strictlySequential, OperationResult parentResult)
Search for objects in the repository in an iterative fashion.<F extends FocusType>
PrismObject<F>searchShadowOwner(String shadowOid, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult)
Returns the object representing owner of specified shadow.<O extends ObjectType>
booleanselectorMatches(ObjectSelectorType objectSelector, PrismObject<O> object, boolean fullInformationAvailable, ObjectFilterExpressionEvaluator filterEvaluator, Trace logger, String logMessagePrefix)
void
setModifyRandomDelayRange(Integer modifyRandomDelayRange)
void
testOrgClosureConsistency(boolean repairIfNecessary, OperationResult testResult)
Checks a closure for consistency, repairing any problems found.void
unregister()
void
unregisterConflictWatcher(ConflictWatcher watcher)
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.evolveum.midpoint.repo.api.RepositoryService
isNative, selectorMatches
-
-
-
-
Field Detail
-
CLASS_NAME_WITH_DOT
public static final String CLASS_NAME_WITH_DOT
-
-
Method Detail
-
enterLocalCaches
public static void enterLocalCaches(CacheConfigurationManager mgr)
Enters thread-local caches.
-
exitLocalCaches
public static void exitLocalCaches()
Exits thread-local caches.
-
getObject
@NotNull public <T extends ObjectType> @NotNull PrismObject<T> getObject(Class<T> type, String oid, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult) throws ObjectNotFoundException, SchemaException
Description copied from interface:RepositoryService
Returns object for provided OID. Must fail if object with the OID does not exist.- Specified by:
getObject
in interfaceRepositoryService
oid
- OID of the object to getparentResult
- parent OperationResult (in/out)- Returns:
- Object fetched from repository
- Throws:
ObjectNotFoundException
- requested object does not existSchemaException
- error dealing with storage schema
-
getVersion
public <T extends ObjectType> String getVersion(Class<T> type, String oid, OperationResult parentResult) throws ObjectNotFoundException, SchemaException
Description copied from interface:RepositoryService
Returns object version for provided OID.Must fail if object with the OID does not exists.
This is a supposed to be a very lightweight and cheap operation. It is used to support efficient caching of expensive objects.
- Specified by:
getVersion
in interfaceRepositoryService
oid
- OID of the object to getparentResult
- parent OperationResult (in/out)- Returns:
- Object version
- Throws:
ObjectNotFoundException
- requested object does not existSchemaException
- error dealing with storage schema
-
searchObjects
@NotNull public <T extends ObjectType> @NotNull SearchResultList<PrismObject<T>> searchObjects(@NotNull @NotNull Class<T> type, ObjectQuery query, Collection<SelectorOptions<GetOperationOptions>> options, @NotNull @NotNull OperationResult parentResult) throws SchemaException
Description copied from interface:RepositoryService
Search for objects in the repository.
If no search criteria specified, list of all objects of specified type is returned.
Searches through all object types. Returns a list of objects that match search criteria.
Returns empty list if object type is correct but there are no objects of that type. The ordering of the results is not significant and may be arbitrary unless sorting in the paging is used.
Should fail if object type is wrong. Should fail if unknown property is specified in the query.
- Specified by:
searchObjects
in interfaceRepositoryService
query
- search queryparentResult
- parent OperationResult (in/out)- Returns:
- all objects of specified type that match search criteria (subject to paging)
- Throws:
SchemaException
- unknown property used in search query
-
searchObjectsIterative
public <T extends ObjectType> SearchResultMetadata searchObjectsIterative(Class<T> type, ObjectQuery query, ResultHandler<T> handler, Collection<SelectorOptions<GetOperationOptions>> options, boolean strictlySequential, OperationResult parentResult) throws SchemaException
Description copied from interface:RepositoryService
Search for objects in the repository in an iterative fashion. Searches through all object types. Calls a specified handler for each object found. If no search criteria specified, list of all objects of specified type is returned. Searches through all object types. Returns a list of objects that match search criteria. Returns empty list if object type is correct but there are no objects of that type. The ordering of the results is not significant and may be arbitrary unless sorting in the paging is used. Should fail if object type is wrong. Should fail if unknown property is specified in the query. [NOTE] ==== New repository uses single reliable iteration method similar to strictly sequential paging and supports custom ordering (currently only one). New repository ignores strictlySequential parameter and related get options completely. In old repository there are three iteration methods (see IterationMethodType): - SINGLE_TRANSACTION: Fetches objects in single DB transaction. Not supported for all DBMSs. - SIMPLE_PAGING: Uses the "simple paging" method: takes objects (e.g.) numbered 0 to 49, then 50 to 99, then 100 to 149, and so on. The disadvantage is that if the order of objects is changed during operation (e.g. by inserting/deleting some of them) then some objects can be processed multiple times, where others can be skipped. - STRICTLY_SEQUENTIAL_PAGING: Uses the "strictly sequential paging" method: sorting returned objects by OID. This is (almost) reliable in such a way that no object would be skipped. However, custom paging cannot be used in this mode. If GetOperationOptions.iterationMethod is specified, it is used without any further considerations. Otherwise, the repository configuration determines whether to use SINGLE_TRANSACTION or a paging. In the latter case, strictlySequential flag determines between SIMPLE_PAGING (if false) and STRICTLY_SEQUENTIAL_PAGING (if true). If explicit GetOperationOptions.iterationMethod is not provided, and paging is prescribed, and strictlySequential flag is true and client-provided paging conflicts with the paging used by the iteration method, a warning is issued, and iteration method is switched to SIMPLE_PAGING. ==== Sources of conflicts: - ordering is specified - offset is specified (limit is not a problem)- Specified by:
searchObjectsIterative
in interfaceRepositoryService
query
- search queryhandler
- result handlerstrictlySequential
- takes care not to skip any object nor to process objects more than onceparentResult
- parent OperationResult (in/out)- Returns:
- summary information about the search result
- Throws:
SchemaException
- unknown property used in search query
-
searchContainers
public <T extends Containerable> SearchResultList<T> searchContainers(Class<T> type, ObjectQuery query, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult) throws SchemaException
Description copied from interface:RepositoryService
Search for "sub-object" structures, i.e. containers. Currently, only one type of search is available: certification case search.- Specified by:
searchContainers
in interfaceRepositoryService
- Throws:
SchemaException
-
searchShadowOwner
public <F extends FocusType> PrismObject<F> searchShadowOwner(String shadowOid, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult)
Description copied from interface:RepositoryService
Returns the object representing owner of specified shadow.
Implements the backward "owns" association between account shadow and user. Forward association is implemented by linkRef reference in subclasses of FocusType.
Returns null if there is no owner for the shadow.This is a "search" operation even though it may return at most one owner. However the operation implies searching the repository for an owner, which may be less efficient that following a direct association. Hence it is called "search" to indicate that there may be non-negligible overhead.
This method should not die even if the specified shadow does not exist. Even if the shadow is gone, it still may be used in some linkRefs. This method should be able to find objects with such linkRefs otherwise we will not be able to do proper cleanup.
- Specified by:
searchShadowOwner
in interfaceRepositoryService
- Parameters:
shadowOid
- OID of shadowparentResult
- parentResult parent OperationResult (in/out)- Returns:
- Object representing owner of specified account (subclass of FocusType)
-
countObjects
public <T extends ObjectType> int countObjects(Class<T> type, ObjectQuery query, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult) throws SchemaException
Description copied from interface:RepositoryService
Returns the number of objects that match specified criteria.
If no search criteria specified, count of all objects of specified type is returned.
Should fail if object type is wrong. Should fail if unknown property is specified in the query.
- Specified by:
countObjects
in interfaceRepositoryService
query
- search queryparentResult
- parent OperationResult (in/out)- Returns:
- count of objects of specified type that match search criteria (subject to paging)
- Throws:
SchemaException
- unknown property used in search query
-
countContainers
public <T extends Containerable> int countContainers(Class<T> type, ObjectQuery query, Collection<SelectorOptions<GetOperationOptions>> options, OperationResult parentResult)
- Specified by:
countContainers
in interfaceRepositoryService
-
addObject
@NotNull public <T extends ObjectType> @NotNull String addObject(@NotNull @NotNull PrismObject<T> object, RepoAddOptions options, @NotNull @NotNull OperationResult parentResult) throws ObjectAlreadyExistsException, SchemaException
Description copied from interface:RepositoryService
Add new object. The OID provided in the input message may be empty. In that case the OID will be assigned by the implementation of this method and it will be provided as return value. This operation should fail if such object already exists (if object with the provided OID already exists). Overwrite is possible ifRepoAddOptions.overwrite
is true, but only for the object of the same type. The operation may fail if provided OID is in an unusable format for the storage. Generating own OIDs and providing them to this method is not recommended for normal operation. Should be atomic. Should not allow creation of two objects with the same OID (even if created in parallel). The operation may fail if the object to be created does not conform to the underlying schema of the storage system or the schema enforced by the implementation. Note: no need for explicit type parameter here. The object parameter contains the information.- Specified by:
addObject
in interfaceRepositoryService
- Parameters:
object
- object to createparentResult
- parent OperationResult (in/out)- Returns:
- OID assigned to the created object
- Throws:
ObjectAlreadyExistsException
- object with specified identifiers already exists, cannot addSchemaException
- error dealing with storage schema, e.g. schema violation
-
modifyObject
@NotNull public <T extends ObjectType> @NotNull ModifyObjectResult<T> modifyObject(@NotNull @NotNull Class<T> type, @NotNull @NotNull String oid, @NotNull @NotNull Collection<? extends ItemDelta<?,?>> modifications, @NotNull @NotNull OperationResult parentResult) throws ObjectNotFoundException, SchemaException, ObjectAlreadyExistsException
Description copied from interface:RepositoryService
Modifies object using relative change description.
Must fail if user with provided OID does not exists. Must fail if any of the described changes cannot be applied. Should be atomic.If two or more modify operations are executed in parallel, the operations should be merged. In case that the operations are in conflict (e.g. one operation adding a value and the other removing the same value), the result is not deterministic.
The operation may fail if the modified object does not conform to the underlying schema of the storage system or the schema enforced by the implementation.
TODO: optimistic locking
Note: the precondition is checked only if actual modification is going to take place (not e.g. if the list of modifications is empty).
- Specified by:
modifyObject
in interfaceRepositoryService
parentResult
- parent OperationResult (in/out)- Throws:
ObjectNotFoundException
- specified object does not existSchemaException
- resulting object would violate the schemaObjectAlreadyExistsException
- if resulting object would have name which already exists in another object of the same type
-
modifyObject
@NotNull public <T extends ObjectType> @NotNull ModifyObjectResult<T> modifyObject(@NotNull @NotNull Class<T> type, @NotNull @NotNull String oid, @NotNull @NotNull Collection<? extends ItemDelta<?,?>> modifications, RepoModifyOptions options, @NotNull @NotNull OperationResult parentResult) throws ObjectNotFoundException, SchemaException, ObjectAlreadyExistsException
- Specified by:
modifyObject
in interfaceRepositoryService
- Throws:
ObjectNotFoundException
SchemaException
ObjectAlreadyExistsException
-
modifyObject
@NotNull public <T extends ObjectType> @NotNull ModifyObjectResult<T> modifyObject(@NotNull @NotNull Class<T> type, @NotNull @NotNull String oid, @NotNull @NotNull Collection<? extends ItemDelta<?,?>> modifications, ModificationPrecondition<T> precondition, RepoModifyOptions options, @NotNull @NotNull OperationResult parentResult) throws ObjectNotFoundException, SchemaException, ObjectAlreadyExistsException, PreconditionViolationException
- Specified by:
modifyObject
in interfaceRepositoryService
- Throws:
ObjectNotFoundException
SchemaException
ObjectAlreadyExistsException
PreconditionViolationException
-
modifyObjectDynamically
@NotNull public <T extends ObjectType> @NotNull ModifyObjectResult<T> modifyObjectDynamically(@NotNull @NotNull Class<T> type, @NotNull @NotNull String oid, @Nullable @Nullable Collection<SelectorOptions<GetOperationOptions>> getOptions, @NotNull @NotNull RepositoryService.ModificationsSupplier<T> modificationsSupplier, @Nullable @Nullable RepoModifyOptions modifyOptions, @NotNull @NotNull OperationResult parentResult) throws ObjectNotFoundException, SchemaException, ObjectAlreadyExistsException
Description copied from interface:RepositoryService
Modifies an object dynamically. This means that the deltas are not provided by the caller, but computed by specified supplier, based on the current object state. This is to allow more complex atomic modifications with low overhead: Instead of calling getObject + compute deltas + modifyObject (with precondition that the object has not changed in the meanwhile) + repeating if the precondition fails, we now simply use modifyObjectDynamically that does all of this within a single DB transaction. BEWARE: Do not use unless really needed. Use modifyObject method instead.- Specified by:
modifyObjectDynamically
in interfaceRepositoryService
- Parameters:
type
- Type of the object to modifyoid
- OID of the object to modifygetOptions
- Options to use when getting the original object statemodificationsSupplier
- Supplier of the modifications (item deltas) to be applied on the objectmodifyOptions
- Options to be used when modifying the objectparentResult
- Operation result into which we put our result- Throws:
ObjectNotFoundException
SchemaException
ObjectAlreadyExistsException
-
deleteObject
@NotNull public <T extends ObjectType> @NotNull DeleteObjectResult deleteObject(Class<T> type, String oid, OperationResult parentResult) throws ObjectNotFoundException
Description copied from interface:RepositoryService
Deletes object with specified OID.
Must fail if object with specified OID does not exists. Should be atomic.
- Specified by:
deleteObject
in interfaceRepositoryService
oid
- OID of object to deleteparentResult
- parent OperationResult (in/out)- Throws:
ObjectNotFoundException
- specified object does not exist
-
advanceSequence
public long advanceSequence(String oid, OperationResult parentResult) throws ObjectNotFoundException, SchemaException
Description copied from interface:RepositoryService
This operation is guaranteed to be atomic. If two threads or even two nodes request a value from the same sequence at the same time then different values will be returned.- Specified by:
advanceSequence
in interfaceRepositoryService
- Parameters:
oid
- sequence OIDparentResult
- Operation result- Returns:
- next unallocated counter value
- Throws:
ObjectNotFoundException
- the sequence does not existSchemaException
- the sequence cannot produce a value (e.g. maximum counter reached)
-
returnUnusedValuesToSequence
public void returnUnusedValuesToSequence(String oid, Collection<Long> unusedValues, OperationResult parentResult) throws ObjectNotFoundException, SchemaException
Description copied from interface:RepositoryService
The sequence may ignore the values, e.g. if value re-use is disabled or when the list of unused values is full. In such a case the values will be ignored silently and no error is indicated.- Specified by:
returnUnusedValuesToSequence
in interfaceRepositoryService
- Parameters:
oid
- sequence OIDunusedValues
- values to returnparentResult
- Operation result- Throws:
ObjectNotFoundException
SchemaException
-
addDiagnosticInformation
public <T extends ObjectType> void addDiagnosticInformation(Class<T> type, String oid, DiagnosticInformationType information, OperationResult parentResult) throws ObjectNotFoundException, SchemaException, ObjectAlreadyExistsException
Description copied from interface:RepositoryService
Adds a diagnostic information, honoring cleanup rules (deleting obsolete records).- Specified by:
addDiagnosticInformation
in interfaceRepositoryService
- Throws:
ObjectNotFoundException
SchemaException
ObjectAlreadyExistsException
-
getRepositoryDiag
public RepositoryDiag getRepositoryDiag()
Description copied from interface:RepositoryService
Provide repository run-time configuration and diagnostic information. May execute diagnostic query on the database.- Specified by:
getRepositoryDiag
in interfaceRepositoryService
-
getRepositoryType
@NotNull public @NotNull String getRepositoryType()
Description copied from interface:RepositoryService
Returns short type identifier of the repository implementation. This should be the same asRepositoryDiag.getImplementationShortName()
.- Specified by:
getRepositoryType
in interfaceRepositoryService
-
repositorySelfTest
public void repositorySelfTest(OperationResult parentResult)
Description copied from interface:RepositoryService
Runs a short, non-destructive repository self test. This methods should never throw a (checked) exception. All the results should be recorded under the provided result structure (including fatal errors).This should implement ONLY self-tests that are IMPLEMENTATION-SPECIFIC. It must not implement self-tests that are generic and applies to all repository implementations. Such self-tests must be implemented in higher layers.
If the repository has no self-tests then the method should return immediately without changing the result structure. It must not throw an exception in this case.
- Specified by:
repositorySelfTest
in interfaceRepositoryService
-
testOrgClosureConsistency
public void testOrgClosureConsistency(boolean repairIfNecessary, OperationResult testResult)
Description copied from interface:RepositoryService
Checks a closure for consistency, repairing any problems found. This methods should never throw a (checked) exception. All the results should be in the returned result structure (including fatal errors).The current implementation expects closure to be of reasonable size - so it could be fetched into main memory as well as recomputed online (perhaps up to ~250K entries). In future, this method will be reimplemented.
BEWARE, this method locks out the M_ORG_CLOSURE table, so org-related operations would wait until it completes.
TODO this method is SQL service specific; it should be generalized/fixed somehow.
- Specified by:
testOrgClosureConsistency
in interfaceRepositoryService
-
isDescendant
public <O extends ObjectType> boolean isDescendant(PrismObject<O> object, String ancestorOrgOid) throws SchemaException
Description copied from interface:RepositoryService
Returns `true` if the `object` is under the organization identified with `ancestorOrgOid`. The `object` can either be an Org or any other object in which case all the targets of its `parentOrgRefs` are tested. Examples (from the perspective of the first parameter): * User belonging to Org with `ancestorOrgOid` returns true. * Organization under Org with `ancestorOrgOid` returns true (in any depth). * User belonging to Org under another Org with `ancestorOrgOid` returns true (any depth). * Organization with `ancestorOrgOid` returns `false`, as it is not considered to be its own descendant.- Specified by:
isDescendant
in interfaceRepositoryService
- Parameters:
object
- object of any type tested to belong under Org with `ancestorOrgOid`ancestorOrgOid
- identifier of ancestor organization- Throws:
SchemaException
-
isAncestor
public <O extends ObjectType> boolean isAncestor(PrismObject<O> object, String descendantOrgOid) throws SchemaException
Description copied from interface:RepositoryService
Returns `true` if the `object` is above organization identified with `descendantOrgOid`. Despite type parameter, only `PrismObject` can return `true`. Examples (from the perspective of the first parameter): * Any other type than `Org` used for `object` returns `false`. * Organization being a parent of another organization with `descendantOrgOid` returns `true`. This means that Organization with `descendantOrgOid` has `parentOrgRef` to `object`. * Organization higher in the organization hierarchy than Org with `descendantOrgOid` returns `true`, for any number of levels between them as long as it's possible to traverse from Org identified by `descendantOrgOid` to `object` using any number of `parentOrgRefs`. * Organization with `descendantOrgOid` returns `false`, as it is not considered to be its own ancestor. - Specified by:
isAncestor
in interfaceRepositoryService
- Parameters:
object
- potential ancestor organizationdescendantOrgOid
- identifier of potential descendant organization- Throws:
SchemaException
-
selectorMatches
public <O extends ObjectType> boolean selectorMatches(ObjectSelectorType objectSelector, PrismObject<O> object, boolean fullInformationAvailable, ObjectFilterExpressionEvaluator filterEvaluator, Trace logger, String logMessagePrefix) throws SchemaException, ObjectNotFoundException, ExpressionEvaluationException, CommunicationException, ConfigurationException, SecurityViolationException
-
executeQueryDiagnostics
public RepositoryQueryDiagResponse executeQueryDiagnostics(RepositoryQueryDiagRequest request, OperationResult parentResult)
Description copied from interface:RepositoryService
A bit of hack - execute arbitrary query, e.g. hibernate query in case of SQL repository. Use with all the care!- Specified by:
executeQueryDiagnostics
in interfaceRepositoryService
- Parameters:
request
- Diagnostics requestparentResult
- Operation result- Returns:
- diagnostics response
-
applyFullTextSearchConfiguration
public void applyFullTextSearchConfiguration(FullTextSearchConfigurationType fullTextSearch)
- Specified by:
applyFullTextSearchConfiguration
in interfaceRepositoryService
-
getFullTextSearchConfiguration
public FullTextSearchConfigurationType getFullTextSearchConfiguration()
- Specified by:
getFullTextSearchConfiguration
in interfaceRepositoryService
-
createAndRegisterConflictWatcher
public ConflictWatcher createAndRegisterConflictWatcher(@NotNull @NotNull String oid)
- Specified by:
createAndRegisterConflictWatcher
in interfaceRepositoryService
-
unregisterConflictWatcher
public void unregisterConflictWatcher(ConflictWatcher watcher)
- Specified by:
unregisterConflictWatcher
in interfaceRepositoryService
-
hasConflict
public boolean hasConflict(ConflictWatcher watcher, OperationResult result)
- Specified by:
hasConflict
in interfaceRepositoryService
-
getPerformanceMonitor
public PerformanceMonitor getPerformanceMonitor()
- Specified by:
getPerformanceMonitor
in interfaceRepositoryService
-
postInit
public void postInit(OperationResult result) throws SchemaException
- Specified by:
postInit
in interfaceRepositoryService
- Throws:
SchemaException
-
unregister
@PreDestroy public void unregister()
-
invalidate
public void invalidate(Class<?> type, String oid, CacheInvalidationContext context)
- Specified by:
invalidate
in interfaceCache
-
getStateInformation
@NotNull public @NotNull Collection<SingleCacheStateInformationType> getStateInformation()
- Specified by:
getStateInformation
in interfaceCache
-
dumpContent
public void dumpContent()
- Specified by:
dumpContent
in interfaceCache
-
setModifyRandomDelayRange
public void setModifyRandomDelayRange(Integer modifyRandomDelayRange)
-
-