eCube The XSLT Profiler.

How to profile




The packages you need

First of all, you need a JRE or JDK (Version 1.2 ++) which you can find on java.sun.com

Download catchXSL!, either with or without included processor (see Download).

The tool is provided as a zip-file which you can unpack under any directory. From now an we refer to this directory with "PROFILER_HOME". The class files of catchXSL! are to be found in catchXSL.jar under $PROFILER_HOME/lib.


TOP



Run catchXSL!

Under $PROFILER_HOME you'll find the script "startui" (resp. "startui.cmd" for Windows NT) for starting catchxsl! Adjust the entry for PROFILER_HOME to your environment. In case you have downloaded the version without xslt processor, you must adjust the classpath settings to the location of your xslt processor.

After calling startui catchXSL! comes up. How to configure a transformation and how to set up the result views is explained as follows.


TOP




Setting up a profiling project

CatchXSL! manages profiling tasks as projects. Thus a project consists of all the parameters needed for a profiling task, i.e. the set of xml/xsl-input files, the desired processor, the number of iterations and lots of other parameters the user can specify. This project management allows to compare different tasks with various parameters changed (e.g. the processor).

A new project is created very easily:


project creation

TOP



Setting up the result views

After the transformation has finished you are prompted to create the desired views on the profiling results. CatchXSL! distinguishes between a template view and a call tree view (see Reading the results). In the dialog you specifiy the runs for which you want the views to be created. You have to create at least one view to see any of your transformation results.


TOP



Integration into XML Spy

For all XSL developers using Altova's XML Spy Ide we provide an easy way to integrate catchXSL! into the IDE. All you have to do is to configure catchXSL as an "external XSL transformation" in XML Spy:

Open the "options" dialog, on panel "XSL" click the radio button "External XSL transformation" and fill in the command line for catchXSL:

C:\catchxsl\profile.cmd %1 %3 processorname > %2

where C:\catchxsl might be your installation path of catchxsl and processorname is either 'saxon' or 'xalan'.

Then, you start the transformation of your xsl- and xml-files in XML Spy as usual. The resulting HTML output of catchXSL is then shown inside XML Spy. Of course, you can use all the options of the command line interface of catchXSL.

TOP