copyright messages updated in all java filees.
[utils] / security / src / main / java / org / wamblee / security / authorization / AuthorizationService.java
index feb7053c11c125454af0d58c342b4a92b69d0d53..6bb5db27308af2e655ba06ed272fd40a4d0de1d7 100644 (file)
@@ -1,76 +1,72 @@
 /*
- * 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.
  * 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. 
- *
+ * 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.
-     *
+     * 
+     * @param aResource
+     *            Resource.
+     * @param aOperation
+     *            Operation.
+     * 
      * @return Checks whether the operation is allowed on a resource.
      */
     boolean isAllowed(Object aResource, Operation aOperation);
 
-    /**
-     * DOCUMENT ME!
-     *
-     * @param <T> DOCUMENT ME!
-     * @param aResource DOCUMENT ME!
-     * @param aOperation DOCUMENT ME!
-     *
-     * @return DOCUMENT ME!
-     */
     <T> T check(T aResource, Operation aOperation);
 
     /**
      * Gets the authorization rules.
-     *
+     * 
      * @return Rules.
      */
     AuthorizationRule[] getRules();
 
     /**
      * Appends a new authorization rule to the end.
-     *
-     * @param aRule Rule to append.
+     * 
+     * @param aRule
+     *            Rule to append.
      */
     void appendRule(AuthorizationRule aRule);
 
     /**
      * Removes a rule.
-     *
-     * @param aIndex Index of the rule to remove.
+     * 
+     * @param aIndex
+     *            Index of the rule to remove.
      */
     void removeRule(int aIndex);
 
     /**
      * Inserts a rule.
-     *
-     * @param aIndex Index of the position of the rule after insertion.
-     * @param aRule Rule to insert.
+     * 
+     * @param aIndex
+     *            Index of the position of the rule after insertion.
+     * @param aRule
+     *            Rule to insert.
      */
     void insertRuleAfter(int aIndex, AuthorizationRule aRule);
 }