org.casbin.jcasbin.main

Class SyncedEnforcer

java.lang.Object

org.casbin.jcasbin.main.CoreEnforcer

org.casbin.jcasbin.main.ManagementEnforcer

org.casbin.jcasbin.main.Enforcer

org.casbin.jcasbin.main.SyncedEnforcer

public class SyncedEnforcer
extends Enforcer

SyncedEnforcer = ManagementEnforcer + RBAC API.

Constructor Summary

Constructors

Constructor and Description
SyncedEnforcer() ; SyncedEnforcer is the default constructor.
SyncedEnforcer(Model m) SyncedEnforcer initializes an enforcer with a model.
SyncedEnforcer(Model m, Adapter adapter) SyncedEnforcer initializes an enforcer with a model and a database adapter.
SyncedEnforcer(java.lang.String modelPath) SyncedEnforcer initializes an enforcer with a model file.
SyncedEnforcer(java.lang.String modelPath, Adapter adapter) SyncedEnforcer initializes an enforcer with a database adapter.
SyncedEnforcer(java.lang.String modelPath, java.lang.String policyFile) SyncedEnforcer initializes an enforcer with a model file and a policy file.
SyncedEnforcer(java.lang.String modelPath, java.lang.String policyFile, boolean enableLog) SyncedEnforcer initializes an enforcer with a model file, a policy file and an enable log flag.

Method Summary

Modifier and Type	Method and Description
boolean	addPermissionForUser(java.lang.String user, java.util.List<java.lang.String> permission) addPermissionForUser adds a permission for a user or role.
boolean	addPermissionForUser(java.lang.String user, java.lang.String... permission) addPermissionForUser adds a permission for a user or role.
boolean	addRoleForUser(java.lang.String user, java.lang.String role) addRoleForUser adds a role for a user.
boolean	addRoleForUserInDomain(java.lang.String user, java.lang.String role, java.lang.String domain) addRoleForUserInDomain adds a role for a user inside a domain.
boolean	deletePermission(java.util.List<java.lang.String> permission) deletePermission deletes a permission.
boolean	deletePermission(java.lang.String... permission) deletePermission deletes a permission.
boolean	deletePermissionForUser(java.lang.String user, java.util.List<java.lang.String> permission) deletePermissionForUser deletes a permission for a user or role.
boolean	deletePermissionForUser(java.lang.String user, java.lang.String... permission) deletePermissionForUser deletes a permission for a user or role.
boolean	deletePermissionsForUser(java.lang.String user) deletePermissionsForUser deletes permissions for a user or role.
void	deleteRole(java.lang.String role) deleteRole deletes a role.
boolean	deleteRoleForUser(java.lang.String user, java.lang.String role) deleteRoleForUser deletes a role for a user.
boolean	deleteRoleForUserInDomain(java.lang.String user, java.lang.String role, java.lang.String domain) deleteRoleForUserInDomain deletes a role for a user inside a domain.
boolean	deleteRolesForUser(java.lang.String user) deleteRolesForUser deletes all roles for a user.
boolean	deleteUser(java.lang.String user) deleteUser deletes a user.
java.util.List<java.util.List<java.lang.String>>	getImplicitPermissionsForUser(java.lang.String user) getImplicitPermissionsForUser gets implicit permissions for a user or role.
java.util.List<java.lang.String>	getImplicitRolesForUser(java.lang.String name, java.lang.String... domain) getImplicitRolesForUser gets implicit roles that a user has.
java.util.List<java.util.List<java.lang.String>>	getPermissionsForUser(java.lang.String user) getPermissionsForUser gets permissions for a user or role.
java.util.List<java.util.List<java.lang.String>>	getPermissionsForUserInDomain(java.lang.String user, java.lang.String domain) getPermissionsForUserInDomain gets permissions for a user or role inside a domain.
java.util.List<java.lang.String>	getRolesForUser(java.lang.String name) getRolesForUser gets the roles that a user has.
java.util.List<java.lang.String>	getRolesForUserInDomain(java.lang.String name, java.lang.String domain) getRolesForUserInDomain gets the roles that a user has inside a domain.
java.util.List<java.lang.String>	getUsersForRole(java.lang.String name) getUsersForRole gets the users that has a role.
boolean	hasPermissionForUser(java.lang.String user, java.util.List<java.lang.String> permission) hasPermissionForUser determines whether a user has a permission.
boolean	hasPermissionForUser(java.lang.String user, java.lang.String... permission) hasPermissionForUser determines whether a user has a permission.
boolean	hasRoleForUser(java.lang.String name, java.lang.String role) hasRoleForUser determines whether a user has a role.

Methods inherited from class org.casbin.jcasbin.main.ManagementEnforcer

addFunction, addGroupingPolicy, addGroupingPolicy, addNamedGroupingPolicy, addNamedGroupingPolicy, addNamedPolicy, addNamedPolicy, addPolicy, addPolicy, getAllActions, getAllNamedActions, getAllNamedObjects, getAllNamedRoles, getAllNamedSubjects, getAllObjects, getAllRoles, getAllSubjects, getFilteredGroupingPolicy, getFilteredNamedGroupingPolicy, getFilteredNamedPolicy, getFilteredPolicy, getGroupingPolicy, getNamedGroupingPolicy, getNamedPolicy, getPolicy, hasGroupingPolicy, hasGroupingPolicy, hasNamedGroupingPolicy, hasNamedGroupingPolicy, hasNamedPolicy, hasNamedPolicy, hasPolicy, hasPolicy, removeFilteredGroupingPolicy, removeFilteredNamedGroupingPolicy, removeFilteredNamedPolicy, removeFilteredPolicy, removeGroupingPolicy, removeGroupingPolicy, removeNamedGroupingPolicy, removeNamedGroupingPolicy, removeNamedPolicy, removeNamedPolicy, removePolicy, removePolicy

Methods inherited from class org.casbin.jcasbin.main.CoreEnforcer

buildRoleLinks, clearPolicy, enableAutoBuildRoleLinks, enableAutoSave, enableEnforce, enableLog, enforce, getAdapter, getModel, isFiltered, loadFilteredPolicy, loadModel, loadPolicy, newModel, newModel, newModel, savePolicy, setAdapter, setEffector, setModel, setRoleManager, setWatcher, validateEnforce

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SyncedEnforcer

public SyncedEnforcer()

; SyncedEnforcer is the default constructor.

SyncedEnforcer

public SyncedEnforcer(java.lang.String modelPath,
                      java.lang.String policyFile)

SyncedEnforcer initializes an enforcer with a model file and a policy file.

Parameters:

modelPath - the path of the model file.

policyFile - the path of the policy file.

SyncedEnforcer

public SyncedEnforcer(java.lang.String modelPath,
                      Adapter adapter)

SyncedEnforcer initializes an enforcer with a database adapter.

Parameters:

modelPath - the path of the model file.

adapter - the adapter.

SyncedEnforcer

public SyncedEnforcer(Model m,
                      Adapter adapter)

SyncedEnforcer initializes an enforcer with a model and a database adapter.

Parameters:

m - the model.

adapter - the adapter.

SyncedEnforcer

public SyncedEnforcer(Model m)

SyncedEnforcer initializes an enforcer with a model.

Parameters:

m - the model.

SyncedEnforcer

public SyncedEnforcer(java.lang.String modelPath)

SyncedEnforcer initializes an enforcer with a model file.

Parameters:

modelPath - the path of the model file.

SyncedEnforcer

public SyncedEnforcer(java.lang.String modelPath,
                      java.lang.String policyFile,
                      boolean enableLog)

SyncedEnforcer initializes an enforcer with a model file, a policy file and an enable log flag.

Parameters:

modelPath - the path of the model file.

policyFile - the path of the policy file.

enableLog - whether to enable Casbin's log.

Method Detail

getRolesForUser

public java.util.List<java.lang.String> getRolesForUser(java.lang.String name)

getRolesForUser gets the roles that a user has.

Overrides:

getRolesForUser in class Enforcer

Parameters:

name - the user.

Returns:

the roles that the user has.

getUsersForRole

public java.util.List<java.lang.String> getUsersForRole(java.lang.String name)

getUsersForRole gets the users that has a role.

Overrides:

getUsersForRole in class Enforcer

Parameters:

name - the role.

Returns:

the users that has the role.

hasRoleForUser

public boolean hasRoleForUser(java.lang.String name,
                              java.lang.String role)

hasRoleForUser determines whether a user has a role.

Overrides:

hasRoleForUser in class Enforcer

Parameters:

name - the user.

role - the role.

Returns:

whether the user has the role.

addRoleForUser

public boolean addRoleForUser(java.lang.String user,
                              java.lang.String role)

addRoleForUser adds a role for a user. Returns false if the user already has the role (aka not affected).

Overrides:

addRoleForUser in class Enforcer

Parameters:

user - the user.

role - the role.

Returns:

succeeds or not.

deleteRoleForUser

public boolean deleteRoleForUser(java.lang.String user,
                                 java.lang.String role)

deleteRoleForUser deletes a role for a user. Returns false if the user does not have the role (aka not affected).

Overrides:

deleteRoleForUser in class Enforcer

Parameters:

user - the user.

role - the role.

Returns:

succeeds or not.

deleteRolesForUser

public boolean deleteRolesForUser(java.lang.String user)

deleteRolesForUser deletes all roles for a user. Returns false if the user does not have any roles (aka not affected).

Overrides:

deleteRolesForUser in class Enforcer

Parameters:

user - the user.

Returns:

succeeds or not.

deleteUser

public boolean deleteUser(java.lang.String user)

deleteUser deletes a user. Returns false if the user does not exist (aka not affected).

Overrides:

deleteUser in class Enforcer

Parameters:

user - the user.

Returns:

succeeds or not.

deleteRole

public void deleteRole(java.lang.String role)

deleteRole deletes a role.

Overrides:

deleteRole in class Enforcer

Parameters:

role - the role.

deletePermission

public boolean deletePermission(java.lang.String... permission)

deletePermission deletes a permission. Returns false if the permission does not exist (aka not affected).

Overrides:

deletePermission in class Enforcer

Parameters:

permission - the permission, usually be (obj, act). It is actually the rule without the subject.

Returns:

succeeds or not.

deletePermission

public boolean deletePermission(java.util.List<java.lang.String> permission)

deletePermission deletes a permission. Returns false if the permission does not exist (aka not affected).

Overrides:

deletePermission in class Enforcer

Parameters:

permission - the permission, usually be (obj, act). It is actually the rule without the subject.

Returns:

succeeds or not.

addPermissionForUser

public boolean addPermissionForUser(java.lang.String user,
                                    java.lang.String... permission)

addPermissionForUser adds a permission for a user or role. Returns false if the user or role already has the permission (aka not affected).

Overrides:

addPermissionForUser in class Enforcer

Parameters:

user - the user.

permission - the permission, usually be (obj, act). It is actually the rule without the subject.

Returns:

succeeds or not.

addPermissionForUser

public boolean addPermissionForUser(java.lang.String user,
                                    java.util.List<java.lang.String> permission)

addPermissionForUser adds a permission for a user or role. Returns false if the user or role already has the permission (aka not affected).

Overrides:

addPermissionForUser in class Enforcer

Parameters:

user - the user.

permission - the permission, usually be (obj, act). It is actually the rule without the subject.

Returns:

succeeds or not.

deletePermissionForUser

public boolean deletePermissionForUser(java.lang.String user,
                                       java.lang.String... permission)

deletePermissionForUser deletes a permission for a user or role. Returns false if the user or role does not have the permission (aka not affected).

Overrides:

deletePermissionForUser in class Enforcer

Parameters:

user - the user.

permission - the permission, usually be (obj, act). It is actually the rule without the subject.

Returns:

succeeds or not.

deletePermissionForUser

public boolean deletePermissionForUser(java.lang.String user,
                                       java.util.List<java.lang.String> permission)

deletePermissionForUser deletes a permission for a user or role. Returns false if the user or role does not have the permission (aka not affected).

Overrides:

deletePermissionForUser in class Enforcer

Parameters:

user - the user.

permission - the permission, usually be (obj, act). It is actually the rule without the subject.

Returns:

succeeds or not.

deletePermissionsForUser

public boolean deletePermissionsForUser(java.lang.String user)

deletePermissionsForUser deletes permissions for a user or role. Returns false if the user or role does not have any permissions (aka not affected).

Overrides:

deletePermissionsForUser in class Enforcer

Parameters:

user - the user.

Returns:

succeeds or not.

getPermissionsForUser

public java.util.List<java.util.List<java.lang.String>> getPermissionsForUser(java.lang.String user)

getPermissionsForUser gets permissions for a user or role.

Overrides:

getPermissionsForUser in class Enforcer

Parameters:

user - the user.

Returns:

the permissions, a permission is usually like (obj, act). It is actually the rule without the subject.

hasPermissionForUser

public boolean hasPermissionForUser(java.lang.String user,
                                    java.lang.String... permission)

hasPermissionForUser determines whether a user has a permission.

Overrides:

hasPermissionForUser in class Enforcer

Parameters:

user - the user.

permission - the permission, usually be (obj, act). It is actually the rule without the subject.

Returns:

whether the user has the permission.

hasPermissionForUser

public boolean hasPermissionForUser(java.lang.String user,
                                    java.util.List<java.lang.String> permission)

hasPermissionForUser determines whether a user has a permission.

Overrides:

hasPermissionForUser in class Enforcer

Parameters:

user - the user.

permission - the permission, usually be (obj, act). It is actually the rule without the subject.

Returns:

whether the user has the permission.

getRolesForUserInDomain

public java.util.List<java.lang.String> getRolesForUserInDomain(java.lang.String name,
                                                                java.lang.String domain)

getRolesForUserInDomain gets the roles that a user has inside a domain.

Overrides:

getRolesForUserInDomain in class Enforcer

Parameters:

name - the user.

domain - the domain.

Returns:

the roles that the user has in the domain.

getPermissionsForUserInDomain

public java.util.List<java.util.List<java.lang.String>> getPermissionsForUserInDomain(java.lang.String user,
                                                                                      java.lang.String domain)

getPermissionsForUserInDomain gets permissions for a user or role inside a domain.

Overrides:

getPermissionsForUserInDomain in class Enforcer

Parameters:

user - the user.

domain - the domain.

Returns:

the permissions, a permission is usually like (obj, act). It is actually the rule without the subject.

addRoleForUserInDomain

public boolean addRoleForUserInDomain(java.lang.String user,
                                      java.lang.String role,
                                      java.lang.String domain)

addRoleForUserInDomain adds a role for a user inside a domain. Returns false if the user already has the role (aka not affected).

Overrides:

addRoleForUserInDomain in class Enforcer

Parameters:

user - the user.

role - the role.

domain - the domain.

Returns:

succeeds or not.

deleteRoleForUserInDomain

public boolean deleteRoleForUserInDomain(java.lang.String user,
                                         java.lang.String role,
                                         java.lang.String domain)

deleteRoleForUserInDomain deletes a role for a user inside a domain. Returns false if the user does not have the role (aka not affected).

Overrides:

deleteRoleForUserInDomain in class Enforcer

Parameters:

user - the user.

role - the role.

domain - the domain.

Returns:

succeeds or not.

getImplicitRolesForUser

public java.util.List<java.lang.String> getImplicitRolesForUser(java.lang.String name,
                                                                java.lang.String... domain)

getImplicitRolesForUser gets implicit roles that a user has. Compared to getRolesForUser(), this function retrieves indirect roles besides direct roles. For example: g, alice, role:admin g, role:admin, role:user

getRolesForUser("alice") can only get: ["role:admin"]. But getImplicitRolesForUser("alice") will get: ["role:admin", "role:user"].

Overrides:

getImplicitRolesForUser in class Enforcer

Parameters:

name - the user

domain - the domain

Returns:

implicit roles that a user has.

getImplicitPermissionsForUser

public java.util.List<java.util.List<java.lang.String>> getImplicitPermissionsForUser(java.lang.String user)

getImplicitPermissionsForUser gets implicit permissions for a user or role. Compared to getPermissionsForUser(), this function retrieves permissions for inherited roles. For example: p, admin, data1, read p, alice, data2, read g, alice, admin

getPermissionsForUser("alice") can only get: [["alice", "data2", "read"]]. But getImplicitPermissionsForUser("alice") will get: [["admin", "data1", "read"], ["alice", "data2", "read"]].

Overrides:

getImplicitPermissionsForUser in class Enforcer

Parameters:

user - the user.

Returns:

implicit permissions for a user or role.