X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=security%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Fsecurity%2Fauthorization%2FAuthorizationService.java;h=6bb5db27308af2e655ba06ed272fd40a4d0de1d7;hb=17775e14ecfb286e59f67117e5cee7e21e95ab1f;hp=0115062247eb1f0b79dccefc21f59b220efa602f;hpb=532f7219273021ef3652e0abe1326b7aeed1f30a;p=utils

diff --git a/security/src/main/java/org/wamblee/security/authorization/AuthorizationService.java b/security/src/main/java/org/wamblee/security/authorization/AuthorizationService.java
index 01150622..6bb5db27 100644
--- a/security/src/main/java/org/wamblee/security/authorization/AuthorizationService.java
+++ b/security/src/main/java/org/wamblee/security/authorization/AuthorizationService.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2005 the original author or authors.
+ * Copyright 2005-2010 the original author or authors.
  * 
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,57 +13,60 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */ 
-
 package org.wamblee.security.authorization;
 
 import org.wamblee.persistence.Persistent;
 
 /**
- * Service to determine if access to a certain resource is allowed. 
- *
+ * Service to determine if access to a certain resource is allowed.
+ * 
  * @author Erik Brakkee
  */
 public interface AuthorizationService extends Persistent {
-
     /**
-     * Checks whether an operation is allowed on a resource. 
-     * @param aResource Resource. 
-     * @param aOperation Operation. 
-     * @return Checks whether the operation is allowed on a resource. 
+     * Checks whether an operation is allowed on a resource.
+     * 
+     * @param aResource
+     *            Resource.
+     * @param aOperation
+     *            Operation.
+     * 
+     * @return Checks whether the operation is allowed on a resource.
      */
     boolean isAllowed(Object aResource, Operation aOperation);
-    
-    /**
-     * Same as {@link #isAllowed(Object, Operation)} but throws a 
-     * <code>RuntimeException</code> in case access is not allowed. 
-     * @param aResource Resource to check. 
-     * @param aOperation Operation to perform.
-     * @return Resource that was checked. 
-     */
-    <T> T check(T aResource, Operation aOperation); 
-    
+
+    <T> T check(T aResource, Operation aOperation);
+
     /**
-     * Gets the authorization rules. 
-     * @return Rules. 
+     * Gets the authorization rules.
+     * 
+     * @return Rules.
      */
-    AuthorizationRule[] getRules(); 
-    
+    AuthorizationRule[] getRules();
+
     /**
-     * Appends a new authorization rule to the end. 
-     * @param aRule Rule to append. 
+     * Appends a new authorization rule to the end.
+     * 
+     * @param aRule
+     *            Rule to append.
      */
-    void appendRule(AuthorizationRule aRule); 
-    
+    void appendRule(AuthorizationRule aRule);
+
     /**
-     * Removes a rule. 
-     * @param aRule Index of the rule to remove.  
+     * Removes a rule.
+     * 
+     * @param aIndex
+     *            Index of the rule to remove.
      */
-    void removeRule(int aIndex); 
-        
+    void removeRule(int aIndex);
+
     /**
-     * Inserts a rule. 
-     * @param aIndex Index of the position of the rule after insertion. 
-     * @param aRule Rule to insert. 
+     * Inserts a rule.
+     * 
+     * @param aIndex
+     *            Index of the position of the rule after insertion.
+     * @param aRule
+     *            Rule to insert.
      */
     void insertRuleAfter(int aIndex, AuthorizationRule aRule);
 }