Tutorial introduction
The automated generation of code, when applied correctly, can be a powerful engineering technique. This tutorial provides a basic introduction to code generation concepts, and in particular introduces XSLT as a code generation tool.
The tutorial also discusses the limitations of XSLT when generating code, and demonstrates how to compensate for some of these issues using a flexible framework built with open source tools, such as Ant and Jalopy. This simple but powerful framework can be applied to the generation of many different types of code.
The examples in the tutorial illustrate how to apply this framework to the generation of both Java code and XSLT stylesheets. The latter section introduces a powerful technique called meta-stylesheets that is sure to prove useful to any XSLT author.
Who should take this tutorial?
This tutorial is designed for developers already familiar with XML, XSLT, and the Java language, and who are interested in combining these technologies to help automate development tasks and explore the potential benefits of code generation. The tutorial therefore assumes that you already understand how to write and apply XSLT stylesheets. The Resources include pointers to an XSLT tutorial for those needing a refresher on the basic concepts.
The tutorial examples also refer to Ant, an open source build tool. However, as the tutorial covers both the installation of the Ant and some background on its basic concepts, no detailed prior knowledge is assumed. If you're interested in learning more about Ant, see the Resources section.
Overall, the tutorial introduces the reader to the uses of XSLT as a code generation tool, providing useful tips, techniques, and advice.
While the majority of the examples discuss the generation of Java code, you can easily adapt the basic techniques to encompass other programming languages.
While this tutorial does not discuss how to install an XSLT processor, you are not required to have a processor installed to follow the examples. Instructions on how to install Ant, the open source Java build tool, are available in the Installing the tools section. Ant includes Xalan as an embedded XSLT processor, and the later sections (see A code generation framework ) show you how to apply XSLT transformations using Ant's built-in XSLT support. But, as no processor-specific extensions have been used, any XSLT processor will work should you care to manually apply the transformations.
The examples were tested against Ant 1.5.1. You can download the binary distributions of the latest version of Ant from the project Web site at: http://ant.apache.org/bindownload.cgi. See Installing Ant for information on how to install Ant and the Java source code formatter, Jalopy, available at: http://sourceforge.net/project/showfiles.php?group_id=45216.
The code samples for this tutorial are available at Downloads. To install the samples, simply extract the files, preserving the directory structure, into a newly created directory. The examples for each section are contained in the following sub-directories:
-
bean-- the Java code generation examples referenced from the Generating JavaBeans . -
meta-- the XSLT stylesheet generation examples introduced in Generating XSLT using XSLT .





