You are viewing a plain text version of this content. The canonical link for it is here.
Posted to slide-dev@jakarta.apache.org by cm...@apache.org on 2001/08/20 17:47:45 UTC

cvs commit: jakarta-slide/src/share/org/apache/slide/lock package.html

cmlenz      01/08/20 08:47:45

  Modified:    src/share/org/apache/slide/structure Structure.java
  Added:       src/share/org/apache/slide/structure package.html
               src/share/org/apache/slide/content package.html
               src/share/org/apache/slide/security package.html
               src/share/org/apache/slide/lock package.html
  Log:
  - Added JavaDoc package overview files for some of the core packages
  - Some cleanup of the JavaDoc comments for the Structure class
  
  Revision  Changes    Path
  1.8       +115 -94   jakarta-slide/src/share/org/apache/slide/structure/Structure.java
  
  Index: Structure.java
  ===================================================================
  RCS file: /home/cvs/jakarta-slide/src/share/org/apache/slide/structure/Structure.java,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- Structure.java	2001/05/29 02:42:43	1.7
  +++ Structure.java	2001/08/20 15:47:44	1.8
  @@ -1,7 +1,7 @@
   /*
  - * $Header: /home/cvs/jakarta-slide/src/share/org/apache/slide/structure/Structure.java,v 1.7 2001/05/29 02:42:43 remm Exp $
  - * $Revision: 1.7 $
  - * $Date: 2001/05/29 02:42:43 $
  + * $Header: /home/cvs/jakarta-slide/src/share/org/apache/slide/structure/Structure.java,v 1.8 2001/08/20 15:47:44 cmlenz Exp $
  + * $Revision: 1.8 $
  + * $Date: 2001/08/20 15:47:44 $
    *
    * ====================================================================
    *
  @@ -76,9 +76,11 @@
   
   /**
    * Structure helper.
  + * Provides methods to manage and navigate the hierarchy of nodes in a 
  + * namespace.
    * 
    * @author <a href="mailto:remm@apache.org">Remy Maucherat</a>
  - * @version $Revision: 1.7 $
  + * @version $Revision: 1.8 $
    */
   public interface Structure {
       
  @@ -87,15 +89,19 @@
       
       
       /**
  -     * Get object's children.
  +     * Returns the children of a node.
        * 
  -     * @param token Credentials token
  -     * @param object Slide object
  -     * @return Enumeration Enumeration of children objects
  -     * @exception ServiceAccessException Low level service access exception
  -     * @exception ObjectNotFoundException One of the children specified 
  -     * by the object were not found
  -     * @exception LinkedObjectNotFoundException Cannot happen
  +     * @param token the slide token
  +     * @param object the node
  +     * 
  +     * @return Enumeration of ObjectNode objects
  +     * 
  +     * @exception ServiceAccessException low level service access exception
  +     * @exception ObjectNotFoundException one of the children specified 
  +     *            by the object was not found
  +     * @exception LinkedObjectNotFoundException cannot happen
  +     *
  +     * @see org.apache.slide.structure.ObjectNode#enumerateChildren()
        */
       Enumeration getChildren(SlideToken token, ObjectNode object) 
           throws ServiceAccessException, ObjectNotFoundException, 
  @@ -103,19 +109,23 @@
       
       
       /**
  -     * Get object's parent.
  +     * Returns the parent of a node.
        * 
  -     * @param token Credentials token
  -     * @param object Slide object
  -     * @return ObjectNode Object's parent; null if the object specified
  -     * if the root node of the namespace
  -     * @exception ServiceAccessException Low level service access exception
  -     * @exception ObjectNotFoundException The parent object specified 
  -     * by the object was not found
  -     * @exception LinkedObjectNotFoundException Cannot happen : a link 
  -     * cannot have children
  -     * @exception AccessDeniedException Credentials token does not 
  -     * have permission to perform the action
  +     * @param token the slide token
  +     * @param object the node
  +     * 
  +     * @return the node's parent, or <code>null</code> if the object specified 
  +     *         is the root node of the namespace
  +     * 
  +     * @exception ServiceAccessException low level service access exception
  +     * @exception ObjectNotFoundException the parent object specified 
  +     *            by the object was not found
  +     * @exception LinkedObjectNotFoundException cannot happen (a link 
  +     *            cannot have children)
  +     * @exception AccessDeniedException credentials token does not 
  +     *            have permission to perform the action
  +     *
  +     * @see org.apache.slide.structure.ObjectNode#enumerateChildren()
        */
       ObjectNode getParent(SlideToken token, ObjectNode object) 
           throws ServiceAccessException, ObjectNotFoundException, 
  @@ -123,19 +133,20 @@
       
       
       /**
  -     * Get an object, following any link.
  +     * Retrieves a node by URI, following any links.
        * 
  -     * @param token Credentials token
  -     * @param strUri Object uri
  -     * @return ObjectNode Object specified by the Uri
  -     * @exception ServiceAccessException Low level service access exception
  -     * @exception ObjectNotFoundException The given Uri doesn't have 
  -     * any matching ObjectNode
  +     * @param token the slide token
  +     * @param strUri the URI of the object to retrieve
  +     * 
  +     * @return the node specified by the URI or the node linked to by the node
  +     *         at the URI.
  +     * 
  +     * @exception ServiceAccessException low level service access exception
  +     * @exception ObjectNotFoundException if no node exists at the URI
        * @exception LinkedObjectNotFoundException A link object encountered 
  -     * during Uri resolution
  -     * doesn't have a valid target
  -     * @exception AccessDeniedException Credentials token does not have 
  -     * permission to perform the action
  +     *            during URI resolution doesn't have a valid target
  +     * @exception AccessDeniedException credentials token does not have 
  +     *            permission to perform the action
        */
       ObjectNode retrieve(SlideToken token, String strUri) 
           throws ServiceAccessException, ObjectNotFoundException, 
  @@ -143,20 +154,23 @@
       
       
       /**
  -     * Get an object, following any link.
  +     * Retrieves a node by URI.
        * 
  -     * @param token Credentials token
  -     * @param strUri Object uri
  -     * @param translateLastUriElement If set to true and if the uri is 
  -     * associated with a link, the function will return the linked object. 
  -     * Otherwise, the link object is returned
  -     * @exception ServiceAccessException Low level service access exception
  -     * @exception ObjectNotFoundException The given Uri doesn't have any 
  -     * matching ObjectNode
  +     * @param token the slide token
  +     * @param strUri the URI of the object to retrieve
  +     * @param translateLastUriElement if set to true and the URI is 
  +     *        associated with a link, this method will return the target of 
  +     *        the link, otherwise the link itself is returned
  +     * 
  +     * @return the node specified by the URI, or the node linked to by the
  +     *         node at the URI, if <code>translateLastUriElement</code> is true
  +     * 
  +     * @exception ServiceAccessException low level service access exception
  +     * @exception ObjectNotFoundException if no node exists at the URI
        * @exception LinkedObjectNotFoundException A link object encountered 
  -     * during Uri resolution doesn't have a valid target
  -     * @exception AccessDeniedException Credentials token does not have 
  -     * permission to perform the action
  +     *            during URI resolution doesn't have a valid target
  +     * @exception AccessDeniedException credentials token does not have 
  +     *            permission to perform the action
        */
       ObjectNode retrieve(SlideToken token, String strUri, 
                           boolean translateLastUriElement) 
  @@ -165,21 +179,23 @@
       
       
       /**
  -     * Create an object.
  +     * Creates a new node in the namespace.
        * 
  -     * @param token Credentials token
  -     * @param object Object we want to create
  -     * @param uri Location in the namespace where we want to create the object
  -     * @exception ServiceAccessException Low level service access exception
  -     * @exception ObjectAlreadyExistException An object already exist 
  -     * at the specified Uri
  +     * @param token the slide token
  +     * @param object the object that should be created
  +     * @param strUri location in the namespace where we the object should be 
  +     *        created
  +     * 
  +     * @exception ServiceAccessException low level service access exception
  +     * @exception ObjectAlreadyExistException an object already exists 
  +     *            at the specified URI
        * @exception ObjectNotFoundException Update of the parent object 
  -     * failed because the parent object does no longer exist. Should not 
  -     * happen, and indicate a critical error
  -     * @exception LinkedObjectNotFoundException Retrieval of a link target 
  -     * failed during Uri resolution
  -     * @exception AccessDeniedException Credentials token does not have 
  -     * permission to perform the action
  +     *            failed because the parent object does no longer exist. 
  +     *            Should not happen, and indicates a critical error if it does
  +     * @exception LinkedObjectNotFoundException retrieval of a link target 
  +     *            failed during URI resolution
  +     * @exception AccessDeniedException credentials token does not have 
  +     *            permission to perform the action
        */
       void create(SlideToken token, ObjectNode object, String strUri)
           throws ServiceAccessException, ObjectAlreadyExistsException, 
  @@ -188,23 +204,24 @@
       
       
       /**
  -     * Create a link.
  +     * Creates a link to another node in the namespace.
        * 
  -     * @param token Credentials token
  -     * @param link Link object we want to create
  -     * @param linkUri Location in the namespace where we want to create 
  -     * the object
  -     * @param linkedObject Link target
  +     * @param token the slide token
  +     * @param link the link object that should be created
  +     * @param linkUri location in the namespace where the link object should 
  +     *        be created
  +     * @param linkedObject target object of the link
  +     * 
        * @exception ServiceAccessException Low level service access exception
        * @exception ObjectAlreadyExistException An object already exist 
  -     * at the specified Uri
  +     *            at the specified URI
        * @exception ObjectNotFoundException Update of the parent object 
  -     * failed because the parent object does no longer exist. Should not 
  -     * happen, and indicate a critical error
  +     *            failed because the parent object does no longer exist. 
  +     *            Should not happen, and indicate a critical error if it does
        * @exception LinkedObjectNotFoundException Retrieval of a link target 
  -     * failed during Uri resolution
  -     * @exception AccessDeniedException Credentials token does not have 
  -     * permission to perform the action
  +     *            failed during Uri resolution
  +     * @exception AccessDeniedException credentials token does not have 
  +     *            permission to perform the action
        */
       void createLink(SlideToken token, LinkNode link, String linkUri, 
                       ObjectNode linkedObject)
  @@ -214,17 +231,18 @@
       
       
       /**
  -     * Store (ie, update) an object.
  +     * Stores/updates an object.
        * 
  -     * @param token Credentials token
  -     * @param object Object to update
  -     * @exception ServiceAccessException Low level service access exception
  -     * @exception ObjectNotFoundException The update failed because one 
  -     * object was not found during Uri resolution
  -     * @exception LinkedObjectNotFoundException Retrieval of a link target 
  -     * failed during Uri resolution
  -     * @exception AccessDeniedException Credentials token does not have 
  -     * permission to perform the action
  +     * @param token the slide token
  +     * @param object the object to update
  +     * 
  +     * @exception ServiceAccessException low level service access exception
  +     * @exception ObjectNotFoundException the update failed because one 
  +     *            object was not found during URI resolution
  +     * @exception LinkedObjectNotFoundException retrieval of a link target 
  +     *            failed during URI resolution
  +     * @exception AccessDeniedException credentials token does not have 
  +     *            permission to perform the action
        */
       void store(SlideToken token, ObjectNode object)
           throws ServiceAccessException, ObjectNotFoundException, 
  @@ -232,23 +250,26 @@
       
       
       /**
  -     * Remove an object.
  +     * Removes a node from the namespace.
        * 
  -     * @param token Credentials token
  -     * @param object Slide object to remove
  -     * @exception ServiceAccessException Low level service access exception
  -     * @exception ObjectNotFoundException The update failed because one 
  -     * object was not found during Uri resolution
  -     * @exception ObjectHasChildrenException Removal failed because object 
  -     * has children
  -     * @exception LinkedObjectNotFoundException Retrieval of a link target 
  -     * failed during Uri resolution
  -     * @exception AccessDeniedException Credentials token does not have 
  -     * permission to perform the action
  +     * @param token the slide token
  +     * @param object the node to remove
  +     * 
  +     * @exception ServiceAccessException low level service access exception
  +     * @exception ObjectNotFoundException the update failed because an 
  +     *            object was not found during URI resolution
  +     * @exception ObjectHasChildrenException removal failed because object 
  +     *            has children
  +     * @exception LinkedObjectNotFoundException retrieval of a link target 
  +     *            failed during URI resolution
  +     * @exception AccessDeniedException credentials token does not have 
  +     *            permission to perform the action
        */
       void remove(SlideToken token, ObjectNode object)
           throws ServiceAccessException, ObjectNotFoundException, 
           ObjectHasChildrenException, AccessDeniedException, 
           LinkedObjectNotFoundException, ObjectLockedException;
       
  +    
   }
  +
  
  
  
  1.1                  jakarta-slide/src/share/org/apache/slide/structure/package.html
  
  Index: package.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  <html>
    
    <head>
      <!-- 
        
        $Header: /home/cvs/jakarta-slide/src/share/org/apache/slide/structure/package.html,v 1.1 2001/08/20 15:47:44 cmlenz Exp $
        $Revision: 1.1 $
        $Date: 2001/08/20 15:47:44 $
        
        ====================================================================
        
        The Apache Software License, Version 1.1
        
        Copyright (c) 1999 The Apache Software Foundation.  All rights
        reserved.
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions
        are met:
        
        1. Redistributions of source code must retain the above copyright
           notice, this list of conditions and the following disclaimer.
           
        2. Redistributions in binary form must reproduce the above copyright
           notice, this list of conditions and the following disclaimer in
           the documentation and/or other materials provided with the
           distribution.
           
        3. The end-user documentation included with the redistribution, if
           any, must include the following acknowlegement:
              "This product includes software developed by the
               Apache Software Foundation (http://www.apache.org/)."
           Alternately, this acknowlegement may appear in the software itself,
           if and wherever such third-party acknowlegements normally appear.
           
        4. The names "The Jakarta Project", "Tomcat", and "Apache Software
           Foundation" must not be used to endorse or promote products derived
           from this software without prior written permission. For written
           permission, please contact apache@apache.org.
           
        5. Products derived from this software may not be called "Apache"
           nor may "Apache" appear in their names without prior written
           permission of the Apache Group.
           
        THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
        WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
        OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
        DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
        ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
        SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
        LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
        USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
        ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
        OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        SUCH DAMAGE.
        ====================================================================
        
        This software consists of voluntary contributions made by many
        individuals on behalf of the Apache Software Foundation.  For more
        information on the Apache Software Foundation, please see
        <http://www.apache.org/>.
        
        [Additional notices, if required by prior licensing conditions]
        
      -->
    </head>
    
    <body>
      <p>
        Provides classes for navigating and manipulating the hierarchy of nodes 
        in a namespace.
      </p>
      <h3>Nodes</h3>
      <p>
        The hierarchy of a namespace is composed of nodes. Each node can have 
        children (called sub-nodes). Just like in a filesystem, nodes have 
        different types. 
        {@link org.apache.slide.structure.ObjectNode ObjectNode} is an abstract 
        data type that represents a node in the namespace structure. A node can 
        be either of the following concrete types:
      </p>
      <ul>
        <li>
          {@link org.apache.slide.structure.SubjectNode SubjectNode} is a type 
          for storing most Slide information. A subject can be a file, a 
          directory or a principal.
        </li>
        <li>
          {@link org.apache.slide.structure.GroupNode GroupNode} is a type used 
          to define groups of nodes, usually groups of users.
        </li>
        <li>
          {@link org.apache.slide.structure.LinkNode LinkNode} represents a node 
          that is a link to another node in the same namespace.
        </li>
        <li>
          {@link org.apache.slide.structure.ActionNode ActionNode} is a type for 
          defining available actions on Slide objects. In Slide, actions can be 
          dynamically placed in the namespace to provide flexible security 
          policy definition.
        </li>
      </ul>
      <p>
        The type of the node determines which roles the node has. See the 
        {@link org.apache.slide.security Security} package for more information 
        on roles.
      </p>
      <h3>Structure Helper</h3>
      <p>
        The central point in this package is the 
        {@link org.apache.slide.structure.Structure Structure} 
        interface, also referred to as the Structure Helper, which you can 
        access by calling 
        {@link org.apache.slide.common.NamespaceAccessToken#getStructureHelper() 
         NamespaceAccessToken.getStructureHelper()}. 
        It provides all the methods required to access and manipulate the node 
        hierarchy of a namespace.
      </p>
    </body>
    
  </html>
  
  
  
  1.1                  jakarta-slide/src/share/org/apache/slide/content/package.html
  
  Index: package.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  <html>
    
    <head>
      <!-- 
        
        $Header: /home/cvs/jakarta-slide/src/share/org/apache/slide/content/package.html,v 1.1 2001/08/20 15:47:44 cmlenz Exp $
        $Revision: 1.1 $
        $Date: 2001/08/20 15:47:44 $
        
        ====================================================================
        
        The Apache Software License, Version 1.1
        
        Copyright (c) 1999 The Apache Software Foundation.  All rights
        reserved.
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions
        are met:
        
        1. Redistributions of source code must retain the above copyright
           notice, this list of conditions and the following disclaimer.
           
        2. Redistributions in binary form must reproduce the above copyright
           notice, this list of conditions and the following disclaimer in
           the documentation and/or other materials provided with the
           distribution.
           
        3. The end-user documentation included with the redistribution, if
           any, must include the following acknowlegement:
              "This product includes software developed by the
               Apache Software Foundation (http://www.apache.org/)."
           Alternately, this acknowlegement may appear in the software itself,
           if and wherever such third-party acknowlegements normally appear.
           
        4. The names "The Jakarta Project", "Tomcat", and "Apache Software
           Foundation" must not be used to endorse or promote products derived
           from this software without prior written permission. For written
           permission, please contact apache@apache.org.
           
        5. Products derived from this software may not be called "Apache"
           nor may "Apache" appear in their names without prior written
           permission of the Apache Group.
           
        THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
        WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
        OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
        DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
        ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
        SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
        LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
        USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
        ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
        OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        SUCH DAMAGE.
        ====================================================================
        
        This software consists of voluntary contributions made by many
        individuals on behalf of the Apache Software Foundation.  For more
        information on the Apache Software Foundation, please see
        <http://www.apache.org/>.
        
        [Additional notices, if required by prior licensing conditions]
        
      -->
    </head>
    
    <body>
      <p>
        Provides classes for accessing and manipulating the content, metadata 
        and revision history of nodes in a namespace.
      </p>
    </body>
    
  </html>
  
  
  
  1.1                  jakarta-slide/src/share/org/apache/slide/security/package.html
  
  Index: package.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  <html>
    
    <head>
      <!-- 
        
        $Header: /home/cvs/jakarta-slide/src/share/org/apache/slide/security/package.html,v 1.1 2001/08/20 15:47:45 cmlenz Exp $
        $Revision: 1.1 $
        $Date: 2001/08/20 15:47:45 $
        
        ====================================================================
        
        The Apache Software License, Version 1.1
        
        Copyright (c) 1999 The Apache Software Foundation.  All rights
        reserved.
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions
        are met:
        
        1. Redistributions of source code must retain the above copyright
           notice, this list of conditions and the following disclaimer.
           
        2. Redistributions in binary form must reproduce the above copyright
           notice, this list of conditions and the following disclaimer in
           the documentation and/or other materials provided with the
           distribution.
           
        3. The end-user documentation included with the redistribution, if
           any, must include the following acknowlegement:
              "This product includes software developed by the
               Apache Software Foundation (http://www.apache.org/)."
           Alternately, this acknowlegement may appear in the software itself,
           if and wherever such third-party acknowlegements normally appear.
           
        4. The names "The Jakarta Project", "Tomcat", and "Apache Software
           Foundation" must not be used to endorse or promote products derived
           from this software without prior written permission. For written
           permission, please contact apache@apache.org.
           
        5. Products derived from this software may not be called "Apache"
           nor may "Apache" appear in their names without prior written
           permission of the Apache Group.
           
        THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
        WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
        OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
        DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
        ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
        SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
        LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
        USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
        ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
        OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        SUCH DAMAGE.
        ====================================================================
        
        This software consists of voluntary contributions made by many
        individuals on behalf of the Apache Software Foundation.  For more
        information on the Apache Software Foundation, please see
        <http://www.apache.org/>.
        
        [Additional notices, if required by prior licensing conditions]
        
      -->
    </head>
    
    <body>
      <p>
        Provides classes to access and manipulate permissions on nodes in a 
        namespace.
      </p>
    </body>
    
  </html>
  
  
  
  1.1                  jakarta-slide/src/share/org/apache/slide/lock/package.html
  
  Index: package.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  <html>
    
    <head>
      <!-- 
        
        $Header: /home/cvs/jakarta-slide/src/share/org/apache/slide/lock/package.html,v 1.1 2001/08/20 15:47:45 cmlenz Exp $
        $Revision: 1.1 $
        $Date: 2001/08/20 15:47:45 $
        
        ====================================================================
        
        The Apache Software License, Version 1.1
        
        Copyright (c) 1999 The Apache Software Foundation.  All rights
        reserved.
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions
        are met:
        
        1. Redistributions of source code must retain the above copyright
           notice, this list of conditions and the following disclaimer.
           
        2. Redistributions in binary form must reproduce the above copyright
           notice, this list of conditions and the following disclaimer in
           the documentation and/or other materials provided with the
           distribution.
           
        3. The end-user documentation included with the redistribution, if
           any, must include the following acknowlegement:
              "This product includes software developed by the
               Apache Software Foundation (http://www.apache.org/)."
           Alternately, this acknowlegement may appear in the software itself,
           if and wherever such third-party acknowlegements normally appear.
           
        4. The names "The Jakarta Project", "Tomcat", and "Apache Software
           Foundation" must not be used to endorse or promote products derived
           from this software without prior written permission. For written
           permission, please contact apache@apache.org.
           
        5. Products derived from this software may not be called "Apache"
           nor may "Apache" appear in their names without prior written
           permission of the Apache Group.
           
        THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
        WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
        OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
        DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
        ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
        SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
        LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
        USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
        ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
        OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        SUCH DAMAGE.
        ====================================================================
        
        This software consists of voluntary contributions made by many
        individuals on behalf of the Apache Software Foundation.  For more
        information on the Apache Software Foundation, please see
        <http://www.apache.org/>.
        
        [Additional notices, if required by prior licensing conditions]
        
      -->
    </head>
    
    <body>
      <p>
        Provides classes to access and manipulate locks on nodes in a namespace.
      </p>
    </body>
    
  </html>