Release 2.x‎ > ‎Development‎ > ‎

JDeveloper


Warning
This page is under construction! It is being updated to reflect the enhancements for version 2.0.

This document will assist the Java developer in setting-up a JDeveloper Application and Projects that leverage the various packages within Project OpenPTK.

The processes outlined in this document will allow the developer to leverage the bundled build process (ant and build.xml file) that is provided with Project OpenPTK while using the development features of JDeveloper.

The process involves downloading the entire Project OpenPTK source code distribution and then creating a specific JDeveloper's projects that "map" to OpenPTK projects.


Revision History

Description Author Version Date
Initial Creation Scott Fehrman 2.0.0 May 2011
Move to new Google Web Site  Scott Fehrman 2.0.0 July 2011

Prerequisites

The following tasks must be completed ...

  1. Install Oracle JDeveloper. This document was created using JDeveloper Studio Edition 11.1.1.2.0 on Mac OS X 10.5.8
  2. Download the entire Project OpenPTK source distribution from http://java.net/projects/openptk

New Application and Project: Base

The Base OpenPTK package is used by all the other packages. Create a JDeveloper Application and a JDeveloper Project, within it, called Base. The Base JDeveloper Project is the first of many JDeveloper Projects within the JDeveloper Application.

From the JDeveloper File Menu, select New ...

  1. From the New Gallery Popup dialog,
    1. Select the General Category
    2. Select Generic Application Item
    3. Select OK

New Gallery - Generic Application:


From the Create Generic Application - Step 1 of 3 Popup dialog,

  1. Set the Application Name
    • Enter: OpenPTK
  2. Set the Directory (optional)
    • Enter: .../jdeveloper/community
  3. Select the Next Button

Create Application:

v2.0: JDeveloper Reference Guide

From the Create Generic Application - Step 2 of 3 Popup dialog,

  1. Set the Project Name
    • Enter Base
  2. Under the Project Technologies Tab:
  3. Move the Java Item from the Available List to the Selected List
  4. Select the Finish Button

Create Application:


The JDeveloper Application Navigator now contains ...

  • Application: OpenPTK
    • Project: Base

Application - Project:

v2.0: JDeveloper Reference Guide

Setting the Source Path ...

  1. Select the Base Project
  2. Right-click on to show a menu
    • Select the *Project Properties ...* (at the bottom)
  3. A dialog window will be displayed
  4. Select the *Project Source Paths* Item in the Left Tree View
    1. The Java Source Paths will contain a default src folder (this will be replaced)
    2. Select the Add ... Button
    3. A Choose Directory dialog will be displayed
      1. Navigate to the OpenPTK source code
      2. Select the java folder for the Base package
        .../trunk/openptk/projects/OpenPTK/Base/src/java
    4. Select the default path item: .../jdeveloper/community/Base/src
      • Remove it
  5. Click OK
    • The JDeveloper Applicaton Navigator now has a Application Sources Folder under the Base Project. Expand the Java packages to see the individual source files.

Change the Source Folder:


Source packages and java files:


Compile the package

  1. Right-click the Base Project
  2. Select Make Base.jpr
    All the source files will be compiled.
  3. Review the Messages - Log output.

Compile:



Project: Framework

The Framework packages depend on the Base packages. The following projects use this project:

  • Server
  • Service-JDBC
  • Service-JNDI
  • Service-SPML
  • Service-SPML2

From the JDeveloper File Menu, select New ...

  1. From the New Gallery Popup dialog,
    1. Select the General Category
    2. Select Generic Project Item
    3. Select OK

New Gallery - Generic Project:

v2.0: JDeveloper Reference Guide

  1. Set the Project Name
    Enter Framework
  2. Under the Project Technologies Tab:
    Move the Java Item from the Available List to the Selected List
  3. Select the Next Button

Create Generic Project - Step 1 of 2

v2.0: JDeveloper Reference Guide

Set the Java Source Path

  1. Click the Browse button next to the path value
    1. Navigate to the path where the source was downloaded
    2. Select: .../trunk/openptk/projects/OpenPTK/Framework/src/java
  2. Click Finish

Create Generic Project - Step 2 of 2


A Folder called Application Sources appears under the Framework Project

  1. Expand the Application Sources Folder
  2. Browse the java packages and source files

View Source Files:

v2.0: JDeveloper Reference Guide

This Project, Framework, is dependent on the Base Project

  1. Right click the Framework Project and select Project Properties ...
  2. A dialog will be displayed
    1. Select Dependencies from the Left Tree View
    2. Click the Pencil icon to add items
    3. A Edit Dependencies dialog is displayed
      1. Expand the Projects to show the Base.jpr Build Output
      2. Check the box
      3. Click OK
    4. Click OK

Set Dependencies:


Select Projects:

v2.0: JDeveloper Reference Guide

Compile the package

  1. Right-click the Framework Project
  2. Select Make Framework.jpr
    All the source files will be compiled.
  3. Review the Messages - Log output.

Compile:

v2.0: JDeveloper Reference Guide


Project: Service-JDBC


Project: Service-JNDI


Project: Service-SPML


Project: Service-SPML2


Project: Taglib


Project: Plugin-MimeUtil


Project: Plugin-SendEmail


Project: Plugin-Templates


Project: ClientAPI


Project: Server


Project: UML


Project: CLI