org.proteios.core
Class Message

java.lang.Object
  org.proteios.core.BasicItem<MessageData>
      org.proteios.core.Message

All Implemented Interfaces:

AccessControlled, Identifiable, Nameable, Removable

public class Message
extends BasicItem<MessageData>
implements Nameable, Removable

This class represents a message. Messages are normally sent by the system when a job is completed. It is also possible to send messages between other users.

Version:

2.0

Author:

Nicklas

Last modified

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

Field Summary

static int	MAX_FROM_LENGTH The maximum length of the sender name.
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

static int	countUnreadMessages(DbControl dc, User user) Count the number of unread messages for the specified or logged in user.
static Message	getById(DbControl dc, int id) Get a Message item when you know the id.
String	getDescription() Get the description for the item.
String	getFrom() Get the name of the sender of this message.
Job	getJob() Get the Job this message is about.
String	getName() Get the name of the item.
static ItemQuery<Message>	getQuery(User user) Get a query configured to retrieve messages for the specified user.
User	getSender() Get the user that sent this message.
Date	getTimeSent() Get the date and time the message was sent.
User	getTo() Get the User this message was sent to.
Item	getType() Get the type of item represented by the object.
boolean	isRead() Check if the message has been read or not.
boolean	isRemoved() Check if the removed flag is set for this item.
boolean	isUsed() Always return FALSE.
void	setDescription(String description) Set the description for the item.
void	setName(String name) Set the name of the item.
void	setRead(boolean isRead) Set read status of the message.
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.MESSAGE, getType()

MAX_FROM_LENGTH

public static final int MAX_FROM_LENGTH

The maximum length of the sender name.

See Also:

Constant Field Values

Method Detail

getById

public static Message getById(DbControl dc,
                              int id)
                       throws ItemNotFoundException,
                              PermissionDeniedException,
                              BaseException

Get a Message item when you know the id.

Parameters:

dc - The DbControl which will be used for permission checking and database access

id - The id of the item to load

Returns:

The Message item

Throws:

ItemNotFoundException - If an item with the specified ID is not found

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

BaseException - If there is another error

countUnreadMessages

public static int countUnreadMessages(DbControl dc,
                                      User user)
                               throws BaseException

Count the number of unread messages for the specified or logged in user. The count doesn't include messages which have been flagged as removed.

Parameters:

dc - The DbControl which will be used for permission checking and database access

user - The user to count the unread messages for, or null to count the messages for the logged in user

Returns:

The number of unread messages

Throws:

BaseException - If there is an error

getQuery

public static ItemQuery<Message> getQuery(User user)

Get a query configured to retrieve messages for the specified user.

Parameters:

user - The user to retreive messages for, null is allowed if the logged in user has generic read permission for messages in which case all messages will be returned

Returns:

An ItemQuery object

See Also:

User.getMessages()

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

isUsed

public boolean isUsed()
               throws BaseException

Always return FALSE. A message is not used by other items.

Specified by:

isUsed in class BasicItem<MessageData>

Returns:

TRUE if this item is used, FALSE otherwise

Throws:

BaseException

getTo

public User getTo()
           throws PermissionDeniedException,
                  BaseException

Get the User this message was sent to.

Returns:

The User item

Throws:

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

BaseException - If there is another error

getFrom

public String getFrom()

Get the name of the sender of this message. The sender may be another user or a system process.

See Also:

getSender()

getSender

public User getSender()
               throws PermissionDeniedException,
                      BaseException

Get the user that sent this message.

Returns:

A User object or null if the message was sent by the system or the sending user account has been deleted

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.READ permission for the sender

BaseException - If there is another error

See Also:

getFrom()

getJob

public Job getJob()
           throws PermissionDeniedException,
                  BaseException

Get the Job this message is about.

Returns:

The Job item

Throws:

PermissionDeniedException - If the logged in user doesn't have Permission.READ permission for the job

BaseException - If there is another error

getTimeSent

public Date getTimeSent()

Get the date and time the message was sent.

isRead

public boolean isRead()

Check if the message has been read or not.

setRead

public void setRead(boolean isRead)
             throws PermissionDeniedException

Set read status of the message.

Parameters:

isRead - TRUE to mark the message as read, FALSE to mark it as unread

Throws:

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