svn commit: r649419 - /jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/Batch.java

[an...@apache.org]

Author: angela
Date: Fri Apr 18 02:11:21 2008
New Revision: 649419

URL: http://svn.apache.org/viewvc?rev=649419&view=rev
Log:
JCR-1500: removing properties through SPI: two ways to do it

Modified:
    jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/Batch.java

Modified: jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/Batch.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/Batch.java?rev=649419&r1=649418&r2=649419&view=diff
==============================================================================
--- jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/Batch.java (original)
+++ jackrabbit/trunk/jackrabbit-spi/src/main/java/org/apache/jackrabbit/spi/Batch.java Fri Apr 18 02:11:21 2008
@@ -158,7 +158,9 @@
     public void addProperty(NodeId parentId, Name propertyName, QValue[] values) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, PathNotFoundException, ItemExistsException, AccessDeniedException, UnsupportedRepositoryOperationException, RepositoryException;
 
     /**
-     * Modify the value of an existing property.
+     * Modify the value of an existing property. Note that in contrast to
+     * the JCR API this method should not accept a <code>null</code> value.
+     * Removing a property is achieved by calling {@link #remove(ItemId)}.
      *
      * @param propertyId PropertyId identifying the property to be modified.
      * @param value The new value.
@@ -180,7 +182,9 @@
     public void setValue(PropertyId propertyId, QValue value) throws RepositoryException;
 
     /**
-     * Modify the value of an existing, multi-valued property.
+     * Modify the value of an existing, multi-valued property. Note that in
+     * contrast to the JCR API this method should not accept a <code>null</code>
+     * value. Removing a property is achieved by calling {@link #remove(ItemId)}.
      *
      * @param propertyId PropertyId identifying the property to be modified.
      * @param values The new values.