Commit 34e046c3 authored by nobody's avatar nobody
Browse files

This commit was manufactured by cvs2svn to create branch 'jms1_0_2b'.

parents 557381c8 da2796b7
# The "checkoutlist" file is used to support additional version controlled
# administrative files in $CVSROOT/CVSROOT, such as template files.
#
# The first entry on a line is a filename which will be checked out from
# the corresponding RCS file in the $CVSROOT/CVSROOT directory.
# The remainder of the line is an error message to use if the file cannot
# be checked out.
#
# File format:
#
# [<whitespace>]<filename><whitespace><error message><end-of-line>
#
# comment lines begin with '#'
# The "commitinfo" file is used to control pre-commit checks.
# The filter on the right is invoked with the repository and a list
# of files to check. A non-zero exit of the filter program will
# cause the commit to be aborted.
#
# The first entry on a line is a regular expression which is tested
# against the directory that the change is being committed to, relative
# to the $CVSROOT. For the first match that is found, then the remainder
# of the line is the name of the filter to run.
#
# If the repository name does not match any of the regular expressions in this
# file, the "DEFAULT" line is used, if it is specified.
#
# If the name "ALL" appears as a regular expression it is always used
# in addition to the first matching regex or "DEFAULT".
# Set this to "no" if pserver shouldn't check system users/passwords
#SystemAuth=no
# Put CVS lock files in this directory rather than directly in the repository.
#LockDir=/var/lock/cvs
# Set `TopLevelAdmin' to `yes' to create a CVS directory at the top
# level of the new working directory when using the `cvs checkout'
# command.
#TopLevelAdmin=no
# Set `LogHistory' to `all' or `TOFEWGCMAR' to log all transactions to the
# history file, or a subset as needed (ie `TMAR' logs all write operations)
#LogHistory=TOFEWGCMAR
# This file affects handling of files based on their names.
#
# The -t/-f options allow one to treat directories of files
# as a single file, or to transform a file in other ways on
# its way in and out of CVS.
#
# The -m option specifies whether CVS attempts to merge files.
#
# The -k option specifies keyword expansion (e.g. -kb for binary).
#
# Format of wrapper file ($CVSROOT/CVSROOT/cvswrappers or .cvswrappers)
#
# wildcard [option value][option value]...
#
# where option is one of
# -f from cvs filter value: path to filter
# -t to cvs filter value: path to filter
# -m update methodology value: MERGE or COPY
# -k expansion mode value: b, o, kkv, &c
#
# and value is a single-quote delimited value.
# For example:
#*.gif -k 'b'
# The "editinfo" file is used to allow verification of logging
# information. It works best when a template (as specified in the
# rcsinfo file) is provided for the logging procedure. Given a
# template with locations for, a bug-id number, a list of people who
# reviewed the code before it can be checked in, and an external
# process to catalog the differences that were code reviewed, the
# following test can be applied to the code:
#
# Making sure that the entered bug-id number is correct.
# Validating that the code that was reviewed is indeed the code being
# checked in (using the bug-id number or a seperate review
# number to identify this particular code set.).
#
# If any of the above test failed, then the commit would be aborted.
#
# Actions such as mailing a copy of the report to each reviewer are
# better handled by an entry in the loginfo file.
#
# One thing that should be noted is the the ALL keyword is not
# supported. There can be only one entry that matches a given
# repository.
# The "loginfo" file controls where "cvs commit" log information
# is sent. The first entry on a line is a regular expression which must match
# the directory that the change is being made to, relative to the
# $CVSROOT. If a match is found, then the remainder of the line is a filter
# program that should expect log information on its standard input.
#
# If the repository name does not match any of the regular expressions in this
# file, the "DEFAULT" line is used, if it is specified.
#
# If the name ALL appears as a regular expression it is always used
# in addition to the first matching regex or DEFAULT.
#
# You may specify a format string as part of the
# filter. The string is composed of a `%' followed
# by a single format character, or followed by a set of format
# characters surrounded by `{' and `}' as separators. The format
# characters are:
#
# s = file name
# V = old version number (pre-checkin)
# v = new version number (post-checkin)
#
# For example:
#DEFAULT (echo ""; id; echo %s; date; cat) >> $CVSROOT/CVSROOT/commitlog
# or
#DEFAULT (echo ""; id; echo %{sVv}; date; cat) >> $CVSROOT/CVSROOT/commitlog
# Three different line formats are valid:
# key -a aliases...
# key [options] directory
# key [options] directory files...
#
# Where "options" are composed of:
# -i prog Run "prog" on "cvs commit" from top-level of module.
# -o prog Run "prog" on "cvs checkout" of module.
# -e prog Run "prog" on "cvs export" of module.
# -t prog Run "prog" on "cvs rtag" of module.
# -u prog Run "prog" on "cvs update" of module.
# -d dir Place module in directory "dir" instead of module name.
# -l Top-level directory only -- do not recurse.
#
# NOTE: If you change any of the "Run" options above, you'll have to
# release and re-checkout any working directories of these modules.
#
# And "directory" is a path to a directory relative to $CVSROOT.
#
# The "-a" option specifies an alias. An alias is interpreted as if
# everything on the right of the "-a" had been typed on the command line.
#
# You can encode a module within a module by using the special '&'
# character to interpose another module into the current module. This
# can be useful for creating a module that consists of many directories
# spread out over the entire source repository.
# The "notify" file controls where notifications from watches set by
# "cvs watch add" or "cvs edit" are sent. The first entry on a line is
# a regular expression which is tested against the directory that the
# change is being made to, relative to the $CVSROOT. If it matches,
# then the remainder of the line is a filter program that should contain
# one occurrence of %s for the user to notify, and information on its
# standard input.
#
# "ALL" or "DEFAULT" can be used in place of the regular expression.
#
# For example:
#ALL mail %s -s "CVS notification"
# The "rcsinfo" file is used to control templates with which the editor
# is invoked on commit and import.
#
# The first entry on a line is a regular expression which is tested
# against the directory that the change is being made to, relative to the
# $CVSROOT. For the first match that is found, then the remainder of the
# line is the name of the file that contains the template.
#
# If the repository name does not match any of the regular expressions in this
# file, the "DEFAULT" line is used, if it is specified.
#
# If the name "ALL" appears as a regular expression it is always used
# in addition to the first matching regex or "DEFAULT".
# The "taginfo" file is used to control pre-tag checks.
# The filter on the right is invoked with the following arguments:
#
# $1 -- tagname
# $2 -- operation "add" for tag, "mov" for tag -F, and "del" for tag -d
# $3 -- repository
# $4-> file revision [file revision ...]
#
# A non-zero exit of the filter program will cause the tag to be aborted.
#
# The first entry on a line is a regular expression which is tested
# against the directory that the change is being committed to, relative
# to the $CVSROOT. For the first match that is found, then the remainder
# of the line is the name of the filter to run.
#
# If the repository name does not match any of the regular expressions in this
# file, the "DEFAULT" line is used, if it is specified.
#
# If the name "ALL" appears as a regular expression it is always used
# in addition to the first matching regex or "DEFAULT".
# The "verifymsg" file is used to allow verification of logging
# information. It works best when a template (as specified in the
# rcsinfo file) is provided for the logging procedure. Given a
# template with locations for, a bug-id number, a list of people who
# reviewed the code before it can be checked in, and an external
# process to catalog the differences that were code reviewed, the
# following test can be applied to the code:
#
# Making sure that the entered bug-id number is correct.
# Validating that the code that was reviewed is indeed the code being
# checked in (using the bug-id number or a seperate review
# number to identify this particular code set.).
#
# If any of the above test failed, then the commit would be aborted.
#
# Actions such as mailing a copy of the report to each reviewer are
# better handled by an entry in the loginfo file.
#
# One thing that should be noted is the the ALL keyword is not
# supported. There can be only one entry that matches a given
# repository.
This diff is collapsed.
<?xml version="1.0" standalone="yes"?>
<project default="compile" basedir=".">
<!-- Initializes properties -->
<target name="init">
<!-- Create the time stamp -->
<tstamp/>
<!-- Initialize the environment properties, use ${env.name} -->
<property environment="env"/>
<!-- Get the user defined properties from file -->
<property file="build.properties"/>
<!-- Initialize the directory structure properties -->
<property name="src.dir" location="src"/>
<property name="obj.dir" location="classes"/>
<property name="lib.dir" location="lib"/>
<property name="config.dir" location="config"/>
<property name="build.dir" location="build"/>
<property name="jdoc.dir" location="javadoc"/>
<property name="test.dir" location="run"/>
<property name="providers.dir" location="providers"/>
<property name="report.dir" location="report"/>
<!-- Base classpath needed for execution -->
<path id="base.class.path">
<pathelement path="${java.class.path}/"/>
<fileset dir="${lib.dir}">
<include name="xalan.jar" />
<include name="*.jar"/>
</fileset>
</path>
<!-- Project classpath needed for compilation -->
<path id="project.class.path">
<path refid="base.class.path"/>
<pathelement path="${obj.dir}"/>
<pathelement path="${config.dir}"/>
</path>
</target>
<!-- Clean all generated files -->
<target name="clean" depends="init"
description="--> Clean all generated files">
<delete dir="${obj.dir}"/>
<delete dir="${jdoc.dir}"/>
<delete dir="${test.dir}"/>
<delete dir="${report.dir}"/>
<delete>
<fileset dir=".">
<Include name="**/junit*.properties"/>
</fileset>
</delete>
</target>
<!-- Prepare compilation phase -->
<target name="prepare" depends="init">
<!-- Create the directory structure -->
<mkdir dir="${obj.dir}"/>
<mkdir dir="${jdoc.dir}"/>
</target>
<target name="prepare.providers" depends="init">
<!-- Project classpath needed for compilation -->
<path id="project.class.path">
<path refid="base.class.path"/>
<pathelement path="${obj.dir}"/>
<pathelement path="${config.dir}"/>
<fileset dir="${providers.dir}">
<include name="**/*"/>
</fileset>
</path>
</target>
<target name="compile" depends="prepare"
description="--> Compile Tests">
<javac srcdir="${src.dir}:${obj.dir}"
destdir="${obj.dir}"
debug="true"
deprecation="${deprecation}"
optimize="false"
nowarn="${nowarn}"
verbose="${verbose}">
<classpath refid="project.class.path"/>
<include name="org/objectweb/jtests/jms/**/*.java"/>
<!-- Excludes CVS directories -->
<exclude name="**/CVS/**/*.java"/>
</javac>
</target>
<target name="compile.joram" depends="prepare.providers"
description="--> Compile Joram specific classes">
<javac srcdir="${src.dir}:${obj.dir}"
destdir="${obj.dir}"
debug="true"
deprecation="${deprecation}"
optimize="false"
nowarn="${nowarn}"
verbose="${verbose}">
<classpath refid="project.class.path"/>
<include name="org/objectweb/jtests/providers/admin/JoramAdmin.java"/>
<!-- Excludes CVS directories -->
<exclude name="**/CVS/**/*.java"/>
</javac>
</target>
<target name="compile.pramati" depends="prepare.providers"
description="--> Compile Pramati specific classes">
<javac srcdir="${src.dir}:${obj.dir}"
destdir="${obj.dir}"
debug="true"
deprecation="${deprecation}"
optimize="false"
nowarn="${nowarn}"
verbose="${verbose}">
<classpath refid="project.class.path"/>
<include name="org/objectweb/jtests/providers/admin/PramatiAdmin.java"/>
<!-- Excludes CVS directories -->
<exclude name="**/CVS/**/*.java"/>
</javac>
</target>
<target name="compile.ashnasoft" depends="prepare.providers"
description="--> Compile AshnaSoft specific classes">
<javac srcdir="${src.dir}:${obj.dir}"
destdir="${obj.dir}"
debug="true"
deprecation="${deprecation}"
optimize="false"
nowarn="${nowarn}"
verbose="${verbose}">
<classpath refid="project.class.path"/>
<include name="org/objectweb/jtests/providers/admin/AshnaMQAdmin.java"/>
<!-- Excludes CVS directories -->
<exclude name="**/CVS/**/*.java"/>
</javac>
</target>
<target name="compile.swiftmq" depends="prepare.providers"
description="--> Compile SwiftMQ specific classes">
<javac srcdir="${src.dir}:${obj.dir}"
destdir="${obj.dir}"
debug="true"
deprecation="${deprecation}"
optimize="false"
nowarn="${nowarn}"
verbose="${verbose}">
<classpath refid="project.class.path"/>
<include name="org/objectweb/jtests/providers/admin/SwiftMQAdmin.java"/>
<!-- Excludes CVS directories -->
<exclude name="**/CVS/**/*.java"/>
</javac>
</target>
<target name="compile.fiorano" depends="prepare.providers"
description="--> Compile Fiorano specific classes">
<javac srcdir="${src.dir}:${obj.dir}"
destdir="${obj.dir}"
debug="true"
deprecation="${deprecation}"
optimize="false"
nowarn="${nowarn}"
verbose="${verbose}">
<classpath refid="project.class.path"/>
<include name="org/objectweb/jtests/providers/admin/FioranoMQAdmin.java"/>
<!-- Excludes CVS directories -->
<exclude name="**/CVS/**/*.java"/>
</javac>
</target>
<target name="javadoc" depends="init"
description="--> Generate Javadoc">
<delete dir="${jdoc.dir}" />
<mkdir dir="${jdoc.dir}" />
<javadoc packagenames="org.objectweb.jtests.jms.*"
sourcepath="${src.dir}"
classpathref="project.class.path"
defaultexcludes="yes"
destdir="${jdoc.dir}"
author="true"
version="true"
use="false"
windowtitle="Test Suite Documentation">
<doctitle><![CDATA[<h1>Test Suite
Documentation</h1>]]></doctitle>
<group title="JMS Conformance Tests" packages="org.objectweb.jtests.jms.conform.*"/>
<group title="JMS Administration" packages="org.objectweb.jtests.jms.admin"/>
<group title="JMS JUnit Framework" packages="org.objectweb.jtests.jms.framework"/>
<link href="http://java.sun.com/j2ee/sdk_1.3/techdocs/api/" />
<link href="http://java.sun.com/j2se/1.3/docs/api/" />
<link href="http://junit.org/junit/javadoc/3.7/" />
</javadoc>
</target>
<target name="init.tests" depends="init">
<delete dir="${test.dir}"/>
<mkdir dir="${test.dir}"/>
<path id="project.class.path">
<path refid="base.class.path"/>
<pathelement path="${obj.dir}"/>
<pathelement path="${config.dir}"/>
<fileset dir="${providers.dir}">
<include name="**/*" />
</fileset>
</path>
</target>
<target name="batchtest" depends="init.tests,compile"
description="--> Run all tests">
<delete dir="${report.dir}" />
<mkdir dir="${report.dir}" />
<delete dir="${report.dir}/html" />
<mkdir dir="${report.dir}/html" />
<junit printsummary="yes"
haltonfailure="no"
haltonerror="no"
fork="yes" >
<classpath refid="project.class.path" />
<formatter type="xml" />
<batchtest fork="yes" todir="${report.dir}">
<fileset dir="${src.dir}">
<include name="org/objectweb/jtests/jms/conform/**/*Test.java" />
</fileset>
</batchtest>
</junit>
<junitreport todir="${report.dir}">
<fileset dir="${report.dir}">
<include name="TEST-*.xml"/>
</fileset>
<report format="frames" todir="./report/html"/>
</junitreport>
</target>
<target name="test" depends="init.tests,compile"
description="--> Start one test (specified by -Dtest=&lt;class name&gt;)" >
<mkdir dir="${report.dir}" />
<junit printsummary="yes"
haltonfailure="no"
haltonerror="no"
fork="yes" >
<classpath refid="project.class.path" />
<formatter type="xml" />
<test name="${test}" todir="${report.dir}" />
</junit>
<junitreport todir="${report.dir}">
<fileset dir="${report.dir}">
<include name="TEST-*.xml"/>
</fileset>
<report format="frames" todir="./report/html"/>
</junitreport>
</target>
<target name="junit.gui" depends="init.tests,compile"
description="--> Use the GUI TestRunner of Junit">
<java classname="junit.swingui.TestRunner"
failonerror="no" fork="yes"
dir="${test.dir}">
<classpath refid="project.class.path"/>
</java>
</target>
<target name="package" depends="init, clean, compile, compile.joram,
javadoc"
description="--> Create a package for the test suite">
<delete file="tests.tgz" />
<tar tarfile="tests.tar"
longfile="gnu"
basedir=".."
includes="tests/**"
excludes="**/CVS, providers/fiorano/**"/>
<gzip zipfile="tests.tgz" src="tests.tar" />
<delete file="tests.tar" />
</target>
</project>
\ No newline at end of file
##
# JORAM: Java(TM) Open Reliable Asynchronous Messaging
# Copyright (C) 2002 INRIA
# Contact: joram-team@objectweb.org
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
# USA
#
# Initial developer(s): Jeff Mesnil (jmesnil@inrialpes.fr)
# Contributor(s): ______________________________________.
##
##
# This property is used to chose which provider is to be tested
# Uncomment the chosen provider and comment the other ones
##
jms.provider.admin.class = org.objectweb.jtests.providers.admin.JoramAdmin
#jms.provider.admin.class = org.objectweb.jtests.providers.admin.AshnaMQAdmin
#jms.provider.admin.class = org.objectweb.jtests.providers.admin.FioranoMQAdmin
#jms.provider.admin.class = org.objectweb.jtests.providers.admin.PramatiAdmin
##
# JORAM: Java(TM) Open Reliable Asynchronous Messaging
# Copyright (C) 2002 INRIA
# Contact: joram-team@objectweb.org
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
# USA
#
# Initial developer(s): Jeff Mesnil (jmesnil@inrialpes.fr)
# Contributor(s): ______________________________________.
##
# Timeout specified for receive(long time) method
# Time in milliseconds or 0 for never expiring
# Default is set to 30 seconds (long enough to receive slow messages
# and won't hang up tests infinitely)
timeout = 30000
\ No newline at end of file
<?xml version="1.0" ?>
<!DOCTYPE article SYSTEM "/usr/share/sgml/docbook/dtd/4.2.cr1/docbook.dtd">
<article>
<articleinfo>
<author>
<firstname>Jeff</firstname>
<surname>Mesnil</surname>
<affiliation>
<address><email>jmesnil@inrialpes.fr</email></address>
</affiliation>
</author>
<title>JMS Test Suite Documentation</title>
</articleinfo>
<sect1>
<title>Aim of the test suite</title>
<para>At first, this test suite goal was to test(!) JMS compliance
for JORAM. It happened while JORAM was totally rewritten from
scratch. Thus we needed to test that the new code was still
compliant to JMS specifications.</para>
<para>Another goal of this test suite was for me to learn more about
JMS. As I was learning it, I was interested by knowing how
other JMS providers performed. So I needed to be able to use other
providers than JORAM for this suite.</para>
<para>Therefore, it became clear that a JMS Test Suite
independent of any JMS providers was interesting. I knew that
other JMS test suites existed but since they came from company
selling JMS solutions I was quite doubtful about it. Working for
<ulink url="http://www.objectweb.org"> ObjectWeb</ulink> which
is a consortium aiming at creating Open Source middleware
softwares, it was my interest to make an
<emphasis>unbiased</emphasis> test suite that
could help us to improve our code quality.</para>
<para>I don't deny that, at the beginning, JORAM results were not
very good. But the new version being written in parallel of this