com.groupdocs.viewer.handlers
Class ViewerHandler

java.lang.Object
  extended by com.groupdocs.viewer.resources.GroupDocsViewer
      extended by com.groupdocs.viewer.handlers.ViewerHandler

public class ViewerHandler
extends GroupDocsViewer

Provides all data actions with Viewer object

Author:
Alex Bobkov
See Also:
GroupDocsViewer

Constructor Summary
ViewerHandler(ServiceConfiguration config)
          Viewer constructor
ViewerHandler(ServiceConfiguration config, com.groupdocs.viewer.handlers.input.InputDataHandler inputDataHandler)
          Viewer constructor
 
Method Summary
 void generateCache(String guid, String width, Integer quality, Boolean usePdf, javax.servlet.http.HttpServletRequest request)
          Generate cache in the background
 String getCacheGenerationProgress(String guid, javax.servlet.http.HttpServletRequest request)
          Get cache generation progress
 ServiceConfiguration getConfiguration()
          Get service configuration
 Object getCssHandler(String cssName, javax.servlet.http.HttpServletResponse response)
          Get CSS scripts
This method is used to get CSS scripts that are required to construct Viewer's UI
 Object getDocumentPageHtmlHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Get HTML page [POST request]
 Object getDocumentPageImageHandler(String path, Integer width, Integer quality, Boolean usePdf, Integer pageIndex, javax.servlet.http.HttpServletResponse response)
          Get image file [GET request]
 Object getFileHandler(String path, boolean getPdf, javax.servlet.http.HttpServletResponse response)
          Download file [GET request]
 Object getFontHandler(String fontName, javax.servlet.http.HttpServletResponse response)
          Get fonts
This method is used to get font that are required to generate documents
 String getHeader()
          Get HTML header
 Object getHtmlRecoucesHandler(String filePath, javax.servlet.http.HttpServletResponse response)
          Get HTML resources [GET request]
 Object getImageHandler(String imageName, javax.servlet.http.HttpServletResponse response)
          Get images
This method is used to get images that are required to construct Viewer's UI
 Object getImageUrlsHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Get thumbs and other images files [POST request]
 Object getImageUrlsHandler(String callback, String data, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Get thumbs and other images files [GET request]
 Object getJsHandler(String scriptName, javax.servlet.http.HttpServletResponse response)
          Get JavaScript scripts
This method is used to get JavaScripts that are required to construct Viewer's UI
 String getLocale()
          Get locale
 String getPdf2JavaScriptHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Deprecated. 
 String getPdf2JavaScriptHandler(String guid)
          Get text from file as json
 String getPdf2JavaScriptHandler(String callback, String data, javax.servlet.http.HttpServletResponse response)
          Deprecated. 
 Object getPdfWithPrintDialog(String path, javax.servlet.http.HttpServletResponse response)
          Get PDF print dialog [GET request]
 String getPrintableHtmlHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Print document [POST request]
 String getPrintableHtmlHandler(PrintDocument doc, String mediaType, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Get printable html from specific file type
 String getPrintableHtmlHandler(String callback, String data, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Print document [GET request]
 String getViewerScript(String viewerId, String filePath, String locale)
          Get Viewer Script
 Object loadFileBrowserTreeDataHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Load tree of files from base directory [POST request]
 Object loadFileBrowserTreeDataHandler(String callback, String data, javax.servlet.http.HttpServletResponse response)
          Load tree of files from base directory [GET request]
 Object renewTokenId(String tokenId)
          Renew expired token
 Object reorderPageHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Reorder Page [POST request]
 Object uploadFile(File file, Integer timeToLive)
          Upload file
 Object uploadFile(InputStream inputStream, String fileName, Integer timeToLive)
          Upload file
 Object uploadFile(String filePath, Integer timeToLive)
          Upload file
 Object viewDocumentHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Generate list of images/pages [POST request]
 Object viewDocumentHandler(String callback, String data, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Generate list of images/pages [GET request]
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ViewerHandler

public ViewerHandler(ServiceConfiguration config)
              throws Exception
Viewer constructor

Parameters:
config - Configuration files with required data to create viewer instance
Throws:
Exception - Invalid license

ViewerHandler

public ViewerHandler(ServiceConfiguration config,
                     com.groupdocs.viewer.handlers.input.InputDataHandler inputDataHandler)
              throws Exception
Viewer constructor

Parameters:
config - Configuration files with required data to create viewer instance
inputDataHandler - Data handler to read from different location or data source (default local disk)
Throws:
Exception - Invalid license
Method Detail

getConfiguration

public ServiceConfiguration getConfiguration()
Get service configuration

Returns:
service configuration

getHeader

public String getHeader()
                 throws IOException
Get HTML header

Returns:
Formatted HTML
Throws:
IOException

getViewerScript

public String getViewerScript(String viewerId,
                              String filePath,
                              String locale)
                       throws IOException
Get Viewer Script

Parameters:
viewerId - viewer id used in html
filePath - path to default file
locale - locale
Returns:
viewer script
Throws:
IOException

getLocale

public String getLocale()
Get locale

Returns:
Locale json object as String if current locale is supported otherwise return default locale (English)

uploadFile

public Object uploadFile(String filePath,
                         Integer timeToLive)
Upload file

Parameters:
filePath - path to file
timeToLive - expiration date for file upload in minutes
set 0 for permanent
Returns:
token id as json

uploadFile

public Object uploadFile(File file,
                         Integer timeToLive)
Upload file

Parameters:
file - file
timeToLive - expiration date for file upload in minutes
set 0 for permanent
Returns:
token id as json

uploadFile

public Object uploadFile(InputStream inputStream,
                         String fileName,
                         Integer timeToLive)
Upload file

Parameters:
inputStream - input stream
fileName - file name
timeToLive - expiration date for file upload in minutes
set 0 for permanent
Returns:
token id as json

renewTokenId

public Object renewTokenId(String tokenId)
Renew expired token

Parameters:
tokenId - expired token id
Returns:
renewed token id

getPdf2JavaScriptHandler

public String getPdf2JavaScriptHandler(String guid)
                                throws Exception
Get text from file as json

Parameters:
guid - file guid
Returns:
json
Throws:
Exception

getPrintableHtmlHandler

public String getPrintableHtmlHandler(PrintDocument doc,
                                      String mediaType,
                                      javax.servlet.http.HttpServletRequest request,
                                      javax.servlet.http.HttpServletResponse response)
Get printable html from specific file type

Parameters:
doc - document object
mediaType - media type
request - HTTP servlet request
response - HTTP servlet response
Returns:
printable html

generateCache

public void generateCache(String guid,
                          String width,
                          Integer quality,
                          Boolean usePdf,
                          javax.servlet.http.HttpServletRequest request)
                   throws Exception
Generate cache in the background

Parameters:
guid - file guid
width - output file width
quality - output file quality
usePdf - use pdf flag
request - HTTP servlet request
Throws:
Exception

getCacheGenerationProgress

public String getCacheGenerationProgress(String guid,
                                         javax.servlet.http.HttpServletRequest request)
                                  throws Exception
Get cache generation progress

Parameters:
guid - file guid
request - HTTP servlet request
Returns:
current progress status
Throws:
Exception

getJsHandler

public Object getJsHandler(String scriptName,
                           javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get JavaScript scripts
This method is used to get JavaScripts that are required to construct Viewer's UI

Specified by:
getJsHandler in class GroupDocsViewer
Parameters:
scriptName - Script name or/and path (ex: libs/jquery.js)
response - HTTP servlet response
Returns:

getCssHandler

public Object getCssHandler(String cssName,
                            javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get CSS scripts
This method is used to get CSS scripts that are required to construct Viewer's UI

Specified by:
getCssHandler in class GroupDocsViewer
Parameters:
cssName - Script name or/and path (ex: libs/custom.css)
response - HTTP servlet response
Returns:

getImageHandler

public Object getImageHandler(String imageName,
                              javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get images
This method is used to get images that are required to construct Viewer's UI

Specified by:
getImageHandler in class GroupDocsViewer
Parameters:
imageName - Image name
response - HTTP servlet response
Returns:

getFontHandler

public Object getFontHandler(String fontName,
                             javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get fonts
This method is used to get font that are required to generate documents

Specified by:
getFontHandler in class GroupDocsViewer
Parameters:
fontName - font name
response - HTTP servlet response
Returns:

getHtmlRecoucesHandler

public Object getHtmlRecoucesHandler(String filePath,
                                     javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get HTML resources [GET request]

Specified by:
getHtmlRecoucesHandler in class GroupDocsViewer
Parameters:
filePath - path to resource file
response - HTTP servlet response
Returns:

getFileHandler

public Object getFileHandler(String path,
                             boolean getPdf,
                             javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Download file [GET request]

Specified by:
getFileHandler in class GroupDocsViewer
Parameters:
path - Path to file to be downloaded
getPdf - flag to set if file will be downloaded as PDF or original
response - HTTP servlet response
Returns:

getDocumentPageImageHandler

public Object getDocumentPageImageHandler(String path,
                                          Integer width,
                                          Integer quality,
                                          Boolean usePdf,
                                          Integer pageIndex,
                                          javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get image file [GET request]

Specified by:
getDocumentPageImageHandler in class GroupDocsViewer
Parameters:
path - Relative path to file from base path directory (ex: folder/example.doc or example.doc)
width - Generated images with
quality - Generated images quality
usePdf - Use PDF flag
pageIndex - Page number
response - HTTP servlet response
Returns:

viewDocumentHandler

public Object viewDocumentHandler(javax.servlet.http.HttpServletRequest request,
                                  javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Generate list of images/pages [POST request]

Specified by:
viewDocumentHandler in class GroupDocsViewer
Parameters:
request - HTTP servlet request
response - HTTP servlet response
Returns:
Document as json object

viewDocumentHandler

public Object viewDocumentHandler(String callback,
                                  String data,
                                  javax.servlet.http.HttpServletRequest request,
                                  javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Generate list of images/pages [GET request]

Specified by:
viewDocumentHandler in class GroupDocsViewer
Parameters:
callback - Callback value
data - Data as json object
request - HTTP servlet request
response - HTTP servlet response
Returns:
Document as json object

loadFileBrowserTreeDataHandler

public Object loadFileBrowserTreeDataHandler(javax.servlet.http.HttpServletRequest request,
                                             javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Load tree of files from base directory [POST request]

Specified by:
loadFileBrowserTreeDataHandler in class GroupDocsViewer
Parameters:
request - HTTP servlet request
response - HTTP servlet response
Returns:
File list as json object

loadFileBrowserTreeDataHandler

public Object loadFileBrowserTreeDataHandler(String callback,
                                             String data,
                                             javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Load tree of files from base directory [GET request]

Specified by:
loadFileBrowserTreeDataHandler in class GroupDocsViewer
Parameters:
callback - Callback value
data - Data as json object
response - HTTP servlet response
Returns:
File list as json object

getImageUrlsHandler

public Object getImageUrlsHandler(javax.servlet.http.HttpServletRequest request,
                                  javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get thumbs and other images files [POST request]

Specified by:
getImageUrlsHandler in class GroupDocsViewer
Parameters:
request - HTTP servlet request
response - HTTP servlet response
Returns:
Image thumbnail data as json object

getImageUrlsHandler

public Object getImageUrlsHandler(String callback,
                                  String data,
                                  javax.servlet.http.HttpServletRequest request,
                                  javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get thumbs and other images files [GET request]

Specified by:
getImageUrlsHandler in class GroupDocsViewer
Parameters:
callback - Callback value
data - Data as json object
request - HTTP servlet request
response - HTTP servlet response
Returns:
Image thumbnail data as json object

getPrintableHtmlHandler

public String getPrintableHtmlHandler(javax.servlet.http.HttpServletRequest request,
                                      javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Print document [POST request]

Specified by:
getPrintableHtmlHandler in class GroupDocsViewer
Parameters:
request - HTTP servlet request
response - HTTP servlet response
Returns:
HTML page for printing

getPrintableHtmlHandler

public String getPrintableHtmlHandler(String callback,
                                      String data,
                                      javax.servlet.http.HttpServletRequest request,
                                      javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Print document [GET request]

Specified by:
getPrintableHtmlHandler in class GroupDocsViewer
Parameters:
callback - Callback value
data - Data as json object
request - HTTP servlet request
response - HTTP servlet response
Returns:
HTML page for printing

getDocumentPageHtmlHandler

public Object getDocumentPageHtmlHandler(javax.servlet.http.HttpServletRequest request,
                                         javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get HTML page [POST request]

Specified by:
getDocumentPageHtmlHandler in class GroupDocsViewer
Parameters:
request - HTTP servlet request
response - HTTP servlet response
Returns:

getPdfWithPrintDialog

public Object getPdfWithPrintDialog(String path,
                                    javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Get PDF print dialog [GET request]

Specified by:
getPdfWithPrintDialog in class GroupDocsViewer
Parameters:
path - path to file
response - HTTP servlet response
Returns:

reorderPageHandler

public Object reorderPageHandler(javax.servlet.http.HttpServletRequest request,
                                 javax.servlet.http.HttpServletResponse response)
Description copied from class: GroupDocsViewer
Reorder Page [POST request]

Specified by:
reorderPageHandler in class GroupDocsViewer
Parameters:
request - HTTP servlet request
response - HTTP servlet response
Returns:
json object with success flag as true or false

getPdf2JavaScriptHandler

@Deprecated
public String getPdf2JavaScriptHandler(javax.servlet.http.HttpServletRequest request,
                                                  javax.servlet.http.HttpServletResponse response)
Deprecated. 

Specified by:
getPdf2JavaScriptHandler in class GroupDocsViewer
Parameters:
request - HTTP servlet request
response - HTTP servlet response
Returns:
JavaScript data as json object

getPdf2JavaScriptHandler

@Deprecated
public String getPdf2JavaScriptHandler(String callback,
                                                  String data,
                                                  javax.servlet.http.HttpServletResponse response)
Deprecated. 

Specified by:
getPdf2JavaScriptHandler in class GroupDocsViewer
Parameters:
callback - Callback value
data - Data as json object
response - HTTP servlet response
Returns:
JavaScript data as json object


Copyright © 2014. All rights reserved.