You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by re...@apache.org on 2008/09/23 12:18:27 UTC
svn commit: r698122 - in /jackrabbit/trunk:
jackrabbit-api/src/main/java/org/apache/jackrabbit/api/jsr283/Node.java
jackrabbit-core/src/main/java/org/apache/jackrabbit/core/NodeImpl.java
Author: reschke
Date: Tue Sep 23 03:18:27 2008
New Revision: 698122
URL: http://svn.apache.org/viewvc?rev=698122&view=rev
Log:
JCR-1104: add o.a.j.api.jsr283.Node extending javax.jcr.Node, and containing the shareable node functionality; let Jackrabbit NodeImpl implement it.
Added:
jackrabbit/trunk/jackrabbit-api/src/main/java/org/apache/jackrabbit/api/jsr283/Node.java (with props)
Modified:
jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/NodeImpl.java
Added: jackrabbit/trunk/jackrabbit-api/src/main/java/org/apache/jackrabbit/api/jsr283/Node.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-api/src/main/java/org/apache/jackrabbit/api/jsr283/Node.java?rev=698122&view=auto
==============================================================================
--- jackrabbit/trunk/jackrabbit-api/src/main/java/org/apache/jackrabbit/api/jsr283/Node.java (added)
+++ jackrabbit/trunk/jackrabbit-api/src/main/java/org/apache/jackrabbit/api/jsr283/Node.java Tue Sep 23 03:18:27 2008
@@ -0,0 +1,97 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * 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.api.jsr283;
+
+import javax.jcr.NodeIterator;
+import javax.jcr.RepositoryException;
+import javax.jcr.lock.LockException;
+import javax.jcr.nodetype.ConstraintViolationException;
+import javax.jcr.version.VersionException;
+
+/**
+ * This interface holds extensions made in JCR 2.0 while work
+ * is in progress implementing JCR 2.0.
+ *
+ * @since JCR 2.0
+ */
+public interface Node extends javax.jcr.Node {
+
+ /**
+ * Returns an iterator over all nodes that are in the shared set of this
+ * node. If this node is not shared then the returned iterator contains
+ * only this node.
+ *
+ * @return a <code>NodeIterator</code>
+ * @throws RepositoryException if an error occurs.
+ * @since JCR 2.0
+ */
+ public NodeIterator getSharedSet() throws RepositoryException;
+
+ /**
+ * A special kind of <code>remove()</code> that removes this node, but does
+ * not remove any other node in the shared set of this node.
+ * <p/>
+ * All of the exceptions defined for <code>remove()</code> apply to this
+ * function. In addition, a <code>RepositoryException</code> is thrown if
+ * this node cannot be removed without removing another node in the shared
+ * set of this node.
+ * <p/>
+ * If this node is not shared this method removes only this node.
+ *
+ * @throws VersionException if the parent node of this item is versionable and checked-in
+ * or is non-versionable but its nearest versionable ancestor is checked-in and this
+ * implementation performs this validation immediately instead of waiting until <code>save</code>.
+ * @throws LockException if a lock prevents the removal of this item and this
+ * implementation performs this validation immediately instead of waiting until <code>save</code>.
+ * @throws ConstraintViolationException if removing the specified item would violate a node type or
+ * implementation-specific constraint and this implementation performs this validation immediately
+ * instead of waiting until <code>save</code>.
+ * @throws RepositoryException if another error occurs.
+ * @see #removeSharedSet()
+ * @see Item#remove()
+ * @see javax.jcr.Workspace#removeItem
+ * @since JCR 2.0
+ */
+ public void removeShare() throws VersionException, LockException, ConstraintViolationException, RepositoryException;
+
+ /**
+ * A special kind of <code>remove()</code> that removes this node and every
+ * other node in the shared set of this node.
+ * <p/>
+ * This removal must be done atomically, i.e., if one of the nodes cannot be
+ * removed, the function throws the exception <code>remove()</code> would
+ * have thrown in that case, and none of the nodes are removed.
+ * <p/>
+ * If this node is not shared this method removes only this node.
+ *
+ * @throws VersionException if the parent node of this item is versionable and checked-in
+ * or is non-versionable but its nearest versionable ancestor is checked-in and this
+ * implementation performs this validation immediately instead of waiting until <code>save</code>.
+ * @throws LockException if a lock prevents the removal of this item and this
+ * implementation performs this validation immediately instead of waiting until <code>save</code>.
+ * @throws ConstraintViolationException if removing the specified item would violate a node type or
+ * implementation-specific constraint and this implementation performs this validation immediately
+ * instead of waiting until <code>save</code>.
+ * @throws RepositoryException if another error occurs.@throws VersionException if
+ * @see #removeShare()
+ * @see Item#remove()
+ * @see javax.jcr.Workspace#removeItem
+ * @since JCR 2.0
+ */
+ public void removeSharedSet() throws VersionException, LockException, ConstraintViolationException, RepositoryException;
+
+}
Propchange: jackrabbit/trunk/jackrabbit-api/src/main/java/org/apache/jackrabbit/api/jsr283/Node.java
------------------------------------------------------------------------------
svn:eol-style = native
Modified: jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/NodeImpl.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/NodeImpl.java?rev=698122&r1=698121&r2=698122&view=diff
==============================================================================
--- jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/NodeImpl.java (original)
+++ jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/NodeImpl.java Tue Sep 23 03:18:27 2008
@@ -102,7 +102,7 @@
/**
* <code>NodeImpl</code> implements the <code>Node</code> interface.
*/
-public class NodeImpl extends ItemImpl implements Node {
+public class NodeImpl extends ItemImpl implements org.apache.jackrabbit.api.jsr283.Node {
private static Logger log = LoggerFactory.getLogger(NodeImpl.class);