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
- 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>.
- 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
-
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.
-
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.
- 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
- If Oracle JDeveloper 10g
is currently running, shut it down.
- 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>
- 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.
- Start Oracle JDeveloper 10g.
Start Using the Oracle
JDeveloper 10g
Portal Extension
-
Start
Oracle JDeveloper 10g
-
Ensure
you are in a
Workspace/Project context (if necessary, create a new temporary
workspace and project).
-
Right-click
on your project and
select "New".
-
In
the New Object Gallery, expand
the "Web Tier" node on the left-hand side.
-
Select
the "Portlets" node.
- 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.
|