Package com.logicaldoc.webservice.soap.endpoint

Class SoapDocumentService

    • Constructor Detail

      • SoapDocumentService

        public SoapDocumentService()

    • Method Detail

      • create

        public WSDocument create​(String sid,
                         WSDocument document,
                         javax.activation.DataHandler content)
                  throws Exception
        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:
        Exception - error in the server application

      • checkinDocument

        public void checkinDocument​(String sid,
                            long docId,
                            String comment,
                            String filename,
                            boolean release,
                            WSDocument docVO,
                            javax.activation.DataHandler content)
                     throws Exception
        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:
        Exception - error in the server application

      • checkin

        public void checkin​(String sid,
                    long docId,
                    String comment,
                    String filename,
                    boolean release,
                    javax.activation.DataHandler content)
             throws Exception
        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:
        Exception - error in the server application

      • checkout

        public void checkout​(String sid,
                     long docId)
              throws Exception
        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:
        Exception - error in the server application

      • delete

        public void delete​(String sid,
                   long docId)
            throws Exception
        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:
        Exception - error in the server application

      • getContent

        public javax.activation.DataHandler getContent​(String sid,
                                               long docId)
                                        throws Exception
        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:
        Exception - error in the server application

      • getVersionContent

        public javax.activation.DataHandler getVersionContent​(String sid,
                                                      long docId,
                                                      String version)
                                               throws Exception
        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:
        Exception - error in the server application

      • getResource

        public javax.activation.DataHandler getResource​(String sid,
                                                long docId,
                                                String fileVersion,
                                                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:
        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:
        Exception - error in the server application

      • createPdf

        public void createPdf​(String sid,
                      long docId,
                      String fileVersion)
               throws Exception
        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:
        Exception - error in the server application

      • createThumbnail

        public void createThumbnail​(String sid,
                            long docId,
                            String fileVersion)
                     throws Exception
        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)
        Throws:
        Exception - error in the server application

      • uploadResource

        public void uploadResource​(String sid,
                           long docId,
                           String fileVersion,
                           String suffix,
                           javax.activation.DataHandler content)
                    throws Exception
        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:
        Exception - error in the server application

      • getDocument

        public WSDocument getDocument​(String sid,
                              long docId)
                       throws Exception
        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:
        Exception - error in the server application

      • getDocumentByCustomId

        public WSDocument getDocumentByCustomId​(String sid,
                                        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:
        sid - identifier of the session
        customId - The custom id
        Returns:
        A value object containing the document's metadata
        Throws:
        Exception - error in the server application

      • isReadable

        public boolean isReadable​(String sid,
                          long docId)
                   throws Exception
        Description copied from interface: DocumentService
        Tests if a document is readable
        Specified by:
        isReadable in interface DocumentService
        Parameters:
        sid - identifier of the session
        docId - The document id
        Returns:
        True if the identifier denotes a document, otherwise false
        Throws:
        Exception - error in the server application

      • lock

        public void lock​(String sid,
                 long docId)
          throws Exception
        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:
        Exception - error in the server application

      • move

        public void move​(String sid,
                 long docId,
                 long folderId)
          throws Exception
        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:
        Exception - error in the server application

      • rename

        public void rename​(String sid,
                   long docId,
                   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:
        sid - identifier of the session
        docId - The document id
        name - The new document title
        Throws:
        Exception - error in the server application

      • restore

        public void restore​(String sid,
                    long docId,
                    long folderId)
             throws Exception
        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:
        Exception - error in the server application

      • unlock

        public void unlock​(String sid,
                   long docId)
            throws Exception
        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:
        Exception - error in the server application

      • update

        public void update​(String sid,
                   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:
        sid - identifier of the session
        document - The value object containing the document's metadata
        Throws:
        Exception - error in the server application

      • listDocuments

        public WSDocument[] listDocuments​(String sid,
                                  long folderId,
                                  String fileName)
                           throws Exception
        Description copied from interface: DocumentService
        Gets a document 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:
        A value object containing the document's metadata
        Throws:
        Exception - error in the server application

      • getDocuments

        public WSDocument[] getDocuments​(String sid,
                                 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:
        sid - identifier of the session
        docIds - identifiers of the documents
        Returns:
        the list of documents
        Throws:
        Exception - error in the server application

      • getVersions

        public WSDocument[] getVersions​(String sid,
                                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:
        sid - identifier of the session
        docId - The document id
        Returns:
        Array of versions
        Throws:
        Exception - error in the server application

      • getRecentDocuments

        public WSDocument[] getRecentDocuments​(String sid,
                                       Integer max)
                                throws Exception
        Description copied from interface: DocumentService
        Lists of last modified documents of the current session.
        Specified by:
        getRecentDocuments in interface DocumentService
        Parameters:
        sid - identifier of the session
        max - Maximum number of returned records
        Returns:
        Array of documents
        Throws:
        Exception - error in the server application

      • sendEmail

        public void sendEmail​(String sid,
                      Long[] docIds,
                      String recipients,
                      String subject,
                      String message)
               throws Exception
        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:
        Exception - error in the server application

      • createAlias

        public WSDocument createAlias​(String sid,
                              long docId,
                              long folderId,
                              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:
        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:
        Exception - error in the server application

      • reindex

        public void reindex​(String sid,
                    long docId,
                    String content)
             throws Exception
        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:
        Exception - error in the server application

      • getAliases

        public WSDocument[] getAliases​(String sid,
                               long docId)
                        throws Exception
        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:
        Arrays of aliases
        Throws:
        Exception - error in the server application

      • upload

        public long upload​(String sid,
                   Long docId,
                   Long folderId,
                   boolean release,
                   String filename,
                   String language,
                   javax.activation.DataHandler content)
            throws Exception
        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:
        Exception - error in the server application

      • link

        public WSLink link​(String sid,
                   long doc1,
                   long doc2,
                   String type)
            throws Exception
        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:
        Exception - error in the server application

      • getLinks

        public WSLink[] getLinks​(String sid,
                         long docId)
                  throws Exception
        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:
        Exception - error in the server application

      • deleteLink

        public void deleteLink​(String sid,
                       long id)
                throws Exception
        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:
        Exception - error in the server application

      • getExtractedText

        public String getExtractedText​(String sid,
                               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:
        sid - identifier of the session
        docId - The document id
        Returns:
        The requested document's text
        Throws:
        Exception - error in the server application

      • createDownloadTicket

        public String createDownloadTicket​(String sid,
                                   long docId,
                                   String suffix,
                                   Integer expireHours,
                                   String expireDate,
                                   Integer maxDownloads)
                            throws Exception
        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:
        Exception - error in the server application

      • setPassword

        public void setPassword​(String sid,
                        long docId,
                        String password)
                 throws Exception
        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:
        Exception - error in the server application

      • unsetPassword

        public void unsetPassword​(String sid,
                          long docId,
                          String currentPassword)
                   throws Exception
        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:
        Exception - error in the server application

      • unprotect

        public boolean unprotect​(String sid,
                         long docId,
                         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:
        sid - identifier of the session
        docId - identifier of the document
        password - the password
        Returns:
        was it uprotected?
        Throws:
        Exception - error in the server application

      • addNote

        public WSNote addNote​(String sid,
                      long docId,
                      String note)
               throws Exception
        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:
        Exception - error in the server application

      • saveNote

        public WSNote saveNote​(String sid,
                       long docId,
                       WSNote wsNote)
                throws Exception
        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:
        Exception - error in the server application

      • deleteNote

        public void deleteNote​(String sid,
                       long noteId)
                throws Exception
        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:
        Exception - error in the server application

      • deleteVersion

        public String deleteVersion​(String sid,
                            long docId,
                            String version)
                     throws Exception
        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
        Throws:
        Exception - when the version to delete is not available

      • getNotes

        public WSNote[] getNotes​(String sid,
                         long docId)
                  throws Exception
        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:
        array of notes
        Throws:
        Exception - error in the server application

      • rateDocument

        public WSRating rateDocument​(String sid,
                             long docId,
                             int vote)
                      throws Exception
        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:
        Exception - error in the server application

      • getRatings

        public WSRating[] getRatings​(String sid,
                             long docId)
                      throws Exception
        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:
        the array of ratings
        Throws:
        Exception - error in the server application

      • replaceFile

        public void replaceFile​(String sid,
                        long docId,
                        String fileVersion,
                        String comment,
                        javax.activation.DataHandler content)
                 throws Exception
        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:
        Exception - if an error occurs, this exception is thrown

      • promoteVersion

        public void promoteVersion​(String sid,
                           long docId,
                           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:
        sid - identifier of the session
        docId - the document to be updated
        version - the version
        Throws:
        Exception - if an error occurs, this exception is thrown