1 // ANNA - Anna is Not Nothingness Anymore //
3 // (c) Copyright 2005-2015 Eduardo Ramos Testillano & Francisco Ruiz Rayo //
5 // See project site at http://redmine.teslayout.com/projects/anna-suite //
6 // See accompanying file LICENSE or copy at http://www.teslayout.com/projects/public/anna.LICENSE //
9 #ifndef example_diameter_launcher_TestCase_hpp
10 #define example_diameter_launcher_TestCase_hpp
17 #include <anna/core/DataBlock.hpp>
18 #include <anna/xml/Node.hpp>
19 #include <anna/diameter/defines.hpp>
22 #include <TestStep.hpp>
38 void assertInitialized() const throw(anna::RuntimeException);
39 void assertMessage(const anna::DataBlock &db, bool toEntity) throw(anna::RuntimeException);
47 anna::Millisecond Timestamp;
51 std::vector<event_t> a_events;
53 void addHint(const std::string &hint) throw();
55 int events() const throw() { return a_events.size(); }
56 anna::xml::Node* asXML(anna::xml::Node* parent) const throw();
59 TestCase(unsigned int id) : a_id(id), a_state(State::Initialized), a_startTime(0) { /*a_stepsIt = a_steps.end()*/;}
62 struct State { enum _v { Initialized, InProgress, Failed, Success }; };
63 static const char* asText(const State::_v state) throw();
64 const State::_v &getState() const throw() { return a_state; }
65 const anna::Millisecond &getStartTimestamp() const throw() { return a_startTime; }
66 void addDebugSummaryHint(const std::string &hint) throw() { a_debugSummary.addHint(hint); }
67 void setState(const State::_v &state) throw();
68 bool isFinished() const throw() { return (getState() == State::Failed || getState() == State::Success); }
69 bool inProgress() const throw() { return (getState() == State::InProgress); }
70 bool hasSameCondition(const TestCondition &condition) const throw();
72 // Step type & information
73 void addTimeout(const anna::Millisecond &timeout) throw(anna::RuntimeException);
74 void addSendxml2e(const anna::DataBlock &db, RealmNode *realm, int stepNumber) throw(anna::RuntimeException);
75 void addSendxml2c(const anna::DataBlock &db, RealmNode *realm, int stepNumber) throw(anna::RuntimeException);
76 void addDelay(const anna::Millisecond &delay) throw(anna::RuntimeException);
77 void addWait(bool fromEntity,
78 const std::string &code, const std::string &bitR, const std::string &resultCode, const std::string &sessionId,
79 const std::string &hopByHop, const std::string &msisdn, const std::string &imsi, const std::string &serviceContextId) throw(anna::RuntimeException);
80 void addWaitAnswer(bool fromEntity, int stepNumber) throw(anna::RuntimeException);
81 void addWaitRegexp(bool fromEntity, const std::string ®exp) throw(anna::RuntimeException);
82 void addCmd(const std::string &script, const std::string ¶meters) throw(anna::RuntimeException);
86 void nextStep() throw() { a_stepsIt++; }
88 bool process() throw(); // false to stop
90 // Reset test case and underlaying information (steps context)
91 bool reset(bool hard /* hard reset includes in-progress test cases */) throw();
94 const anna::Millisecond &getStartTime() const throw() { return a_startTime; }
95 const unsigned int &getId() const throw() { return a_id; }
98 int steps() const throw() { return a_steps.size(); }
99 TestStepWait *searchNextWaitConditionFulfilled(const anna::DataBlock &message, bool waitFromEntity) throw();
100 // When a message arrives, we identify the test case by mean the Session-Id. Then, from the current step iterator (included),
101 // we search for a fulfilling condition for that message. The first found, is 'completed' and then breaks the search.
102 const TestStep *getStep(int stepNumber) const throw();
104 anna::xml::Node* asXML(anna::xml::Node* parent) const throw();
105 std::string asXMLString() const throw();
111 std::vector<TestStep*> a_steps;
112 std::vector<TestStep*>::const_iterator a_stepsIt;
113 std::map<anna::diameter::HopByHop, TestStep*> a_hopByHops; // for wait-answer
115 anna::Millisecond a_startTime;
116 DebugSummary a_debugSummary; // used when a test case has failed, uncovered message conditions, and any other hint.
118 friend class TestStep;