com.openkm.api

Class OKMMail

java.lang.Object

com.openkm.api.OKMMail

All Implemented Interfaces:

MailModule

public class OKMMail
extends Object
implements MailModule

Author:

pavila

Method Summary

Methods

Modifier and Type	Method and Description
void	copy(String token, String mailPath, String dstPath) Copy a mail to another location in the repository.
Mail	create(String token, Mail mail) Create a new mail in the repository.
void	delete(String token, String mailPath) Delete a mail the repository.
List<Mail>	getChildren(String token, String fldPath) Retrieve a list of children mails from an existing folder.
List<Mail>	getChilds(String token, String fldPath) Deprecated.
static OKMMail	getInstance()
String	getPath(String token, String uuid) Get the mail path from a UUID
Mail	getProperties(String token, String mailPath) Obtains properties from a previously created mail.
boolean	isValid(String token, String mailPath) Test if a mail path is valid.
void	move(String token, String mailPath, String dstPath) Move a mail to another location in the repository.
void	purge(String token, String mailPath) Deletes definitively a mail from the repository.
Mail	rename(String token, String mailPath, String newName) Rename a mail in the repository.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static OKMMail getInstance()

create

public Mail create(String token,
          Mail mail)
            throws PathNotFoundException,
                   ItemExistsException,
                   VirusDetectedException,
                   AccessDeniedException,
                   RepositoryException,
                   DatabaseException,
                   UserQuotaExceededException

Description copied from interface: MailModule

Create a new mail in the repository.

Specified by:

create in interface MailModule

mail - A mail object with the new mail properties.

Returns:

A mail object with the new created mail properties.

Throws:

PathNotFoundException - If the parent mail doesn't exist.

ItemExistsException - If there is already a mail in the repository with the same name in the same path.

AccessDeniedException - If there is any security problem: you can't modify the parent mail because of lack of permissions.

RepositoryException - If there is any general repository problem.

VirusDetectedException

DatabaseException

UserQuotaExceededException

getProperties

public Mail getProperties(String token,
                 String mailPath)
                   throws PathNotFoundException,
                          RepositoryException,
                          DatabaseException

Description copied from interface: MailModule

Obtains properties from a previously created mail.

Specified by:

getProperties in interface MailModule

mailPath - The path that identifies an unique mail.

Returns:

A mail object with the selected mail properties.

Throws:

PathNotFoundException - If the indicated mail doesn't exist.

RepositoryException - If there is any general repository problem.

DatabaseException

delete

public void delete(String token,
          String mailPath)
            throws LockException,
                   PathNotFoundException,
                   AccessDeniedException,
                   RepositoryException,
                   DatabaseException

Description copied from interface: MailModule

Delete a mail the repository. It is a logical delete, so really is moved to the user trash and can be restored.

Specified by:

delete in interface MailModule

mailPath - The path that identifies an unique mail.

Throws:

LockException - Can't delete a mail with locked documents.

PathNotFoundException - If there is no mail in the repository in this path.

AccessDeniedException - If there is any security problem: you can't modify the mail because of lack of permissions.

RepositoryException - If there is any general repository problem.

DatabaseException

purge

public void purge(String token,
         String mailPath)
           throws LockException,
                  PathNotFoundException,
                  AccessDeniedException,
                  RepositoryException,
                  DatabaseException

Description copied from interface: MailModule

Deletes definitively a mail from the repository. It is a physical delete, so the mail can't be restored.

Specified by:

purge in interface MailModule

mailPath - The path that identifies an unique mail.

Throws:

LockException - Can't delete a mail with locked documents.

PathNotFoundException - If there is no mail in the repository in this path.

AccessDeniedException - If there is any security problem: you can't modify the mail because of lack of permissions.

RepositoryException - If there is any general repository problem.

DatabaseException

rename

public Mail rename(String token,
          String mailPath,
          String newName)
            throws PathNotFoundException,
                   ItemExistsException,
                   AccessDeniedException,
                   RepositoryException,
                   DatabaseException

Description copied from interface: MailModule

Rename a mail in the repository.

Specified by:

rename in interface MailModule

mailPath - The path that identifies an unique mail.

newName - The new mail name.

Returns:

A mail object with the new mail properties.

Throws:

PathNotFoundException - If there is no mail in the repository in this path.

ItemExistsException - If there is already a mail in the repository with the same name in the same path.

AccessDeniedException - If there is any security problem: you can't modify the mail because of lack of permissions.

RepositoryException - If there is any general repository problem.

DatabaseException

move

public void move(String token,
        String mailPath,
        String dstPath)
          throws PathNotFoundException,
                 ItemExistsException,
                 AccessDeniedException,
                 RepositoryException,
                 DatabaseException

Description copied from interface: MailModule

Move a mail to another location in the repository.

Specified by:

move in interface MailModule

mailPath - The path that identifies an unique mail.

dstPath - The path of the destination mail.

Throws:

PathNotFoundException - If the dstPath does not exists.

ItemExistsException - If there is already a mail in the destination mail with the same name.

AccessDeniedException - If there is any security problem: you can't modify the parent mail or the destination mail because of lack of permissions.

RepositoryException - If there is any general repository problem.

DatabaseException

copy

public void copy(String token,
        String mailPath,
        String dstPath)
          throws PathNotFoundException,
                 ItemExistsException,
                 AccessDeniedException,
                 RepositoryException,
                 IOException,
                 AutomationException,
                 DatabaseException,
                 UserQuotaExceededException

Description copied from interface: MailModule

Copy a mail to another location in the repository.

Specified by:

copy in interface MailModule

mailPath - The path that identifies an unique mail.

dstPath - The path of the destination mail.

Throws:

PathNotFoundException - If the dstPath does not exists.

ItemExistsException - If there is already a mail in the destination mail with the same name.

AccessDeniedException - If there is any security problem: you can't modify the parent mail or the destination mail because of lack of permissions.

RepositoryException - If there is any general repository problem.

IOException

AutomationException

DatabaseException

UserQuotaExceededException

getChilds

@Deprecated
public List<Mail> getChilds(String token,
                              String fldPath)
                     throws PathNotFoundException,
                            RepositoryException,
                            DatabaseException

Deprecated.

Description copied from interface: MailModule

Retrieve a list of child mails from an existing folder.

Specified by:

getChilds in interface MailModule

fldPath - The path that identifies an unique folder.

Returns:

A Collection with the child folders.

Throws:

PathNotFoundException - If there is no folder in the repository in this path

RepositoryException - If there is any general repository problem.

DatabaseException

getChildren

public List<Mail> getChildren(String token,
                     String fldPath)
                       throws PathNotFoundException,
                              RepositoryException,
                              DatabaseException

Description copied from interface: MailModule

Retrieve a list of children mails from an existing folder.

Specified by:

getChildren in interface MailModule

fldPath - The path that identifies an unique folder.

Returns:

A Collection with the child folders.

Throws:

PathNotFoundException - If there is no folder in the repository in this path

RepositoryException - If there is any general repository problem.

DatabaseException

isValid

public boolean isValid(String token,
              String mailPath)
                throws PathNotFoundException,
                       AccessDeniedException,
                       RepositoryException,
                       DatabaseException

Description copied from interface: MailModule

Test if a mail path is valid.

Specified by:

isValid in interface MailModule

mailPath - The path that identifies an unique mail.

Throws:

PathNotFoundException - If there is no mail in the repository with this path.

AccessDeniedException - If there is any security problem: you can't access this mail because of lack of permissions.

RepositoryException - If there is any general repository problem.

DatabaseException

getPath

public String getPath(String token,
             String uuid)
               throws AccessDeniedException,
                      RepositoryException,
                      DatabaseException

Description copied from interface: MailModule

Get the mail path from a UUID

Specified by:

getPath in interface MailModule

uuid - The unique mail id.

Returns:

The mail path

Throws:

AccessDeniedException - If there is any security problem: you can't access this folder because of lack of permissions.

RepositoryException - If there is any problem.

DatabaseException