Skip navigation links

Oracle BPEL Process Manager
Workflow Services API Reference
10g Release 3 (10.1.3)
B28985-02


oracle.tip.pc.services.identity
Interface BPMIdentity

All Superinterfaces:
BPMPrincipal, java.security.Principal
All Known Subinterfaces:
BPMAppRole, BPMGroup, BPMRole, BPMUser

public interface BPMIdentity
extends BPMPrincipal

BPMIdentity interface defines a BPEL Process Manager Identity. This interface can be implemented to represented a user or role entity in the backend.


Method Summary
 java.util.Set getActions()
          Gets list of Actions which this BPMIndentity has.
 java.util.List getAppRoles(boolean direct)
          Gets list of application roles,BPMAppRoles, which this BPMIndentity has been granted.
 java.lang.String getEmail()
          Gets e-mail address for this BPMIdentity.
 java.util.Set getGrantedRoles(boolean direct)
          Gets set of all BPMRole objects which the BPMIndentity has been granted
 java.util.List getGroups(boolean direct)
          Gets list of all BPMGroup objects which this BPMIndentity has been granted.
 java.util.Set getOwnedRoles(boolean direct)
          Gets all roles owned by this identity.
 java.util.List getRoles(RoleClassifier roleType, boolean direct)
          Gets list of all BPMRoles which this BPMIndentity has
 boolean isInRole(BPMRole role)
          Defines whether the BPMIdentity belongs to given BPMRole
 boolean isInRole(java.lang.String roleName)
          Defines whether the BPMIdentity belongs to given BPMGroup name
 boolean isOwner(BPMRole role)
          Check whether the principal owns the role

 

Methods inherited from interface oracle.tip.pc.services.identity.BPMPrincipal
getAttribute, getAttributes, getDescription, getDisplayName, getFullName, getGuid, getRealmName, toNode

 

Methods inherited from interface java.security.Principal
equals, getName, hashCode, toString

 

Method Detail

getEmail

public java.lang.String getEmail()
                          throws BPMIdentityException
Gets e-mail address for this BPMIdentity.
Returns:
e-mail adderess or null if not populated in the system.
Throws:
BPMIdentityException - If exception condition occurs.
BPMIdentityException

isInRole

public boolean isInRole(BPMRole role)
                 throws BPMIdentityException
Defines whether the BPMIdentity belongs to given BPMRole
Parameters:
role - The role against which the check is to be made.
Returns:
true if this identity belongs to given BPMRole, false otherwise.
Throws:
BPMIdentityException - If exception condition occurs or the role could not be found.
BPMIdentityException

isInRole

public boolean isInRole(java.lang.String roleName)
                 throws BPMIdentityException,
                        BPMIdentityNotFoundException
Defines whether the BPMIdentity belongs to given BPMGroup name
Returns:
boolean true if user in group
Throws:
BPMIdentityNotFoundException - If the group could not be found.
BPMIdentityException - If exception condition occurs.
BPMIdentityException
BPMIdentityNotFoundException

getAppRoles

public java.util.List getAppRoles(boolean direct)
                           throws BPMIdentityException
Gets list of application roles,BPMAppRoles, which this BPMIndentity has been granted.
Parameters:
direct - a boolean if true only direct roles, else all roles
Returns:
List of granted BPMRoles objects which this BPMIndentity has
Throws:
BPMIdentityException - If exception condition occurs.
BPMIdentityException

getRoles

public java.util.List getRoles(RoleClassifier roleType,
                               boolean direct)
                        throws BPMIdentityException
Gets list of all BPMRoles which this BPMIndentity has
Parameters:
roleType - a role classifier
direct - a boolean if true method returns only direct granted roles, else all roles
Returns:
List of granted BPMRoles objects which this BPMIndentity has
Throws:
BPMIdentityException - If exception condition occurs.
BPMIdentityException

getGroups

public java.util.List getGroups(boolean direct)
                         throws BPMIdentityException
Gets list of all BPMGroup objects which this BPMIndentity has been granted.
Parameters:
direct - is a boolean flag. If is true the method returns only direct granted groups, else all groups
Returns:
List of BPMGroups objects which this BPMIndentity belongs
Throws:
BPMIdentityException - If exception condition occurs.
BPMIdentityException

getGrantedRoles

public java.util.Set getGrantedRoles(boolean direct)
                              throws BPMIdentityException
Gets set of all BPMRole objects which the BPMIndentity has been granted
Parameters:
direct - is a boolean flag. If is true the method returns only direct granted roles, else all
Returns:
Set of BPMRole objects which are graned to given identity
Throws:
BPMIdentityException - If exception condition occurs.
BPMIdentityException

getActions

public java.util.Set getActions()
                         throws BPMIdentityException
Gets list of Actions which this BPMIndentity has.
Returns:
List of Actions
Throws:
BPMIdentityException - If exception condition occurs.
BPMIdentityException

getOwnedRoles

public java.util.Set getOwnedRoles(boolean direct)
                            throws BPMIdentityException
Gets all roles owned by this identity.
Parameters:
direct - a boolean flag. If true return direct onwed roles, else all owned rolse
Returns:
Set of BPMRole objects which the principal owns
Throws:
BPMIdentityException - If exception condition occurs.

isOwner

public boolean isOwner(BPMRole role)
                throws BPMIdentityException
Check whether the principal owns the role
Parameters:
role - a BPMRole
Returns:
boolean true, if principal owns the role, else false. Method returns false if role is BPMAppRole
Throws:
BPMIdentityException - If exception condition occurs.

Skip navigation links

Oracle BPEL Process Manager
Workflow Services API Reference
10g Release 3 (10.1.3)
B28985-02


Copyright © 2006, Oracle. All rights reserved.