org.apache.jetspeed.portlet.service
Interface ContentAccessService

All Superinterfaces:
PortletService

Deprecated. since 6.0. Support of the IBM portlet API may be removed in a future release of WebSphere Portal. Use of the Java Portlet API (javax.portlet) is recommended instead.

public interface ContentAccessService
extends PortletService

Service to access external and internal resources. This on-demand proxy allows the creation of a URL or Stream which can then be passed to other classes without knowing about the proxy support to enable seemless adaption to proxied environments. The proxying will be provided to the URL object by means of a StreamHandler.

Since:
4.1

Method Summary
 java.io.InputStream getInputStream(java.lang.String urlString, PortletRequest req, PortletResponse resp)
          Deprecated. Returns an input stream that reads from the passed url.
 java.lang.String getMarkup(java.lang.String urlString, PortletRequest req, PortletResponse resp)
          Deprecated. Returns the markup of the input stream read from the passed url.
 java.net.URL getURL(java.lang.String urlString, PortletRequest request, PortletResponse response)
          Deprecated. Returns an URL object after following redirects using a proxy if necessary
 void include(java.lang.String urlString, PortletRequest request, PortletResponse response)
          Deprecated. Writes the content of the given url to the output stream of the portlet following redirects and using a proxy if necessary trying to use the RequestDispatcher to include local servlets or JSPs
 

Method Detail

getURL

java.net.URL getURL(java.lang.String urlString,
                    PortletRequest request,
                    PortletResponse response)
                    throws PortletServiceException,
                           java.net.MalformedURLException
Deprecated. 
Returns an URL object after following redirects using a proxy if necessary

Parameters:
urlString - a string representing the start url
request - the portlet request
response - the portlet response
Returns:
URL object based on the given url string and the proxy configuration
Throws:
PortletServiceException - if the needed credential could not be retrieved or the expected URL could not been created.
java.net.MalformedURLException - if the given urlString is a malformed URL.

getInputStream

java.io.InputStream getInputStream(java.lang.String urlString,
                                   PortletRequest req,
                                   PortletResponse resp)
                                   throws PortletServiceException,
                                          java.net.MalformedURLException
Deprecated. 
Returns an input stream that reads from the passed url.

Parameters:
urlString - a string representing the start url
req -
resp -
Returns:
InputStream from the proxied connection
Throws:
PortletServiceException - thrown if the portlet service fails
java.net.MalformedURLException - thrown if the URL is invalid

getMarkup

java.lang.String getMarkup(java.lang.String urlString,
                           PortletRequest req,
                           PortletResponse resp)
                           throws PortletServiceException,
                                  java.net.MalformedURLException
Deprecated. 
Returns the markup of the input stream read from the passed url.

Parameters:
urlString - a string representing the start url
req -
resp -
Returns:
String representing the markup of the proxied connection
Throws:
PortletServiceException - thrown if the portlet service fails.
java.net.MalformedURLException - thrown if the URL is invalid.

include

void include(java.lang.String urlString,
             PortletRequest request,
             PortletResponse response)
             throws PortletServiceException,
                    java.net.MalformedURLException
Deprecated. 
Writes the content of the given url to the output stream of the portlet following redirects and using a proxy if necessary trying to use the RequestDispatcher to include local servlets or JSPs

Parameters:
urlString - a string representing the start url
request - the portlet request
response - the portlet response
Throws:
PortletServiceException - thrown if the portlet service fails.
java.net.MalformedURLException - thrown if the URL is invalid.