src/content/renderer/media/android/media_info_loader.h

   1 // Copyright 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_RENDERER_MEDIA_ANDROID_MEDIA_INFO_LOADER_H_
   6 #define CONTENT_RENDERER_MEDIA_ANDROID_MEDIA_INFO_LOADER_H_
   7
   8 #include <string>
   9
  10 #include "base/callback.h"
  11 #include "base/memory/scoped_ptr.h"
  12 #include "base/time/time.h"
  13 #include "content/common/content_export.h"
  14 #include "content/renderer/media/active_loader.h"
  15 #include "third_party/WebKit/public/platform/WebMediaPlayer.h"
  16 #include "third_party/WebKit/public/platform/WebURLLoaderClient.h"
  17 #include "url/gurl.h"
  18
  19 namespace blink {
  20 class WebFrame;
  21 class WebURLLoader;
  22 class WebURLRequest;
  23 }
  24
  25 namespace content {
  26
  27 // This class provides additional information about a media URL. Currently it
  28 // can be used to determine if a media URL has a single security origin and
  29 // whether the URL passes a CORS access check.
  30 class CONTENT_EXPORT MediaInfoLoader : private blink::WebURLLoaderClient {
  31  public:
  32   // Status codes for start operations on MediaInfoLoader.
  33   enum Status {
  34     // The operation failed, which may have been due to:
  35     //   - Page navigation
  36     //   - Server replied 4xx/5xx
  37     //   - The response was invalid
  38     //   - Connection was terminated
  39     //
  40     // At this point you should delete the loader.
  41     kFailed,
  42
  43     // Everything went as planned.
  44     kOk,
  45   };
  46
  47   // Start loading information about the given media URL.
  48   // |url| - URL for the media resource to be loaded.
  49   // |cors_mode| - HTML media element's crossorigin attribute.
  50   // |ready_cb| - Called when media info has finished or failed loading.
  51   typedef base::Callback<void(Status)> ReadyCB;
  52   MediaInfoLoader(
  53       const GURL& url,
  54       blink::WebMediaPlayer::CORSMode cors_mode,
  55       const ReadyCB& ready_cb);
  56   virtual ~MediaInfoLoader();
  57
  58   // Start loading media info.
  59   void Start(blink::WebFrame* frame);
  60
  61   // Returns true if the media resource has a single origin, false otherwise.
  62   // Only valid to call after the loader becomes ready.
  63   bool HasSingleOrigin() const;
  64
  65   // Returns true if the media resource passed a CORS access control check.
  66   // Only valid to call after the loader becomes ready.
  67   bool DidPassCORSAccessCheck() const;
  68
  69  private:
  70   friend class MediaInfoLoaderTest;
  71
  72   // blink::WebURLLoaderClient implementation.
  73   virtual void willSendRequest(
  74       blink::WebURLLoader* loader,
  75       blink::WebURLRequest& newRequest,
  76       const blink::WebURLResponse& redirectResponse);
  77   virtual void didSendData(
  78       blink::WebURLLoader* loader,
  79       unsigned long long bytesSent,
  80       unsigned long long totalBytesToBeSent);
  81   virtual void didReceiveResponse(
  82       blink::WebURLLoader* loader,
  83       const blink::WebURLResponse& response);
  84   virtual void didDownloadData(
  85       blink::WebURLLoader* loader,
  86       int data_length,
  87       int encodedDataLength);
  88   virtual void didReceiveData(
  89       blink::WebURLLoader* loader,
  90       const char* data,
  91       int data_length,
  92       int encoded_data_length);
  93   virtual void didReceiveCachedMetadata(
  94       blink::WebURLLoader* loader,
  95       const char* data, int dataLength);
  96   virtual void didFinishLoading(
  97       blink::WebURLLoader* loader,
  98       double finishTime,
  99       int64_t total_encoded_data_length);
 100   virtual void didFail(
 101       blink::WebURLLoader* loader,
 102       const blink::WebURLError&);
 103
 104   void DidBecomeReady(Status status);
 105
 106   // Injected WebURLLoader instance for testing purposes.
 107   scoped_ptr<blink::WebURLLoader> test_loader_;
 108
 109   // Keeps track of an active WebURLLoader and associated state.
 110   scoped_ptr<ActiveLoader> active_loader_;
 111
 112   bool loader_failed_;
 113   GURL url_;
 114   blink::WebMediaPlayer::CORSMode cors_mode_;
 115   bool single_origin_;
 116
 117   ReadyCB ready_cb_;
 118   base::TimeTicks start_time_;
 119
 120   DISALLOW_COPY_AND_ASSIGN(MediaInfoLoader);
 121 };
 122
 123 }  // namespace content
 124
 125 #endif  // CONTENT_RENDERER_MEDIA_ANDROID_MEDIA_INFO_LOADER_H_