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 anna_testing_TestCase_hpp
10 #define anna_testing_TestCase_hpp
18 #include <anna/core/DataBlock.hpp>
19 #include <anna/core/util/Millisecond.hpp>
22 #include <anna/diameter/defines.hpp>
23 #include <anna/testing/TestDiameterCondition.hpp>
41 class TestStepWaitDiameter;
44 void assertInitialized() const throw(anna::RuntimeException);
45 void assertMessage(const anna::DataBlock &db, bool toEntity) throw(anna::RuntimeException);
53 anna::Millisecond Timestamp;
57 std::vector<event_t> a_events;
59 void addHint(const std::string &hint) throw();
61 int events() const throw() { return a_events.size(); }
62 anna::xml::Node* asXML(anna::xml::Node* parent) const throw();
63 std::string asString() const throw();
66 TestCase(unsigned int id, const std::string &description = "");
69 struct State { enum _v { Initialized, InProgress, Failed, Success }; };
70 static const char* asText(const State::_v state) throw();
71 const State::_v &getState() const throw() { return a_state; }
72 const anna::Millisecond &getStartTimestamp() const throw() { return a_startTimestamp; }
73 const anna::Millisecond &getFinishTimestamp() const throw() { return a_finishTimestamp; }
74 anna::Millisecond getLapseMs() const throw();
75 anna::Millisecond getProcessingTimeMs() const throw();
76 void addDebugSummaryHint(const std::string &hint) throw() { a_debugSummary.addHint(hint); }
77 void setState(const State::_v &state) throw();
78 bool isFinished() const throw() { return (getState() == State::Failed || getState() == State::Success); }
79 bool inProgress() const throw() { return (getState() == State::InProgress); }
80 bool isFailed() const throw() { return (getState() == State::Failed); }
81 bool isSuccess() const throw() { return (getState() == State::Success); }
82 bool hasSameCondition(const TestDiameterCondition &condition) const throw();
83 const DebugSummary & getDebugSummary() const throw() { return a_debugSummary; }
86 void makeInteractive(bool yes = true) throw() { a_interactiveAmount = (yes ? 0:-1); }
87 void addInteractiveAmount(unsigned int amount) throw() {
88 if (a_interactiveAmount == -1) makeInteractive();
89 if (amount == 0) return;
90 a_interactiveAmount += amount;
93 int interactiveAmount() const throw() { return a_interactiveAmount; }
94 void interactiveExecution() throw() { a_interactiveAmount --; }
96 // Step type & information
97 void addTimeout(const anna::Millisecond &timeout) throw(anna::RuntimeException);
98 void addDelay(const anna::Millisecond &delay) throw(anna::RuntimeException);
99 void addWaitDiameter(bool fromEntity,
100 const std::string &code, const std::string &bitR, const std::string &hopByHop, const std::string &applicationId,
101 const std::string &sessionId, const std::string &resultCode,
102 const std::string &msisdn, const std::string &imsi, const std::string &serviceContextId) throw(anna::RuntimeException);
103 void addCommand(const std::string &cmd) throw(anna::RuntimeException);
104 void addIpLimit(unsigned int ipLimit) throw(anna::RuntimeException);
107 void addSendDiameterXml2e(const anna::DataBlock &db, anna::diameter::comm::OriginHost *host, int stepNumber) throw(anna::RuntimeException);
108 void addSendDiameterXml2c(const anna::DataBlock &db, anna::diameter::comm::OriginHost *host, int stepNumber) throw(anna::RuntimeException);
109 void addWaitDiameterAnswer(bool fromEntity, int stepNumber) throw(anna::RuntimeException);
110 void addWaitDiameterRegexpHex(bool fromEntity, const std::string ®exp) throw(anna::RuntimeException);
111 void addWaitDiameterRegexpXml(bool fromEntity, const std::string ®exp) throw(anna::RuntimeException);
115 void nextStep() throw() { a_stepsIt++; }
117 bool process() throw(); // false to stop
119 // Reset test case and underlaying information (steps context)
120 bool reset(bool hard /* hard reset includes in-progress test cases */) throw();
123 const unsigned int &getId() const throw() { return a_id; }
124 const std::string &getDescription() const throw() { return a_description; }
127 void setDescription(const std::string &description) throw() { a_description = description; }
130 int steps() const throw() { return a_steps.size(); }
131 void addStep(TestStep *step) throw() { a_steps.push_back(step); }
133 TestStepWaitDiameter *searchNextWaitConditionFulfilled(const anna::DataBlock &message, bool waitFromEntity) throw();
134 // When a message arrives, we identify the test case by mean the Session-Id. Then, from the current step iterator (included),
135 // we search for a fulfilling condition for that message. The first found, is 'completed' and then breaks the search.
136 const TestStep *getStep(int stepNumber) const throw();
138 anna::xml::Node* asXML(anna::xml::Node* parent) const throw();
139 std::string asXMLString() const throw();
145 std::string a_description;
146 std::vector<TestStep*> a_steps;
147 std::vector<TestStep*>::const_iterator a_stepsIt;
148 std::map<anna::diameter::HopByHop, TestStep*> a_hopByHops; // for wait-answer
150 anna::Millisecond a_startTimestamp;
151 anna::Millisecond a_finishTimestamp;
152 DebugSummary a_debugSummary; // used when a test case has failed, uncovered message conditions, and any other hint.
153 int a_interactiveAmount;
155 friend class TestStep;