org.proteios.core
Class GroupPermissions

java.lang.Object
  org.proteios.core.GroupPermissions

public class GroupPermissions
extends Object

This class is used to specify permissions to share an item to groups. It is a three-step procedure:

• Fill this object with permissions for specific groups
• Create a new ItemKey using this object as one of the input parameters to ItemKey.getNewOrExisting(DbControl, UserPermissions, GroupPermissions)
• Assign the project key to the item: Shareable.setItemKey(ItemKey)

Don't forget to commit the transaction.

Version:

2.0

Author:

Nicklas

See Also:

ItemKey, UserPermissions

Last modified

$Date: 2009-04-09 08:48:11 +0200 (Thu, 09 Apr 2009) $

Constructor Summary

GroupPermissions()
Create a new empty object.

GroupPermissions(ItemKey itemKey)
Create a new object, and initialise it with the permissions from a ItemKey.

Method Summary

void	addPermissions(Group group, Set<Permission> permissions) Grant permissions to a group, keeping those that have already been set.
Set<Permission>	getPermissions(Group group) Get the permissions for a group.
void	setPermissions(Group group, Set<Permission> permissions) Grant permissions to a group.
int	size() Get the number of entries.

Methods inherited from class java.lang.Object

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

Constructor Detail

GroupPermissions

public GroupPermissions()

Create a new empty object.

GroupPermissions

public GroupPermissions(ItemKey itemKey)
                 throws InvalidDataException

Create a new object, and initialise it with the permissions from a ItemKey.

Parameters:

itemKey - The item key from which we take the current permissions

Throws:

InvalidDataException - If the item key is null

Method Detail

setPermissions

public void setPermissions(Group group,
                           Set<Permission> permissions)
                    throws InvalidDataException

Grant permissions to a group. Use an empty Set or null to remove all permissions for the group.

Parameters:

group - The Group

permissions - The permissions to grant

Throws:

InvalidDataException - If the group is null

See Also:

Permission

addPermissions

public void addPermissions(Group group,
                           Set<Permission> permissions)
                    throws InvalidDataException

Grant permissions to a group, keeping those that have already been set.

Parameters:

group - The Group

permissions - The permissions to grant

Throws:

InvalidDataException - If the user is null

See Also:

Permission

getPermissions

public Set<Permission> getPermissions(Group group)
                               throws InvalidDataException

Get the permissions for a group.

Parameters:

group - The Group for which we want to get the permission

Returns:

An Set containing the granted permissions, or an empty set if no permissions have been granted

Throws:

InvalidDataException - If the group is null

See Also:

Permission

size

public int size()

Get the number of entries.