Building ADF Projects with Maven

5 Building ADF Projects with Maven

You can use the Oracle Application Development Framework (ADF) Maven archetypes to create, build, and deploy Oracle ADF applications.

For more information about using the Oracle ADF development plug-in with Maven, see "Building and Running with Apache Maven " in Developing Applications with Oracle JDeveloper.

Introduction to Building Oracle ADF Projects with Maven
Oracle Fusion Middleware provides two Maven plug-ins and an archetype for Oracle ADF projects.
Creating an ADF Application Using the Maven Archetype
You can create a new Oracle ADF application using the Oracle ADF application Maven archetype.
Building Your Oracle ADF Project with Maven
After you have written your code, you can use Maven to build the project.

Introduction to Building Oracle ADF Projects with Maven

Oracle Fusion Middleware provides two Maven plug-ins and an archetype for Oracle ADF projects.

Table 5-1 describes the Maven coordinates.

Table 5-1 Maven Coordinates with Oracle ADF

Name	GroupId	ArtifactId	Version
ADF ojmake plug-in	`com.oracle.adf.plugin`	`ojmake`	`14.1.2-0-0`
ADF ojdeploy plug-in	`com.oracle.adf.plugin`	`ojdeploy`	`14.1.2-0-0`
ADF archetype	`com.oracle.adf.archetype`	`oracle-adffaces-ejb`	`14.1.2-0-0`

JDeveloper also has extensive support for Maven. This documentation covers Maven use outside of JDeveloper. For more details about using Maven within JDeveloper, see "Building and Running with Apache Maven" in Developing Applications with Oracle JDeveloper.

Parent topic: Building ADF Projects with Maven

Creating an ADF Application Using the Maven Archetype

You can create a new Oracle ADF application using the Oracle ADF application Maven archetype.

To do so, issue a command similar to the following:

mvn archetype:generate
-DarchetypeGroupId=com.oracle.adf.archetype
 -DarchetypeArtifactId=oracle-adffaces-ejb
 -DarchetypeVersion=14.1.2-0-0
 -DgroupId=org.mycompany
 -DartifactId=my-adf-application
 -Dversion=1.0-SNAPSHOT

This command runs Maven's archetype:generate goal which allows you to create a new project from an archetype. Table 5-2 describes the parameters.

Table 5-2 Parameters for the Oracle ADF Project

Parameter	Purpose
`archetypeGroupId`	The group ID of the archetype that you want to use to create the new project. This must be `com.oracle.adf.archetype`, as shown in the example.
`archetypeArtifactId`	The artifact ID of the archetype that you want to use to create the new project. This must be `oracle-adffaces-ejb`, as shown in the example.
`archetypeVersion`	The version of the archetype that you want to use to create the new project. This must be `14.1.2-0-0`, as shown in the example.
`groupId`	The group ID for your new project. This usually starts with your organization's domain name in reverse format.
`artifactId`	The artifact ID for your new project. This is usually an identifier for this project.
`version`	The version for your new project. This is usually `1.0-SNAPSHOT` for a new project.

You can also run the command without any arguments, as shown in the following example. In this case, Maven displays a list of available archetypes and prompts you to enter the required information.

mvn archetype:generate

Parent topic: Building ADF Projects with Maven

Building Your Oracle ADF Project with Maven

After you have written your code, you can use Maven to build the project.

To compile your project, run the following command:
```
mvn compile
```
This command runs the ojmake plug-in.
To package the project into an EAR file, run the following command (note that this actually runs all steps up to package, including the compile again):
```
mvn package
```
This command runs the ojdeploy plug-in.

Parent topic: Building ADF Projects with Maven