gecko-dev/dom/quota/Client.h

113 lines
2.4 KiB
C++

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_dom_quota_client_h__
#define mozilla_dom_quota_client_h__
#include "mozilla/dom/quota/QuotaCommon.h"
class nsIOfflineStorage;
class nsIRunnable;
BEGIN_QUOTA_NAMESPACE
class UsageRunnable;
// An abstract interface for quota manager clients.
// Each storage API must provide an implementation of this interface in order
// to participate in centralized quota and storage handling.
class Client
{
public:
NS_IMETHOD_(nsrefcnt)
AddRef() = 0;
NS_IMETHOD_(nsrefcnt)
Release() = 0;
enum Type {
IDB = 0,
//LS,
//APPCACHE,
TYPE_MAX
};
virtual Type
GetType() = 0;
static nsresult
TypeToText(Type aType, nsAString& aText)
{
switch (aType) {
case IDB:
aText.AssignLiteral("idb");
break;
case TYPE_MAX:
default:
NS_NOTREACHED("Bad id value!");
return NS_ERROR_UNEXPECTED;
}
return NS_OK;
}
static nsresult
TypeFromText(const nsAString& aText, Type& aType)
{
if (aText.EqualsLiteral("idb")) {
aType = IDB;
}
else {
return NS_ERROR_FAILURE;
}
return NS_OK;
}
// Methods which are called on the IO thred.
virtual nsresult
InitOrigin(const nsACString& aOrigin, UsageRunnable* aUsageRunnable) = 0;
virtual nsresult
GetUsageForOrigin(const nsACString& aOrigin,
UsageRunnable* aUsageRunnable) = 0;
virtual void
OnOriginClearCompleted(const nsACString& aPattern) = 0;
virtual void
ReleaseIOThreadObjects() = 0;
// Methods which are called on the main thred.
virtual bool
IsFileServiceUtilized() = 0;
virtual bool
IsTransactionServiceActivated() = 0;
virtual void
WaitForStoragesToComplete(nsTArray<nsIOfflineStorage*>& aStorages,
nsIRunnable* aCallback) = 0;
virtual void
AbortTransactionsForStorage(nsIOfflineStorage* aStorage) = 0;
virtual bool
HasTransactionsForStorage(nsIOfflineStorage* aStorage) = 0;
virtual void
ShutdownTransactionService() = 0;
protected:
virtual ~Client()
{ }
};
END_QUOTA_NAMESPACE
#endif // mozilla_dom_quota_client_h__