Jump to: navigation, search

View Cache


Revision as of 14:19, 7 May 2015 by KNO (Talk | contribs)

IC ReleaseStatus Beta.png
This feature is a beta version. If you experience unexpected issues, please Contact us for support.


The View Cache feature increases the performance of the Web Service by caching the data to be published and sent to the clients. All content data as well as the hierarchies, as defined by the View and in the ACM, is evaluated and cached internally.

A client's request for hierarchical data, covering two or more hierarchy levels, will be handled using the cached data. Any request covering only one hierarchy level will by-pass the view cache and be treated directly. For example, browsing through the objects using the Content Browser does not use the View Cache, whereas preparing the Offline Mode utilizes the cache to improve performance.

Once the cache has been initialized, its status and additional information can be retrieved by web service methods.

IC Attention.pngUp to now the View Cache needs to be initialized and updated manually after every (re)start of the web service, due to a missing automatism!

Using the View Cache

Once initialized, a client's request for hierarchical data will be handled using the cached data. This data encompasses all content data and its hierarchies, but not the physical documents linked to the objects. Hence, if the client is actually fetching data from the web service the documents have to be loaded.

Initialization / Update of View Cache

The cache needs to be initialized after a web service has been (re)started. This can be achieved by calling


= Enabling

The View Cache features needs to be enabled in the web.config file of the corresponding web service.

Area Setting Description
appSettings UBIK.Service.EnableViewCachage Enable (1) / Disable (0) the view cache feature for this web service
  <appSettings>
    ...
    <add key="UBIK.Service.EnableViewCache" value="1" />
  </appSettings>

Web Service Interface

Use the these web service members to gain status and runtime information of the View Cache. More detailed information and a comprehensive list of all members and data types are located in the UBIK® class documentation.

GetViewStateInformation

Get information about the current state of the View Cache.

        /// <summary>
        /// Gets information abut the state of view cache.
        /// </summary>
        /// <param name="appName">Name of the application.</param>
        /// <param name="contextName">Name of the context.</param>
        /// <param name="authentication">The authentication.</param>
        /// <returns>Information about the state of the view cache as human readable string</returns>
        [OperationContract]
        [WebInvoke(UriTemplate = "GetViewStateInformation/{appName}/{contextName}/{authentication}", Method = "GET",
                   RequestFormat = WebMessageFormat.Json,
                   ResponseFormat = WebMessageFormat.Json)]
        string GetViewStateInformation(string appName, string contextName, string authentication);

TriggerViewStateUpdate

Start or trigger reinitialization of the View Cache.

        /// <summary>
        /// Triggers a refresh of the view cache.
        /// The current cache stays valid until the new cache was fully built.
        /// </summary>
        /// <param name="appName">Name of the application.</param>
        /// <param name="contextName">Name of the context.</param>
        /// <param name="authentication">The authentication.</param>
        /// <returns>true as the refresh was triggered successfully, false otherwise</returns>
        [OperationContract]
        [WebInvoke(UriTemplate = "TriggerViewStateUpdate/{appName}/{contextName}/{authentication}", Method = "GET",
                   RequestFormat = WebMessageFormat.Json,
                   ResponseFormat = WebMessageFormat.Json)]
        bool TriggerViewStateRefresh(string appName, string contextName, string authentication);

TestViewState

Test the View Cache's result for a single object (given by its Guid), without retrieving the physical documents.

        /// <summary>
        /// Test member for testing the View Cache.
        /// </summary>
        /// <param name="appName">Name of the application.</param>
        /// <param name="contextName">Name of the context.</param>
        /// <param name="ownerUID">UID of the object the test should be executed for (e.g. root object). All data below this object will be delivered.</param>
        /// <param name="authentication">The authentication.</param>
        /// <returns>data stored in the view cache as BCHierarchyDeltaShipments</returns>
        [OperationContract]
        [WebInvoke(UriTemplate = "TestViewState/{appName}/{contextName}/{owneruid}/{authentication}", Method = "GET",
                   RequestFormat = WebMessageFormat.Json,
                   ResponseFormat = WebMessageFormat.Json)]
        DTO.V211.BCHierarchyDeltaShipments TestViewState(string appName, string contextName, string ownerUID, string authentication);