Interface BookmarksInterface

  • All Known Implementing Classes:
    FileContentHandler, RestfulHttpContentHandler

    public interface BookmarksInterface
    Allows for retrieving and saving page bookmarks. Bookmarks are listed with a short note and allow anyone who views a document to skip to a specific page.
    • Method Detail

      • getBookmarkContent

        ContentHandlerResult getBookmarkContent​(ContentHandlerInput input)
                                         throws VirtualViewerAPIException
        Returns the bookmark XML content for the specified document key in the form of a byte array.
        Parameters:
        input - ContentHandlerInput containing the following values:
        Every row is an expected value in the ContentHandlerInput. The first column is the string key for the value. The second column is the type of the value. The third column is the detailed description of the value.
        KeyTypeDescription
        KEY_DOCUMENT_ID java.lang.String The key representing the document. Can be retrieved with String documentId = input.getDocumentId(); .
        KEY_CLIENT_INSTANCE_ID java.lang.String Custom configurable value used to pass data from client to content handler. If not set then will be the session ID. Can be retrieved with String clientInstanceId = input.getClientInstanceId();
        KEY_HTTP_SERVLET_REQUEST javax.servlet.http.HttpServletRequest Request that called this method. Can be retrieved with HttpServletRequest request = input.getHttpServletRequest();
        Returns:
        ContentHandlerResult with the following values:
        Every row is an expected value in the ContentHandlerResult. The first column is the string key for the value. The second column is the type of the value. The third column is the detailed description of the value.
        KeyTypeDescription
        KEY_BOOKMARK_CONTENT byte[] Contents of the bookmark XML file, or null if no bookmarks are associated with the given document.
        Throws:
        VirtualViewerAPIException - if content handler throws exception
      • deleteBookmarkContent

        ContentHandlerResult deleteBookmarkContent​(ContentHandlerInput input)
                                            throws VirtualViewerAPIException
        Delete the bookmark XML content for the specified document key, if it exists. If it does not exist no action is needed.
        Parameters:
        input - ContentHandlerInput containing the following values:
        Every row is an expected value in the ContentHandlerInput. The first column is the string key for the value. The second column is the type of the value. The third column is the detailed description of the value.
        KeyTypeDescription
        KEY_DOCUMENT_ID java.lang.String The key representing the document. Can be retrieved with String documentId = input.getDocumentId(); .
        KEY_CLIENT_INSTANCE_ID java.lang.String Custom configurable value used to pass data from client to content handler. If not set then will be the session ID. Can be retrieved with String clientInstanceId = input.getClientInstanceId();
        KEY_HTTP_SERVLET_REQUEST javax.servlet.http.HttpServletRequest Request that called this method. Can be retrieved with HttpServletRequest request = input.getHttpServletRequest();
        Returns:
        ContentHandlerResult with no values currently expected.
        Throws:
        VirtualViewerAPIException - if content handler throws exception