Author: angela
Date: Tue Mar 10 11:10:44 2009
New Revision: 752063

URL: http://svn.apache.org/viewvc?rev=752063&view=rev
Log:
javadoc

Modified:
    jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AMContext.java
    jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AbstractAccessControlManager.java
    jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AccessManager.java
    jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/DefaultAccessManager.java
    jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/JackrabbitAccessControlManager.java

Modified: jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AMContext.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AMContext.java?rev=752063&r1=752062&r2=752063&view=diff
==============================================================================
--- jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AMContext.java (original)
+++ jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AMContext.java Tue Mar 10 11:10:44 2009
@@ -72,6 +72,7 @@
      *
      * @param physicalHomeDir the physical home directory
      * @param fs              the virtual jackrabbit filesystem
+     * @param session         the session.
      * @param subject         subject whose access rights should be reflected
      * @param hierMgr         hierarchy manager
      * @param resolver        name and path resolver

Modified: jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AbstractAccessControlManager.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AbstractAccessControlManager.java?rev=752063&r1=752062&r2=752063&view=diff
==============================================================================
--- jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AbstractAccessControlManager.java (original)
+++ jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AbstractAccessControlManager.java Tue Mar 10 11:10:44 2009
@@ -43,7 +43,7 @@
     /**
      * Always returns all registered <code>Privilege</code>s.
      *
-     * @param absPath
+     * @param absPath Path to an existing node.
      * @return Always returns all registered <code>Privilege</code>s.
      * @see AccessControlManager#getSupportedPrivileges(String)
      */
@@ -68,7 +68,7 @@
     /**
      * Returns <code>null</code>.
      *
-     * @param absPath
+     * @param absPath Path to an existing node.
      * @return always returns <code>null</code>.
      * @see AccessControlManager#getApplicablePolicies(String)
      */
@@ -83,7 +83,7 @@
     /**
      * Returns an empty iterator.
      *
-     * @param absPath
+     * @param absPath Path to an existing node.
      * @return always returns an empty iterator.
      * @see AccessControlManager#getApplicablePolicies(String)
      */
@@ -142,19 +142,19 @@
     /**
      * Check if the specified privileges are granted at <code>absPath</code>.
      *
-     * @param absPath
-     * @param permission
+     * @param absPath Path to an existing node.
+     * @param permission Permissions to be checked.
      * @throws AccessDeniedException if the session does not have the
      * specified privileges.
      * @throws PathNotFoundException if no node exists at <code>absPath</code>
      * of if the session does not have the permission to READ it.
-     * @throws RepositoryException
+     * @throws RepositoryException If another error occurs.
      */
     protected abstract void checkPermission(String absPath, int permission) throws AccessDeniedException, PathNotFoundException, RepositoryException;
 
     /**
      * @return the privilege registry
-     * @throws RepositoryException
+     * @throws RepositoryException If another error occurs.
      */
     protected abstract PrivilegeRegistry getPrivilegeRegistry() throws RepositoryException;
 
@@ -162,7 +162,7 @@
      * Build a qualified path from the specified <code>absPath</code> and test
      * if it is really absolute and points to an existing node.
      *
-     * @param absPath
+     * @param absPath Path to an existing node.
      * @throws PathNotFoundException if no node at <code>absPath</code> exists
      * or the session does not have privilege to retrieve the node.
      * @throws RepositoryException If the given <code>absPath</code> is not

Modified: jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AccessManager.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AccessManager.java?rev=752063&r1=752062&r2=752063&view=diff
==============================================================================
--- jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AccessManager.java (original)
+++ jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/AccessManager.java Tue Mar 10 11:10:44 2009
@@ -67,9 +67,9 @@
      * be thrown if the subject of the given <code>context</code> is not
      * granted access to the specified workspace.
      *
-     * @param context access manager context
-     * @param acProvider
-     * @param wspAccessMgr
+     * @param context access manager context.
+     * @param acProvider The access control provider.
+     * @param wspAccessMgr The workspace access manager.
      * @throws AccessDeniedException if the subject is not granted access
      *                               to the specified workspace.
      * @throws Exception             if another error occurs
@@ -106,10 +106,10 @@
             throws AccessDeniedException, ItemNotFoundException, RepositoryException;
 
     /**
-     *      * Determines whether the specified <code>permissions</code> are granted
+     * Determines whether the specified <code>permissions</code> are granted
      * on the item with the specified <code>id</code> (i.e. the <i>target</i> item).
      *
-     * @param absPath
+     * @param absPath Path to an item.
      * @param permissions A combination of one or more of the
      * {@link org.apache.jackrabbit.core.security.authorization.Permission}
      * constants encoded as a bitmask value.
@@ -173,7 +173,7 @@
     /**
      * Determines whether the item at the specified absolute path can be read.
      *
-     * @param itemPath
+     * @param itemPath Path to the item to be tested.s
      * @return <code>true</code> if the item can be read; otherwise <code>false</code>.
      * @throws RepositoryException if an error occurs.
      */

Modified: jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/DefaultAccessManager.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/DefaultAccessManager.java?rev=752063&r1=752062&r2=752063&view=diff
==============================================================================
--- jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/DefaultAccessManager.java (original)
+++ jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/DefaultAccessManager.java Tue Mar 10 11:10:44 2009
@@ -429,6 +429,7 @@
     }
 
     /**
+     * @param subject The subject associated with the session.
      * @return if created with system-privileges
      */
     private static boolean isSystemOrAdmin(Subject subject) {

Modified: jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/JackrabbitAccessControlManager.java
URL: http://svn.apache.org/viewvc/jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/JackrabbitAccessControlManager.java?rev=752063&r1=752062&r2=752063&view=diff
==============================================================================
--- jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/JackrabbitAccessControlManager.java (original)
+++ jackrabbit/trunk/jackrabbit-core/src/main/java/org/apache/jackrabbit/core/security/JackrabbitAccessControlManager.java Tue Mar 10 11:10:44 2009
@@ -33,7 +33,7 @@
     /**
      * Returns the editable policies for the specified <code>principal</code>.
      *
-     * @param principal
+     * @param principal A principal known to the editing session.
      * @return array of policies for the specified <code>principal</code>. Note
      * that the policy object returned must reveal the path of the node where
      * they can be applied later on using {@link AccessControlManager#setPolicy(String, org.apache.jackrabbit.api.jsr283.security.AccessControlPolicy)}.