XEP Servlet Connector version 2.0

Table of Contents

1. Overview
2. Prerequisites
3. Package Contents
4. Compilation
5. Usage

1. Overview

XEP Servlet Connector is a web application built around RenderX XEP XSL FO formatter. It transforms XML documents into PDF or PostScript.

2. Prerequisites

Before installing XEP Servlet Connector, the following components must be installed:

XEP 3.7 or higher;
Sun JDK 1.2.2 or higher;
Ant 1.5 or higher;
Servlet container compatible with Servlet 2.2 API (http://java.sun.com/products/servlet/download.html); we tested the connector with Jakarta Tomcat 5.x.

3. Package Contents

com/: the source code;
web/: configuration files and sample HTML form;
build.xml: Ant build file for the servlet.

4. Compilation

Before compiling, define the following Ant properties:

xep.dir: XEP installation path;
servlet.interface.jar: path to the jar file providing the servlet interface;
build.dir (optional): folder to put compiled classes and war.

Run Ant to build the servlet archive.

5. Usage

XEP Servlet Container supports the following parameters:

XEPServlet?
				(xml=<source>&xsl=<stylesheet>|fo=<source>)
				[&format=(pdf|PostScript)]
				{&(|xsl_|pdf_|ps_)<name>=<value>}

xml, xsl: Source XML and transformartion stylesheet.
fo: XSL FO document.
format: The output format – PDF and PostScript are supported, the default format is PDF.
<name>=<value>: Options for XEP (no prefix), PDF generator (prefixed with pdf_), PostScript generator (prefixed with ps_) and XSL transformation parameters (prefixed with xsl_). Valid options are described in RenderX XEP documentation.