Cayenne-AXIS Server Ant Scripts

This folder contains scripts which can be used to perform building and administrating tasks related to cayenne-axis-server project.

Quick start

Use ../cayenne-config/*.driver.xml file to set db connection parameters.
Use dbgen.xml to generate database structure.
Use build.xml to build web app.
Use start-web-container.xml to start embedded Winstone Web Container.
Go to "http://localhost:8080/Cayenne" or start one of examples in "cayenne-axis-test-client project".

Ant files

build.xml

Main Ant project - building web app. Depending on configuration (see further) building implies:

Cleaning.
Copying cayenne-axis.jar (and dependencies) from "cayenne-axis" project.
Generating client-side cayenne-axis java distributive and placing it for downloading from web app (see ../build/clients/java).
Reencoding i18n property files by native2ascii. Currently only english available.
Copying needed server libraries to ../build/WEB-INF/lib folder.
Creating web application archive (war).
Deployment to local server folder.
Restarting web app at the server.

dbgen.xml

Data base generation. Reads db connection info from Cayenne configuration files and generates database structure (as defined in data map).

start-web-container.xml, stop-web-container.xml

There is Winstone Web Container .jar file in lib/ folder. It is very small servlet container (350kb). It can be used for quick testing web app. "Start-web-container.xml" script will start Winstone using ../build/ dir as webroot. "Stop-web-container.xml" script will send shutdown request to the server. Also restarting web app at Winstone supported by build.xml (see "Configuration"). JSP not supported by this server without addons. So some pages may be not visible. (use Tomcat or something else if JSP's are strictly needed).

Configuration.

All configuration properties can be set in "*.properties.xml" files in "properties" folder:

cayenne-config.properties.xml

Information related to Cayenne configuration files (data maps, db driver, cayenne.xml etc...).

deployment.properties.xml

Information related to local deployment of web app after building. Local deployment implies copying war archive (or dir tree) to "webapps" (or other) deployment folder of some local web server and restarting this web app at this through some control points.

Currently the easiest way to test web application is using embedded Winstone Servlet Container. In this case no deployment needed because Winstone can be started straight on "../build" dir of the project where all application files placed.

propertties.xml

Common properties.

See property files contents for more comments.