svn commit: r472903 - in /jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config: CacheMaintenance.java RepositoryConfig.java

[mr...@apache.org]

Author: mreutegg
Date: Thu Nov  9 06:17:52 2006
New Revision: 472903

URL: http://svn.apache.org/viewvc?view=rev&rev=472903
Log:
- Definition of cache maintenance strategies

Added:
    jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/CacheMaintenance.java   (with props)
Modified:
    jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/RepositoryConfig.java

Added: jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/CacheMaintenance.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/CacheMaintenance.java?view=auto&rev=472903
==============================================================================
--- jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/CacheMaintenance.java (added)
+++ jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/CacheMaintenance.java Thu Nov  9 06:17:52 2006
@@ -0,0 +1,56 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  The ASF licenses this file to You
+ * 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 org.apache.jackrabbit.jcr2spi.config;
+
+/**
+ * <code>CacheMaintenance</code> defines constants for the various cache
+ * maintenance strategies. The effective strategy depends on two factors,
+ * whether the repository implementation supports observation and the strategy
+ * provided in the {@link RepositoryConfig}.
+ */
+public final class CacheMaintenance {
+
+    /**
+     * Cache maintenance is stictly done on a manual basis even though the
+     * repository implementation might support observation. Only the result of a
+     * <code>save()</code> upon a transient modification is reflected in the
+     * cache. The client has to call {@link javax.jcr.Item#refresh(boolean)}
+     * <i>manually</i> to get the full effect of his action. E.g. workspace
+     * operations will not change any cached state.
+     */
+    public static final CacheMaintenance MANUAL = new CacheMaintenance();
+
+    /**
+     * Cache maintenance is done by invalidating affected items of an operation
+     * and forcing the jcr2spi implementation to reload the item states when
+     * they are accessed next time. No event listener is used for cache
+     * maintenance even though the repository implementation might support
+     * observation.
+     */
+    public static final CacheMaintenance INVALIDATE = new CacheMaintenance();
+
+    /**
+     * Cache maintenance is done using events from the repository. After an
+     * operation has been executed on the RepositoryService events are retrieved
+     * from the repository and the cache is updated based on the returned
+     * events. This strategy requires that the repository implementation
+     * supports observation.
+     */
+    public static final CacheMaintenance OBSERVATION = new CacheMaintenance();
+
+    private CacheMaintenance() {
+    }
+}

Propchange: jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/CacheMaintenance.java
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/RepositoryConfig.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/RepositoryConfig.java?view=diff&rev=472903&r1=472902&r2=472903
==============================================================================
--- jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/RepositoryConfig.java (original)
+++ jackrabbit/trunk/contrib/spi/jcr2spi/src/main/java/org/apache/jackrabbit/jcr2spi/config/RepositoryConfig.java Thu Nov  9 06:17:52 2006
@@ -32,4 +32,6 @@
     public ValueFactory getValueFactory() throws RepositoryException;
 
     public String getDefaultWorkspaceName();
+
+    public CacheMaintenance getCacheMaintenanceStrategy();
 }