This tutorial shows you how to use JDeveloper to archive and deploy J2EE
and ADF applications to an Oracle 10g Application Server.
Deployment is the process of packaging the files that make up an application
as an archive file, and transferring the archive to the server where the application
will run. This tutorial shows you how to use JDeveloper to deploy either J2EE
or ADF applications to application servers through application server connections.
The basic steps are:
1. Create the application as a JDeveloper project.
2. Package the project components into a deployment
profile and specify deployment resources.
3. Create an application server connection to the Oracle
Application Server.
4. Deploy the packaged application to the Oracle Application
Server.
Move
your mouse over this icon to show all screenshots. You can also move your mouse
over each individual icon to see only the screenshot associated with it.
Overview
This tutorial shows you how to use JDeveloper to package
and deploy the model and view components of both J2EE and ADF applications.
The J2EE application is composed of an EJB as the
model component and a JSP as the view component. The model is deployed to
an EJB JAR file with the JSP deployed to a WAR file. Once each component has
been deployed to the appropriate archive, both are included in an EAR file,
then deployed to the Oracle Application Server 10g .
The ADF application view component is archived to
a WAR file and then deployed to the Oracle Application Server 10g.
In both the J2EE and ADF deployments, the application can then be accessed
using a browser.
To complete this OBE, you must download
and install two JDeveloper workspaces. Each contains a sample application for
you to deploy. These applications access the Common Schema Human Resources database
objects. It is very important to create and name the JDeveloper Database Connections
according to the specifications found in the second step of the prerequisites.
In this step, you will load two application workspaces in JDeveloper and
test the applications using the embedded OC4J server. One workspace contains
a J2EE application with a JSP as the view and an EJB defining the business
rules. The second workspace contains an ADF application.
1.
Download and unzip the deploySamples.zip
file onto your machine in the <JDEVELOPER_HOME>\jdev\mywork\
directory. You should have two directories: deployment_j2ee and deployment_adf
. The deployment_j2ee directory contains a J2EE application and the deployment_adf
contains an ADF application.
2 .
Invoke JDeveloper and independently open each of the two
workspaces. Select Open from the File
menu, and navigate to the <JDEVELOPER_HOME>\jdev\mywork\deployment_j2ee
directory. Select the J2EEApplication.jws
file and click OK to load the J2EE workspace. Repeat the Open operation
and select the ADFApplication.jws
file in the <JDEVELOPER_HOME>\jdev\mywork\deployment_adf
directory.
3.
Compile the J2EE application by selecting the J2EEApplication
workspace in the Application Navigator and selecting the Make
option from the context menu.
4.
Run the J2EE application. Expand the View
node and select the login.
From the context menu, select Run.
5.
When the application is invoked, login using 100
as the Employee Id and King
as the Employee Name.
6.
Three employees belonging to the same department as King
are displayed.
7.
Compile the ADF application by selecting the ADFApplication
workspace in the Application Navigator and selecting the Make
option from the context menu.
8.
Run the ADF application. Expand the ViewController
and Web Content nodes and select Login.jsp.
From the context menu, select Run.
9.
When the application is invoked, login using 100
as the Employee Id and King
as the Employee Name.
10.
Three employees belonging to the Executive department are
displayed.
Step 2- Create
a Connection to the Application Server
JDeveloper supports deploying your applications to a variety of production application
servers, via application sever connections. You must create a connection to
deploy applications directly to Oracle Application Server 10g from
JDeveloper.
1.
Click the Connections tab in the Navigator. Right-click Application
Server and select New Application Server Connection.
2.
In the Type pane, name the connection OracleAS10g
and specify Oracle Application Server 10g as the connection type.
Click Next.
3 .
Provide the password in the Authorization
pane for the ias_admin user,
for example, welcome1, and
click Next.
4 .
In the Connection pane, accept the default
host name and port and specify the ORACLE_HOME
directory for the Oracle Application Server 10g install, for example,
D:\Oracle\OraAS10g, and click
Next.
5 .
Click Next and accept the default values for the EJB
Client Connection.
6 .
Click Next and in the Test pane, click the
Test Connection button. When the status message indicates success, click
Finish.
Step 3- Deploy a J2EE Application
In this step you create an archive for the J2EE components, deploy it to
the Oracle Application Server 10g, and test it from a browser.
With the J2EEApplication
node expanded in the Application Navigator, right-click View
node and select New.
2.
From the “Deployment Profiles” category, select
“EAR File” and Click OK.
3 .
Accept the default Deployment Profile Name (application1).
Click OK.
4 .
In the General category of the EAR Deployment Properties pane,
name the application hr.
5 .
In the Application Assembly node, select the check-boxes
for the ejb1.deploy and
webapp1.deploy to include
them as part of the EAR deployment. Click OK.
6 .
In the Resources node, right-click the
deployment profile (application1.deploy)
and select “Deploy to -> ” and select the name of your
application server connection, (OracleAS10g).
7 .
When you see the text “Deployment
Finished” in the message window, the application has deployed.
It may take up to 5 minutes for this step to complete, depending on your
hardware specifications.
Access the application by using the following
URL: http://localhost/hrapp/login
(the application has the "starter" Login.java
servlet mapped to /login).
2.
Test the application and login using 100
as the Employee Id and King
as the Employee Name.
Step 4 - Deploy an ADF Application
In this step you create an archive for the J2EE components, deploy it to
the Oracle Application Server 10g, and test it from a browser. .
Shut down the Application Server services using
the Application Server Control located by default at: http://localhost:1810.
2.
Shut down the OracleOraAS10ASControl and
OracleOraAS10ProcessManager Application Server services
from the operating system .
3.
In JDeveloper, select Tools -> ADF
Runtime Installer -> Oracle Application Server
(this installs the necessary runtime files for either Oracle9iAS
or Oracle Application Server 10g).
4.
Step your way through the ADF Runtime Installer.
5.
Specify the Application Server home directory then click
Next.
6.
In the Installation Options page, ensure Install
a new version of the ADF runtime is selected and click Next.
7.
On the Summary
page, confirm your settings are correct and click Finish.
8.
When the installation is finished, view the ias.html
and confirm it was successful.
9 .
Restart the Application Server services in Windows and access
http://localhost:1810 to
ensure that the application server is running and the home instance status
is "up".
Create
and Deploy a WAR file for the ADF ViewController Project
Expand the ADFApplication
node in the Application Navigator, right-click ViewController
node and select New.
2.
From the “Deployment Profiles” category, select
“WAR File” and Click OK.
3 .
Accept the default Deployment Profile Name (webapp1).
Click OK.
4 .
In the General Category page, select the Specify J2EE Context
Root radio-button and enter adfapp.
Click OK.
5 .
In the Resources node, right-click the
deployment profile (webapp1.deploy)
and select “Deploy to -> ” and select
the name of your application server connection, (OracleAS10g).
6 .
When you see the text “Deployment
Finished” in the message window, the application has deployed.
It may take up to 5 minutes for this step to complete, depending on your
hardware specifications.
- Creating a JAR archive for the model components of a
J2EE application
- Creating a WAR archive for the view components of a J2EE application
- Creating an EAR archive for the entire application
- Deploying the J2EE application to Oracle Application Server
- Testing the J2EE application deployment
- Installing the ADF runtime libraries
- Creating a WAR archive for the view components of an ADF application
- Deploying the ADF application to Oracle Application Server
- Testing the ADF application deployment