Package com.logicaldoc.webservice.soap.endpoint

Class SoapDocumentService

java.lang.Object

com.logicaldoc.webservice.AbstractService

com.logicaldoc.webservice.soap.endpoint.SoapDocumentService

All Implemented Interfaces:

DocumentService

Direct Known Subclasses:

RestDocumentService

public class SoapDocumentService
extends AbstractService
implements DocumentService

Document Web Service Implementation (SOAP)

Since:

5.2

Author:

Matteo Caruso - LogicalDOC

Constructor Summary

Constructors

Constructor	Description
SoapDocumentService()

Method Summary

Modifier and Type	Method	Description
WSNote	addNote(String sid, long docId, String note)	Adds a new note for the given document
void	checkin(String sid, long docId, String comment, String filename, boolean release, WSDocument docVO, InputStream content)
void	checkin(String sid, long docId, String comment, String filename, boolean release, jakarta.activation.DataHandler content)	Checks in an existing document with the given identifier to create a new version.
void	checkinDocument(String sid, long docId, String comment, String filename, boolean release, WSDocument docVO, jakarta.activation.DataHandler content)	Checks in an existing document with the given identifier to create a new version.
void	checkinDocument(String sid, long docId, String comment, String filename, boolean release, WSDocument docVO, InputStream content)
void	checkout(String sid, long docId)	Checks out an existing document with the given identifier.
WSDocument	copy(String sid, long docId, long folderId, boolean links, boolean notes, boolean security)	Copies a document into another folder.
WSDocument	create(String sid, WSDocument document, jakarta.activation.DataHandler content)	Create a new document.
WSDocument	create(String sid, WSDocument document, InputStream content)
WSDocument	createAlias(String sid, long docId, long folderId, String type)	Creates a new document alias for the given document inside a specified folder
String	createDownloadTicket(String sid, long docId, String suffix, Integer expireHours, String expireDate, Integer maxDownloads)	Creates a new download ticket
void	createPdf(String sid, long docId, String fileVersion)	Creates the PDF conversion of the given document.
void	createThumbnail(String sid, long docId, String fileVersion, String type)	Creates the thumbnail of the given document.
String	createViewTicket(String sid, long docId, String suffix, Integer expireHours, String expireDate, Integer maxDownloads, Integer maxViews)	Creates a new view ticket
void	delete(String sid, long docId)	Deletes an existing document with the given identifier.
void	deleteLink(String sid, long id)	Removes an existing link
void	deleteNote(String sid, long noteId)	Adds a new note for the given document
String	deleteVersion(String sid, long docId, String version)	Deletes a version of a document with the given identifiers.
List<WSAccessControlEntry>	getAccessControlList(String sid, long docId)	Retrieves the access control list
List<WSDocument>	getAliases(String sid, long docId)	Gets the aliases of the given document
jakarta.activation.DataHandler	getContent(String sid, long docId)	Gets the content of an existing document with the given identifier
WSDocument	getDocument(String sid, long docId)	Gets the metadata of an existing document with the given identifier
WSDocument	getDocumentByCustomId(String sid, String customId)	Gets document metadata of an existing document with the given custom identifier
List<WSDocument>	getDocuments(String sid, List<Long> docIds)	Gets document metadata of a collection of existing documents with the given identifiers
String	getExtractedText(String sid, long docId)	Gets the document's text stored in the full-text index
List<WSLink>	getLinks(String sid, long docId)	Gets all the links of a specific document
List<WSNote>	getNotes(String sid, long docId)	Gets the notes for the given document
List<WSRating>	getRatings(String sid, long docId)	Gets all the ratings of the given document
List<WSDocument>	getRecentDocuments(String sid, Integer max)	Lists of last modified documents by current user.
jakarta.activation.DataHandler	getResource(String sid, long docId, String fileVersion, String suffix)	Gets the content of a resource associated to the given document.
WSDocument	getVersion(String sid, long docId, String version)	Gets a specific version
jakarta.activation.DataHandler	getVersionContent(String sid, long docId, String version)	Gets the content of a specific version of a document
List<WSDocument>	getVersions(String sid, long docId)	Gets the version history of an existing document with the given identifier
boolean	isDownload(String sid, long docId)	Tests if a document is downloadable
boolean	isGranted(String sid, long docId, String permission)	Tests if the current user has a specific permission on a document
boolean	isRead(String sid, long docId)	Tests if a document is readable.
boolean	isWrite(String sid, long docId)	Tests if a document is writable
WSLink	link(String sid, long doc1, long doc2, String type)	Creates a new link between two documents.
List<WSDocument>	list(String sid, long folderId, String fileName, String sort, Integer page, Integer max)	Gets the documents in a specific folder
List<WSDocument>	listDocuments(String sid, long folderId, String fileName)	Gets the documents in a specific folder
void	lock(String sid, long docId)	Locks an existing document with the given identifier.
void	move(String sid, long docId, long folderId)	Moves an existing document with the given identifier.
void	promoteVersion(String sid, long docId, String version)	Promotes an old version to the current default one.
WSRating	rateDocument(String sid, long docId, int vote)	Puts a new rating on the given document
void	reindex(String sid, long docId, String content)	Re-indexes(or indexes from scratch) a document
void	rename(String sid, long docId, String name)	Renames the title of an existing document with the given identifier.
void	replaceFile(String sid, long docId, String fileVersion, String comment, jakarta.activation.DataHandler content)	Replaces the file associated to a given version.
void	restore(String sid, long docId, long folderId)	Restores a deleted document
WSNote	saveNote(String sid, long docId, WSNote wsNote)	Adds a new note for the given document
void	sendEmail(String sid, List<Long> docIds, String recipients, String subject, String message)	Sends a set of documents as mail attachments
void	setAccessControlList(String sid, long docId, List<WSAccessControlEntry> acl)	Sets the Access Control List
void	setPassword(String sid, long docId, String password)	Puts a password protection to the document
void	unlock(String sid, long docId)	Unlocks an existing document with the given identifier.
boolean	unprotect(String sid, long docId, String password)	Unprotects a document that is password protected.
void	unsetPassword(String sid, long docId, String currentPassword)	Removes the password protection from the document
void	update(String sid, WSDocument document)	Updates an existing document with the value object containing the document's metadata
long	upload(String sid, Long docId, Long folderId, boolean release, String filename, String language, jakarta.activation.DataHandler content)	Creates a new document or updates an existing one.
void	uploadResource(String sid, long docId, String fileVersion, String suffix, jakarta.activation.DataHandler content)	Uploads a new resource attached to the given document.

Methods inherited from class com.logicaldoc.webservice.AbstractService

convertDateToString, convertStringToDate, getCurrentMessage, isValidateSession, setCurrentMessage, setValidateSession

Methods inherited from class java.lang.Object

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

Constructor Details

SoapDocumentService

public SoapDocumentService()

Method Details

create

public WSDocument create(String sid,
 WSDocument document,
 jakarta.activation.DataHandler content)
                  throws IOException,
AuthenticationException,
PermissionException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Create a new document. The user can completely customize the document through a value object containing the document's metadata

Specified by:

create in interface DocumentService

Parameters:

sid - identifier of the session

document - Web service value object containing the document's metadata

content - The document's binary content

Returns:

The value object containing the document's metadata

Throws:

IOException - I/O error

AuthenticationException - Invalid session

PermissionException - The user does not have the required permission

WebserviceException - Error in the webservice

PersistenceException - Error in the database

create

public WSDocument create(String sid,
 WSDocument document,
 InputStream content)
                  throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Throws:

AuthenticationException

WebserviceException

PersistenceException

PermissionException

checkinDocument

public void checkinDocument(String sid,
 long docId,
 String comment,
 String filename,
 boolean release,
 WSDocument docVO,
 InputStream content)
                     throws AuthenticationException,
PermissionException,
WebserviceException,
PersistenceException,
IOException

Throws:

AuthenticationException

PermissionException

WebserviceException

PersistenceException

IOException

checkinDocument

public void checkinDocument(String sid,
 long docId,
 String comment,
 String filename,
 boolean release,
 WSDocument docVO,
 jakarta.activation.DataHandler content)
                     throws IOException,
AuthenticationException,
PermissionException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Checks in an existing document with the given identifier to create a new version.

Specified by:

checkinDocument in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

comment - The check in operation comment

filename - The document file name

release - True if this is a new release(e.g.: 2.0) rather than a subversion(e.g.: 1.1)

docVO - metadata for the document

content - The document's binary content

Throws:

IOException - I/O error

AuthenticationException - Invalid session

PermissionException - The user does not have the required permission

WebserviceException - Error in the webservice

PersistenceException - Error in the database

checkin

public void checkin(String sid,
 long docId,
 String comment,
 String filename,
 boolean release,
 jakarta.activation.DataHandler content)
             throws IOException,
AuthenticationException,
PermissionException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Checks in an existing document with the given identifier to create a new version.

Specified by:

checkin in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

comment - The check in operation comment

filename - The document file name

release - True if this is a new release(eg: 2.0) rather than a subversion(eg: 1.1)

content - The document's binary content

Throws:

IOException - I/O error

AuthenticationException - Invalid session

PermissionException - The user does not have the required permission

WebserviceException - Error in the webservice

PersistenceException - Error in the database

checkin

public void checkin(String sid,
 long docId,
 String comment,
 String filename,
 boolean release,
 WSDocument docVO,
 InputStream content)
             throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException

Throws:

AuthenticationException

WebserviceException

PersistenceException

PermissionException

IOException

checkout

public void checkout(String sid,
 long docId)
              throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Checks out an existing document with the given identifier.

Specified by:

checkout in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

delete

public void delete(String sid,
 long docId)
            throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Deletes an existing document with the given identifier.

Specified by:

delete in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

getContent

public jakarta.activation.DataHandler getContent(String sid,
 long docId)
                                          throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException

Description copied from interface: DocumentService

Gets the content of an existing document with the given identifier

Specified by:

getContent in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

Returns:

The requested document's binary

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O error

getVersionContent

public jakarta.activation.DataHandler getVersionContent(String sid,
 long docId,
 String version)
                                                 throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException

Description copied from interface: DocumentService

Gets the content of a specific version of a document

Specified by:

getVersionContent in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

version - The specific version(it can be empty)

Returns:

The requested version's binary

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O error

getResource

public jakarta.activation.DataHandler getResource(String sid,
 long docId,
 String fileVersion,
 String suffix)
                                           throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException

Description copied from interface: DocumentService

Gets the content of a resource associated to the given document.

Specified by:

getResource in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

fileVersion - The specific file version(it can be empty)

suffix - Suffix specification(it can be empty, conversion.pdf to get the PDF conversion)

Returns:

The requested resource's binary

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O error

createPdf

public void createPdf(String sid,
 long docId,
 String fileVersion)
               throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException

Description copied from interface: DocumentService

Creates the PDF conversion of the given document. If the conversion was already created, nothing will happen.

Specified by:

createPdf in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

fileVersion - The specific file version(it can be empty)

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O error

createThumbnail

public void createThumbnail(String sid,
 long docId,
 String fileVersion,
 String type)
                     throws AuthenticationException,
WebserviceException,
PersistenceException,
IOException

Description copied from interface: DocumentService

Creates the thumbnail of the given document. If the thumbnail was already created, nothing will happen.

Specified by:

createThumbnail in interface DocumentService

Parameters:

sid - Session identifier

docId - The document id

fileVersion - The specific file version(it can be empty)

type - The thumbnail type(eg: thumb, tile, mobile, thumbXXX where XXX is a resolution in pixels)

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

IOException - I/O error

uploadResource

public void uploadResource(String sid,
 long docId,
 String fileVersion,
 String suffix,
 jakarta.activation.DataHandler content)
                    throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException

Description copied from interface: DocumentService

Uploads a new resource attached to the given document. If the resource already exists it is overwritten.

Specified by:

uploadResource in interface DocumentService

Parameters:

sid - Session identifier

docId - The document id

fileVersion - The specific file version(it can be empty)

suffix - Suffix specification(it cannot be empty, use 'conversion.pdf' to put the PDF conversion)

content - The resource's binary content

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O error

getDocument

public WSDocument getDocument(String sid,
 long docId)
                       throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Gets the metadata of an existing document with the given identifier

Specified by:

getDocument in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

Returns:

A value object containing the document's metadata

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - the required document does not exist

getDocumentByCustomId

public WSDocument getDocumentByCustomId(String sid,
 String customId)
                                 throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Gets document metadata of an existing document with the given custom identifier

Specified by:

getDocumentByCustomId in interface DocumentService

Parameters:

sid - identifier of the session

customId - The custom id

Returns:

A value object containing the document's metadata

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

lock

public void lock(String sid,
 long docId)
          throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Locks an existing document with the given identifier.

Specified by:

lock in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The requested document does not exist

move

public void move(String sid,
 long docId,
 long folderId)
          throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Moves an existing document with the given identifier.

Specified by:

move in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

folderId - Identifier of the new document's folder

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

copy

public WSDocument copy(String sid,
 long docId,
 long folderId,
 boolean links,
 boolean notes,
 boolean security)
                throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException

Description copied from interface: DocumentService

Copies a document into another folder.

Specified by:

copy in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

folderId - Identifier of the new document's folder

links - If links must be copied too

notes - If notes and annotations must be copied too

Returns:

The created copy

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O error

rename

public void rename(String sid,
 long docId,
 String name)
            throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Renames the title of an existing document with the given identifier.

Specified by:

rename in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

name - The new document title

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

restore

public void restore(String sid,
 long docId,
 long folderId)
             throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Restores a deleted document

Specified by:

restore in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

folderId - Id of the folder in which the document must be restored

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

unlock

public void unlock(String sid,
 long docId)
            throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Unlocks an existing document with the given identifier.

Specified by:

unlock in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

update

public void update(String sid,
 WSDocument document)
            throws AuthenticationException,
PermissionException,
WebserviceException,
PersistenceException,
UnexistingResourceException

Description copied from interface: DocumentService

Updates an existing document with the value object containing the document's metadata

Specified by:

update in interface DocumentService

Parameters:

sid - identifier of the session

document - The value object containing the document's metadata

Throws:

AuthenticationException - Invalid session

PermissionException - The user does not have the required permission

WebserviceException - Error in the webservice

PersistenceException - Error in the database

UnexistingResourceException - The specified document does not exist

listDocuments

public List<WSDocument> listDocuments(String sid,
 long folderId,
 String fileName)
                               throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Gets the documents in a specific folder

Specified by:

listDocuments in interface DocumentService

Parameters:

sid - identifier of the session

folderId - The folder id

fileName - Optional file name filter

Returns:

Collection of documents

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

list

public List<WSDocument> list(String sid,
 long folderId,
 String fileName,
 String sort,
 Integer page,
 Integer max)
                      throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Gets the documents in a specific folder

Specified by:

list in interface DocumentService

Parameters:

sid - identifier of the session

folderId - The folder id

fileName - Optional file name filter

sort - Optional sort criteria (eg date asc)

page - Optional page number

max - Optional maximum number of elements per page

Returns:

Collection of documents

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

getDocuments

public List<WSDocument> getDocuments(String sid,
 List<Long> docIds)
                              throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Gets document metadata of a collection of existing documents with the given identifiers

Specified by:

getDocuments in interface DocumentService

Parameters:

sid - identifier of the session

docIds - identifiers of the documents

Returns:

the list of documents

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

getRecentDocuments

public List<WSDocument> getRecentDocuments(String sid,
 Integer max)
                                    throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Lists of last modified documents by current user.

Specified by:

getRecentDocuments in interface DocumentService

Parameters:

sid - identifier of the session

max - Maximum number of returned records

Returns:

List of documents

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

sendEmail

public void sendEmail(String sid,
 List<Long> docIds,
 String recipients,
 String subject,
 String message)
               throws AuthenticationException,
WebserviceException,
PersistenceException,
IOException,
jakarta.mail.MessagingException

Description copied from interface: DocumentService

Sends a set of documents as mail attachments

Specified by:

sendEmail in interface DocumentService

Parameters:

sid - identifier of the session

docIds - Set of document identifiers

recipients - Set of recipients(comma separated)

subject - The email subject

message - The email message body

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

IOException - I/O error

jakarta.mail.MessagingException - error sending the email

createAlias

public WSDocument createAlias(String sid,
 long docId,
 long folderId,
 String type)
                       throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Creates a new document alias for the given document inside a specified folder

Specified by:

createAlias in interface DocumentService

Parameters:

sid - identifier of the session

docId - The original document id

folderId - Identifier of the folder in which will be stored the alias.

type - Type of the alias

Returns:

The value object containing the document's metadata

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

reindex

public void reindex(String sid,
 long docId,
 String content)
             throws ParsingException,
AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Re-indexes(or indexes from scratch) a document

Specified by:

reindex in interface DocumentService

Parameters:

sid - Session identifier

docId - The document id

content - The content to be used (if null the file is parsed)

Throws:

ParsingException - Error in adding the entry into fulltext index

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error at data layer

getAliases

public List<WSDocument> getAliases(String sid,
 long docId)
                            throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Gets the aliases of the given document

Specified by:

getAliases in interface DocumentService

Parameters:

sid - identifier of the session

docId - The master document ID

Returns:

List of aliases

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

upload

public long upload(String sid,
 Long docId,
 Long folderId,
 boolean release,
 String filename,
 String language,
 jakarta.activation.DataHandler content)
            throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException

Description copied from interface: DocumentService

Creates a new document or updates an existing one.

Specified by:

upload in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id (optional)

folderId - The folder id (optional)

release - True if this is a major release(eg: 2.0) rather than a minor release(eg: 1.12)

filename - The document file name

language - The language for the document

content - The document's binary content

Returns:

The created/updated document's ID

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O erro

link

public WSLink link(String sid,
 long doc1,
 long doc2,
 String type)
            throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Creates a new link between two documents.

Specified by:

link in interface DocumentService

Parameters:

sid - identifier of the session

doc1 - ID of document 1

doc2 - ID of document 2

type - The link type(it can be empty)

Returns:

the new link

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

getLinks

public List<WSLink> getLinks(String sid,
 long docId)
                      throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Gets all the links of a specific document

Specified by:

getLinks in interface DocumentService

Parameters:

sid - Session identifier

docId - ID of the document

Returns:

The new links of the document

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

deleteLink

public void deleteLink(String sid,
 long id)
                throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Removes an existing link

Specified by:

deleteLink in interface DocumentService

Parameters:

sid - identifier of the session

id - ID of the link

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error at data layer

getExtractedText

public String getExtractedText(String sid,
 long docId)
                        throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Gets the document's text stored in the full-text index

Specified by:

getExtractedText in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

Returns:

The requested document's text

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

createDownloadTicket

public String createDownloadTicket(String sid,
 long docId,
 String suffix,
 Integer expireHours,
 String expireDate,
 Integer maxDownloads)
                            throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Creates a new download ticket

Specified by:

createDownloadTicket in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

suffix - can be null or 'conversion.pdf'

expireHours - expiration time expressed in hours

expireDate - exact expiration date expressed in the format yyyy-MM-dd

maxDownloads - maximum number of downloads allowed

Returns:

the download ticket

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the download permission

createViewTicket

public String createViewTicket(String sid,
 long docId,
 String suffix,
 Integer expireHours,
 String expireDate,
 Integer maxDownloads,
 Integer maxViews)
                        throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException

Description copied from interface: DocumentService

Creates a new view ticket

Specified by:

createViewTicket in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

suffix - can be null or 'conversion.pdf'

expireHours - expiration time expressed in hours

expireDate - exact expiration date expressed in the format yyyy-MM-dd

maxDownloads - maximum number of downloads allowed

maxViews - maximum number of downloads allowed

Returns:

the download ticket

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the download permission

setPassword

public void setPassword(String sid,
 long docId,
 String password)
                 throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Puts a password protection to the document

Specified by:

setPassword in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

password - the new password

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

unsetPassword

public void unsetPassword(String sid,
 long docId,
 String currentPassword)
                   throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Removes the password protection from the document

Specified by:

unsetPassword in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

currentPassword - the password

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

unprotect

public boolean unprotect(String sid,
 long docId,
 String password)
                  throws PersistenceException,
AuthenticationException,
WebserviceException

Description copied from interface: DocumentService

Unprotects a document that is password protected. If the given password is right, the document remains unprotected for the duration of the session

Specified by:

unprotect in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

password - the password

Returns:

was it uprotected?

Throws:

PersistenceException - Error in the database

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

addNote

public WSNote addNote(String sid,
 long docId,
 String note)
               throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Adds a new note for the given document

Specified by:

addNote in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

note - text of the note

Returns:

the created note

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

saveNote

public WSNote saveNote(String sid,
 long docId,
 WSNote wsNote)
                throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Adds a new note for the given document

Specified by:

saveNote in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

wsNote - the note to add

Returns:

the added note

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

deleteNote

public void deleteNote(String sid,
 long noteId)
                throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Adds a new note for the given document

Specified by:

deleteNote in interface DocumentService

Parameters:

sid - identifier of the session

noteId - identifier of the note

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

deleteVersion

public String deleteVersion(String sid,
 long docId,
 String version)
                     throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Deletes a version of a document with the given identifiers. You can not delete the latest version of a document

Specified by:

deleteVersion in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

version - The specific version

Returns:

the latest version specification

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

getNotes

public List<WSNote> getNotes(String sid,
 long docId)
                      throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Gets the notes for the given document

Specified by:

getNotes in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

Returns:

list of notes

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

rateDocument

public WSRating rateDocument(String sid,
 long docId,
 int vote)
                      throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Puts a new rating on the given document

Specified by:

rateDocument in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

vote - the vote

Returns:

the rating

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

getRatings

public List<WSRating> getRatings(String sid,
 long docId)
                          throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Gets all the ratings of the given document

Specified by:

getRatings in interface DocumentService

Parameters:

sid - identifier of the session

docId - identifier of the document

Returns:

List of ratings

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

replaceFile

public void replaceFile(String sid,
 long docId,
 String fileVersion,
 String comment,
 jakarta.activation.DataHandler content)
                 throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException,
UnexistingResourceException

Description copied from interface: DocumentService

Replaces the file associated to a given version.

Specified by:

replaceFile in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

fileVersion - The file version

comment - The comment left for this action

content - The file's binary content

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O error

UnexistingResourceException - The specified document does not exist

promoteVersion

public void promoteVersion(String sid,
 long docId,
 String version)
                    throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
IOException,
UnexistingResourceException

Description copied from interface: DocumentService

Promotes an old version to the current default one. If you promote a prior version, what it does is make it the default version again. (regardless of there being many versions).

Specified by:

promoteVersion in interface DocumentService

Parameters:

sid - identifier of the session

docId - the document to be updated

version - the version

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

IOException - I/O error

UnexistingResourceException - The specified document does not exist

getVersion

public WSDocument getVersion(String sid,
 long docId,
 String version)
                      throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Gets a specific version

Specified by:

getVersion in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

version - The version number

Returns:

The version

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

getVersions

public List<WSDocument> getVersions(String sid,
 long docId)
                             throws AuthenticationException,
WebserviceException,
PersistenceException,
PermissionException,
UnexistingResourceException

Description copied from interface: DocumentService

Gets the version history of an existing document with the given identifier

Specified by:

getVersions in interface DocumentService

Parameters:

sid - identifier of the session

docId - The document id

Returns:

Collection of versions

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

UnexistingResourceException - The specified document does not exist

setAccessControlList

public void setAccessControlList(String sid,
 long docId,
 List<WSAccessControlEntry> acl)
                          throws PersistenceException,
PermissionException,
AuthenticationException,
WebserviceException

Description copied from interface: DocumentService

Sets the Access Control List

Specified by:

setAccessControlList in interface DocumentService

Parameters:

sid - Session identifier

docId - Document id

acl - the complete Access Control List

Throws:

PersistenceException - Error in the database

PermissionException - The user does not have the required permission

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

getAccessControlList

public List<WSAccessControlEntry> getAccessControlList(String sid,
 long docId)
                                                throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Retrieves the access control list

Specified by:

getAccessControlList in interface DocumentService

Parameters:

sid - Session identifier

docId - Document id

Returns:

'error' if error occurred, the right objects collection

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

isRead

public boolean isRead(String sid,
 long docId)
               throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Tests if a document is readable.

Specified by:

isRead in interface DocumentService

Parameters:

sid - Session identifier

docId - The document id

Returns:

True if the identifier denotes a readable document, otherwise false.

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

isWrite

public boolean isWrite(String sid,
 long docId)
                throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Tests if a document is writable

Specified by:

isWrite in interface DocumentService

Parameters:

sid - Session identifier

docId - The document id

Returns:

True if the identifier denotes a writable folder, otherwise false

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

isDownload

public boolean isDownload(String sid,
 long docId)
                   throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Tests if a document is downloadable

Specified by:

isDownload in interface DocumentService

Parameters:

sid - Session identifier

docId - The document id

Returns:

True if the identifier denotes a writable folder, otherwise false

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database

isGranted

public boolean isGranted(String sid,
 long docId,
 String permission)
                  throws AuthenticationException,
WebserviceException,
PersistenceException

Description copied from interface: DocumentService

Tests if the current user has a specific permission on a document

Specified by:

isGranted in interface DocumentService

Parameters:

sid - Session identifier

docId - The document id

permission - The permission to check (eg: 'read', 'write', ...)

Returns:

True if the identifier denotes a granted permission, otherwise false

Throws:

AuthenticationException - Invalid session

WebserviceException - Error in the webservice

PersistenceException - Error in the database