org.apache.maven.plugin.ear
Interface EarModule

All Known Implementing Classes:

AbstractEarModule, AppClientModule, Ejb3Module, EjbClientModule, EjbModule, HarModule, JarModule, JavaModule, ParModule, RarModule, SarModule, WebModule, WsrModule

public interface EarModule

The ear module interface.

Version:

$Id: EarModule.java 1228836 2012-01-08 12:59:53Z rfscholte $

Author:

Stephane Nicoll

Method Summary

void	appendModule(XMLWriter writer, String version, Boolean generateId) Appends the XML representation of this module.
boolean	changeManifestClasspath()
String	getAltDeploymentDescriptor() The alt-dd element specifies an optional URI to the post-assembly version of the deployment descriptor file for a particular Java EE module.
Artifact	getArtifact() Returns the Artifact representing this module.
String	getLibDir()
String	getType() Returns the type associated to the module.
String	getUri() Returns the URI for this module.
boolean	isExcluded() Specify whether this module should be excluded or not.
void	resolveArtifact(Set<Artifact> artifacts) Resolves the Artifact represented by the module.
void	setEarExecutionContext(EarExecutionContext earExecutionContext)
Boolean	shouldUnpack() Specify whether this module should be unpacked in the EAR archive or not.

Method Detail

getArtifact

Artifact getArtifact()

Returns the Artifact representing this module.

Note that this might return null till the module has been resolved.

Returns:

the artifact

See Also:

resolveArtifact(java.util.Set)

getUri

String getUri()

Returns the URI for this module.

Returns:

the URI

getType

String getType()

Returns the type associated to the module.

Returns:

the artifact's type of the module

isExcluded

boolean isExcluded()

Specify whether this module should be excluded or not.

Returns:

true if this module should be skipped, false otherwise

shouldUnpack

Boolean shouldUnpack()

Specify whether this module should be unpacked in the EAR archive or not.

Returns null if no configuration was specified so that defaulting may apply.

Returns:

true if this module should be bundled unpacked, false otherwise

getAltDeploymentDescriptor

String getAltDeploymentDescriptor()

The alt-dd element specifies an optional URI to the post-assembly version of the deployment descriptor file for a particular Java EE module. The URI must specify the full pathname of the deployment descriptor file relative to the application's root directory.

Returns:

the alternative deployment descriptor for this module

Since:

JavaEE 5

appendModule

void appendModule(XMLWriter writer,
                  String version,
                  Boolean generateId)

Appends the XML representation of this module.

Parameters:

writer - the writer to use

version - the version of the application.xml file

generateId - whether an id should be generated

resolveArtifact

void resolveArtifact(Set<Artifact> artifacts)
                     throws EarPluginException,
                            MojoFailureException

Resolves the Artifact represented by the module. Note that the EarExecutionContext might be used to customize further the resolution.

Parameters:

artifacts - the project's artifacts

Throws:

EarPluginException - if the artifact could not be resolved

MojoFailureException - if an unexpected error occurred

setEarExecutionContext

void setEarExecutionContext(EarExecutionContext earExecutionContext)

changeManifestClasspath

boolean changeManifestClasspath()

getLibDir

String getLibDir()