| java.lang.Object
 __PACKAGE__.__NAME__
| getContent | | public StringBuffer getContent(HttpServletRequest request, HttpServletResponse response) throws ProviderException(Code) | | Gets the provider's objects 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.
StringBuffer holding the content.
Parameters:
request - An HttpServletRequest that containsinformation related to this request for content.
Parameters:
response - An HttpServletResponse that allows the providerto influence the overall response for the desktop page (besides generating the content).
exception:
ProviderException - If there was an error generating thecontent. How this exception is handled is up to the client of theprovider object.
See Also: com.sun.portal.providers.ProviderException |
| getEdit | | public StringBuffer getEdit(HttpServletRequest request, HttpServletResponse response) throws ProviderException(Code) | | Gets the edit view for the provider.
This method is called by the clients of the provider object
to request the provider's edit view.
This method must generate either a complete document, or a subset,
depending on the return value of .getEditType().
A subset document should include all code that goes between
the FORM tags. The exception is that the
submit and cancel buttons should not be
generated. A subset document is always submitted back to the
desktop servlet, where control is passed to the provider's
processEdit() method for processing the
form data.
If a complete document is returned,
there are several restrictions:
- It must be a complete, valid form.
- The form must have an encoding type of
"application/x-www-form-urlencoded".
- The form action must point back to the desktop servlet.
Typically, this is "/portal/dt".
- The form must specify a valid action to the desktop servlet
as defined in the DesktopSerlvet javadocs.
The above restrictions only apply if the form is to be submitted
to the desktop servlet. If the form is submitted to a third-party
CGI or servlet, the format will depend on what this entity is
expecting.
This method may return null if the provider does not implement an edit
view. In this case, the provider should return false from its
isEditable() method.
StringBuffer holding the html edit form.
Parameters:
request - An HttpServletRequest thatcontains information related to this request for content.
Parameters:
response - An HttpServletResponse thatallows the provider to influence the overall response for the desktop page (besides generating the content).
exception:
ProviderException - If there was an error generating theedit form. How this exception is handled is up to the client of theprovider object.
See Also: com.sun.portal.providers.Provider.getContent
See Also: com.sun.portal.providers.Provider.isEditable
See Also: com.sun.portal.providers.Provider.processEdit
See Also: com.sun.portal.providers.Provider.getEditType
See Also: com.sun.portal.desktop.DesktopServlet
See Also: com.sun.portal.providers.ProviderException
See Also: |
| getHelp | | public URL getHelp(HttpServletRequest request) throws ProviderException(Code) | | Gets the help URL for this provider.
The returned help URL can be either fully-qualified URL string (e.g.,
http://server:port/portal/docs/en_US/desktop/usedesk.htm)
or a relative path (e.g., desktop/usedesk.htm)). When it is
relative path, the desktop software will prepend the server request
string (e.g., http://server:port/portal, plus the
document root (e.g., /docs/), plus the user locale (e.g.,
en_US/) to it to resolve the full URL.
A URL pointing to the help page for the provider. A returnvalue of null should signify that this provider does not have ahelp page. |
| getName | | public String getName()(Code) | | Gets the name of this provider.
The name returned from this method must match the name of the provider
that it was initialized with.
The name of this provider. |
| getRefreshTime | | public long getRefreshTime() throws ProviderException(Code) | | Gets the refresh time for this provider, in seconds.
Clients of the provider object should use this value to determine
if they should fetch a fresh default view for the provider.
If the return value from this method is X, they may choose to
not fetch fresh content (and use a cached copy instead) if less than
X seconds has elapsed since the last time content was fetched.
If provider content is expected to change very 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.
Clients may choose not to use this value.
>0, refresh time in number of seconds that a container shouldwait before expiring a content cache.0, container should never cache channel's content.-1, container may cache channel's content indefinitely. |
| init | | public void init(String pName, HttpServletRequest request) throws ProviderException(Code) | | Initializes the provider.
This method must be called by clients of the provider object
when the provider object is created (after it is constructed, or
before the object is used). This method should not be called more
than once per object.
Parameters:
name - Unique name identifying this provider. This valueshould always be returned from getName().
Parameters:
req - The HTTP request object corresponding to the HTTP requestthat caused this provider object to be created. This request may beused to extract session or user information that could be used togain access to external resources.
exception:
ProviderException - If there was an error initializing theprovider. How this exception is handled is up to the client of theprovider object.
See Also: com.sun.portal.providers.Provider.getName
See Also: |
| isPresentable | | public boolean isPresentable()(Code) | | Determines if the provider is presentable based on the client device type.
true or false, indicating if theprovider is presentable to the user's client device. |
| processEdit | | public URL processEdit(HttpServletRequest request, HttpServletResponse response) throws ProviderException(Code) | | 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, passed into this method in the request, has been decoded into
Unicode.
When the desktop servlet receives a request where the action is
"process", it looks at the
parameters to identify which provider will handle the action, through
this method. The request passed in contains the parameters.
After calling this method, the desktop servlet will re-direct to the URL
returned from this method. Therefore, the result of a provider post
can be any desktop serlvet action, or the content of an arbitrary URL.
For more information on constructing desktop serlvet URLs, see
DesktopSerlvet.
The URL that the iPS desktop will re-direct to. A valueof null should indicate to the client that it should return to itsdefault view.
Parameters:
request - An HttpServletRequest that containsinformation related to thisrequest for content.
Parameters:
response - An HttpServletResponse that allows theprovider to influence the overall response for the desktop page (besides generating the content).
exception:
ProviderException - If there was an error processingthe edit form. How this exception is handled is up to the client of theprovider object. The URL that the iPS desktop will re-direct to. A valueof null should indicate to the client that it should return to itsdefault view.
See Also: com.sun.portal.providers.Provider.getEdit
See Also: com.sun.portal.providers.Provider.isEditable
See Also: com.sun.portal.providers.InvalidEditFormDataException
See Also: com.sun.portal.desktop.DesktopServlet |
|
|