1 /***
2 * Redistribution and use of this software and associated documentation
3 * ("Software"), with or without modification, are permitted provided
4 * that the following conditions are met:
5 *
6 * 1. Redistributions of source code must retain copyright
7 * statements and notices. Redistributions must also contain a
8 * copy of this document.
9 *
10 * 2. Redistributions in binary form must reproduce the
11 * above copyright notice, this list of conditions and the
12 * following disclaimer in the documentation and/or other
13 * materials provided with the distribution.
14 *
15 * 3. The name "Exolab" must not be used to endorse or promote
16 * products derived from this Software without prior written
17 * permission of Exoffice Technologies. For written permission,
18 * please contact tma@netspace.net.au.
19 *
20 * 4. Products derived from this Software may not be called "Exolab"
21 * nor may "Exolab" appear in their names without prior written
22 * permission of Exoffice Technologies. Exolab is a registered
23 * trademark of Exoffice Technologies.
24 *
25 * 5. Due credit should be given to the Exolab Project
26 * (http://www.exolab.org/).
27 *
28 * THIS SOFTWARE IS PROVIDED BY EXOFFICE TECHNOLOGIES AND CONTRIBUTORS
29 * ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT
30 * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
31 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
32 * EXOFFICE TECHNOLOGIES OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
33 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
34 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
35 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
36 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
37 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
38 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
39 * OF THE POSSIBILITY OF SUCH DAMAGE.
40 *
41 * Copyright 2001-2004 (C) Exoffice Technologies Inc. All Rights Reserved.
42 *
43 * $Id: AbstractMessageTestRunner.java,v 1.5 2004/01/31 13:44:24 tanderson Exp $
44 */
45 package org.exolab.jmscts.core;
46
47 import junit.framework.Test;
48 import junit.framework.TestResult;
49
50
51 /***
52 * This class enables generic message test cases to be run for each JMS
53 * message type.
54 *
55 * @version $Revision: 1.5 $ $Date: 2004/01/31 13:44:24 $
56 * @author <a href="mailto:tma@netspace.net.au">Tim Anderson</a>
57 * @see MessageTestCase
58 */
59 public abstract class AbstractMessageTestRunner extends TestRunner
60 implements SessionTestCase {
61
62 /***
63 * Construct an instance with the test case to run.
64 *
65 * @param test the test case to run.
66 */
67 public AbstractMessageTestRunner(MessageTestCase test) {
68 super(test);
69 }
70
71 /***
72 * Get the connection factory types to test against
73 *
74 * @return the connection factory types to test against
75 */
76 public ConnectionFactoryTypes getConnectionFactoryTypes() {
77 return ((MessageTestCase) getTest()).getConnectionFactoryTypes();
78 }
79
80 /***
81 * Returns true if the connection should be started prior to running the
82 * test.
83 *
84 * @return true if the connection should be started, false if it should be
85 * stopped
86 */
87 public boolean startConnection() {
88 return ((MessageTestCase) getTest()).startConnection();
89 }
90
91 /***
92 * Returns true if the client identifier should be set on the connection.
93 * This is only applicable for TopicConnection instances, and will be
94 * ignored for QueueConnection instances.
95 *
96 * @return true if an identifier should be allocated to the connection
97 */
98 public boolean setClientID() {
99 return ((MessageTestCase) getTest()).setClientID();
100 }
101
102 /***
103 * Returns the message acknowledgement types of the sessions to test
104 * against. A session will be constructed for each type
105 *
106 * @return the acknowledgement type of the sessions to test against
107 */
108 public AckTypes getAckTypes() {
109 return ((MessageTestCase) getTest()).getAckTypes();
110 }
111
112 /***
113 * Counts the number of test cases that will be run by this test
114 *
115 * @return the number of test cases that will be run
116 */
117 public int countTestCases() {
118 MessageTestCase test = (MessageTestCase) getTest();
119 return test.getMessageTypes().count();
120 }
121
122 /***
123 * Run a test against each of the message types it supports
124 *
125 * @param test the test case
126 * @param result the instance to collect test results in
127 */
128 protected void runTest(Test test, TestResult result) {
129 MessageTestCase messageTest = (MessageTestCase) test;
130 Class[] types = messageTest.getMessageTypes().getTypes();
131 TestContext context = getContext();
132 TestFilter filter = getFilter();
133
134 for (int i = 0; i < types.length && !result.shouldStop(); ++i) {
135 if (filter == null || filter.includes(context, types[i], test)) {
136 runTest(test, result, types[i]);
137 }
138 }
139 }
140
141 /***
142 * Runs a test case for the given message type.
143 *
144 * @param test the test case
145 * @param result the instance to collect test results in
146 * @param messageType the message type
147 */
148 protected abstract void runTest(Test test, TestResult result,
149 Class messageType);
150
151 }
This page was automatically generated by Maven