com.groiss.dms.html

Class DMSUtil

java.lang.Object

com.groiss.dms.html.DMSUtil

public class DMSUtil
extends Object

Utility class containing methods for customizing web interfaces of the document management.

Method Summary

Modifier and Type	Method and Description
static String	getEditUrl(DMSObject object, DMSFolder folder, boolean readOnly) Returns a relative URL (starting with classname) for editing or viewing a document in the DMS.
static String	getIconClass(DMSObject object) Returns css classes for the icon of the document.
static String	getPath(DMSFolder folder, DMSObject object) Returns the path string for a object in a folder.
static Page	showDMSFolder(HttpServletRequest req) Show a DMSFolder.
static void	showDocument(DMSDocForm document, HttpServletRequest req, HttpServletResponse res) Send the contents of a document to the client.

Methods inherited from class java.lang.Object

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

Method Detail

getIconClass

public static String getIconClass(DMSObject object)

Returns css classes for the icon of the document. The document icon can be created from an empty div element with these css classes.

Parameters:

object - a DMSObject

Returns:

css classes string

showDMSFolder

public static Page showDMSFolder(HttpServletRequest req)
                          throws Exception

Show a DMSFolder. The appearance can be customized with the following request parameters:

• showToolbar: show a toolbar
• displayClose: display a close button on the bottom
• disableUpNav: disable up-navigation

values are true and false, false is the default. Define the folder with a "folder" request parameter in syntax classname:oid, "object" parameter in same syntax, or a "path" parameter (syntax see getPath(DMSFolder, DMSObject))

Parameters:

req -

Returns:

a page containing the folder contents

Throws:

Exception

getEditUrl

public static String getEditUrl(DMSObject object,
                                DMSFolder folder,
                                boolean readOnly)

Returns a relative URL (starting with classname) for editing or viewing a document in the DMS.

Parameters:

object - a DMSObject

folder - the folder containing the document

readOnly - if true the object is opened in view mode (applicable for forms where an edit url is returned)

Returns:

a relative URL

showDocument

public static void showDocument(DMSDocForm document,
                                HttpServletRequest req,
                                HttpServletResponse res)
                         throws Exception

Send the contents of a document to the client. The mime-type is set based on the document extension. If the mime-type starts with "text/" the configured text character is used (system configuration, section DMS).

Parameters:

document - a document

Throws:

Exception

getPath

public static String getPath(DMSFolder folder,
                             DMSObject object)

Returns the path string for a object in a folder. Note, that the path string for the folder is cached for the thread.

Parameters:

folder - a folder

object - a object in the folder

Returns:

a path string: list of the names of the folders up to the root folder followed by the object name, separated by "/", for example: Common/projects/ep/document.txt