Index: ppapi/cpp/url_loader.h |
=================================================================== |
--- ppapi/cpp/url_loader.h (revision 98665) |
+++ ppapi/cpp/url_loader.h (working copy) |
@@ -18,67 +18,8 @@ |
class URLResponseInfo; |
/// URLLoader provides an API for loading URLs. |
-/// |
-/// <strong>Example:</strong> |
-/// |
-/// @code |
-/// |
-/// class MyHandler { |
-/// public: |
-/// MyHandler(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_.NewOptionalCallback(&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_; |
-/// }; |
-/// @endcode |
+/// Refer to <code>ppapi/examples/url_loader/streaming.cc</code> |
+/// for an example of how to use this class. |
class URLLoader : public Resource { |
public: |
/// Default constructor for creating an is_null() |
@@ -92,7 +33,8 @@ |
/// A constructor used when a <code>PP_Resource</code> is provided as a |
/// return value whose reference count we need to increment. |
/// |
- /// @param[in] resource A <code>PP_Resource</code>. |
+ /// @param[in] resource A <code>PP_Resource</code> corresponding to a |
+ /// <code>URLLoader</code> resource. |
explicit URLLoader(PP_Resource resource); |
/// A constructor used to allocate a new URLLoader in the browser. The |