Oracle9iAS Portal Developer Kit
Upgrading to PDK-URL Services v9.0.2

This document describes how to upgrade your PDK-URL Services v3.0.9 provider to PDK-URL Services v9.0.2. The jump in version numbers reflects the synchronization of version numbers with Oracle9iAS v9.0.2, of which the PDK-URL Services is a component.

UPGRADING THE PROVIDER.XML

To upgrade your PDK-URL Services provider to PDK-URL Services v.9.0.2, you simply need to modify the provider.xml file of your provider. Then your provider will be ready for deployment on OC4J (see the article Installing the PDK-URL Services Samples (V2)). This article simply describes what you need to do to upgrade your provider.xml file.

There are two ways to upgrade your provider.xml file: automatically and manually. You can automatically upgrade the file by placing it in the same directory as the upgrade.bat file provided by PDK-URL Services and then running upgrade.bat. This will automatically convert the provider.xml file to a v2 compliant provider.xml.

To manually upgrade your provider.xml file, you must change the syntax of any tag attributes that refer to a java package that is specific to v1.  Use the following table as a guide.  Once you have converted all of the tag attributes to reflect the appropriate v2 java package names, you have completed all that is necessary to upgrade your provider.

Tag Name

Syntax in v1

Syntax in v2

provider

<provider class="oracle.portal.provider.v1.http.URLProvider" session="true">

Divided into two parts

  • URLProviderDefinition - for containing meta data information.
  • URLProviderInstance - for managing the portlets owned by this provider instance.

<provider class="oracle.portal.provider.v2.http.URLProviderDefinition">
<providerInstanceClass> oracle.portal.provider.v2.http.URLProviderInstance </providerInstanceClass>

authentication

 

<authentication class="oracle.portal.provider.v1.http.Authentication">

<authentication class="oracle.portal.provider.v2.security.Authentication">

proxyInfo

<proxyInfo class="oracle.portal.provider.v1.http.ProxyInformation">

<proxyInfo class="oracle.portal.provider.v2.ProxyInformation">

httpsProxyInfo

<httpsProxyInfo class="oracle.portal.provider.v1.http.ProxyInformation">

<httpsProxyInfo class="oracle.portal.provider.v2.ProxyInformation">

portlet

<portlet class="oracle.portal.provider.v1.http.URLPortlet">

<portlet class="oracle.portal.provider.v2.http.URLPortletDefinition">

render

<renderer class="oracle.portal.provider.v1..RenderManager">

<renderer class="oracle.portal.provider.v2.render.RenderManager">

showPage

<showPage class="oracle.portal.provider.v1.http.URLRenderer">

<showPage class="oracle.portal.provider.v2.render.http.URLRenderer">

filter

<filter class="oracle.portal.provider.v1.http.HtmlFilter">

<filter class="oracle.portal.provider.v2.render.HtmlFilter">

securityManager

<securityManager class="oracle.portal.provider.v1.http.URLSecurityManager">

<securityManager class="oracle.portal.provider.v2.security.URLSecurityManager">

Revision History: