Source Code Cross Referenced for Acl.java in  » Wiki-Engine » JSPWiki » com » ecyrd » jspwiki » auth » acl » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » Wiki Engine » JSPWiki » com.ecyrd.jspwiki.auth.acl 
Source Cross Referenced  Class Diagram Java Document (Java Doc) 


001:        /*
002:         JSPWiki - a JSP-based WikiWiki clone.
003:
004:         Copyright (C) 2001-2002 Janne Jalkanen (Janne.Jalkanen@iki.fi)
005:
006:         This program is free software; you can redistribute it and/or modify
007:         it under the terms of the GNU Lesser General Public License as published by
008:         the Free Software Foundation; either version 2.1 of the License, or
009:         (at your option) any later version.
010:
011:         This program is distributed in the hope that it will be useful,
012:         but WITHOUT ANY WARRANTY; without even the implied warranty of
013:         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
014:         GNU Lesser General Public License for more details.
015:
016:         You should have received a copy of the GNU Lesser General Public License
017:         along with this program; if not, write to the Free Software
018:         Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
019:         */
020:        package com.ecyrd.jspwiki.auth.acl;
021:
022:        import java.security.Permission;
023:        import java.security.Principal;
024:        import java.util.Enumeration;
025:
026:        /**
027:         * <p>
028:         * Defines an access control list (ACL) for wiki pages. An Access Control List
029:         * is a data structure used to guard access to resources. An ACL can be thought
030:         * of as a data structure with multiple ACL entries. Each ACL entry, of
031:         * interface type AclEntry, contains a set of positive permissions associated
032:         * with a particular principal. (A principal represents an entity such as an
033:         * individual user or a group). The ACL Entries in each ACL observe the
034:         * following rules:
035:         * </p>
036:         * <ul>
037:         * <li>Each principal can have at most one ACL entry; that is, multiple ACL
038:         * entries are not allowed for any principal. Each entry specifies the set of
039:         * permissions that are to be granted</li>
040:         * <li>If there is no entry for a particular principal, then the principal is
041:         * considered to have a null (empty) permission set</li>
042:         * </ul>
043:         * <p>
044:         * This interface is a highly stripped-down derivation of the
045:         * java.security.acl.Acl interface. In particular, the notion of an Acl "owner"
046:         * has been eliminated, since JWPWiki pages do not have owners. An additional
047:         * simplification compared to the standard Java package is that negative
048:         * permissions have been eliminated. Instead, JSPWiki assumes a "default-deny"
049:         * security stance: principals are granted no permissions by default, and
050:         * posesses only those that have been explicitly granted to them. And finally,
051:         * the getPermissions() and checkPermission() methods have been eliminated due
052:         * to the complexities associated with resolving Role principal membership.
053:         * </p>
054:         * @author Janne Jalkanen
055:         * @author Andrew Jaquith
056:         * @since 2.3
057:         */
058:        public interface Acl {
059:            /**
060:             * Adds an ACL entry to this ACL. An entry associates a principal (e.g., an
061:             * individual or a group) with a set of permissions. Each principal can have
062:             * at most one positive ACL entry, specifying permissions to be granted to
063:             * the principal. If there is already an ACL entry already in the ACL, false
064:             * is returned.
065:             * @param entry - the ACL entry to be added to this ACL
066:             * @return true on success, false if an entry of the same type (positive or
067:             *         negative) for the same principal is already present in this ACL
068:             */
069:            public boolean addEntry(AclEntry entry);
070:
071:            /**
072:             * Returns an enumeration of the entries in this ACL. Each element in the
073:             * enumeration is of type AclEntry.
074:             * @return an enumeration of the entries in this ACL.
075:             */
076:            public Enumeration entries();
077:
078:            /**
079:             * Returns <code>true</code>, if this Acl is empty.
080:             * @return the result
081:             * @since 2.4.68
082:             */
083:            public boolean isEmpty();
084:
085:            /**
086:             * Returns all Principal objects assigned a given Permission in the access
087:             * control list. The Princiapls returned are those that have been granted
088:             * either the supplied permission, or a permission implied by the supplied
089:             * permission. Principals are not "expanded" if they are a role or group.
090:             * @param permission the permission to search for
091:             * @return an array of Principals posessing the permission
092:             */
093:            public Principal[] findPrincipals(Permission permission);
094:
095:            /**
096:             * Returns an AclEntry for a supplied Principal, or <code>null</code> if
097:             * the Principal does not have a matching AclEntry.
098:             * @param principal the principal to search for
099:             * @return the AclEntry associated with the principal, or <code>null</code>
100:             */
101:            public AclEntry getEntry(Principal principal);
102:
103:            /**
104:             * Removes an ACL entry from this ACL.
105:             * @param entry the ACL entry to be removed from this ACL
106:             * @return true on success, false if the entry is not part of this ACL
107:             */
108:            public boolean removeEntry(AclEntry entry);
109:
110:            /**
111:             * Returns a string representation of the contents of this Acl.
112:             * @return the string representation
113:             */
114:            public String toString();
115:
116:        }
www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.