https://github.com/sdorra/shiro-static-permissions

AnnotationProcessor which generates static shiro permission check objects
https://github.com/sdorra/shiro-static-permissions

annotationprocessor java permissions security shiro

Last synced: 25 days ago
JSON representation

AnnotationProcessor which generates static shiro permission check objects

• Host: GitHub
• URL: https://github.com/sdorra/shiro-static-permissions
• Owner: sdorra
• Created: 2016-10-01T14:09:51.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2024-01-16T20:45:30.000Z (10 months ago)
• Last Synced: 2024-04-14T03:13:05.999Z (7 months ago)
• Topics: annotationprocessor, java, permissions, security, shiro
• Language: Java
• Size: 96.7 KB
• Stars: 0
• Watchers: 4
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Shiro Static Permissions

[![Build Status](https://travis-ci.org/sdorra/shiro-static-permissions.svg?branch=master)](https://travis-ci.org/sdorra/shiro-static-permissions)

[![Quality Gates](https://sonarcloud.io/api/project_badges/measure?project=com.github.sdorra%3Assp&metric=alert_status)](https://sonarcloud.io/dashboard?id=com.github.sdorra%3Assp)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=com.github.sdorra%3Assp&metric=coverage)](https://sonarcloud.io/dashboard?id=com.github.sdorra%3Assp)

[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=com.github.sdorra%3Assp&metric=sqale_index)](https://sonarcloud.io/dashboard?id=com.github.sdorra%3Assp)

[![JitPack](https://www.jitpack.io/v/sdorra/shiro-static-permissions.svg)](https://www.jitpack.io/#sdorra/shiro-static-permissions)

Shiro Static Permissions consists of two parts an AnnotationProcessor and a small library.

The AnnotationProcessor generates classes for static permission checks with [Apache Shrio](http://shiro.apache.org/)

which allows checks like the following:

```java

// check for repository create permission

if (RepositoryPermissions.create().isPermitted()) {

    // create repository

}

// throw exception if the user lacks create permission

RepositoryPermissions.create().check();

// check for repository 123 delete permission

if (RepositoryPermissions.delete("123").isPermitted()) {

    // delete repository

}

// throw exception if the user lacks delete permission for repository 123

RepositoryPermissions.delete(new Repository("123")).check();

```

## Usage

```xml

    com.github.sdorra

    ssp-lib

    x.y.z

    com.github.sdorra

    ssp-processor

    x.y.z

    true

```

```java

@StaticPermissions("repositories")

public class Repository implements PermissionObject {

  private final String id;

  

  public Repository(String id) {

    this.id = id;

  }

  

  @Override

  public String getId() {

    return id;

  }

}

```

## Real world example

[SCM-Manager](https://scm-manager.org):

* Annotation: [`User`](https://github.com/scm-manager/scm-manager/blob/3f018c22557eb2e7804f0c4e9100121992b760b2/scm-core/src/main/java/sonia/scm/user/User.java#L51)

* Permission Check: [`UserManager`](https://github.com/scm-manager/scm-manager/blob/3f018c22557eb2e7804f0c4e9100121992b760b2/scm-webapp/src/main/java/sonia/scm/user/DefaultUserManager.java#L250)