Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Portal Server 6 2005Q1 Technical Reference Guide 

Chapter 61
Normal Tags in desktop.tld

All of the normal tags in the desktop.tld file have a bodycontent of empty.

Table 61-1  desktop.tld Normal Tags with Attributes  

Tag Name

Description

Attributes

getProviderClassName

Returns the class name of the provider that backs the channel.

id (optional)

scope (optional)

getContent

Returns a string buffer with the contents of the provider’s object’s default view. This method is called by the clients of the provider object to request the provider’s default view. This method may return null if the provider does not implement a default view. In this case, the provider should return false from its isPresentable() method.

none

getTitle

Returns a string with the title of the channel.

id (optional)

scope (optional)

silentException (optional)

getDescription

Returns a string with the description for the channel.

id (optional)

scope (optional)

silentException (optional)

getEdit

Returns a string buffer with the provider’s Edit page.

id (optional)

scope (optional)

getHelp

Returns the help URL for this provider. The returned help URL can be either fully qualified URL string (http://server:port/portal/docs/en/desktop/usedesk.htm) or a relative path (desktop/usedesk.htm). When it is a relative path, the Desktop software resolves it to the full URL.

id (optional)

scope (optional)

silentException (optional)

getName

Returns a string with the name of the provider, which must match the name of the provider the channel was initialized with.

id (optional)

scope (optional)

getRefreshTime

Returns a long with the refresh time for this provider in seconds.

Use this value to determine if you should fetch a fresh default view for the provider.

If the return value from this method is X, you may choose not to fetch fresh content (and use a cached copy instead) if less than X seconds has elapsed since the last time the content was refreshed.

If provider content is expected to change infrequently, this method can return some value so that the provider’s content is not fetched every time the front page is drawn, thereby saving significant processing time.

id (optional)

scope (optional)

getWidth

Returns an integer with the suggested width for the channel to the container of the channel as to how much screen real estate it requires. The values correspond to thick, thin, full top and full bottom.

id (optional)

scope (optional)

silentException (optional)

getEditType

Returns an integer that defines edit type either EDIT_SUBSET or EDIT_COMPLETE.

id (optional)

scope (optional)

isEditable

Returns a Boolean that gives the editable status of the channel. Returns true if the channel is editable; otherwise false.

id (optional)

scope (optional)

isPresentable

Returns a Boolean that gives the presentable status for a channel. Returns true if the channel is presentable.

Searches for the key HTML with the value true on the client data for the session’s client type and returns true.

If there is no such key, the method returns true if the session’s client type is named HTML.

In both cases, the content-type for the session’s client type must equal text/html in order for the method to return true.

id (optional)

scope (optional)

processEdit

Performs the provider’s Edit page processing. Processes a form for this provider. This method is called to process form data associated with the provider. Typically, this method is called to process the Edit page generated from the getEdit() method. Usually, the client calling this method on a provider object is the desktop servlet. Form data that is passed into this method in the request has been decoded into Unicode.

id (optional)

scope (optional)

getContainerClassName

Returns the class name of the container that backs the container.

id (optional)

scope (optional)

getSelectedChannels

Returns a list of selected channel names. The list returned is a Collection of Strings. Each of the Strings is the name of a channel that has been selected.

id (required)

scope (optional)

getAvailableChannels

Returns a list of available channel names. The list returned is a Collection of Strings. Each of the Strings is the name of a channel that is available

id (required)

scope (optional)

scontent

Returns the URL of the directory that has the static content (for example, images and style sheet). This utility tag can be used anywhere.

none



Previous      Contents      Index      Next     


Part No: 817-7696.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.