1 files changed, 75 insertions, 0 deletions
diff --git a/Final/cpp/tests/TestCase.h b/Final/cpp/tests/TestCase.h
new file mode 100644
index 0000000000..ec151a6d84
--- /dev/null
+++ b/Final/cpp/tests/TestCase.h
@@ -0,0 +1,75 @@
+#ifndef _TestCase_
+#define _TestCase_
+/*
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ * 
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ *
+ */
+
+#include <ClientMessage.h>
+#include "TestOptions.h"
+
+
+namespace qpid {
+
+/**
+ * TestCase provides an interface that classes implementing tests to be run using a distributed test client
+ * must implement. The interop test spec, defines a life-cycle for interop tests. This consists of, inviting
+ * a test to participate in a test, assigning a role, starting the test, and extracting a report on the
+ * outcome of the test.
+ * 
+ * TODO: There is not method to process the test invitation. Add one.
+ */
+class TestCase
+{
+public:
+
+    /**
+     * Assigns the role to be played by this test case. The test parameters are fully specified in the
+     * assignment messages filed table.
+     *
+     * @param role              The role to be played; sender or receiver.
+     * @param assignRoleMessage The role assingment messages field table, contains the full test parameters.
+     * @param options           Additional test options.
+     */
+    virtual void assign(const std::string& role, framing::FieldTable& params, TestOptions& options) = 0;
+
+    /**
+     * Each test will be started on its own thread, which should block
+     * until the test completes (this may or may not require an
+     * explicit stop() request).
+     */
+    virtual void start() = 0;
+
+    /**
+     * Requests that the test be stopped if still running.
+     */
+    virtual void stop() = 0;
+
+    /**
+     * Allows the test to fill in details on the final report
+     * message. Will be called only after start has returned.
+     */
+    virtual void report(client::Message& report) = 0;
+
+    virtual ~TestCase() {}
+};
+
+}
+
+#endif