Installing the Oracle JDeveloper 10g Portal Extension
  
  
  


OracleAS Portal Developer Kit (PDK)
Installing the Oracle JDeveloper 10g Portal Extension

Last Update: February 1, 2005
Status: Production
Version: Oracle JDeveloper 10g Portal Extension Release 9.0.5.1

Introduction

The OracleAS Portal Developer Kit (PDK) is a powerful environment to create portlets, the reusable, pluggable Web components that display portions of Web content. Now, you can use the PDK to quickly and easily build portlets based on portlet standards.  These portlets can be deployed into any portlet container supporting the Java Portlet Specification 1.0, such as the OracleAS Java Portlet Container which automatically enables your portlets to interoperate with other WSRP-enabled portals.

As part of this release, we provide you with the necessary libraries to install the Java Portlet Wizard into Oracle JDeveloper 10g (see Installation, below).

The Oracle JDeveloper 10g Portal Extensions have the goal to reduce the amount of work for wrapping your business logic so you can concentrate on implementing the necessary functionality. Using the Java Portlet Wizard dramatically increases the flexibility and productivity when developing portlets.

Prerequisites

  1. You have downloaded and installed, or have access to, one of the following versions of Oracle JDeveloper 10g: 9.0.5.1, 9.0.5.2, or 10.1.2.  The location of your Oracle JDeveloper 10g installation will be referred to as <jdev home>.

  2. You have downloaded and installed a Java Portlet Specification 1.0 compatible container such as the OracleAS Java Portlet Container and PDK (available from Portal Center).

Assumptions

  1. You are familiar with portlet terminology such as portlet show modes.  For an overview of portlets, review the Understanding Portlets chapter of the Portal Developer's Guide.

  2. You are already familiar with J2EE development using an Integrated Development Environment (IDE) such as Oracle JDeveloper 10g.

Installation

This version of the Oracle JDeveloper 10g Extension includes two wizards for portlet building:  Java Portlet and Oracle PDK Java Portlet.  The Java Portlet wizard allows you will build portlets based on the Java Portlet Specification 1.0.  The Oracle PDK Java Portlet wizard allows you to build portlet based on the Oracle PDK APIs.

  1. At a command prompt, ensure that the J2SE SDK 1.4 binaries are available in your system path. To do this, type "java -version". You should see something like:
    java version "1.4.2_02"
    Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_02-b03)
    Java HotSpot(TM) Client VM (build 1.4.2_02-b03, mixed mode)

    If not, alter your PATH environment variable so that it includes the 'bin' directory of your J2SE SDK 1.4.1 install (you may want to set up a script or shortcut to do this). After doing this, repeat the previous step to ensure the J2SE SDK 1.4 binaries are now available in your system path.

    • In Windows Command Prompt:
      set PATH=D:\j2sdk1.4.2_02\bin;%PATH%
    • In UNIX/Linux Bourne Shell (sh):
      export PATH=/usr/lib/java/bin:$PATH

  2. If Oracle JDeveloper 10g is currently running, shut it down.

  3. Run the auto-installer, passing as the only argument the location of your Oracle JDeveloper 10g installation, with the following command:
    java -jar portal-addin-install.jar <jdev home>
  4. You should see output similar to the following

    Backing up "/opt/jdev/10g/jdev/lib/ext/portal-addin.jar"
    Backing up "/opt/jdev/10g/jdev/lib/ext/ptlshare.jar"
    Backing up "/opt/jdev/10g/jdev/lib/ext/pdkjava.jar"
    Backing up "/opt/jdev/10g/jdev/lib/ext/jazn.jar"
    Backing up "/opt/jdev/10g/jdev/lib/ext/jazncore.jar"
    Backing up "/opt/jdev/10g/jdev/lib/ext/wsrp-container.jar"
    Backing up "/opt/jdev/10g/jdev/lib/patches/jaxb-api.jar"
    Backing up "/opt/jdev/10g/jdev/lib/patches/jaxb-impl.jar"
    Backing up "/opt/jdev/10g/jdev/lib/patches/jaxb-libs.jar"
    Backing up "/opt/jdev/10g/jdev/lib/patches/namespace.jar"
    Backing up "/opt/jdev/10g/jdev/lib/patches/relaxngDatatype.jar"
    Backing up "/opt/jdev/10g/jdev/lib/patches/xsdlib.jar"
    Installing "/opt/jdev/10g/jdev/lib/ext/portal-addin.jar"
    Installing "/opt/jdev/10g/jdev/lib/ext/wsrp-container.jar"
    Installing "/opt/jdev/10g/jdev/lib/ext/oracle-portlet-tags.jar"
    Installing "/opt/jdev/10g/jdev/lib/ext/ptlshare.jar"
    Installing "/opt/jdev/10g/jdev/lib/ext/pdkjava.jar"
    Installing "/opt/jdev/10g/jdev/lib/ext/jazn.jar"
    Installing "/opt/jdev/10g/jdev/lib/ext/jazncore.jar"
    Installing "/opt/jdev/10g/jdev/lib/patches/jaxb-api.jar"
    Installing "/opt/jdev/10g/jdev/lib/patches/jaxb-libs.jar"
    Installing "/opt/jdev/10g/jdev/lib/patches/jaxb-impl.jar"
    Installing "/opt/jdev/10g/jdev/lib/patches/namespace.jar"
    Installing "/opt/jdev/10g/jdev/lib/patches/relaxngDatatype.jar"
    Installing "/opt/jdev/10g/jdev/lib/patches/xsdlib.jar"
    Install successful. You may now start JDeveloper.

    Note: the auto installer will back up previous extension files to a zip file in the <jdev home> root directory.  If you did not have a previous version installed, you will not see the "Backing up ..." messages.

  5. Start Oracle JDeveloper 10g.

Start Using the Oracle JDeveloper 10g Portal Extension

  1. Start Oracle JDeveloper 10g

  2. Ensure you are in a Workspace/Project context (if necessary, create a new temporary workspace and project).

  3. Right-click on your project and select "New".

  4. In the New Object Gallery, expand the "Web Tier" node on the left-hand side.

  5. Select the "Portlets" node.

  6. Ensure two items are visible and selectable: Java Portlet and Oracle PDK Java Portlet.  Select Java Portlet and click OK.

Begin Building Portlets

To begin building standards based Java Portlets, refer to Building Portlets Using the Java Portlet Wizard within Oracle JDeveloper. You can find this article in the Portlet Development section of the Java area at portalcenter.oracle.com.


Oracle Corporation
World Headquarters
500 Oracle Parkway
Redwood Shores, CA 94065, USA
http://www.oracle.com/
Worldwide Inquiries:
1-800-ORACLE1
Fax 650.506.7200
Copyright and Corporate Info
E-mail this page
Printer View Printer View
Oracle Is The Information Company About Oracle | Oracle RSS Feeds | Careers | Contact Us | Site Maps | Legal Notices | Terms of Use | Privacy