summaryrefslogtreecommitdiffstats
path: root/ppapi/cpp/dev/url_loader_dev.h
blob: 4256c3299d0c3a8ce8f9717925daf9724a623057 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
// Copyright (c) 2010 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.

#ifndef PPAPI_CPP_DEV_URL_LOADER_DEV_H_
#define PPAPI_CPP_DEV_URL_LOADER_DEV_H_

#include "ppapi/c/pp_stdint.h"
#include "ppapi/cpp/resource.h"

namespace pp {

class CompletionCallback;
class Instance;
class URLRequestInfo_Dev;
class URLResponseInfo_Dev;

// URLLoader provides an API to download URLs.
//
// EXAMPLE USAGE:
//
//   class MyHandler {
//    public:
//     MyHandler(const Instance& instance)
//         : factory_(this),
//           loader_(instance),
//           did_open_(false) {
//     }
//     void ProcessURL(const char* url) {
//       CompletionCallback* cc = NewCallback();
//       int32_t rv = loader_.Open(MakeRequest(url), cc);
//       if (rv != PP_Error_WouldBlock)
//         cc->Run(rv);
//     }
//    private:
//     CompletionCallback* NewCallback() {
//       return factory_.NewCallback(&MyHandler::DidCompleteIO);
//     }
//     URLRequestInfo MakeRequest(const char* url) {
//       URLRequestInfo request;
//       request.SetURL(url);
//       request.SetMethod("GET");
//       request.SetFollowRedirects(true);
//       return request;
//     }
//     void DidCompleteIO(int32_t result) {
//       if (result > 0) {
//         // buf_ now contains 'result' number of bytes from the URL.
//         ProcessBytes(buf_, result);
//         ReadMore();
//       } else if (result == PP_OK && !did_open_) {
//         // Headers are available, and we can start reading the body.
//         did_open_ = true;
//         ProcessResponseInfo(loader_.GetResponseInfo());
//         ReadMore();
//       } else {
//         // Done reading (possibly with an error given by 'result').
//       }
//     }
//     void ReadMore() {
//       CompletionCallback* cc = NewCallback();
//       int32_t rv = fio_.Read(offset_, buf_, sizeof(buf_), cc);
//       if (rv != PP_Error_WouldBlock)
//         cc->Run(rv);
//     }
//     void ProcessResponseInfo(const URLResponseInfo& response_info) {
//       // Read response headers, etc.
//     }
//     void ProcessBytes(const char* bytes, int32_t length) {
//       // Do work ...
//     }
//     pp::CompletionCallbackFactory<MyHandler> factory_;
//     pp::URLLoader loader_;
//     char buf_[4096];
//     bool did_open_;
//   };
//
class URLLoader_Dev : public Resource {
 public:
  // Creates an is_null() URLLoader object.
  URLLoader_Dev() {}

  explicit URLLoader_Dev(PP_Resource resource);
  explicit URLLoader_Dev(const Instance& instance);
  URLLoader_Dev(const URLLoader_Dev& other);

  URLLoader_Dev& operator=(const URLLoader_Dev& other);
  void swap(URLLoader_Dev& other);

  // PPB_URLLoader methods:
  int32_t Open(const URLRequestInfo_Dev& request_info,
               const CompletionCallback& cc);
  int32_t FollowRedirect(const CompletionCallback& cc);
  bool GetUploadProgress(int64_t* bytes_sent,
                         int64_t* total_bytes_to_be_sent) const;
  bool GetDownloadProgress(int64_t* bytes_received,
                           int64_t* total_bytes_to_be_received) const;
  URLResponseInfo_Dev GetResponseInfo() const;
  int32_t ReadResponseBody(char* buffer,
                           int32_t bytes_to_read,
                           const CompletionCallback& cc);
  int32_t FinishStreamingToFile(const CompletionCallback& cc);
  void Close();
};

}  // namespace pp

#endif  // PPAPI_CPP_DEV_URL_LOADER_DEV_H_