summaryrefslogtreecommitdiffstats
path: root/native_client_sdk/src/examples/geturl/geturl_handler.h
diff options
context:
space:
mode:
Diffstat (limited to 'native_client_sdk/src/examples/geturl/geturl_handler.h')
-rw-r--r--native_client_sdk/src/examples/geturl/geturl_handler.h81
1 files changed, 81 insertions, 0 deletions
diff --git a/native_client_sdk/src/examples/geturl/geturl_handler.h b/native_client_sdk/src/examples/geturl/geturl_handler.h
new file mode 100644
index 0000000..928f22c
--- /dev/null
+++ b/native_client_sdk/src/examples/geturl/geturl_handler.h
@@ -0,0 +1,81 @@
+// Copyright (c) 2011 The Native Client 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 EXAMPLES_GETURL_GETURL_HANDLER_H_
+#define EXAMPLES_GETURL_GETURL_HANDLER_H_
+
+#include <string>
+#include "ppapi/cpp/completion_callback.h"
+#include "ppapi/cpp/url_loader.h"
+#include "ppapi/cpp/url_request_info.h"
+#include "ppapi/cpp/instance.h"
+
+#define READ_BUFFER_SIZE 4096
+
+// GetURLHandler is used to download data from |url|. When download is
+// finished or when an error occurs, it posts a message back to the browser
+// with the results encoded in the message as a string and self-destroys.
+//
+// EXAMPLE USAGE:
+// GetURLHandler* handler* = GetURLHandler::Create(instance,url);
+// handler->Start();
+//
+class GetURLHandler {
+ public:
+ // Creates instance of GetURLHandler on the heap.
+ // GetURLHandler objects shall be created only on the heap (they
+ // self-destroy when all data is in).
+ static GetURLHandler* Create(pp::Instance* instance_,
+ const std::string& url);
+ // Initiates page (URL) download.
+ void Start();
+
+ private:
+ GetURLHandler(pp::Instance* instance_, const std::string& url);
+ ~GetURLHandler();
+
+ // Callback fo the pp::URLLoader::Open().
+ // Called by pp::URLLoader when response headers are received or when an
+ // error occurs (in response to the call of pp::URLLoader::Open()).
+ // Look at <ppapi/c/ppb_url_loader.h> and
+ // <ppapi/cpp/url_loader.h> for more information about pp::URLLoader.
+ void OnOpen(int32_t result);
+
+ // Callback fo the pp::URLLoader::ReadResponseBody().
+ // |result| contains the number of bytes read or an error code.
+ // Appends data from this->buffer_ to this->url_response_body_.
+ void OnRead(int32_t result);
+
+ // Reads the response body (asynchronously) into this->buffer_.
+ // OnRead() will be called when bytes are received or when an error occurs.
+ void ReadBody();
+
+ // Append data bytes read from the URL onto the internal buffer. Does
+ // nothing if |num_bytes| is 0.
+ void AppendDataBytes(const char* buffer, int32_t num_bytes);
+
+ // Post a message back to the browser with the download results.
+ void ReportResult(const std::string& fname,
+ const std::string& text,
+ bool success);
+ // Post a message back to the browser with the download results and
+ // self-destroy. |this| is no longer valid when this method returns.
+ void ReportResultAndDie(const std::string& fname,
+ const std::string& text,
+ bool success);
+
+ pp::Instance* instance_; // Weak pointer.
+ std::string url_; // URL to be downloaded.
+ pp::URLRequestInfo url_request_;
+ pp::URLLoader url_loader_; // URLLoader provides an API to download URLs.
+ char buffer_[READ_BUFFER_SIZE]; // Temporary buffer for reads.
+ std::string url_response_body_; // Contains accumulated downloaded data.
+ pp::CompletionCallbackFactory<GetURLHandler> cc_factory_;
+
+ GetURLHandler(const GetURLHandler&);
+ void operator=(const GetURLHandler&);
+};
+
+#endif // EXAMPLES_GETURL_GETURL_HANDLER_H_
+