Added 'nodeArchiveService' bean

- Added tests around transaction visibility
 - TODO: Need to set the owner of archived and restored nodes


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@2786 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/service/cmr/repository/NodeService.java

@@ -494,14 +494,17 @@ public interface NodeService
      * set against it.
      * 
      * @param archivedNodeRef the archived node
-     * @param targetParentNodeRef
-     * @param assocTypeQName
-     * @param assocQName
+     * @param destinationParentNodeRef the parent to move the node into
+     *      or <tt>null</tt> to use the original
+     * @param assocTypeQName the primary association type name to use in the new location
+     *      or <tt>null</tt> to use the original
+     * @param assocQName the primary association name to use in the new location
+     *      or <tt>null</tt> to use the original
      * @return Returns the reference to the newly created node 
      */
     public NodeRef restoreNode(
             NodeRef archivedNodeRef,
-            NodeRef targetParentNodeRef,
+            NodeRef destinationParentNodeRef,
             QName assocTypeQName,
             QName assocQName);
 }

source/java/org/alfresco/service/cmr/search/ResultSetRow.java

@@ -35,39 +35,41 @@ import org.alfresco.service.namespace.QName;
 public interface ResultSetRow
 {
     /**
-     * Get the values of all available node properties
+     * Get the values of all available node properties.  These are only properties
+     * that were stored in the query results and can vary depending on the query
+     * language that was used.
      * 
-     * @return
+     * @return Returns all the available node properties
      */
     public Map<Path, Serializable> getValues();
 
     /**
      * Get a node property by path
      * 
-     * @param path
-     * @return
+     * @param path the path to the value required
+     * @return Returns the value of the property at the given path
      */
     public Serializable getValue(Path path);
 
     /**
-     * Get a node value by name
+     * Get a node property value by name
      * 
-     * @param qname
-     * @return
+     * @param qname the property name
+     * @return Returns the node property for the given name
      */
     public Serializable getValue(QName qname);
     
     /**
-     * The refernce to the node that equates to this row in the result set
+     * The reference to the node that equates to this row in the result set
      * 
-     * @return
+     * @return Returns the reference to the node that makes this result 
      */
     public NodeRef getNodeRef();
 
     /**
      * Get the score for this row in the result set
      * 
-     * @return
+     * @return Returns the score for this row in the resultset
      */
     public float getScore(); // Score is score + rank + potentially other
                                 // stuff
@@ -75,26 +77,25 @@ public interface ResultSetRow
     /**
      * Get the containing result set
      * 
-     * @return
+     * @return Returns the containing resultset
      */
     public ResultSet getResultSet();
     
     /**
-     * Return the QName of the node in the context in which it was found.
-     * @return
+     * @return Returns the name of the child association leading down to the
+     *      node represented by this row 
      */
-    
     public QName getQName();
 
     /**
      * Get the position of this row in the containing set.
-     * @return
+     * 
+     * @return Returns the position of this row in the containing resultset
      */
     public int getIndex();
     
     /**
-     * Return the child assoc ref for this row
-     * @return
+     * @return Returns the child assoc ref for this row
      */
     public ChildAssociationRef getChildAssocRef();
     

source/java/org/alfresco/service/cmr/security/AuthenticationService.java

@@ -86,8 +86,8 @@ public interface AuthenticationService
      * Carry out an authentication attempt. If successful the user is set to the current user.
      * The current user is a part of the thread context.
      * 
-     * @param userName
-     * @param password
+     * @param userName the username
+     * @param password the passowrd
      * @throws AuthenticationException
      */
     public void authenticate(String userName, char[] password) throws AuthenticationException;
@@ -99,6 +99,14 @@ public interface AuthenticationService
      */
     public void authenticateAsGuest() throws AuthenticationException;
     
+    /**
+     * Check if the given authentication exists.
+     * 
+     * @param userName the username
+     * @return Returns <tt>true</tt> if the authentication exists
+     */
+    public boolean authenticationExists(String userName);
+    
     /**
      * Get the name of the currently authenticated user.
      *