Class EjbJar

java.lang.Object

org.apache.tools.ant.ProjectComponent

org.apache.tools.ant.Task

org.apache.tools.ant.taskdefs.MatchingTask

org.apache.tools.ant.taskdefs.optional.ejb.EjbJar

All Implemented Interfaces:

Cloneable, SelectorContainer

public class EjbJar
extends MatchingTask

Provides automated EJB JAR file creation.

Extends the MatchingTask class provided in the default ant distribution to provide a directory scanning EJB jarfile generator.

The task works by taking the deployment descriptors one at a time and parsing them to locate the names of the classes which should be placed in the jar. The classnames are translated to java.io.Files by replacing periods with File.separatorChar and resolving the generated filename as a relative path under the srcDir attribute. All necessary files are then assembled into a jarfile. One jarfile is constructed for each deployment descriptor found.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	EjbJar.CMPVersion	CMP versions supported valid CMP versions are 1.0 and 2.0
static class	EjbJar.DTDLocation	Inner class used to record information about the location of a local DTD
static class	EjbJar.NamingScheme	An EnumeratedAttribute class for handling different EJB jar naming schemes

Field Summary

Fields inherited from class MatchingTask

fileset

Modifier and Type	Field	Description
protected FileSet	fileset

Fields inherited from class Task

target, taskName, taskType, wrapper

Modifier and Type	Field	Description
protected Target	target	Deprecated. since 1.6.x.
protected String	taskName	Deprecated. since 1.6.x.
protected String	taskType	Deprecated. since 1.6.x.
protected RuntimeConfigurable	wrapper	Deprecated. since 1.6.x.

Fields inherited from class ProjectComponent

description, location, project

Modifier and Type	Field	Description
protected String	description	Deprecated. since 1.6.x.
protected Location	location	Deprecated. since 1.6.x.
protected Project	project	Deprecated. since 1.6.x.

Constructor Summary

Constructors

Constructor	Description
EjbJar()

Method Summary

Modifier and Type	Method	Description
protected void	addDeploymentTool(EJBDeploymentTool deploymentTool)	Add a deployment tool to the list of deployment tools that will be processed
BorlandDeploymentTool	createBorland()	Adds a deployment tool for Borland server.
Path	createClasspath()	Adds to the classpath used to locate the super classes and interfaces of the classes that will make up the EJB JAR.
EjbJar.DTDLocation	createDTD()	Create a DTD location record.
IPlanetDeploymentTool	createIplanet()	Adds a deployment tool for iPlanet Application Server.
JbossDeploymentTool	createJboss()	Adds a deployment tool for JBoss server.
JonasDeploymentTool	createJonas()	Adds a deployment tool for JOnAS server.
OrionDeploymentTool	createOrion()	Create a orion nested element used to configure a deployment tool for Orion server.
FileSet	createSupport()	Adds a fileset for support elements.
WeblogicDeploymentTool	createWeblogic()	Adds a deployment tool for WebLogic server.
WeblogicTOPLinkDeploymentTool	createWeblogictoplink()	Adds a deployment tool for WebLogic when using the TOPLink Object-Relational mapping.
WebsphereDeploymentTool	createWebsphere()	Adds a deployment tool for WebSphere 4.0 server.
void	execute()	Invoked by Ant after the task is prepared, when it is ready to execute this task.
String	getCmpversion()	Gets the CMP version.
File	getDestdir()	Gets the destination directory.
void	setBasejarname(String inValue)	Set the base name of the EJB JAR that is to be created if it is not to be determined from the name of the deployment descriptor files.
void	setBasenameterminator(String inValue)	The string which terminates the bean name.
void	setClasspath(Path classpath)	Set the classpath to use when resolving classes for inclusion in the jar.
void	setCmpversion(EjbJar.CMPVersion version)	Sets the CMP version.
void	setDependency(String analyzer)	Set the analyzer to use when adding in dependencies to the JAR.
void	setDescriptordir(File inDir)	Set the descriptor directory.
void	setDestdir(File inDir)	Set the destination directory.
void	setFlatdestdir(boolean inValue)	Controls whether the destination JARs are written out in the destination directory with the same hierarchical structure from which the deployment descriptors have been read.
void	setGenericjarsuffix(String inString)	Set the suffix for the generated jar file.
void	setManifest(File manifest)	Set the Manifest file to use when jarring.
void	setNaming(EjbJar.NamingScheme namingScheme)	Set the naming scheme used to determine the name of the generated jars from the deployment descriptor
void	setSrcdir(File inDir)	Sets the source directory, which is the directory that contains the classes that will be added to the EJB jar.

Methods inherited from class MatchingTask

add, addAnd, addContains, addContainsRegexp, addCustom, addDate, addDepend, addDepth, addDifferent, addFilename, addMajority, addModified, addNone, addNot, addOr, addPresent, addSelector, addSize, addType, appendSelector, createExclude, createExcludesFile, createInclude, createIncludesFile, createPatternSet, getDirectoryScanner, getImplicitFileSet, getSelectors, hasSelectors, selectorCount, selectorElements, setCaseSensitive, setDefaultexcludes, setExcludes, setExcludesfile, setFollowSymlinks, setIncludes, setIncludesfile, setProject, XsetIgnore, XsetItems

Modifier and Type	Method	Description
void	add(FileSelector selector)	add an arbitrary selector
void	addAnd(AndSelector selector)	add an "And" selector entry on the selector list
void	addContains(ContainsSelector selector)	add a contains selector entry on the selector list
void	addContainsRegexp(ContainsRegexpSelector selector)	add a regular expression selector entry on the selector list
void	addCustom(ExtendSelector selector)	add an extended selector entry on the selector list
void	addDate(DateSelector selector)	add a selector date entry on the selector list
void	addDepend(DependSelector selector)	add a depends selector entry on the selector list
void	addDepth(DepthSelector selector)	add a depth selector entry on the selector list
void	addDifferent(DifferentSelector selector)	add a type selector entry on the type list
void	addFilename(FilenameSelector selector)	add a selector filename entry on the selector list
void	addMajority(MajoritySelector selector)	add a majority selector entry on the selector list
void	addModified(ModifiedSelector selector)	add the modified selector
void	addNone(NoneSelector selector)	add a "None" selector entry on the selector list
void	addNot(NotSelector selector)	add a "Not" selector entry on the selector list
void	addOr(OrSelector selector)	add an "Or" selector entry on the selector list
void	addPresent(PresentSelector selector)	add a present selector entry on the selector list
void	addSelector(SelectSelector selector)	add a "Select" selector entry on the selector list
void	addSize(SizeSelector selector)	add a selector size entry on the selector list
void	addType(TypeSelector selector)	add a type selector entry on the type list
void	appendSelector(FileSelector selector)	Add a new selector into this container.
PatternSet.NameEntry	createExclude()	add a name entry on the exclude list
PatternSet.NameEntry	createExcludesFile()	add a name entry on the include files list
PatternSet.NameEntry	createInclude()	add a name entry on the include list
PatternSet.NameEntry	createIncludesFile()	add a name entry on the include files list
PatternSet	createPatternSet()	add a set of patterns
protected DirectoryScanner	getDirectoryScanner(File baseDir)	Returns the directory scanner needed to access the files to process.
protected final FileSet	getImplicitFileSet()	Accessor for the implicit fileset.
FileSelector[]	getSelectors(Project p)	Returns the set of selectors as an array.
boolean	hasSelectors()	Indicates whether there are any selectors here.
int	selectorCount()	Gives the count of the number of selectors in this container
Enumeration<FileSelector>	selectorElements()	Returns an enumerator for accessing the set of selectors.
void	setCaseSensitive(boolean isCaseSensitive)	Sets case sensitivity of the file system
void	setDefaultexcludes(boolean useDefaultExcludes)	Sets whether default exclusions should be used or not.
void	setExcludes(String excludes)	Sets the set of exclude patterns.
void	setExcludesfile(File excludesfile)	Sets the name of the file containing the includes patterns.
void	setFollowSymlinks(boolean followSymlinks)	Sets whether or not symbolic links or Windows junctions should be followed.
void	setIncludes(String includes)	Sets the set of include patterns.
void	setIncludesfile(File includesfile)	Sets the name of the file containing the includes patterns.
void	setProject(Project project)	Sets the project object of this component.
void	XsetIgnore(String ignoreString)	List of filenames and directory names to not include.
void	XsetItems(String itemString)	Set this to be the items in the base directory that you want to be included.

Methods inherited from class Task

bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

Modifier and Type	Method	Description
final void	bindToOwner(Task owner)	Bind a task to another; use this when configuring a newly created task to do work on behalf of another.
Target	getOwningTarget()	Returns the container target of this task.
RuntimeConfigurable	getRuntimeConfigurableWrapper()	Returns the wrapper used for runtime configuration.
String	getTaskName()	Returns the name to use in logging messages.
String	getTaskType()	Return the type of task.
protected RuntimeConfigurable	getWrapper()	Return the runtime configurable structure for this task.
protected void	handleErrorFlush(String output)	Handles an error line by logging it with the WARN priority.
protected void	handleErrorOutput(String output)	Handles an error output by logging it with the WARN priority.
protected void	handleFlush(String output)	Handles output by logging it with the INFO priority.
protected int	handleInput(byte[] buffer, int offset, int length)	Handle an input request by this task.
protected void	handleOutput(String output)	Handles output by logging it with the INFO priority.
void	init()	Called by the project to let the task initialize properly.
protected final boolean	isInvalid()	Has this task been marked invalid?
void	log(String msg)	Logs a message with the default (INFO) priority.
void	log(String msg, int msgLevel)	Logs a message with the given priority.
void	log(String msg, Throwable t, int msgLevel)	Logs a message with the given priority.
void	log(Throwable t, int msgLevel)	Logs a message with the given priority.
void	maybeConfigure()	Configures this task - if it hasn't been done already.
final void	perform()	Performs this task if it's still valid, or gets a replacement version and performs that otherwise.
void	reconfigure()	Force the task to be reconfigured from its RuntimeConfigurable.
void	setOwningTarget(Target target)	Sets the target container of this task.
void	setRuntimeConfigurableWrapper(RuntimeConfigurable wrapper)	Sets the wrapper to be used for runtime configuration.
void	setTaskName(String name)	Sets the name to use in logging messages.
void	setTaskType(String type)	Sets the name with which the task has been invoked.

Methods inherited from class ProjectComponent

clone, getDescription, getLocation, getProject, setDescription, setLocation

Modifier and Type	Method	Description
Object	clone()
String	getDescription()	Returns the description of the current action.
Location	getLocation()	Returns the file/location where this task was defined.
Project	getProject()	Returns the project to which this component belongs.
void	setDescription(String desc)	Sets a description of the current action.
void	setLocation(Location location)	Sets the file/location where this task was defined.

Methods inherited from class Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

EjbJar

public EjbJar()

Method Details

addDeploymentTool

protected void addDeploymentTool(EJBDeploymentTool deploymentTool)

Add a deployment tool to the list of deployment tools that will be processed

Parameters:

deploymentTool - a deployment tool instance to which descriptors will be passed for processing.

createOrion

public OrionDeploymentTool createOrion()

Create a orion nested element used to configure a deployment tool for Orion server.

Returns:

the deployment tool instance to be configured.

Since:

Ant 1.10.2

createWeblogic

public WeblogicDeploymentTool createWeblogic()

Adds a deployment tool for WebLogic server.

Returns:

the deployment tool instance to be configured.

createWebsphere

public WebsphereDeploymentTool createWebsphere()

Adds a deployment tool for WebSphere 4.0 server.

Returns:

the deployment tool instance to be configured.

createBorland

public BorlandDeploymentTool createBorland()

Adds a deployment tool for Borland server.

Returns:

the deployment tool instance to be configured.

createIplanet

public IPlanetDeploymentTool createIplanet()

Adds a deployment tool for iPlanet Application Server.

Returns:

the deployment tool instance to be configured.

createJboss

public JbossDeploymentTool createJboss()

Adds a deployment tool for JBoss server.

Returns:

the deployment tool instance to be configured.

createJonas

public JonasDeploymentTool createJonas()

Adds a deployment tool for JOnAS server.

Returns:

the deployment tool instance to be configured.

createWeblogictoplink

public WeblogicTOPLinkDeploymentTool createWeblogictoplink()

Adds a deployment tool for WebLogic when using the TOPLink Object-Relational mapping.

Returns:

the deployment tool instance to be configured.

createClasspath

public Path createClasspath()

Adds to the classpath used to locate the super classes and interfaces of the classes that will make up the EJB JAR.

Returns:

the path to be configured.

createDTD

public EjbJar.DTDLocation createDTD()

Create a DTD location record. This stores the location of a DTD. The DTD is identified by its public Id. The location may either be a file location or a resource location.

Returns:

the DTD location object to be configured by Ant

createSupport

public FileSet createSupport()

Adds a fileset for support elements.

Returns:

a fileset which can be populated with support files.

setManifest

public void setManifest(File manifest)

Set the Manifest file to use when jarring. As of EJB 1.1, manifest files are no longer used to configure the EJB. However, they still have a vital importance if the EJB is intended to be packaged in an EAR file. By adding "Class-Path" settings to a Manifest file, the EJB can look for classes inside the EAR file itself, allowing for easier deployment. This is outlined in the J2EE specification, and all J2EE components are meant to support it.

Parameters:

manifest - the manifest to be used in the EJB jar

setSrcdir

public void setSrcdir(File inDir)

Sets the source directory, which is the directory that contains the classes that will be added to the EJB jar. Typically this will include the home and remote interfaces and the bean class.

Parameters:

inDir - the source directory.

setDescriptordir

public void setDescriptordir(File inDir)

Set the descriptor directory. The descriptor directory contains the EJB deployment descriptors. These are XML files that declare the properties of a bean in a particular deployment scenario. Such properties include, for example, the transactional nature of the bean and the security access control to the bean's methods.

Parameters:

inDir - the directory containing the deployment descriptors.

setDependency

public void setDependency(String analyzer)

Set the analyzer to use when adding in dependencies to the JAR.

Parameters:

analyzer - the name of the dependency analyzer or a class.

setBasejarname

public void setBasejarname(String inValue)

Set the base name of the EJB JAR that is to be created if it is not to be determined from the name of the deployment descriptor files.

Parameters:

inValue - the basename that will be used when writing the jar file containing the EJB

setNaming

public void setNaming(EjbJar.NamingScheme namingScheme)

Set the naming scheme used to determine the name of the generated jars from the deployment descriptor

Parameters:

namingScheme - the naming scheme to be used

getDestdir

public File getDestdir()

Gets the destination directory.

Returns:

destination directory

Since:

ant 1.6

setDestdir

public void setDestdir(File inDir)

Set the destination directory. The EJB jar files will be written into this directory. The jar files that exist in this directory are also used when determining if the contents of the jar file have changed. Note that this parameter is only used if no deployment tools are specified. Typically each deployment tool will specify its own destination directory.

Parameters:

inDir - the destination directory in which to generate jars

getCmpversion

public String getCmpversion()

Gets the CMP version.

Returns:

CMP version

Since:

ant 1.6

setCmpversion

public void setCmpversion(EjbJar.CMPVersion version)

Sets the CMP version. Must be either 1.0 or 2.0. Default is 1.0. Initially, only the JBoss implementation does something specific for CMP 2.0.

Parameters:

version - CMP version.

Since:

ant 1.6

setClasspath

public void setClasspath(Path classpath)

Set the classpath to use when resolving classes for inclusion in the jar.

Parameters:

classpath - the classpath to use.

setFlatdestdir

public void setFlatdestdir(boolean inValue)

Controls whether the destination JARs are written out in the destination directory with the same hierarchical structure from which the deployment descriptors have been read. If this is set to true the generated EJB jars are written into the root of the destination directory, otherwise they are written out in the same relative position as the deployment descriptors in the descriptor directory.

Parameters:

inValue - the new value of the flatdestdir flag.

setGenericjarsuffix

public void setGenericjarsuffix(String inString)

Set the suffix for the generated jar file. When generic jars are generated, they have a suffix which is appended to the the bean name to create the name of the jar file. Note that this suffix includes the extension fo te jar file and should therefore end with an appropriate extension such as .jar or .ear

Parameters:

inString - the string to use as the suffix.

setBasenameterminator

public void setBasenameterminator(String inValue)

The string which terminates the bean name. The convention used by this task is that bean descriptors are named as the BeanName with some suffix. The baseNameTerminator string separates the bean name and the suffix and is used to determine the bean name.

Parameters:

inValue - a string which marks the end of the basename.

execute

public void execute()
             throws BuildException

Invoked by Ant after the task is prepared, when it is ready to execute this task. This will configure all of the nested deployment tools to allow them to process the jar. If no deployment tools have been configured a generic tool is created to handle the jar. A parser is configured and then each descriptor found is passed to all the deployment tool elements for processing.

Overrides:

execute in class Task

Throws:

BuildException - thrown whenever a problem is encountered that cannot be recovered from, to signal to ant that a major problem occurred within this task.