/*
* 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.test.api;
import org.apache.jackrabbit.test.AbstractJCRTest;
import org.apache.jackrabbit.test.NotExecutableException;
import javax.jcr.RepositoryException;
import javax.jcr.Node;
import javax.jcr.Session;
import javax.jcr.ReferentialIntegrityException;
import javax.jcr.InvalidItemStateException;
import javax.jcr.nodetype.NoSuchNodeTypeException;
/**
* <code>NodeUUIDTest</code> contains all tests for the
* <code>javax.jcr.Node</code> class that require a UUID (and therefore are
* optional). If the repository does not support the node type mix:referenceable
* a {@link NotExecutableException} is thrown.
*
*/
public class NodeUUIDTest extends AbstractJCRTest {
/**
* Tries to remove a node that is a reference target using {@link
* Node#save()}.<br> <br>Procedure: <ul> <li>Creates two nodes with same
* session</li> <li>One has a referencing property pointing to the other
* node</li> <li>Target node gets removed.</li> </ul> This should
* generate a {@link javax.jcr.ReferentialIntegrityException} upon save.
* <br><br>Prerequisites: <ul> <li><code>javax.jcr.tck.NodeUUIDTest.nodetype</code>
* must allow a property of type {@link javax.jcr.PropertyType#REFERENCE}</li>
* <li><code>javax.jcr.tck.NodeUUIDTest.propertyname1</code> name of the
* property of type {@link javax.jcr.PropertyType#REFERENCE}</li>
* <li><code>javax.jcr.tck.NodeUUIDTest.nodetype2</code> must have the mixin
* type <code>mix:referenceable</code> assigned.</li> </ul>
*/
public void testSaveReferentialIntegrityException() throws RepositoryException, NotExecutableException {
checkMixReferenceable();
// get default workspace test root node using superuser session
Node defaultRootNode = (Node) superuser.getItem(testRootNode.getPath());
// create a node with a property of type PropertyType.REFERENCE
Node referencingNode = defaultRootNode.addNode(nodeName1, testNodeType);
// create a node with a jcr:uuid property to serve as target
Node refTargetNode = defaultRootNode.addNode(nodeName2, getProperty("nodetype2"));
// make sure, mix:referenceable is effective. some impls may require a save() call.
defaultRootNode.save();
// abort test if the repository does not allow setting
// reference properties on this node
ensureCanSetProperty(referencingNode, propertyName1, referencingNode.getSession().getValueFactory().createValue(refTargetNode));
// set the reference
referencingNode.setProperty(propertyName1, refTargetNode);
// save the new nodes
defaultRootNode.save();
// remove the referenced node
refTargetNode.remove();
// try to save
try {
defaultRootNode.save();
fail("Saving a deleted node using Node.save() that is a reference target should throw ReferentialIntegrityException");
} catch (ReferentialIntegrityException e) {
// ok, works as expected
}
}
/**
* Moves a referencable node using {@link javax.jcr.Session#move(String,
* String)} with one session and saves afterward changes made with a second
* session to the moved node using {@link Node#save()}.
* <p>
* Procedure: <ul> <li>Creates node 1 and node 2 with session 1</li>
* <li>Gets reference to node 1 using session 2</li> <li>Session 1 moves
* node 1 under node 2, saves changes</li> <li>Session 2 modifes node 1,
* saves</li> </ul> This should work (since the modified node is identified
* by its UUID, not by position in repository) or throw an
* <code>InvalidItemStateException</code> if 'move' is reported to the second
* session as a sequence of remove and add events. <br><br>Prerequisites: <ul>
* <li><code>javax.jcr.tck.NodeUUIDTest.nodetype2</code> must have the mixin
* type <code>mix:referenceable</code> assigned.</li>
* <li><code>javax.jcr.tck.NodeUUIDTest.testSaveMovedRefNode.propertyname1</code>
* name of a property that can be modified in <code>nodetype2</code> for
* testing</li> </ul>
*/
public void testSaveMovedRefNode() throws RepositoryException, NotExecutableException {
checkMixReferenceable();
// get default workspace test root node using superuser session
Node defaultRootNode = (Node) superuser.getItem(testRootNode.getPath());
// create a node
Node newParentNode = defaultRootNode.addNode(nodeName1, testNodeType);
// create a referenceable node
Node refTargetNode = defaultRootNode.addNode(nodeName2, getProperty("nodetype2"));
// save the new nodes
superuser.save();
// get the moving node with session 2
Session testSession = getHelper().getReadWriteSession();
try {
Node refTargetNodeSession2 = (Node) testSession.getItem(refTargetNode.getPath());
//move the node with session 1
superuser.move(refTargetNode.getPath(), newParentNode.getPath() + "/" + nodeName3);
// make the move persistent with session 1
superuser.save();
// modify some prop of the moved node with session 2
try {
refTargetNodeSession2.setProperty(propertyName1, "test");
// save it
refTargetNodeSession2.save();
// ok, works as expected
} catch (InvalidItemStateException e) {
// ok as well.
}
} finally {
testSession.logout();
}
}
/**
* Checks if the repository supports the mixin mix:Referenceable otherwise a
* {@link NotExecutableException} is thrown.
*
* @throws NotExecutableException if the repository does not support the
* mixin mix:referenceable.
*/
private void checkMixReferenceable() throws RepositoryException, NotExecutableException {
try {
superuser.getWorkspace().getNodeTypeManager().getNodeType(mixReferenceable);
} catch (NoSuchNodeTypeException e) {
throw new NotExecutableException("Repository does not support mix:referenceable");
}
}
}