<fuego.j2ee : buildear>

Description

Generates the ear files for a given engine or deployed project.

Example 1 Building an engine ear:


  <target name="build-engine" description="Build engine ear">

      <fuego.j2ee:buildear fuegobasedir="${fuego.basedir}"
           destfile="${destination.file}" displayName="${displayName}"
           workdir="${fuego.workdir}"
           directoryfile="${fuego.directory.file}"
           engineid="${engine.name}"/>
           includelibs="false"/>
           <fuego.j2ee:engine/>
  </target>

Example 2 Building a project ear:


  <target name="build-project" description="Build project ear">

      <fuego.j2ee:buildear fuegobasedir="${fuego.basedir}"
           destfile="${destination.file}" displayName="${displayName}"
           workdir="${fuego.workdir}"
           directoryfile="${fuego.directory.file}"
           engineid="${engine.name}"/>
           includelibs="false"/>
           <fuego.j2ee:project name="${project.name}"/>
  </target>

Example 2 Building the greatest deployed revision of a project ear:


  <target name="build-project" description="Build project ear">

      <fuego.j2ee:buildear fuegobasedir="${fuego.basedir}"
           destfile="${destination.file}" displayName="${displayName}"
           workdir="${fuego.workdir}"
           directoryfile="${fuego.directory.file}"
           engineid="${engine.name}"/>
           includelibs="false"/>
           <fuego.j2ee:project name="${project.name}"greatest="true"/>
  </target>

Parameters

Attribute Description Type Required?
destdir The destination directory where the archive file will be written. The file name of the destination archive is calculated based on the module included in the ear. This ear should contain a single module. File Yes required if destFile has not been specified
includelibs Include the required libs for the ear inside the ear itself. boolean No Defaults to False
directorypreset String ?
destfile The file name of the destination archive file. File Yes required if destDir has not been specified
engineid The Fuego Server identification. The server is used to obtain the Application Server Vendor and configure the EAR based on it. String Yes
verbose boolean ?
displayname The description of the ear application. String No
fuegobasedir File ?
loaderref Reference ?
templateset String ?
directoryfile File ?
workdir A writable directory where temporary files are generated. All the content of the workDir will be delete before executing the task File Yes The directory must exist and it must be writable.

Parameters accepted as nested elements

<portal>

Indicates the creation of the Portal war
Attribute Description Type Required
expanded boolean ?
uri String ?
webmodulename Name for this web module. String No Defaults to portal.war

<portlets>

Indicates the creation of the Portlets war
Attribute Description Type Required
expanded boolean ?
uri String ?
webmodulename Name for this web module. String No Defaults to portlets.war

<console>

Indicates the creation of the WebConsole war
Attribute Description Type Required
expanded boolean ?
uri String ?
webmodulename Name for this web module. String No Defaults to console.war

<portaladmin>

Indicates the creation of the Portal Admin war
Attribute Description Type Required
expanded boolean ?
uri String ?
webmodulename Metod to specified a name for this web module. Tipical value is portalname.war. If this method is not calle the default name is used. String ?

<engine>

Indicate the creation of the engine ear
Attribute Description Type Required

<project>

Represents a deployed project
Attribute Description Type Required
name Project name String Yes
greatest

Boolean to indicate if the ear is to be generated for the greatest available version of the project. When this attribute is true, the project name should not include the version attribute.

For example, if MyProject-1.0, MyProject-2.0 and MyProject-2.1 are deployed, when this task is execute for MyProject, the ear will be generated for MyProject-2.1.

Note that being the greatest version does not mean that it is the active process. Version 1.0 may be the active one while Version 2.0 may be deprecated. In this case, the active is 1.0 while the greatest is 2.0.

 boolean No Defaults to false.

© 2007, BEA Systems