cpp/tests/TestCase.h

#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