org.openpermis
Interface Subject

All Superinterfaces:
Identifiable, Serializable
All Known Subinterfaces:
Authority, AuthorityBean
All Known Implementing Classes:
BasicAuthority, MutableSubject

public interface Subject
extends Identifiable, Serializable

A subject is an entity that requests access to resources.

Since:
0.1.0

Method Summary
 Set<RoleDefinition> getAssignedRoleDefinitions(TimeStamp timeStamp, TimePeriodConstraint constraint)
          Returns a set of role definitions held by this subject at the current time.
 Set<Role> getAssignedRoles(TimeStamp timeStamp, TimePeriodConstraint constraint, Set<Role> roles)
          Returns a subset of all roles held by this subject at the current time.
 Set<Subject> getIssuersOf(Role role)
          Returns the subjects who issued the role to this.
 
Methods inherited from interface org.openpermis.policy.Identifiable
getIdentity
 

Method Detail

getAssignedRoleDefinitions

Set<RoleDefinition> getAssignedRoleDefinitions(TimeStamp timeStamp,
                                               TimePeriodConstraint constraint)
Returns a set of role definitions held by this subject at the current time.

Parameters:
timeStamp - the current time, a TimeStamp.
constraint - to constrain the time period of the role assignment.
Returns:
the set of role definitions held by this subject at the current time, never null but may be empty if the subject does not hold any roles.
Since:
0.9.0

getAssignedRoles

Set<Role> getAssignedRoles(TimeStamp timeStamp,
                           TimePeriodConstraint constraint,
                           Set<Role> roles)
Returns a subset of all roles held by this subject at the current time.

Parameters:
timeStamp - the current time, a TimeStamp.
constraint - to constrain the time period of the role assignment.
roles - a set of Roles.
Returns:
a subset of roles containing only those roles that have been assigned to this subject.
Since:
0.3.0

getIssuersOf

Set<Subject> getIssuersOf(Role role)
                          throws SubjectException
Returns the subjects who issued the role to this.

Parameters:
role - a Role. The subject assumes that it previously confirmed with getAssignedRoles(TimeStamp, TimePeriodConstraint, Set) to have this role.
Returns:
the subjects who issued the role to this.
Throws:
SubjectException - signals a problem in finding an issuer.
Since:
0.3.0


OpenPermis Role Based Access Control 0.9.0 (Build 16)
2009/08/13 07:16:59
Copyright (c) 2002-2007 Ergon Informatik AG