• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<!--
2 * Licensed to the Apache Software Foundation (ASF) under one
3 * or more contributor license agreements. See the NOTICE file
4 * distributed with this work for additional information
5 * regarding copyright ownership. The ASF licenses this file
6 * to you under the Apache License, Version 2.0 (the  "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
9 *
10 *     http://www.apache.org/licenses/LICENSE-2.0
11 *
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
17-->
18<!-- $Id$ -->
19<html>
20  <title>XSL-TEST general XSLT package.</title>
21  <body>
22    <p>This package contains XSLT testing base classes and utilities, and a generic test driver.</p>
23    <dl>
24      <dt><b>Author: </b></dt><dd><a href="mailto:shane_curcuru@lotus.com">Shane_Curcuru@lotus.com</a></dd>
25      <dt><b>Program(s) Under Test: </b></dt>
26      <dd><a href="http://xml.apache.org/xalan-j" target="_top">Xalan-J 2.x XSLT Processor</a></dd>
27      <dd><a href="http://xml.apache.org/xalan" target="_top">Xalan-J 1.x XSLT Processor</a></dd>
28      <dd><a href="http://xml.apache.org/xalan-c" target="_top">Xalan-C 1.x XSLT Processor</a></dd>
29    </dl>
30    <p>This package includes base classes and utilities, as well as several
31    generic test drivers that use {@link org.apache.qetest.xslwrapper.ProcessorWrapper ProcessorWrappers}
32    to process stylesheets.  Classes in this package must not depend directly
33    on any Xalan interfaces, only on the ProcessorWrapper interface.<p>
34    <ul>Current utilities include:
35    <li>Logging* - implementations of XSLT-related listeners
36    and the like that log to our Reporter.</li>
37    <li>XHTFileCheckService, XHTComparator - checks equivalence of
38    two File objects by parsing either as XML, HTML, or text.  Note
39    the HTML parsing is unimplemented - we need a good HTML->DOM
40    parser we can use in Apache - any suggestions?</li>
41    <li>XSLTestfileInfo - simple extension of TestfileInfo to
42    add xmlName member. Should be replaced with StylesheetDatalet</li>
43    <li>XSLDirectoryIterator - simple implementation that processes
44    xsl/xml file pairs from a fileList or over a directory tree,
45    automatically comparing the result files with a known good
46    or 'gold' reference tree of outputs. Should be replaced
47    with StylesheetTestletDriver and various Testlets.</li>
48    <li>XSLProcessorTestBase - adds useful XSLT processing
49    utilities, etc. from FileTestBase: including flags like
50    -preprocess, -flavor, -category, etc.  Most xsl and trax
51    package Test scripts derive from this class.</li>
52    </ul>
53    <ul>Current tests include:
54    <li>ConformanceTest - generic test driver, including some
55    FilenameFilters.  This essentially uses the XSLDirectoryIterator
56    for everything.
57    Being replaced by StylesheetTestletDriver and
58    StylesheetTestlet/Datalet</li>
59    <li>PerformanceTest - test driver that iterates repeatedly and
60    reports memory and timing info
61    Being replaced by StylesheetTestletDriver and
62    PerformanceTestlet, PerfPreloadTestlet</li>
63
64    <li>CConformanceTest - generic test driver that constructs a
65    command line and then shells out to execute TestXSLT.exe, which
66    is from the Xalan-C build.  This allows basic comparisons of
67    results from the Java versions with the C++ versions.
68    I'd like to replace this with a more generic and configurable
69    CmdlineTestlet, that can run any sort of command-line interface
70    like this in a standard way.</li>
71    </ul>
72  </body>
73</html>
74
75
76