Configuring and Building an ADF Application using Maven in Oracle Developer Cloud Service Classic

Before You Begin

This 15-minute tutorial shows you how to configure and build an Oracle Application Development Framework (Oracle ADF) application with Apache Maven and Oracle Maven Repository by using Oracle JDeveloper and Oracle Developer Cloud Service.

Background

Oracle Developer Cloud Service can build Oracle ADF applications by using Maven, Oracle Maven Repository, JDeveloper, Oracle ADF libraries, and OJMake and OJDeploy utilities.

In this tutorial, you use the Oracle Alta UI Work Better sample application and configure it in JDeveloper to use Maven. You configure the Maven Project Object model (POM) file to access the Oracle Maven Repository to download Oracle ADF libraries, and to access the OJMake and OJDeploy utilities available on the Oracle Developer Cloud Service build system. You then create a job in Oracle Developer Cloud Service that runs a Maven build and generates the artifacts.

The Alta UI Work Better sample application is a demo application that uses the Alta UI to develop the most recent Oracle Cloud products.

What Do You Need?

• A web browser
• Your Oracle Cloud account credentials
• An Oracle Cloud account with an active Oracle Developer Cloud Service instance
• Oracle JDeveloper
• Familiarity with creating and configuring a job in Oracle Developer Cloud Service
  See Create and Configure a Build Job in Developer Cloud OBE to learn how to create a job.
• Familiarity with JDeveloper, Maven, POM file, Oracle Maven repository, and OJMake and OJDeploy utilities
• JDeveloper Team Server configured to connect to your Oracle Developer Cloud Service instance
  See the Integrating Oracle Developer Cloud Service with JDeveloper OBE.
• The Oracle Alta UI WorkBetterFaces Application uploaded to and cloned from an Oracle Developer Cloud Service project Git repository
  See the Uploading Application to Oracle Developer Cloud Service Git Repository using JDeveloper OBE.
• Acceptance of the Oracle Maven Repository license agreement at https://www.oracle.com/webapps/maven/register/license.html using your Oracle credentials

Add the Maven POM File to the Oracle ADF Application

In this section, you add a Maven pom.xml file to an Oracle ADF application in JDeveloper.

1. In JDeveloper, if you aren't using the Studio Developer role, from the Tools menu, select Switch Roles, and then select Studio Developer (All Features). Save all files and restart JDeveloper.
2. Open the WorkBetterFaces application from the cloned Git repository of the project.
3. From the File menu, select New, and then select From Gallery.

   

4. In the New Gallery dialog box, select Maven in the General category, select Application POM in the Items list, and click OK.

   

5. In the Create a Maven POM for the Application dialog box, select the Include packaging plugin information (uses ojdeploy) and Include compile plugin information (uses ojmake) check boxes and click OK.

   

   A pom.xml file is added to the ADF application.

   

Configure the POM File to Access Oracle Maven Repository, OJMake, and OJDeploy

In this section, you configure the POM file to access the Oracle Maven Repository and to use the OJMake and OJDeploy utilities. The OJMake and OJDeploy utilities are available on the build system of Oracle Developer Cloud Service and can be accessed by using Oracle Developer Cloud Service system environment variables.

1. In JDeveloper, double-click pom.xml to open it in the editor.

   

2. Click the Repositories tab.

   

3. In the Remote Repositories section, click Add .
4. To add the Oracle Maven Repository as a remote repository, enter the following values:
   • Name: OracleMaven
   • ID: maven.oracle.com
   • URL: https://maven.oracle.com

   

5. Click the Plugins tab.

   

6. In the Plugin table, click the first column in the first row to select the ojmake plugin row.

   

7. In the Configuration Parameters table, update the parameter value of the ojmake parameter to ${env.ORACLE_HOME_SOA_12_2_1}/jdev/bin/ojmake.

   

   The ORACLE_HOME_SOA_12_2_1 environment variable defines the path of the JDeveloper 12.2.1 directory that's installed on the Oracle Developer Cloud Service build executor.
8. In the Plugin table, click the first column in the second row to select the ojdeploy plugin row.

   

9. In the Configuration Parameters table, update the parameter value of the ojdeploy parameter to ${env.ORACLE_HOME_SOA_12_2_1}/jdev/bin/ojdeploy.

   

10. Save the pom.xml file.
11. Using the Team > Git menu options, use the Add option to add the pom.xml file to the Git repository index, use the Commit option to commit it, and the Push coption to push the commit to the project Git repository.

Create and Configure a Build Job in Oracle Developer Cloud Service

In this section, you configure a build job to run Maven and deploy the archived artifacts.

1. In the Oracle Developer Cloud Service web interface, create a ADF_Maven_Build job and open its configuration page.
   See the Create and Configure a Build Job in Developer Cloud OBE in the Want to Learn More section to learn about how to create and configure a job in Oracle Developer Cloud Service.
2. On the Main tab of Configure build job, select JDK 8 in the JDK field. ADF 12c (12.2.1.0.0) applications require JDK 8.

   

3. Click the Source Control tab and select the Git option. In the Repositories section, select the adf-sample-application.git Git repository.

   

4. Click the Environment tab, select the Connect Oracle Maven Repository check box, and enter your Oracle Account user name and password.
   If not done before, accept the Oracle Maven Repository license agreement at https://www.oracle.com/webapps/maven/register/license.html.

   

5. Click the Build Steps tab, click Add Build Step and select Invoke Maven 3.

   

6. In the POM File field, enter WorkBetterFaces/pom.xml as the path of the POM file.
   You can verify the path in the Code page.

   

7. Click the Post Build tab, select the Archive the artifacts check box, and enter WorkBetterFaces/target/*.ear in Files To Archive.

   

8. Click Save.
9. In the ADF_Maven_Build details page, click Build Now and wait for the build to complete.

   

   Check the build's progress in the Build History section.
10. After the build is completed, expand Artifacts of Last Build to view the archived artifacts.
11. To view the build status of ADF_Maven_Build in JDeveloper, refresh the project in Team Server. Place your cursor over Demo and click the Refresh icon.

    

12. On the Team tab, expand Builds.

    

13. After the build is successful, in the Deploy page of Oracle Developer Cloud Service, create a deployment configuration and deploy the ADF application to Oracle Java Cloud Service. See the Deploying an Application from Oracle Developer Cloud Service to Oracle Java Cloud Service OBE in the Want to Learn More section to learn about how to deploy an application to Oracle Java Cloud Service.

Want to Learn More?

• Using the Oracle Developer Cloud Service Build Executor Environment Variables in Using Developer Cloud Service
• Create and Configure a Build Job in Developer Cloud OBE
• Deploying an Application from Oracle Developer Cloud Service to Oracle Java Cloud Service OBE
• Configuring the Oracle Maven Repository in Oracle Fusion Middleware Developing Applications Using Continuous Integration
• Building Java Projects and Deploying Applications in Oracle Fusion Middleware Developing Applications with Oracle JDeveloper
• Oracle Developer Cloud Service product page
• Oracle Developer Cloud Service documentation page in the Oracle Help Center