Deploying a J2EE Application from JDeveloper 10g


Purpose

 
  
This tutorial shows you how to use JDeveloper to archive and deploy J2EE 
    applications (either ADF or non-ADF applications) to Oracle Application Server 10g.
  
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 applications to the OracleAS 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. 

      

       
  


Topics

The tutorial discusses the following:


 

  
 
    

    
Overview
  
  
 
    

    
Prerequisites
  
  
 
    

    
Compile and Run the Application 
      from JDeveloper
  
  
 
    

    
Create a Connection to the 
      Application Server
  
  
 
    

    
 Deploy a J2EE Application
  
  
 
    

    
Deploy an ADF-based J2EE Application 
  
  
 
    

    
Summary
  



Time to complete

This tutorial should take about an hour to complete.

    

Viewing Screenshots
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. 

Back to Topic 
  List 

Scenario
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 Sample 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. 


 

Prerequisites

Back to Topic List

In order for this lesson to work successfully, you
need to have performed the following:


 

  
 
    

 
      1.
    
 
      
Install Oracle JDeveloper 10g.
      
    
 
  
  
 
    
 
       
      2.
    
 
      
 
        Install the Oracle Application Server 10g. 
          You will need the administrator Username and Password to start and stop 
          it.
		  
        
 
      
    
  
  
 
    
 
      
      3.
    
 
      
 Install the sample schema and create a connection 
        to the HR or HR8 schema to use in this tutorial. See Installing 
        the Sample Schemas and Establishing a Database Connection tutorial. 
        Ensure the name of the connection is 
        tutorial_jdbc_connection. 
		
  
      
    
  
  
 
    
 
      
      4.
    
 
      

        
Download the deploySamples.zip 
          file to your machine. It contains the sample JDeveloper workspaces for 
          use in this OBE. 
        
  
      
    
  



  

 Compile and 
  Run the Applications from JDeveloper

Back to Topic List

 
  
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 
      and Application Sources nodes. Right click 
      login.java and 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. 
      

      
 
  




 
 Create a 
  Connection to the Application Server

Back to Topic List



  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.
    
Review the welcome page and click Next. Name the connection 
      OracleAS10g and 
      specify Oracle Application Server 10g as the connection type. Click 
      Next. 
      
 
      
 
    
  
  
 
    
 
      
      3.
    
Provide the password for the ias_admin 
      user, for example, welcome1, 
      and click Next.
 
      
 
      
 
    
  
  
 
    
 
      
      4.
    
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.
    
Accept the default values for the EJB Client Connection
      and click Next.  
      

      
 
    
  
  
 
    
 
      
      6.
    
Click Test Connection. When the status message 
      indicates success, click Finish.  
      

      
 
    
  


  

 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.


Back to Topic List




  
 
    

    
Create and Deploy 
      a JAR file for the J2EE EJB Model Project
  
  
 
    

    
Create and Deploy 
      a WAR file for the J2EE View Project
  
  
 
    

    
Create and Deploy 
      an EAR file for the Complete J2EE Application
  
  
 
    

    
Test the J2EE 
      Application Deployment
  

  

 Create and Deploy 
a JAR file for the J2EE EJB Model Project


  
Back to List



 



  
 
    

 
      1.
    
With the J2EEApplication 
      node expanded in the Application Navigator, right-click Model 
      node, and select New. 
      
 
      
  
  
 
    

 
      2.
    
From the Deployment Profiles category, select 
      EJB JAR File and click OK.  
      
 
      
 
  
  
 
    

 
      3 .
    
Accept the default deployment profile name (ejb1). 
      Click OK.

      

      
 
    
  
  
 
    

 
      4 .
    
In the EJB JAR Deployment Profile Properties pane, 
      specify the enterprise application name as hrejb. 
      Click OK.   

      

      
 
      
  
  
 
    

 
      5 .
    
In the Resources node of the Application Navigator, 
      right-click the deployment profile (ejb1.deploy) 
      and select Deploy to JAR file. 

      

      
 
      
  
  
 
    
 
      
      6 .
    
 In the Deployment window, ensure the EJB JAR file 
      was created and there were no errors.

      

      
 
    
  




Create and Deploy a WAR 
file for the J2EE View Project

Back to List



  

  
 
    
 
      1.
    

      
Expand the J2EEApplication 
        node in the Application Navigator, right-click View 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 .
    
Select Specify J2EE Context Root and enter  
      hrapp as the context root. Click OK. 

      

      
 
    
  
  
 
    
 
      5 .
    
In the Resources node, right-click the deployment profile 
      (webapp1.deploy) and select 
      Deploy to WAR file. 

      

      
 
    
  
  
 
    


      6 .
    
 In the Deployment window, ensure the .war 
      file was created.

      

      
 
    
  

 Create and Deploy 
  an EAR file for the Complete J2EE Application
Back to List



  
 
    

 
      1.
    
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.
      

      
 
    
  

 Test the J2EE 
  Application Deployment 
Back to List



  
 
    
 
      
      1.
    
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. 
      

      
 
    
  
  

    

      
      3.
    

      
Three employees belonging to the same department as King 
        are displayed. 
      

      
 
    
  

 
  


 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. .


Back to Topic List




  
 
    

    
Install the ADF Runtime Libraries
  
  
 
    

    
Create and Deploy a WAR file 
      for the ADF ViewController Project
  
  
 
    

    
Test the ADF Application 
      Deployment
  

Install the ADF Runtime 
  Libraries 
Back to List 


  
 
    
 
      
      1.
    
 Navigate to the Application Server Control located 
      by default at: http://localhost:1810. 
      Provide the username and password for the administrator. Select Stop 
      All to stop all of the running components. 
      

      
Click Yes to confirm the shutdown. 
      
  
    
  
  
 
    
 
      
      2.
    
 Shut down the OracleASControl 
      and OracleProcessManager Application Server services from 
      the operating system. The services may be named differently according to 
      your installation. 
      

      
 
    
  
  
 
    
 
      
      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.
    
Review the welcome page and click Next. 
      

      
 
    
  
  
 
    
 
      
      5.
    
 Specify the Application Server home directory 
      and 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 ias.html 
      and confirm the installation was successful. 
      

      
 
    
  
  
 
    
 
      
      9.
    
Restart the Application Server services in Windows. 
      

      

      
 
      
  
  
 
    
 
      
      10.
    
 
      
Access http://localhost:1810 
        and select Start All to start the application server components.
      

      
  
    
  


 
Create 
  and Deploy a WAR file for the ADF ViewController Project
Back to List

    

  
 
    

 
      1.
    
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 .
    
Select Specify J2EE Context Root and enter 
       adfapp. Click OK. 
      

      

      
 
    
  
  
 
    


      5 .
    

      
In the Resources node, right-click the deployment profile 
        (webapp1.deploy). 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.

      
      

      
 
    
  



Test the ADF Application 
  Deployment 
Back to List



  
 
    
 
      
      1.
    
Access the application by using the following URL: http://localhost/adfapp/Login.jsp 
      (the application has Login.jsp 
      as its "starter" page). 
      

      
 
      
  
  
 
    
 
      
      2.
    
 Test the application and login using 100 
      as the Employee Id and King 
      as the Employee Name. 
      

      
 
      
  
  

    
 
      
      3.
    
 
      
Three employees belonging to the Executive 
        department are displayed.
      

      
 
    
  

   

Summary

In this tutorial you archived and deployed a J2EE application 
  and an ADF application to Oracle Application Server 10g.
Back to Topic 
  List
 
  
 - 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

  
  
Related topics

 Installing 
  the Sample Schemas and Establishing a Database Connection  
 
  Move your mouse over this icon to hide all screenshots