org.proteios.core
Class Group

java.lang.Object
  org.proteios.core.BasicItem<GroupData>
      org.proteios.core.Group

All Implemented Interfaces:

AccessControlled, Identifiable, Nameable, Removable, SystemItem

public class Group
extends BasicItem<GroupData>
implements Nameable, Removable, SystemItem

This class is used to represent groups. Groups are used in the permission system to make it possible for a user to share items with other users.

Groups are intended to represent the actual organisation of a company/organisation. For example a top-level group "The company" may contain the sub-groups "Sales", "Marketing" and "Research". Individual users should be added to the sub-groups only.

Proteios comes with the predefined group Everyone, which cannot contain any members, except that the permission system works as if everyone is a member.

Version:

2.0

Author:

Nicklas

See Also:

Role, Project

Last modified

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

Field Summary

static String	EVERYONE The id of the Everyone group where all users are (virtual) members.
static Item	TYPE The type of item represented by this class.

Fields inherited from interface org.proteios.core.Nameable

MAX_DESCRIPTION_LENGTH, MAX_NAME_LENGTH

Method Summary

void	addGroup(Group group) Add a group as a member to this group.
void	addUser(User user) Add a user as a member to this group.
String	getDescription() Get the description for the item.
long	getDiskUsage(QuotaType quotaType, Location location) Get the used number of bytes for the specified quota type and location.
ItemQuery<Group>	getGroups() Get a query that returns the groups that are members of this group.
String	getName() Get the name of the item.
ItemQuery<Project>	getProjects() Get a query that returns the projects that this group is a member of.
static ItemQuery<Group>	getQuery() Get a query configured to retrieve groups.
Quota	getQuota() Get the Quota that applies to the group.
String	getSystemId() Get the system id for the item.
Item	getType() Get the type of item represented by the object.
ItemQuery<User>	getUsers() Get a query that returns the users that are members of this group.
boolean	isMember(Group group) Checks if a group is a member of this group.
boolean	isMember(User user) Checks if a user is a member of this group.
boolean	isRemoved() Check if the removed flag is set for this item.
boolean	isSystemItem() Check if the item is a system item or not.
boolean	isUsed() Checks if: A user has been assigned this group as a quota group There are also other items that can reference a group: DiscUsage Other groups ItemKeys Projects Users (as group members) The links to all these items are automatically deleted if the group is deleted and aren't included in this check.
void	removeGroup(Group group) Remove a group that is a member of this group.
void	removeUser(User user) Remove a user that is a member of this group.
void	setDescription(String description) Set the description for the item.
void	setName(String name) Set the name of the item.
void	setQuota(Quota quota) Set the quota for the group.
void	setRemoved(boolean removed) Set the removed flag for this item.

Methods inherited from class org.proteios.core.BasicItem

checkPermission, equals, getDbControl, getId, getPermissions, getSessionControl, getVersion, hashCode, hasPermission, isDetached, isInDatabase, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.proteios.core.Identifiable

getId, getVersion

Methods inherited from interface org.proteios.core.AccessControlled

checkPermission, hasPermission

Field Detail

TYPE

public static final Item TYPE

The type of item represented by this class.

See Also:

Item.GROUP, getType()

EVERYONE

public static final String EVERYONE

The id of the Everyone group where all users are (virtual) members.

See Also:

Constant Field Values

Method Detail

getQuery

public static ItemQuery<Group> getQuery()

Get a query configured to retrieve groups. If the logged in user doesn't have generic permission to all groups, only groups where the logged in user is a member are returned.

Returns:

An ItemQuery object

getType

public Item getType()

Description copied from interface: Identifiable

Get the type of item represented by the object. The returned value is one of the values defined in the Item enumeration.

Specified by:

getType in interface Identifiable

Returns:

A value indicating the type of item

getName

public String getName()

Description copied from interface: Nameable

Get the name of the item.

Specified by:

getName in interface Nameable

Returns:

A String with the name of the item

setName

public void setName(String name)
             throws PermissionDeniedException,
                    InvalidDataException

Description copied from interface: Nameable

Set the name of the item. The name cannot be null and mustn't be longer than the value specified by the Nameable.MAX_NAME_LENGTH constant.

Specified by:

setName in interface Nameable

Parameters:

name - The new name for the item

Throws:

PermissionDeniedException - If the logged in user doesn't have write permission

InvalidDataException - If the name is null or longer than specified by the Nameable.MAX_NAME_LENGTH constant

getDescription

public String getDescription()

Description copied from interface: Nameable

Get the description for the item.

Specified by:

getDescription in interface Nameable

Returns:

A String with a description of the item

setDescription

public void setDescription(String description)
                    throws PermissionDeniedException,
                           InvalidDataException

Description copied from interface: Nameable

Set the description for the item. The description can be null but mustn't be longer than the value specified by the Nameable.MAX_DESCRIPTION_LENGTH constant.

Specified by:

setDescription in interface Nameable

Parameters:

description - The new description for the item

Throws:

PermissionDeniedException - If the logged in user doesn't have write permission

InvalidDataException - If the description longer than specified by the Nameable.MAX_DESCRIPTION_LENGTH constant

isRemoved

public boolean isRemoved()

Description copied from interface: Removable

Check if the removed flag is set for this item.

Specified by:

isRemoved in interface Removable

Returns:

TRUE if the item is flagged as removed, FALSE otherwise

setRemoved

public void setRemoved(boolean removed)
                throws PermissionDeniedException

Description copied from interface: Removable

Set the removed flag for this item.

Specified by:

setRemoved in interface Removable

Parameters:

removed - TRUE if the item should be flagged as removed, FALSE otherwise

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.DELETE permission for setting the flag to TRUE or Permission.WRITE permission for setting the flag to FALSE

getSystemId

public String getSystemId()

Description copied from interface: SystemItem

Get the system id for the item.

Specified by:

getSystemId in interface SystemItem

Returns:

The id of the item or null if it is not a system item

isSystemItem

public boolean isSystemItem()

Description copied from interface: SystemItem

Check if the item is a system item or not. A system item have a non-null value for the system id.

Specified by:

isSystemItem in interface SystemItem

Returns:

TRUE if this item is a system item, FALSE otherwise

isUsed

public boolean isUsed()
               throws BaseException

Checks if:

• A user has been assigned this group as a quota group

There are also other items that can reference a group:

• DiscUsage
• Other groups
• ItemKeys
• Projects
• Users (as group members)

The links to all these items are automatically deleted if the group is deleted and aren't included in this check.

Specified by:

isUsed in class BasicItem<GroupData>

Returns:

TRUE if this item is used, FALSE otherwise

Throws:

BaseException

getQuota

public Quota getQuota()
               throws PermissionDeniedException,
                      BaseException

Get the Quota that applies to the group.

Returns:

A Quota item, or null if no quota has been assigned to this group

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.READ permission to the item

BaseException

setQuota

public void setQuota(Quota quota)
              throws PermissionDeniedException,
                     InvalidDataException

Set the quota for the group.

Parameters:

quota - The new Quota, or null to disable quota for this group

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.WRITE permission for the group or Permission.USE permission for the quota

InvalidDataException - If the quota is null

getDiskUsage

public long getDiskUsage(QuotaType quotaType,
                         Location location)
                  throws BaseException

Get the used number of bytes for the specified quota type and location.

Parameters:

quotaType - The QuotaType

location - The location

Returns:

The number of bytes that have been used

Throws:

BaseException

addUser

public void addUser(User user)
             throws PermissionDeniedException,
                    InvalidDataException

Add a user as a member to this group. It is not allowed to add members to the EVERYONE group.

Parameters:

user - The user to add

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.WRITE permission for the group and Permission.USE for the user

InvalidDataException - If the user is null

removeUser

public void removeUser(User user)
                throws PermissionDeniedException,
                       InvalidDataException

Remove a user that is a member of this group.

Parameters:

user - The user to remove

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.WRITE permission for the group and Permission.USE for the user

InvalidDataException - If the user is null

isMember

public boolean isMember(User user)

Checks if a user is a member of this group.

Parameters:

user - The user to check

Returns:

TRUE if the user is a member, FALSE otherwise

getUsers

public ItemQuery<User> getUsers()
                         throws BaseException

Get a query that returns the users that are members of this group. This query excludes users that the logged in user doesn't have permission to read.

Throws:

BaseException

See Also:

User.getQuery()

addGroup

public void addGroup(Group group)
              throws PermissionDeniedException,
                     InvalidDataException

Add a group as a member to this group. This method does nothing if one tries to add a group to itself. It is not allowed to add members to the EVERYONE group.

Parameters:

group - The group to add

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.WRITE permission for both groups

InvalidDataException - If the group is null

removeGroup

public void removeGroup(Group group)
                 throws PermissionDeniedException,
                        InvalidDataException

Remove a group that is a member of this group.

Parameters:

group - The group to remove

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.WRITE permission for both groups

InvalidDataException - If the group is null

isMember

public boolean isMember(Group group)

Checks if a group is a member of this group.

Parameters:

group - The group to check

Returns:

TRUE if the group is a member, FALSE otherwise

getGroups

public ItemQuery<Group> getGroups()

Get a query that returns the groups that are members of this group. This query excludes groups that the logged in user doesn't have permission to read.

See Also:

getQuery()

getProjects

public ItemQuery<Project> getProjects()

Get a query that returns the projects that this group is a member of. This query excludes projects that the logged in user doesn't have permission to read.

See Also:

Project.getQuery()