// Copyright (c) 2011 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. // Brought to you by number 42. #ifndef NET_BASE_COOKIE_STORE_H_ #define NET_BASE_COOKIE_STORE_H_ #pragma once #include <string> #include <vector> #include "base/basictypes.h" #include "base/memory/ref_counted.h" #include "base/time.h" #include "net/base/cookie_options.h" #include "net/base/net_export.h" class GURL; namespace net { class CookieMonster; // An interface for storing and retrieving cookies. Implementations need to // be thread safe as its methods can be accessed from IO as well as UI threads. class NET_EXPORT CookieStore : public base::RefCountedThreadSafe<CookieStore> { public: // Sets a single cookie. Expects a cookie line, like "a=1; domain=b.com". virtual bool SetCookieWithOptions(const GURL& url, const std::string& cookie_line, const CookieOptions& options) = 0; // TODO what if the total size of all the cookies >4k, can we have a header // that big or do we need multiple Cookie: headers? // Simple interface, gets a cookie string "a=b; c=d" for the given URL. // Use options to access httponly cookies. virtual std::string GetCookiesWithOptions(const GURL& url, const CookieOptions& options) = 0; // Deletes the passed in cookie for the specified URL. virtual void DeleteCookie(const GURL& url, const std::string& cookie_name) = 0; // Returns the underlying CookieMonster. virtual CookieMonster* GetCookieMonster() = 0; // -------------------------------------------------------------------------- // Helpers to make the above interface simpler for some cases. // Sets a cookie for the given URL using default options. bool SetCookie(const GURL& url, const std::string& cookie_line); // Gets cookies for the given URL using default options. std::string GetCookies(const GURL& url); // Sets a vector of response cookie values for the same URL. void SetCookiesWithOptions(const GURL& url, const std::vector<std::string>& cookie_lines, const CookieOptions& options); void SetCookies(const GURL& url, const std::vector<std::string>& cookie_lines); protected: friend class base::RefCountedThreadSafe<CookieStore>; CookieStore(); virtual ~CookieStore(); }; } // namespace net #endif // NET_BASE_COOKIE_STORE_H_