X-Git-Url: http://wamblee.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=security%2Fsrc%2Fmain%2Fjava%2Forg%2Fwamblee%2Fsecurity%2Fauthorization%2FAuthorizationService.java;h=feb7053c11c125454af0d58c342b4a92b69d0d53;hb=89c06d4d52b46c154128c97d6e758fa1f4fc7a6e;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..feb7053c 100644
--- a/security/src/main/java/org/wamblee/security/authorization/AuthorizationService.java
+++ b/security/src/main/java/org/wamblee/security/authorization/AuthorizationService.java
@@ -1,69 +1,76 @@
/*
* Copyright 2005 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.
* You may obtain a copy of the License at
- *
+ *
* http://www.apache.org/licenses/LICENSE-2.0
- *
+ *
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* 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.
*
* @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.
+ * DOCUMENT ME!
+ *
+ * @param DOCUMENT ME!
+ * @param aResource DOCUMENT ME!
+ * @param aOperation DOCUMENT ME!
+ *
+ * @return DOCUMENT ME!
*/
- 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);
}