diff -r 000000000000 -r 6474c204b198 content/media/plugins/MediaResourceServer.h
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/content/media/plugins/MediaResourceServer.h	Wed Dec 31 06:09:35 2014 +0100
@@ -0,0 +1,96 @@
+/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim:set ts=2 sw=2 sts=2 et cindent: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this file,
+ * You can obtain one at http://mozilla.org/MPL/2.0/. */
+#if !defined(MediaResourceServer_h_)
+#define MediaResourceServer_h_
+
+#include <map>
+#include "nsIServerSocket.h"
+#include "MediaResource.h"
+
+namespace mozilla {
+
+class MediaResource;
+
+/*
+  MediaResourceServer instantiates a socket server that understands
+  HTTP requests for MediaResource instances. The server runs on an
+  automatically selected port and MediaResource instances are registered.
+  The registration returns a string URL than can be used to fetch the
+  resource. That URL contains a randomly generated path to make it
+  difficult for other local applications on the device to guess it.
+
+  The HTTP protocol is limited in that it supports only what the
+  Android DataSource implementation uses to fetch media. It
+  understands HTTP GET and byte range requests.
+
+  The intent of this class is to be used in Media backends that
+  have a system component that does its own network requests. These
+  requests are made against this server which then uses standard
+  Gecko network requests and media cache usage.
+
+  The MediaResourceServer can be instantiated on any thread and
+  its methods are threadsafe - they can be called on any thread.
+  The server socket itself is always run on the main thread and
+  this is done by the Start() static method by synchronously
+  dispatching to the main thread.
+*/
+class MediaResourceServer : public nsRunnable
+{
+private:
+  // Mutex protecting private members of MediaResourceServer.
+  // All member variables below this point in the class definition
+  // must acquire the mutex before access.
+  mozilla::Mutex mMutex;
+
+  // Server socket used to listen for incoming connections
+  nsCOMPtr<nsIServerSocket> mSocket;
+
+  // Mapping between MediaResource URL's to the MediaResource
+  // object served at that URL.
+  typedef std::map<nsCString,
+                  nsRefPtr<mozilla::MediaResource> > ResourceMap;
+  ResourceMap mResources;
+
+  // Create a MediaResourceServer that will listen on an automatically
+  // selected port when started. This is private as it should only be
+  // called internally from the public 'Start' method.
+  MediaResourceServer();
+  NS_IMETHOD Run();
+
+  // Append a random URL path to a string. This is used for creating a
+  // unique URl for a resource which helps prevent malicious software
+  // running on the same machine as the server from guessing the URL
+  // and accessing video data.
+  nsresult AppendRandomPath(nsCString& aURL);
+
+public:
+  // Create a MediaResourceServer and start it listening. This call will
+  // perform a synchronous request on the main thread.
+  static already_AddRefed<MediaResourceServer> Start();
+
+  // Stops the server from listening and accepting further connections.
+  void Stop();
+
+  // Add a MediaResource to be served by this server. Stores the
+  // absolute URL that can be used to access the resource in 'aUrl'.
+  nsresult AddResource(mozilla::MediaResource* aResource, nsCString& aUrl);
+
+  // Remove a MediaResource so it is no longer served by this server.
+  // The URL provided must match exactly that provided by a previous
+  // call to "AddResource".
+  void RemoveResource(nsCString const& aUrl);
+
+  // Returns the prefix for HTTP requests to the server. This plus
+  // the result of AddResource results in an Absolute URL.
+  nsCString GetURLPrefix();
+
+  // Returns the resource asociated with a given URL
+  already_AddRefed<mozilla::MediaResource> GetResource(nsCString const& aUrl);
+};
+
+} // namespace mozilla
+
+#endif