X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;f=security%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Fsecurity%2Fauthorization%2FAuthorizationService.java;h=6bb5db27308af2e655ba06ed272fd40a4d0de1d7;hb=b55898f1f5b788c9a5fcbb06cd79ffb211aff3de;hp=0115062247eb1f0b79dccefc21f59b220efa602f;hpb=42515fd88bee97ebb3a3180fdcb320faf5fa1d91;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
- * RuntimeException
in case access is not allowed.
- * @param aResource Resource to check.
- * @param aOperation Operation to perform.
- * @return Resource that was checked.
- */
- T check(T aResource, Operation aOperation);
-
+
+ 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);
}