Package com.logicaldoc.webservice.rest.endpoint

Class RestDocumentService

java.lang.Object

com.logicaldoc.webservice.AbstractService

com.logicaldoc.webservice.soap.endpoint.SoapDocumentService

com.logicaldoc.webservice.rest.endpoint.RestDocumentService

All Implemented Interfaces:

DocumentService, DocumentService

Direct Known Subclasses:

RestDocumentSwagger

@Path("/")
@Consumes({"application/xml","application/json"})
@Produces("application/json")
public class RestDocumentService
extends SoapDocumentService
implements DocumentService

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	RestDocumentService.CheckinDocumentMultipartRequest
class	RestDocumentService.CreateDocumentMultipartRequest
class	RestDocumentService.ReplaceFileMultipartRequest
class	RestDocumentService.UploadDocumentMultipartRequest
class	RestDocumentService.UploadResourceMultipartRequest

Constructor Summary

Constructors

Constructor	Description
RestDocumentService()

Method Summary

Modifier and Type	Method	Description
WSNote	addNote(long docId, String note)	Adds a new note for the given document
void	checkin(Integer docId, String comment, String releaseStr, String filename, org.apache.cxf.jaxrs.ext.multipart.Attachment filedataDetail)	Check-in an existing document Performs a check-in (commit) operation of new content over an existing document.
void	checkout(long docId)	Executed the checkout
WSDocument	copy(long docId, long folderId)	Copies a document into another folder
WSDocument	create(WSDocument document, org.apache.cxf.jaxrs.ext.multipart.Attachment contentDetail)	Creates a new document using the metadata document object provided as JSON/XML
WSDocument	createAlias(long docId, long folderId, String type)	Creates a new document alias for the given document inside a specified folder
String	createDownloadTicket(long docId, String suffix, Integer expireHours, String expireDate, Integer maxDownloads)	Creates a new download ticket
void	createPdf(long docId, String fileVersion)	Creates the PDF conversion of the given document; if the PDF conversion was already created, nothing will happen
void	createThumbnail(long docId, String fileVersion, String type)	Creates the thumbail of the given document; if the thumbnail was already created, nothing will happen
void	delete(long docId)	Deletes a document
void	deleteLink(long id)	Removes an existing link
void	deleteNote(long noteId)	Adds a new note for the given document
String	deleteVersion(long docId, String version)	Deletes a version by document identifier and version ID.
WSDocument[]	getAliases(long docId)	Gets the aliases of the given document
javax.activation.DataHandler	getContent(long docId)	Retrieves the file content of a document.
WSDocument	getDocument(long docId)	Retrieves a document from the database
WSDocument	getDocumentByCustomId(String customId)	Gets document metadata of an existing document with the given custom identifier
WSDocument[]	getDocuments(Long[] docIds)	Gets document metadata of a collection of existing documents with the given identifiers
String	getExtractedText(long docId)	Gets the document's text stored in the full-text index
WSLink[]	getLinks(long docId)	Gets all the links of a specific document
WSNote[]	getNotes(long docId)	Gets the notes for the given document
WSRating[]	getRatings(long docId)	Gets all the ratings of the given document
WSDocument[]	getRecentDocuments(Integer maxHits)	Lists of last modified documents of the current session
javax.activation.DataHandler	getResource(long docId, String fileVersion, String suffix)	Gets the content of a resource associated to the given document.
javax.activation.DataHandler	getThumbnail(String type, String docPath, List<javax.ws.rs.core.PathSegment> docPathList)	Retrieves the thumbnail image
javax.activation.DataHandler	getVersionContent(long docId, String version)	Retrieves the file content of a version.
WSDocument[]	getVersions(long docId)	Gets the version history of an existing document with the given identifier
boolean	isReadable(long docId)	Tests if a document is readable
WSLink	link(long doc1, long doc2, String type)	Creates a new link between two documents.
WSDocument[]	list(long folderId)	Lists the documents in a folder
WSDocument[]	listDocuments(long folderId, String fileName)	Lists the documents in a folder
void	lock(long docId)	Locks an existing document with the given identifier.
void	move(long docId, long folderId)	Moves an existing document with the given identifier
void	promoteVersion(long docId, String version)	Promotes an old version to the current default one.
WSRating	rateDocument(long docId, int vote)	Puts a new rating on the given document
void	reindex(long docId, String content)	Re-indexes(or indexes from scratch) a document
void	rename(long docId, String name)	Renames the title of an existing document with the given identifier.
void	replaceFile(Integer docId, String fileVersion, String comment, org.apache.cxf.jaxrs.ext.multipart.Attachment filedataDetail)	Replace the file of a version Replaces the file associated to a given version.
void	restore(long docId, long folderId)	Restores a deleted document
WSNote	saveNote(long docId, WSNote note)	Adds a new note for the given document
void	sendEmail(Long[] docIds, String recipients, String subject, String message)	Sends a set of documents as mail attachments
void	setPassword(long docId, String password)	Puts a password protection to the document
void	unlock(long docId)	Unlocks an existing document with the given identifier.
boolean	unprotect(long docId, String password)	Unprotects a document that is password protected.
void	unsetPassword(long docId, String currentPassword)	Removes the password protection from the document
void	update(WSDocument document)	Updates an existing document with the value object containing the document's metadata.
Long	upload(Integer docId, String folderId, String release, String filename, String language, org.apache.cxf.jaxrs.ext.multipart.Attachment filedataDetail)	Uploads a document Creates or updates an existing document, if used in update mode docId must be provided, when used in create mode folderId is required.
void	uploadResource(Integer docId, String fileVersion, String suffix, org.apache.cxf.jaxrs.ext.multipart.Attachment contentDetail)	Uploads a new resource of the document Uploads a new resource attached to the given document.

Methods inherited from class com.logicaldoc.webservice.soap.endpoint.SoapDocumentService

addNote, checkin, checkin, checkinDocument, checkinDocument, checkout, copy, create, create, createAlias, createDownloadTicket, createPdf, createThumbnail, delete, deleteLink, deleteNote, deleteVersion, getAliases, getContent, getDocument, getDocumentByCustomId, getDocuments, getExtractedText, getLinks, getNotes, getRatings, getRecentDocuments, getResource, getVersion, getVersionContent, getVersions, isReadable, link, listDocuments, lock, move, promoteVersion, rateDocument, reindex, rename, replaceFile, restore, saveNote, sendEmail, setPassword, unlock, unprotect, unsetPassword, update, upload, uploadResource

Methods inherited from class com.logicaldoc.webservice.AbstractService

convertDateToString, convertStringToDate, getContext, getMessageContext, isValidateSession, setContext, setMessageContext, setValidateSession

Methods inherited from class java.lang.Object

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

Constructor Detail

RestDocumentService

public RestDocumentService()

Method Detail

create

@POST
@Path("/create")
@Consumes("multipart/form-data")
@Produces("application/json")
public WSDocument create(WSDocument document,
                         org.apache.cxf.jaxrs.ext.multipart.Attachment contentDetail)
                  throws Exception

Creates a new document using the metadata document object provided as JSON/XML

Specified by:

create in interface DocumentService

Parameters:

document - the document's metadata

contentDetail - the file content

Returns:

data structure representing the created document

Throws:

Exception - a generic error

getDocument

@GET
@Path("/getDocument")
@Produces({"application/json","application/xml"})
public WSDocument getDocument(@QueryParam("docId")
                              long docId)
                       throws Exception

Description copied from interface: DocumentService

Retrieves a document from the database

Specified by:

getDocument in interface DocumentService

Parameters:

docId - identifier of the document

Returns:

the document object representation

Throws:

Exception - a generic error

checkout

@POST
@Path("/checkout")
@Consumes("application/x-www-form-urlencoded")
public void checkout(@FormParam("docId")
                     long docId)
              throws Exception

Description copied from interface: DocumentService

Executed the checkout

Specified by:

checkout in interface DocumentService

Parameters:

docId - identifier of the document

Throws:

Exception - a generic error

checkin

@POST
@Path("/checkin")
@Consumes("multipart/form-data")
public void checkin(Integer docId,
                    String comment,
                    String releaseStr,
                    String filename,
                    org.apache.cxf.jaxrs.ext.multipart.Attachment filedataDetail)
             throws Exception

Description copied from interface: DocumentService

Check-in an existing document Performs a check-in (commit) operation of new content over an existing document. The document must be in checked-out status

Specified by:

checkin in interface DocumentService

Parameters:

docId - identifier of the document

comment - version comment

releaseStr - it this is a major version or not

filename - filename of the document

filedataDetail - binary content of the file

Throws:

Exception - a generic error

upload

@POST
@Path("/upload")
@Consumes("multipart/form-data")
public Long upload(Integer docId,
                   String folderId,
                   String release,
                   String filename,
                   String language,
                   org.apache.cxf.jaxrs.ext.multipart.Attachment filedataDetail)
            throws Exception

Description copied from interface: DocumentService

Uploads a document Creates or updates an existing document, if used in update mode docId must be provided, when used in create mode folderId is required. Returns the ID of the created/updated document. <br/>Example: curl -u admin:admin -H ''Accept: application/json'' -X POST -F folderId=4 -F filename=newDoc.txt -F filedata=@newDoc.txt http://localhost:8080/services/rest/document/upload

Specified by:

upload in interface DocumentService

Parameters:

docId - identifier of the document

folderId - identifier of the folder

release - if the upload must produce a major release or now

filename - name of the file

language - the document's language

filedataDetail - the binary content

Returns:

identifier of the updated document

Throws:

Exception - a generic error

replaceFile

@POST
@Path("/replaceFile")
@Consumes("multipart/form-data")
public void replaceFile(Integer docId,
                        String fileVersion,
                        String comment,
                        org.apache.cxf.jaxrs.ext.multipart.Attachment filedataDetail)
                 throws Exception

Replace the file of a version Replaces the file associated to a given version.

Specified by:

replaceFile in interface DocumentService

Parameters:

docId - identifier of the document

fileVersion - the file version

comment - version comment

filedataDetail - binary content of the file

Throws:

Exception - a generic error

delete

@DELETE
@Path("/delete")
public void delete(@QueryParam("docId")
                   long docId)
            throws Exception

Description copied from interface: DocumentService

Deletes a document

Specified by:

delete in interface DocumentService

Parameters:

docId - identifier of the document to delete

Throws:

Exception - a generic error

list

@GET
@Path("/list")
@Produces("application/json")
public WSDocument[] list(@QueryParam("folderId")
                         long folderId)
                  throws Exception

Description copied from interface: DocumentService

Lists the documents in a folder

Specified by:

list in interface DocumentService

Parameters:

folderId - identifier of the folder

Returns:

array of documents contained in the folder

Throws:

Exception - a generic error

listDocuments

@GET
@Path("/listDocuments")
public WSDocument[] listDocuments(@QueryParam("folderId")
                                  long folderId,
                                  @QueryParam("fileName")
                                  String fileName)
                           throws Exception

Description copied from interface: DocumentService

Lists the documents in a folder

Specified by:

listDocuments in interface DocumentService

Parameters:

folderId - identifier of the folder

fileName - a file name to use as filter

Returns:

array of documents contained in the folder

Throws:

Exception - a generic error

getContent

@GET
@Path("/getContent")
@Produces("application/octet-stream")
public javax.activation.DataHandler getContent(@QueryParam("docId")
                                               long docId)
                                        throws Exception

Description copied from interface: DocumentService

Retrieves the file content of a document.

Specified by:

getContent in interface DocumentService

Parameters:

docId - identifier of the document

Returns:

the contents

Throws:

Exception - error in the server application

getVersionContent

@GET
@Path("/getVersionContent")
@Produces("application/octet-stream")
public javax.activation.DataHandler getVersionContent(@QueryParam("docId")
                                                      long docId,
                                                      @QueryParam("version")
                                                      String version)
                                               throws Exception

Description copied from interface: DocumentService

Retrieves the file content of a version.

Specified by:

getVersionContent in interface DocumentService

Parameters:

docId - identifier of the document

version - version specification

Returns:

the contents

Throws:

Exception - error in the server application

deleteVersion

@DELETE
@Path("/deleteVersion")
public String deleteVersion(@QueryParam("docId")
                            long docId,
                            @QueryParam("version")
                            String version)
                     throws Exception

Description copied from interface: DocumentService

Deletes a version by document identifier and version ID. You can not delete the latest version of a document

Specified by:

deleteVersion in interface DocumentService

Parameters:

docId - identifier of the document

version - the document's version

Returns:

the latest version of the document

Throws:

Exception - error in the server application

update

@PUT
@Path("/update")
public void update(WSDocument document)
            throws Exception

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:

document - the document to update

Throws:

Exception - error in the server application

addNote

@POST
@Path("/addNote")
@Consumes("application/x-www-form-urlencoded")
public WSNote addNote(@FormParam("docId")
                      long docId,
                      @FormParam("note")
                      String note)
               throws Exception

Description copied from interface: DocumentService

Adds a new note for the given document

Specified by:

addNote in interface DocumentService

Parameters:

docId - identifier of the document

note - the note to add

Returns:

the added note

Throws:

Exception - error in the server application

deleteNote

@DELETE
@Path("/deleteNote")
public void deleteNote(@QueryParam("noteId")
                       long noteId)
                throws Exception

Adds a new note for the given document

Specified by:

deleteNote in interface DocumentService

Parameters:

noteId - identifier of the note

Throws:

Exception - error in the server application

getNotes

@GET
@Path("/getNotes")
public WSNote[] getNotes(@QueryParam("docId")
                         long docId)
                  throws Exception

Gets the notes for the given document

Specified by:

getNotes in interface DocumentService

Parameters:

docId - identifier of the document

Returns:

array of notes

Throws:

Exception - error in the server application

rateDocument

@PUT
@Path("/rateDocument")
public WSRating rateDocument(@QueryParam("docId")
                             long docId,
                             @QueryParam("vote")
                             int vote)
                      throws Exception

Puts a new rating on the given document

Specified by:

rateDocument in interface DocumentService

Parameters:

docId - identifier of the document

vote - the vote

Returns:

the rating

Throws:

Exception - error in the server application

getRatings

@GET
@Path("/getRatings")
public WSRating[] getRatings(@QueryParam("docId")
                             long docId)
                      throws Exception

Gets all the ratings of the given document

Specified by:

getRatings in interface DocumentService

Parameters:

docId - identifier of the document

Returns:

the ratings

Throws:

Exception - error in the server application

move

@PUT
@Path("/move")
public void move(@QueryParam("docId")
                 long docId,
                 @QueryParam("folderId")
                 long folderId)
          throws Exception

Description copied from interface: DocumentService

Moves an existing document with the given identifier

Specified by:

move in interface DocumentService

Parameters:

docId - The document id

folderId - Identifier of the new document's folder

Throws:

Exception - error in the server application

copy

@PUT
@Path("/move")
@Produces("application/json")
public WSDocument copy(@QueryParam("docId")
                       long docId,
                       @QueryParam("folderId")
                       long folderId)
                throws Exception

Description copied from interface: DocumentService

Copies a document into another folder

Specified by:

copy in interface DocumentService

Parameters:

docId - The document id

folderId - Identifier of the new document's folder

Returns:

The new copy

Throws:

Exception - error in the server application

createThumbnail

@PUT
@Path("/createThumbnail")
public void createThumbnail(@QueryParam("docId")
                            long docId,
                            @QueryParam("fileVersion")
                            String fileVersion,
                            @QueryParam("type")
                            String type)
                     throws Exception

Description copied from interface: DocumentService

Creates the thumbail of the given document; if the thumbnail was already created, nothing will happen

Specified by:

createThumbnail in interface DocumentService

Parameters:

docId - The document id

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

type - The thumbnail type(eg: thumbnail, tile, mobile)

Throws:

Exception - error in the server application

createPdf

@PUT
@Path("/createPdf")
public void createPdf(@QueryParam("docId")
                      long docId,
                      @QueryParam("fileVersion")
                      String fileVersion)
               throws Exception

Description copied from interface: DocumentService

Creates the PDF conversion of the given document; if the PDF conversion was already created, nothing will happen

Specified by:

createPdf in interface DocumentService

Parameters:

docId - The document id

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

Throws:

Exception - error in the server application

promoteVersion

@PUT
@Path("/promoteVersion")
public void promoteVersion(@QueryParam("docId")
                           long docId,
                           @QueryParam("version")
                           String version)
                    throws Exception

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:

docId - the document to be updated

version - the version

Throws:

Exception - if an error occurs, this exception is thrown

rename

@PUT
@Path("/rename")
public void rename(@QueryParam("docId")
                   long docId,
                   @QueryParam("name")
                   String name)
            throws Exception

Description copied from interface: DocumentService

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

Specified by:

rename in interface DocumentService

Parameters:

docId - The document id

name - The new document filename

Throws:

Exception - error in the server application

getVersions

@GET
@Path("/getVersions")
public WSDocument[] getVersions(@QueryParam("docId")
                                long docId)
                         throws Exception

Description copied from interface: DocumentService

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

Specified by:

getVersions in interface DocumentService

Parameters:

docId - The document id

Returns:

Array of versions

Throws:

Exception - error in the server application

createAlias

@POST
@Path("/createAlias")
@Consumes("application/x-www-form-urlencoded")
public WSDocument createAlias(@FormParam("docId")
                              long docId,
                              @FormParam("folderId")
                              long folderId,
                              @FormParam("type")
                              String type)
                       throws Exception

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:

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:

Exception - error in the server application

createDownloadTicket

@POST
@Path("/createDownloadTicket")
@Consumes("application/x-www-form-urlencoded")
public String createDownloadTicket(@FormParam("docId")
                                   long docId,
                                   @FormParam("suffix")
                                   String suffix,
                                   @FormParam("expireHours")
                                   Integer expireHours,
                                   @FormParam("expireDate")
                                   String expireDate,
                                   @FormParam("maxDownloads")
                                   Integer maxDownloads)
                            throws Exception

Description copied from interface: DocumentService

Creates a new download ticket

Specified by:

createDownloadTicket in interface DocumentService

Parameters:

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 admitted downloads

Returns:

the download ticket

Throws:

Exception - error in the server application

deleteLink

@DELETE
@Path("/deleteLink")
public void deleteLink(@QueryParam("id")
                       long id)
                throws Exception

Description copied from interface: DocumentService

Removes an existing link

Specified by:

deleteLink in interface DocumentService

Parameters:

id - ID of the link

Throws:

Exception - error in the server application

getAliases

@GET
@Path("/getAliases")
public WSDocument[] getAliases(@QueryParam("docId")
                               long docId)
                        throws Exception

Description copied from interface: DocumentService

Gets the aliases of the given document

Specified by:

getAliases in interface DocumentService

Parameters:

docId - The master document ID

Returns:

Arrays of aliases

Throws:

Exception - error in the server application

getDocumentByCustomId

@GET
@Path("/getDocumentByCustomId")
public WSDocument getDocumentByCustomId(@QueryParam("customId")
                                        String customId)
                                 throws Exception

Description copied from interface: DocumentService

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

Specified by:

getDocumentByCustomId in interface DocumentService

Parameters:

customId - The custom id

Returns:

A value object containing the document's metadata

Throws:

Exception - error in the server application

getDocuments

@GET
@Path("/getDocuments")
public WSDocument[] getDocuments(@QueryParam("docIds")
                                 Long[] docIds)
                          throws Exception

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:

docIds - identifiers of the documents

Returns:

the list of documents

Throws:

Exception - error in the server application

getExtractedText

@GET
@Path("/getExtractedText")
@Produces("text/plain")
public String getExtractedText(@QueryParam("docId")
                               long docId)
                        throws Exception

Description copied from interface: DocumentService

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

Specified by:

getExtractedText in interface DocumentService

Parameters:

docId - The document id

Returns:

The requested document's text

Throws:

Exception - error in the server application

getRecentDocuments

@GET
@Path("/getRecentDocuments")
public WSDocument[] getRecentDocuments(@QueryParam("maxHits")
                                       Integer maxHits)
                                throws Exception

Description copied from interface: DocumentService

Lists of last modified documents of the current session

Specified by:

getRecentDocuments in interface DocumentService

Parameters:

maxHits - Maximum number of returned records

Returns:

Array of documents

Throws:

Exception - error in the server application

getLinks

@GET
@Path("/getLinks")
public WSLink[] getLinks(@QueryParam("docId")
                         long docId)
                  throws Exception

Description copied from interface: DocumentService

Gets all the links of a specific document

Specified by:

getLinks in interface DocumentService

Parameters:

docId - ID of the document

Returns:

The new links of the document

Throws:

Exception - error in the server application

getResource

@GET
@Path("/getResource")
@Produces("application/octet-stream")
public javax.activation.DataHandler getResource(@QueryParam("docId")
                                                long docId,
                                                @QueryParam("fileVersion")
                                                String fileVersion,
                                                @QueryParam("suffix")
                                                String suffix)
                                         throws Exception

Description copied from interface: DocumentService

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

Specified by:

getResource in interface DocumentService

Parameters:

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:

Exception - error in the server application

isReadable

@GET
@Path("/isReadable")
public boolean isReadable(@QueryParam("docId")
                          long docId)
                   throws Exception

Description copied from interface: DocumentService

Tests if a document is readable

Specified by:

isReadable in interface DocumentService

Parameters:

docId - The document id

Returns:

True if the identifier denotes a document, otherwise false

Throws:

Exception - error in the server application

link

@POST
@Path("/link")
@Consumes("application/x-www-form-urlencoded")
public WSLink link(@FormParam("doc1")
                   long doc1,
                   @FormParam("doc2")
                   long doc2,
                   @FormParam("type")
                   String type)
            throws Exception

Description copied from interface: DocumentService

Creates a new link between two documents.

Specified by:

link in interface DocumentService

Parameters:

doc1 - ID of document 1

doc2 - ID of document 2

type - The link type(it can be empty)

Returns:

the new link

Throws:

Exception - error in the server application

lock

@PUT
@Path("/lock")
public void lock(@QueryParam("docId")
                 long docId)
          throws Exception

Description copied from interface: DocumentService

Locks an existing document with the given identifier.

Specified by:

lock in interface DocumentService

Parameters:

docId - The document id

Throws:

Exception - error in the server application

reindex

@POST
@Path("/reindex")
@Consumes("application/x-www-form-urlencoded")
public void reindex(@FormParam("doc1")
                    long docId,
                    @FormParam("content")
                    String content)
             throws Exception

Description copied from interface: DocumentService

Re-indexes(or indexes from scratch) a document

Specified by:

reindex in interface DocumentService

Parameters:

docId - The document id

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

Throws:

Exception - error in the server application

uploadResource

@POST
@Path("/uploadResource")
@Consumes("multipart/form-data")
public void uploadResource(Integer docId,
                           String fileVersion,
                           String suffix,
                           org.apache.cxf.jaxrs.ext.multipart.Attachment contentDetail)
                    throws Exception

Description copied from interface: DocumentService

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

Specified by:

uploadResource in interface DocumentService

Parameters:

docId - identifier of the document

fileVersion - version of the file

suffix - suffix specification

contentDetail - file content

Throws:

Exception - a generic error

restore

@PUT
@Path("/restore")
public void restore(@QueryParam("docId")
                    long docId,
                    @QueryParam("folderId")
                    long folderId)
             throws Exception

Description copied from interface: DocumentService

Restores a deleted document

Specified by:

restore in interface DocumentService

Parameters:

docId - The document id

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

Throws:

Exception - error in the server application

saveNote

@POST
@Path("/saveNote")
@Consumes("application/x-www-form-urlencoded")
public WSNote saveNote(@FormParam("docId")
                       long docId,
                       @FormParam("note")
                       WSNote note)
                throws Exception

Description copied from interface: DocumentService

Adds a new note for the given document

Specified by:

saveNote in interface DocumentService

Parameters:

docId - identifier of the document

note - the note to add

Returns:

the added note

Throws:

Exception - error in the server application

sendEmail

@POST
@Path("/sendEmail")
@Consumes("application/x-www-form-urlencoded")
public void sendEmail(@FormParam("docIds")
                      Long[] docIds,
                      @FormParam("recipients")
                      String recipients,
                      @FormParam("subject")
                      String subject,
                      @FormParam("message")
                      String message)
               throws Exception

Description copied from interface: DocumentService

Sends a set of documents as mail attachments

Specified by:

sendEmail in interface DocumentService

Parameters:

docIds - Set of document identifiers

recipients - Set of recipients(comma separated)

subject - The email subject

message - The email message body

Throws:

Exception - error in the server application

setPassword

@POST
@Path("/setPassword")
@Consumes("application/x-www-form-urlencoded")
public void setPassword(@FormParam("docId")
                        long docId,
                        @FormParam("password")
                        String password)
                 throws Exception

Description copied from interface: DocumentService

Puts a password protection to the document

Specified by:

setPassword in interface DocumentService

Parameters:

docId - identifier of the document

password - the new password

Throws:

Exception - error in the server application

unlock

@PUT
@Path("/unlock")
public void unlock(@QueryParam("docId")
                   long docId)
            throws Exception

Description copied from interface: DocumentService

Unlocks an existing document with the given identifier.

Specified by:

unlock in interface DocumentService

Parameters:

docId - identifier of the document

Throws:

Exception - error in the server application

unsetPassword

@POST
@Path("/unsetPassword")
@Consumes("application/x-www-form-urlencoded")
public void unsetPassword(@FormParam("docId")
                          long docId,
                          @FormParam("currentPassword")
                          String currentPassword)
                   throws Exception

Description copied from interface: DocumentService

Removes the password protection from the document

Specified by:

unsetPassword in interface DocumentService

Parameters:

docId - identifier of the document

currentPassword - the password

Throws:

Exception - error in the server application

unprotect

@POST
@Path("/unprotect")
@Consumes("application/x-www-form-urlencoded")
public boolean unprotect(@FormParam("docId")
                         long docId,
                         @FormParam("password")
                         String password)
                  throws Exception

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:

docId - identifier of the document

password - the password

Returns:

was it uprotected?

Throws:

Exception - error in the server application

getThumbnail

@GET
@Path("/thumbnail/{type}/{docpath:.*}")
@Produces("image/png")
public javax.activation.DataHandler getThumbnail(@PathParam("type")
                                                 String type,
                                                 @PathParam("docpath")
                                                 String docPath,
                                                 @PathParam("docpath")
                                                 List<javax.ws.rs.core.PathSegment> docPathList)
                                          throws Exception

Description copied from interface: DocumentService

Retrieves the thumbnail image

Specified by:

getThumbnail in interface DocumentService

Parameters:

type - type of the thumbnail

docPath - path of the document

docPathList - path of the document

Returns:

image content

Throws:

Exception - a generic error