//
// Copyright (C) 2009 The Android Open Source Project
//
// Licensed 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 "update_engine/common/action_processor.h"
#include <string>
#include <utility>
#include <gtest/gtest.h>
#include "update_engine/common/action.h"
#include "update_engine/common/mock_action.h"
using std::string;
namespace chromeos_update_engine {
using chromeos_update_engine::ActionPipe;
class ActionProcessorTestAction;
template <>
class ActionTraits<ActionProcessorTestAction> {
public:
typedef string OutputObjectType;
typedef string InputObjectType;
};
// This is a simple Action class for testing.
class ActionProcessorTestAction : public Action<ActionProcessorTestAction> {
public:
typedef string InputObjectType;
typedef string OutputObjectType;
ActionPipe<string>* in_pipe() { return in_pipe_.get(); }
ActionPipe<string>* out_pipe() { return out_pipe_.get(); }
ActionProcessor* processor() { return processor_; }
void PerformAction() {}
void CompleteAction() {
ASSERT_TRUE(processor());
processor()->ActionComplete(this, ErrorCode::kSuccess);
}
string Type() const { return "ActionProcessorTestAction"; }
};
namespace {
class MyActionProcessorDelegate : public ActionProcessorDelegate {
public:
explicit MyActionProcessorDelegate(const ActionProcessor* processor)
: processor_(processor),
processing_done_called_(false),
processing_stopped_called_(false),
action_completed_called_(false),
action_exit_code_(ErrorCode::kError) {}
virtual void ProcessingDone(const ActionProcessor* processor,
ErrorCode code) {
EXPECT_EQ(processor_, processor);
EXPECT_FALSE(processing_done_called_);
processing_done_called_ = true;
}
virtual void ProcessingStopped(const ActionProcessor* processor) {
EXPECT_EQ(processor_, processor);
EXPECT_FALSE(processing_stopped_called_);
processing_stopped_called_ = true;
}
virtual void ActionCompleted(ActionProcessor* processor,
AbstractAction* action,
ErrorCode code) {
EXPECT_EQ(processor_, processor);
EXPECT_FALSE(action_completed_called_);
action_completed_called_ = true;
action_exit_code_ = code;
}
const ActionProcessor* processor_;
bool processing_done_called_;
bool processing_stopped_called_;
bool action_completed_called_;
ErrorCode action_exit_code_;
};
} // namespace
class ActionProcessorTest : public ::testing::Test {
void SetUp() override {
action_processor_.set_delegate(&delegate_);
// Silence Type() calls used for logging.
mock_action_.reset(new testing::StrictMock<MockAction>());
mock_action_ptr_ = mock_action_.get();
action_.reset(new ActionProcessorTestAction());
action_ptr_ = action_.get();
EXPECT_CALL(*mock_action_, Type()).Times(testing::AnyNumber());
}
void TearDown() override { action_processor_.set_delegate(nullptr); }
protected:
// The ActionProcessor under test.
ActionProcessor action_processor_;
MyActionProcessorDelegate delegate_{&action_processor_};
// Common actions used during most tests.
std::unique_ptr<testing::StrictMock<MockAction>> mock_action_;
testing::StrictMock<MockAction>* mock_action_ptr_;
std::unique_ptr<ActionProcessorTestAction> action_;
ActionProcessorTestAction* action_ptr_;
};
TEST_F(ActionProcessorTest, SimpleTest) {
EXPECT_FALSE(action_processor_.IsRunning());
action_processor_.EnqueueAction(std::move(action_));
EXPECT_FALSE(action_processor_.IsRunning());
EXPECT_FALSE(action_ptr_->IsRunning());
action_processor_.StartProcessing();
EXPECT_TRUE(action_processor_.IsRunning());
EXPECT_TRUE(action_ptr_->IsRunning());
action_ptr_->CompleteAction();
EXPECT_FALSE(action_processor_.IsRunning());
EXPECT_EQ(action_processor_.current_action(), nullptr);
}
TEST_F(ActionProcessorTest, DelegateTest) {
action_processor_.EnqueueAction(std::move(action_));
action_processor_.StartProcessing();
action_ptr_->CompleteAction();
EXPECT_TRUE(delegate_.processing_done_called_);
EXPECT_TRUE(delegate_.action_completed_called_);
}
TEST_F(ActionProcessorTest, StopProcessingTest) {
action_processor_.EnqueueAction(std::move(action_));
action_processor_.StartProcessing();
action_processor_.StopProcessing();
EXPECT_TRUE(delegate_.processing_stopped_called_);
EXPECT_FALSE(delegate_.action_completed_called_);
EXPECT_FALSE(action_processor_.IsRunning());
EXPECT_EQ(nullptr, action_processor_.current_action());
}
TEST_F(ActionProcessorTest, ChainActionsTest) {
// This test doesn't use a delegate since it terminates several actions.
action_processor_.set_delegate(nullptr);
auto action0 = std::make_unique<ActionProcessorTestAction>();
auto action1 = std::make_unique<ActionProcessorTestAction>();
auto action2 = std::make_unique<ActionProcessorTestAction>();
auto action0_ptr = action0.get();
auto action1_ptr = action1.get();
auto action2_ptr = action2.get();
action_processor_.EnqueueAction(std::move(action0));
action_processor_.EnqueueAction(std::move(action1));
action_processor_.EnqueueAction(std::move(action2));
EXPECT_EQ(action_processor_.actions_.size(), 3u);
EXPECT_EQ(action_processor_.actions_[0].get(), action0_ptr);
EXPECT_EQ(action_processor_.actions_[1].get(), action1_ptr);
EXPECT_EQ(action_processor_.actions_[2].get(), action2_ptr);
action_processor_.StartProcessing();
EXPECT_EQ(action0_ptr, action_processor_.current_action());
EXPECT_TRUE(action_processor_.IsRunning());
action0_ptr->CompleteAction();
EXPECT_EQ(action1_ptr, action_processor_.current_action());
EXPECT_TRUE(action_processor_.IsRunning());
action1_ptr->CompleteAction();
EXPECT_EQ(action2_ptr, action_processor_.current_action());
EXPECT_TRUE(action_processor_.actions_.empty());
EXPECT_TRUE(action_processor_.IsRunning());
action2_ptr->CompleteAction();
EXPECT_EQ(nullptr, action_processor_.current_action());
EXPECT_TRUE(action_processor_.actions_.empty());
EXPECT_FALSE(action_processor_.IsRunning());
}
TEST_F(ActionProcessorTest, DefaultDelegateTest) {
// Just make sure it doesn't crash.
action_processor_.EnqueueAction(std::move(action_));
action_processor_.StartProcessing();
action_ptr_->CompleteAction();
action_.reset(new ActionProcessorTestAction());
action_processor_.EnqueueAction(std::move(action_));
action_processor_.StartProcessing();
action_processor_.StopProcessing();
}
// This test suspends and resume the action processor while running one action.
TEST_F(ActionProcessorTest, SuspendResumeTest) {
action_processor_.EnqueueAction(std::move(mock_action_));
testing::InSequence s;
EXPECT_CALL(*mock_action_ptr_, PerformAction());
action_processor_.StartProcessing();
EXPECT_CALL(*mock_action_ptr_, SuspendAction());
action_processor_.SuspendProcessing();
// Suspending the processor twice should not suspend the action twice.
action_processor_.SuspendProcessing();
// IsRunning should return whether there's is an action doing some work, even
// if it is suspended.
EXPECT_TRUE(action_processor_.IsRunning());
EXPECT_EQ(mock_action_ptr_, action_processor_.current_action());
EXPECT_CALL(*mock_action_ptr_, ResumeAction());
action_processor_.ResumeProcessing();
// Calling ResumeProcessing twice should not affect the action_.
action_processor_.ResumeProcessing();
action_processor_.ActionComplete(mock_action_ptr_, ErrorCode::kSuccess);
}
// This test suspends an action that presumably doesn't support suspend/resume
// and it finished before being resumed.
TEST_F(ActionProcessorTest, ActionCompletedWhileSuspendedTest) {
action_processor_.EnqueueAction(std::move(mock_action_));
testing::InSequence s;
EXPECT_CALL(*mock_action_ptr_, PerformAction());
action_processor_.StartProcessing();
EXPECT_CALL(*mock_action_ptr_, SuspendAction());
action_processor_.SuspendProcessing();
// Simulate the action completion while suspended. No other call to
// |mock_action_| is expected at this point.
action_processor_.ActionComplete(mock_action_ptr_, ErrorCode::kSuccess);
// The processing should not be done since the ActionProcessor is suspended
// and the processing is considered to be still running until resumed.
EXPECT_FALSE(delegate_.processing_done_called_);
EXPECT_TRUE(action_processor_.IsRunning());
action_processor_.ResumeProcessing();
EXPECT_TRUE(delegate_.processing_done_called_);
EXPECT_FALSE(delegate_.processing_stopped_called_);
}
TEST_F(ActionProcessorTest, StoppedWhileSuspendedTest) {
action_processor_.EnqueueAction(std::move(mock_action_));
testing::InSequence s;
EXPECT_CALL(*mock_action_ptr_, PerformAction());
action_processor_.StartProcessing();
EXPECT_CALL(*mock_action_ptr_, SuspendAction());
action_processor_.SuspendProcessing();
EXPECT_CALL(*mock_action_ptr_, TerminateProcessing());
action_processor_.StopProcessing();
// Stopping the processing should abort the current execution no matter what.
EXPECT_TRUE(delegate_.processing_stopped_called_);
EXPECT_FALSE(delegate_.processing_done_called_);
EXPECT_FALSE(delegate_.action_completed_called_);
EXPECT_FALSE(action_processor_.IsRunning());
EXPECT_EQ(nullptr, action_processor_.current_action());
}
} // namespace chromeos_update_engine