com.saperion.ngc.viewer

Class DocumentViewPresenter

java.lang.Object

com.saperion.ngc.viewer.DocumentViewPresenter

All Implemented Interfaces:

Presenter

public class DocumentViewPresenter
extends Object
implements Presenter

Presenter for document viewing.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DocumentViewPresenter() Constructor.

Method Summary

Modifier and Type	Method and Description
boolean	canDownload(int maskRights, DocumentId documentId) Checks if downloading an item is allowed in this mask.
boolean	canEditAnnotations(OpenDocumentBean bean) Checks if the user can edit the annotations.
boolean	canEditDocument(DocumentId id) Checks if the document can be edited.
boolean	canView(DocumentId documentId) Checks if the document can be opened in viewer.
void	checkConnection() Checks if the connection to the backend is still alive.
void	downloadAsZip(List<Content> content) Triggers a download of a ZIP containing the specified content.
void	downloadSingle(DocumentId docId, String filename, int element) Triggers the download of a single document.
DocumentArchiveMetaInfo	getArchiveMetaInfo(DocumentId documentId, boolean currentRevision, boolean previewMode) Gets the archive meta info.
List<Content>	getContentListForLink(DocumentId id, DocumentArchiveMetaInfo linkMetaInfo) Returns a list of Content of a linked document.
ResultProperties	getDocumentInfo(DocumentId id) Returns the database meta-info of the document with the specified ID.
long	getElementSize(DocumentId id, int element) Determines the size of the element.
Map<Integer,Long>	getElementSizes(DocumentId id, List<Integer> elementsWithoutSize) Determines the sizes of the list of elements.
String	getLinkFilename(DocumentArchiveMetaInfo archiveMetaInfo) Returns the file name for a linked element.
long	getLinkFileSize(DocumentArchiveMetaInfo linkInfo) Returns the file size of a linked document.
String	getNotes(String hDoc) Reads the notes element for the given document id.
InputStream	getStream(DocumentId id, int element) Gets the document's content as stream.
String	resolveLatestRevision(String originalHdoc) Resolves the latest revision of the document with the specified HDOC.
void	writeNotes(DocumentId documentId, String text) Writes the text to the notes element or creates a new one.

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentViewPresenter

protected DocumentViewPresenter()

Constructor.

Method Detail

getArchiveMetaInfo

public DocumentArchiveMetaInfo getArchiveMetaInfo(DocumentId documentId,
                                                  boolean currentRevision,
                                                  boolean previewMode)
                                           throws NgcUiException,
                                                  AuthenticationException

Gets the archive meta info.

Parameters:

documentId - the document id

currentRevision - if true, the latest revision of the document will be retrieved

previewMode - used to decide if the document will be opened in the preview viewer or not

Returns:

meta information about the document

Throws:

NgcUiException - exception to be handled by view

AuthenticationException - re-logon required

canEditDocument

public boolean canEditDocument(DocumentId id)
                        throws AuthenticationException,
                               NgcUiException

Checks if the document can be edited.

Parameters:

id - document id

Returns:

true if edit is possible

Throws:

AuthenticationException - authentication exception

NgcUiException - exception that causes an error window

getNotes

public String getNotes(String hDoc)
                throws AuthenticationException,
                       NgcUiException

Reads the notes element for the given document id. It returns the text or an empty string, if the notes element don't exists.

Parameters:

hDoc - Document id

Returns:

Notes string

Throws:

AuthenticationException - authentication exception

NgcUiException - exception that causes an error window

writeNotes

public void writeNotes(DocumentId documentId,
                       String text)
                throws AuthenticationException,
                       NgcUiException

Writes the text to the notes element or creates a new one.

Parameters:

documentId - Document ID

text - Text

Throws:

AuthenticationException - authentication exception

NgcUiException - exception that causes an error window

checkConnection

public void checkConnection()
                     throws AuthenticationException,
                            NgcUiException

Checks if the connection to the backend is still alive.

Throws:

AuthenticationException - if re-logon is required

NgcUiException - if checking the connection failed

getElementSizes

public Map<Integer,Long> getElementSizes(DocumentId id,
                                         List<Integer> elementsWithoutSize)
                                  throws NgcUiException,
                                         AuthenticationException

Determines the sizes of the list of elements.

Parameters:

id - document id

elementsWithoutSize - List of elements that have no file size.

Returns:

Map with element numbers and its sizes (in bytes)

Throws:

NgcUiException - exception to be handled by view

AuthenticationException - Authentication exception

getElementSize

public long getElementSize(DocumentId id,
                           int element)
                    throws NgcUiException,
                           AuthenticationException

Determines the size of the element.

Parameters:

id - document id

element - element number

Returns:

size (in bytes)

Throws:

NgcUiException - exception to be handled by view

AuthenticationException - Authentication exception

getStream

public InputStream getStream(DocumentId id,
                             int element)
                      throws NgcUiException,
                             AuthenticationException

Gets the document's content as stream.

Parameters:

id - the id of the document

element - the element to retrieve

Returns:

the content as stream

Throws:

NgcUiException - exception to be handled by view

AuthenticationException - authentication exception

canEditAnnotations

public boolean canEditAnnotations(OpenDocumentBean bean)
                           throws NgcUiException,
                                  AuthenticationException

Checks if the user can edit the annotations. If an annotation contains an ACL that forbids editing, the viewer must be switched to read-only mode. The annotations are retrieved from the backend and are stored in the bean for re-use.

Parameters:

bean - the open-document-bean

Returns:

true, if user can edit the annotations

Throws:

NgcUiException - exception to be handled by view

AuthenticationException - re-logon required

canView

public boolean canView(DocumentId documentId)
                throws NgcUiException

Checks if the document can be opened in viewer.

Parameters:

documentId - id of the document

Returns:

true if viewing is allowed

Throws:

NgcUiException - exception to be handled by view

canDownload

public boolean canDownload(int maskRights,
                           DocumentId documentId)
                    throws NgcUiException

Checks if downloading an item is allowed in this mask.

Parameters:

maskRights - rights on this mask

documentId - id of the current document

Returns:

true if allowed

Throws:

NgcUiException - exception to be handled by view

getLinkFileSize

public long getLinkFileSize(DocumentArchiveMetaInfo linkInfo)

Returns the file size of a linked document. If the document has a single element, the size of the element is returned. If not, "unknown size" is returned.

Parameters:

linkInfo - archive info of the linked element

Returns:

file size string

getLinkFilename

public String getLinkFilename(DocumentArchiveMetaInfo archiveMetaInfo)

Returns the file name for a linked element. If the linked document contains a single element, the name of the element is returned. If not, a generic title ("Documents") is returned.

Parameters:

archiveMetaInfo - archive info of the linked element

Returns:

file name string

getContentListForLink

public List<Content> getContentListForLink(DocumentId id,
                                           DocumentArchiveMetaInfo linkMetaInfo)
                                    throws NgcUiException,
                                           AuthenticationException

Returns a list of Content of a linked document.

Parameters:

id - id of the linked document

linkMetaInfo - archive info of the link

Returns:

list of Content

Throws:

NgcUiException - exception to be handled by view

AuthenticationException - re-logon required

downloadAsZip

public void downloadAsZip(List<Content> content)
                   throws AuthenticationException,
                          NgcUiException

Triggers a download of a ZIP containing the specified content.

Parameters:

content - content to download

Throws:

AuthenticationException - re-logon required

NgcUiException - exception to be handled by view

downloadSingle

public void downloadSingle(DocumentId docId,
                           String filename,
                           int element)
                    throws AuthenticationException,
                           NgcUiException

Triggers the download of a single document.

Parameters:

docId - id of the document to download

filename - name of the file

element - element to download

Throws:

AuthenticationException - re-logon required

NgcUiException - exception to be handled by view

resolveLatestRevision

public String resolveLatestRevision(String originalHdoc)
                             throws NgcUiException,
                                    AuthenticationException

Resolves the latest revision of the document with the specified HDOC.

Parameters:

originalHdoc - HDOC to resolve

Returns:

HDOC of the latest revision of the document

Throws:

NgcUiException - system error when resolving revision

AuthenticationException - re-logon required

getDocumentInfo

public ResultProperties getDocumentInfo(DocumentId id)
                                 throws NgcUiException,
                                        AuthenticationException

Returns the database meta-info of the document with the specified ID.

Parameters:

id - document's ID

Returns:

database meta-info

Throws:

NgcUiException - exception to be handled by view

AuthenticationException - re-logon required