org.sakaiproject.api.privacy

Interface PrivacyManager

public interface PrivacyManager

PrivacyManager maintains and queries user privacy settings

 An implementation can modify the behavior of the Privacy Service within sakai.properties:
 
 privacy.manager.defaultViewable=true|false
   a 'true' value will set privacy enabled for a user whose privacy settings are unknown
   a 'false' value will set privacy disabled for a user whose privacy settings are unknown
   If this value is not set, the default behavior will be to show users or make them viewable.
   
 privacy.manager.overrideViewable=true|false
   a 'true' value will make all users viewable in the system
   a 'false' value will make all users hidden in the system
   Do not set this value for normal operation (non overridden behavior).
   
 privacy.manager.userRecordHasPrecedence=true|false
   a 'true' value indicates that a user record has precedence over a system record
   a 'false' value indicates that a system record has precedence over a user record
 
 

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_PRIVACY_KEY
static String	HIDDEN
static String	PRIVACY_PREFS
static String	SYSTEM_RECORD_TYPE
static String	USER_RECORD_TYPE
static String	VISIBLE

Method Summary

Modifier and Type	Method and Description
Set	findHidden(String contextId, Set userIds) Get a set of users who have privacy enabled within a context.
Set	findViewable(String contextId, Set userIds) Get a set of users who have privacy disabled within a context.
String	getDefaultPrivacyState(String userId)
Set	getViewableState(String contextId, Boolean value, String recordType) Get the state of the users within the specified context filtered by a Boolean value.
Map	getViewableState(String contextId, String recordType) Get the state of the users within the specified context.
boolean	isViewable(String contextId, String userId) Determine user privacy within the specified context.
void	setDefaultPrivacyState(String userId, String visibility)
void	setViewableState(String contextId, Map userViewableState, String recordType) Set the state for each entry in the userMap.
void	setViewableState(String contextId, String userId, Boolean value, String recordType) Set user's privacy setting within the specified context given a record type.
boolean	userMadeSelection(String contextId, String userId) Determine if a user has specifically made a choice.

Field Detail

SYSTEM_RECORD_TYPE

static final String SYSTEM_RECORD_TYPE

See Also:

Constant Field Values

USER_RECORD_TYPE

static final String USER_RECORD_TYPE

See Also:

Constant Field Values

VISIBLE

static final String VISIBLE

See Also:

Constant Field Values

HIDDEN

static final String HIDDEN

See Also:

Constant Field Values

PRIVACY_PREFS

static final String PRIVACY_PREFS

See Also:

Constant Field Values

DEFAULT_PRIVACY_KEY

static final String DEFAULT_PRIVACY_KEY

See Also:

Constant Field Values

Method Detail

isViewable

boolean isViewable(String contextId,
                   String userId)

Determine user privacy within the specified context.

Parameters:

contextId -

userId - (UUID)

Returns:

true if privacy is enabled for the user, false otherwise

userMadeSelection

boolean userMadeSelection(String contextId,
                          String userId)

Determine if a user has specifically made a choice.

Parameters:

contextId -

userId - (UUID)

Returns:

true if user made a privacy decision

findViewable

Set findViewable(String contextId,
                 Set userIds)

Get a set of users who have privacy disabled within a context. (Visible)

Parameters:

contextId -

userIds -

Returns:

Set of org.sakakproject.service.legacy.User.id objects (UUID)

findHidden

Set findHidden(String contextId,
               Set userIds)

Get a set of users who have privacy enabled within a context. (Hidden)

Parameters:

contextId -

userIds -

Returns:

Set of org.sakakproject.service.legacy.User.id objects (UUID)

getViewableState

Set getViewableState(String contextId,
                     Boolean value,
                     String recordType)

Get the state of the users within the specified context filtered by a Boolean value. Implementation should delegate to AuthzGroupService to get users from Realm.

Parameters:

contextId -

value - filter (True, False, NULL)

recordType - is a UUID i.e. (getSystemRecordType(), getUserRecordType())

Returns:

Set of users who satisfy the criteria

getViewableState

Map getViewableState(String contextId,
                     String recordType)

Get the state of the users within the specified context.

Parameters:

contextId -

recordType - is a UUID i.e. (getSystemRecordType(), getUserRecordType())

Returns:

Map {key=userId, value=Boolean}

setViewableState

void setViewableState(String contextId,
                      String userId,
                      Boolean value,
                      String recordType)

Set user's privacy setting within the specified context given a record type.

Parameters:

contextId -

userId - (UUID)

value - using three-valued logic (True, False, NULL)

recordType - is a UUID i.e. (getSystemRecordType(), getUserRecordType())

setViewableState

void setViewableState(String contextId,
                      Map userViewableState,
                      String recordType)

Set the state for each entry in the userMap.

Parameters:

contextId -

userMap - is a Map {key=userId, value=Boolean}

recordType - is a UUID i.e. (getSystemRecordType(), getUserRecordType())

getDefaultPrivacyState

String getDefaultPrivacyState(String userId)

setDefaultPrivacyState

void setDefaultPrivacyState(String userId,
                            String visibility)