1// Copyright (c) 2013 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef CONTENT_BROWSER_APPCACHE_APPCACHE_EXECUTABLE_HANDLER_H_
6#define CONTENT_BROWSER_APPCACHE_APPCACHE_EXECUTABLE_HANDLER_H_
7
8#include "base/callback.h"
9#include "base/memory/scoped_ptr.h"
10#include "content/common/content_export.h"
11#include "url/gurl.h"
12
13namespace net {
14class IOBuffer;
15class URLRequest;
16}
17
18namespace content {
19
20// An interface that must be provided by the embedder to support this feature.
21class CONTENT_EXPORT AppCacheExecutableHandler {
22 public:
23  // A handler can respond in one of 4 ways, if each of the GURL fields
24  // in 'Response' are empty and use_network is false, an error response is
25  // synthesized.
26  struct Response {
27    GURL cached_resource_url;
28    GURL redirect_url;
29    bool use_network;
30    // TODO: blob + headers would be a good one to provide as well, as it would
31    // make templating possible.
32  };
33  typedef base::Callback<void(const Response&)> ResponseCallback;
34
35  // Deletion of the handler cancels all pending callbacks.
36  virtual ~AppCacheExecutableHandler() {}
37
38  virtual void HandleRequest(net::URLRequest* req,
39                             ResponseCallback callback) = 0;
40};
41
42// A factory to produce instances.
43class CONTENT_EXPORT AppCacheExecutableHandlerFactory {
44 public:
45  virtual scoped_ptr<AppCacheExecutableHandler> CreateHandler(
46      const GURL& handler_url, net::IOBuffer* handler_source) = 0;
47
48 protected:
49  virtual ~AppCacheExecutableHandlerFactory() {}
50};
51
52}  // namespace content
53
54#endif  // CONTENT_BROWSER_APPCACHE_APPCACHE_EXECUTABLE_HANDLER_H_
55