// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "content/public/test/download_test_observer.h"
#include <vector>
#include "base/bind.h"
#include "base/logging.h"
#include "base/message_loop/message_loop.h"
#include "base/stl_util.h"
#include "base/threading/sequenced_worker_pool.h"
#include "content/public/browser/browser_thread.h"
#include "content/public/browser/download_url_parameters.h"
#include "content/public/test/test_utils.h"
#include "testing/gtest/include/gtest/gtest.h"
namespace content {
DownloadUpdatedObserver::DownloadUpdatedObserver(
DownloadItem* item, DownloadUpdatedObserver::EventFilter filter)
: item_(item),
filter_(filter),
waiting_(false),
event_seen_(false) {
item->AddObserver(this);
}
DownloadUpdatedObserver::~DownloadUpdatedObserver() {
if (item_)
item_->RemoveObserver(this);
}
bool DownloadUpdatedObserver::WaitForEvent() {
if (item_ && filter_.Run(item_))
event_seen_ = true;
if (event_seen_)
return true;
waiting_ = true;
RunMessageLoop();
waiting_ = false;
return event_seen_;
}
void DownloadUpdatedObserver::OnDownloadUpdated(DownloadItem* item) {
DCHECK_EQ(item_, item);
if (filter_.Run(item_))
event_seen_ = true;
if (waiting_ && event_seen_)
base::MessageLoopForUI::current()->Quit();
}
void DownloadUpdatedObserver::OnDownloadDestroyed(DownloadItem* item) {
DCHECK_EQ(item_, item);
item_->RemoveObserver(this);
item_ = NULL;
if (waiting_)
base::MessageLoopForUI::current()->Quit();
}
DownloadTestObserver::DownloadTestObserver(
DownloadManager* download_manager,
size_t wait_count,
DangerousDownloadAction dangerous_download_action)
: download_manager_(download_manager),
wait_count_(wait_count),
finished_downloads_at_construction_(0),
waiting_(false),
dangerous_download_action_(dangerous_download_action),
weak_factory_(this) {
}
DownloadTestObserver::~DownloadTestObserver() {
for (DownloadSet::iterator it = downloads_observed_.begin();
it != downloads_observed_.end(); ++it)
(*it)->RemoveObserver(this);
if (download_manager_)
download_manager_->RemoveObserver(this);
}
void DownloadTestObserver::Init() {
download_manager_->AddObserver(this);
std::vector<DownloadItem*> downloads;
download_manager_->GetAllDownloads(&downloads);
for (std::vector<DownloadItem*>::iterator it = downloads.begin();
it != downloads.end(); ++it) {
OnDownloadCreated(download_manager_, *it);
}
finished_downloads_at_construction_ = finished_downloads_.size();
states_observed_.clear();
}
void DownloadTestObserver::ManagerGoingDown(DownloadManager* manager) {
CHECK_EQ(manager, download_manager_);
download_manager_ = NULL;
SignalIfFinished();
}
void DownloadTestObserver::WaitForFinished() {
if (!IsFinished()) {
waiting_ = true;
RunMessageLoop();
waiting_ = false;
}
}
bool DownloadTestObserver::IsFinished() const {
return (finished_downloads_.size() - finished_downloads_at_construction_ >=
wait_count_) || (download_manager_ == NULL);
}
void DownloadTestObserver::OnDownloadCreated(
DownloadManager* manager,
DownloadItem* item) {
// NOTE: This method is called both by DownloadManager when a download is
// created as well as in DownloadTestObserver::Init() for downloads that
// existed before |this| was created.
OnDownloadUpdated(item);
DownloadSet::const_iterator finished_it(finished_downloads_.find(item));
// If it isn't finished, start observing it.
if (finished_it == finished_downloads_.end()) {
item->AddObserver(this);
downloads_observed_.insert(item);
}
}
void DownloadTestObserver::OnDownloadDestroyed(DownloadItem* download) {
// Stop observing. Do not do anything with it, as it is about to be gone.
DownloadSet::iterator it = downloads_observed_.find(download);
ASSERT_TRUE(it != downloads_observed_.end());
downloads_observed_.erase(it);
download->RemoveObserver(this);
}
void DownloadTestObserver::OnDownloadUpdated(DownloadItem* download) {
// Real UI code gets the user's response after returning from the observer.
if (download->IsDangerous() &&
!ContainsKey(dangerous_downloads_seen_, download->GetId())) {
dangerous_downloads_seen_.insert(download->GetId());
// Calling ValidateDangerousDownload() at this point will
// cause the download to be completed twice. Do what the real UI
// code does: make the call as a delayed task.
switch (dangerous_download_action_) {
case ON_DANGEROUS_DOWNLOAD_ACCEPT:
// Fake user click on "Accept". Delay the actual click, as the
// real UI would.
BrowserThread::PostTask(
BrowserThread::UI, FROM_HERE,
base::Bind(&DownloadTestObserver::AcceptDangerousDownload,
weak_factory_.GetWeakPtr(),
download->GetId()));
break;
case ON_DANGEROUS_DOWNLOAD_DENY:
// Fake a user click on "Deny". Delay the actual click, as the
// real UI would.
BrowserThread::PostTask(
BrowserThread::UI, FROM_HERE,
base::Bind(&DownloadTestObserver::DenyDangerousDownload,
weak_factory_.GetWeakPtr(),
download->GetId()));
break;
case ON_DANGEROUS_DOWNLOAD_FAIL:
ADD_FAILURE() << "Unexpected dangerous download item.";
break;
case ON_DANGEROUS_DOWNLOAD_IGNORE:
break;
case ON_DANGEROUS_DOWNLOAD_QUIT:
DownloadInFinalState(download);
break;
default:
NOTREACHED();
}
}
if (IsDownloadInFinalState(download))
DownloadInFinalState(download);
}
size_t DownloadTestObserver::NumDangerousDownloadsSeen() const {
return dangerous_downloads_seen_.size();
}
size_t DownloadTestObserver::NumDownloadsSeenInState(
DownloadItem::DownloadState state) const {
StateMap::const_iterator it = states_observed_.find(state);
if (it == states_observed_.end())
return 0;
return it->second;
}
void DownloadTestObserver::DownloadInFinalState(DownloadItem* download) {
if (finished_downloads_.find(download) != finished_downloads_.end()) {
// We've already seen the final state on this download.
return;
}
// Record the transition.
finished_downloads_.insert(download);
// Record the state.
states_observed_[download->GetState()]++; // Initializes to 0 the first time.
SignalIfFinished();
}
void DownloadTestObserver::SignalIfFinished() {
if (waiting_ && IsFinished())
base::MessageLoopForUI::current()->Quit();
}
void DownloadTestObserver::AcceptDangerousDownload(uint32 download_id) {
// Download manager was shutdown before the UI thread could accept the
// download.
if (!download_manager_)
return;
DownloadItem* download = download_manager_->GetDownload(download_id);
if (download && !download->IsDone())
download->ValidateDangerousDownload();
}
void DownloadTestObserver::DenyDangerousDownload(uint32 download_id) {
// Download manager was shutdown before the UI thread could deny the
// download.
if (!download_manager_)
return;
DownloadItem* download = download_manager_->GetDownload(download_id);
if (download && !download->IsDone())
download->Remove();
}
DownloadTestObserverTerminal::DownloadTestObserverTerminal(
DownloadManager* download_manager,
size_t wait_count,
DangerousDownloadAction dangerous_download_action)
: DownloadTestObserver(download_manager,
wait_count,
dangerous_download_action) {
// You can't rely on overriden virtual functions in a base class constructor;
// the virtual function table hasn't been set up yet. So, we have to do any
// work that depends on those functions in the derived class constructor
// instead. In this case, it's because of |IsDownloadInFinalState()|.
Init();
}
DownloadTestObserverTerminal::~DownloadTestObserverTerminal() {
}
bool DownloadTestObserverTerminal::IsDownloadInFinalState(
DownloadItem* download) {
return download->IsDone();
}
DownloadTestObserverInProgress::DownloadTestObserverInProgress(
DownloadManager* download_manager,
size_t wait_count)
: DownloadTestObserver(download_manager,
wait_count,
ON_DANGEROUS_DOWNLOAD_ACCEPT) {
// You can't override virtual functions in a base class constructor; the
// virtual function table hasn't been set up yet. So, we have to do any
// work that depends on those functions in the derived class constructor
// instead. In this case, it's because of |IsDownloadInFinalState()|.
Init();
}
DownloadTestObserverInProgress::~DownloadTestObserverInProgress() {
}
bool DownloadTestObserverInProgress::IsDownloadInFinalState(
DownloadItem* download) {
return (download->GetState() == DownloadItem::IN_PROGRESS) &&
!download->GetTargetFilePath().empty();
}
DownloadTestObserverInterrupted::DownloadTestObserverInterrupted(
DownloadManager* download_manager,
size_t wait_count,
DangerousDownloadAction dangerous_download_action)
: DownloadTestObserver(download_manager,
wait_count,
dangerous_download_action) {
// You can't rely on overriden virtual functions in a base class constructor;
// the virtual function table hasn't been set up yet. So, we have to do any
// work that depends on those functions in the derived class constructor
// instead. In this case, it's because of |IsDownloadInFinalState()|.
Init();
}
DownloadTestObserverInterrupted::~DownloadTestObserverInterrupted() {
}
bool DownloadTestObserverInterrupted::IsDownloadInFinalState(
DownloadItem* download) {
return download->GetState() == DownloadItem::INTERRUPTED;
}
DownloadTestFlushObserver::DownloadTestFlushObserver(
DownloadManager* download_manager)
: download_manager_(download_manager),
waiting_for_zero_inprogress_(true) {}
void DownloadTestFlushObserver::WaitForFlush() {
DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
download_manager_->AddObserver(this);
// The wait condition may have been met before WaitForFlush() was called.
CheckDownloadsInProgress(true);
BrowserThread::GetBlockingPool()->FlushForTesting();
RunMessageLoop();
}
void DownloadTestFlushObserver::OnDownloadCreated(
DownloadManager* manager,
DownloadItem* item) {
CheckDownloadsInProgress(true);
}
void DownloadTestFlushObserver::OnDownloadDestroyed(DownloadItem* download) {
// Stop observing. Do not do anything with it, as it is about to be gone.
DownloadSet::iterator it = downloads_observed_.find(download);
ASSERT_TRUE(it != downloads_observed_.end());
downloads_observed_.erase(it);
download->RemoveObserver(this);
}
void DownloadTestFlushObserver::OnDownloadUpdated(DownloadItem* download) {
// No change in DownloadItem set on manager.
CheckDownloadsInProgress(false);
}
DownloadTestFlushObserver::~DownloadTestFlushObserver() {
download_manager_->RemoveObserver(this);
for (DownloadSet::iterator it = downloads_observed_.begin();
it != downloads_observed_.end(); ++it) {
(*it)->RemoveObserver(this);
}
}
// If we're waiting for that flush point, check the number
// of downloads in the IN_PROGRESS state and take appropriate
// action. If requested, also observes all downloads while iterating.
void DownloadTestFlushObserver::CheckDownloadsInProgress(
bool observe_downloads) {
if (waiting_for_zero_inprogress_) {
int count = 0;
std::vector<DownloadItem*> downloads;
download_manager_->GetAllDownloads(&downloads);
for (std::vector<DownloadItem*>::iterator it = downloads.begin();
it != downloads.end(); ++it) {
if ((*it)->GetState() == DownloadItem::IN_PROGRESS)
count++;
if (observe_downloads) {
if (downloads_observed_.find(*it) == downloads_observed_.end()) {
(*it)->AddObserver(this);
downloads_observed_.insert(*it);
}
// Download items are forever, and we don't want to make
// assumptions about future state transitions, so once we
// start observing them, we don't stop until destruction.
}
}
if (count == 0) {
waiting_for_zero_inprogress_ = false;
// Stop observing DownloadItems. We maintain the observation
// of DownloadManager so that we don't have to independently track
// whether we are observing it for conditional destruction.
for (DownloadSet::iterator it = downloads_observed_.begin();
it != downloads_observed_.end(); ++it) {
(*it)->RemoveObserver(this);
}
downloads_observed_.clear();
// Trigger next step. We need to go past the IO thread twice, as
// there's a self-task posting in the IO thread cancel path.
BrowserThread::PostTask(
BrowserThread::FILE, FROM_HERE,
base::Bind(&DownloadTestFlushObserver::PingFileThread, this, 2));
}
}
}
void DownloadTestFlushObserver::PingFileThread(int cycle) {
BrowserThread::PostTask(
BrowserThread::IO, FROM_HERE,
base::Bind(&DownloadTestFlushObserver::PingIOThread, this, cycle));
}
void DownloadTestFlushObserver::PingIOThread(int cycle) {
if (--cycle) {
BrowserThread::PostTask(
BrowserThread::UI, FROM_HERE,
base::Bind(&DownloadTestFlushObserver::PingFileThread, this, cycle));
} else {
BrowserThread::PostTask(
BrowserThread::UI, FROM_HERE, base::MessageLoop::QuitClosure());
}
}
DownloadTestItemCreationObserver::DownloadTestItemCreationObserver()
: download_id_(DownloadItem::kInvalidId),
interrupt_reason_(DOWNLOAD_INTERRUPT_REASON_NONE),
called_back_count_(0),
waiting_(false) {
}
DownloadTestItemCreationObserver::~DownloadTestItemCreationObserver() {
}
void DownloadTestItemCreationObserver::WaitForDownloadItemCreation() {
DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
if (called_back_count_ == 0) {
waiting_ = true;
RunMessageLoop();
waiting_ = false;
}
}
void DownloadTestItemCreationObserver::DownloadItemCreationCallback(
DownloadItem* item,
DownloadInterruptReason interrupt_reason) {
DCHECK(BrowserThread::CurrentlyOn(BrowserThread::UI));
if (item)
download_id_ = item->GetId();
interrupt_reason_ = interrupt_reason;
++called_back_count_;
DCHECK_EQ(1u, called_back_count_);
if (waiting_)
base::MessageLoopForUI::current()->Quit();
}
const DownloadUrlParameters::OnStartedCallback
DownloadTestItemCreationObserver::callback() {
return base::Bind(
&DownloadTestItemCreationObserver::DownloadItemCreationCallback, this);
}
} // namespace content