cdeploy is an Ant task that configures Cayenne connection information in existing jar files that contain Cayenne project information. It is useful for the automation of deployment of Cayenne-based frameworks in different environments.
|src||Source jar file that contains Cayenne project files among other things.||Yes|
|dest||Destination jar file that should be generated as a result of this task execution. If omitted, src is used.||No|
|altProjectFile||An alternative location of cayenne.xml file. User can specify an arbitrary file. This file will be used as the main project file, replacing any existing cayenne.xml in the source jar. This gives the users an ultimate flexibility in configuring deployment libraries. For instance this feature can be used to deploy standalone DataMaps.||No|
One or more nested "node" elements specify connection information for the named nodes. All nested nodes must exist in the project, or otherwise they will be ignored.
Nested node Parameters:
|domain||Parent DataDomain of this node. If omitted, project must have only a single domain (very common case).||No|
|dataSource||DataSource name to use for this node.||No|
|driverFile||File that contains driver information.||No|
"dataSource" and "driverFile" are mutually exclusive, but none of them are required.
Load the Ant task (note: if you already loaded all Cayenne tasks via an antlib taskdef described before, this step is not needed):
Here is an example of using cdeploy to regenerate a jar file called "business.jar" with connection info located in "alt.driver.xml":
An example of using cdeploy to redeploy a 3rd party library that contains DataMaps, but may not contain cayenne.xml: