/**
* Copyright (c) 2017 Evolveum
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.evolveum.midpoint.schema;
/**
* Specifies the point in time for the returned data. This option controls whether fresh or cached data will
* be returned or whether future data projection will be returned. MidPoint usually deals with fresh data
* that describe situation at the current point in time. But the client code may want to get data from the
* cache that may be possibly stale. Or the client code may want a projection about the future state of the
* data (e.g. taking running asynchronous operation into consideration).
*
* @author semancik
*/
public enum PointInTimeType {
/**
* Return cached data (if available).
* Avoid fetching the data from external system.
*/
CACHED,
/**
* Return current data. Fetch from external system if needed.
* The "current" has to be understood in Einsteinean sense.
* The returned data are as fresh as possible - but that still
* may be hours or days old for some resources.
* This is usually the default.
*/
CURRENT,
/**
* Returns current data and applies all the available projections
* about future state of the data. E.g. applies projected state of
* pending asynchronous operations.
*/
FUTURE;
}