PermissionAnnotationHandler (Apache Shiro :: Core 1.7.1 API)

- org.apache.shiro.aop.AnnotationHandler
- - org.apache.shiro.authz.aop.AuthorizingAnnotationHandler
  - - org.apache.shiro.authz.aop.PermissionAnnotationHandler

```
public class PermissionAnnotationHandler
extends AuthorizingAnnotationHandler
```
Checks to see if a @RequiresPermissions annotation is declared, and if so, performs a permission check to see if the calling Subject is allowed continued access.

Since:

0.9.0

Field Summary
- Fields inherited from class org.apache.shiro.aop.AnnotationHandler
  annotationClass

Constructor Summary

Constructors
Constructor Description

PermissionAnnotationHandler()
Default no-argument constructor that ensures this handler looks for RequiresPermissions annotations.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`a)`	Ensures that the calling `Subject` has the Annotation's specified permissions, and if not, throws an `AuthorizingException` indicating access is denied.
`protected []`	`a)`	Returns the annotation `value`, from which the Permission will be constructed.

Methods inherited from class org.apache.shiro.aop.AnnotationHandler
getAnnotationClass, getSubject, setAnnotationClass

Methods inherited from class java.lang.
, , , , , , , , , ,

- Constructor Detail
  - PermissionAnnotationHandler
```
public PermissionAnnotationHandler()
```
    Default no-argument constructor that ensures this handler looks for RequiresPermissions annotations.
- Method Detail
  - getAnnotationValue
```
protected [] getAnnotationValue( a)
```
    Returns the annotation value, from which the Permission will be constructed.
    
    Parameters:
    
    a - the RequiresPermissions annotation being inspected.
    
    Returns:
    
    the annotation's value, from which the Permission will be constructed.
  - assertAuthorized
```
public void assertAuthorized( a)
                      throws AuthorizationException
```
    Ensures that the calling Subject has the Annotation's specified permissions, and if not, throws an AuthorizingException indicating access is denied.
    
    Specified by:
    
    assertAuthorized in class AuthorizingAnnotationHandler
    
    Parameters:
    
    a - the RequiresPermission annotation being inspected to check for one or more permissions
    
    Throws:
    
    AuthorizationException - if the calling Subject does not have the permission(s) necessary to continue access or execution.