author Cosmin Sabou <>
Fri, 12 Oct 2018 20:43:40 +0300
changeset 441083 a81783cc2cb164ef91f6d30ab638628ea920d245
parent 408600 6af1f5ac596b4aa0a87f8a8151395c692eb81a58
child 448947 6f3709b3878117466168c40affa7bca0b60cf75b
permissions -rw-r--r--
Backed out changeset 14243af871cc (bug 1475562) for causing build bustages. CLOSED TREE

/* 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 */

#ifndef nsHtml5StreamListener_h
#define nsHtml5StreamListener_h

#include "nsIStreamListener.h"
#include "nsIThreadRetargetableStreamListener.h"
#include "nsHtml5StreamParserPtr.h"
#include "nsHtml5StreamParser.h"

 * The purpose of this class is to reconcile the problem that
 * nsHtml5StreamParser is a cycle collection participant, which means that it
 * can only be refcounted on the main thread, but
 * nsIThreadRetargetableStreamListener can be refcounted from another thread,
 * so nsHtml5StreamParser being an nsIThreadRetargetableStreamListener was
 * a memory corruption problem.
 * mDelegate is an nsHtml5StreamParserPtr, which releases the object that it
 * points to from a runnable on the main thread. DropDelegate() is only called
 * on the main thread. This call will finish before the main-thread derefs the
 * nsHtml5StreamListener itself, so there is no risk of another thread making
 * the refcount of nsHtml5StreamListener go to zero and running the destructor
 * concurrently. Other than that, the thread-safe nsISupports implementation
 * takes care of the destructor not running concurrently from different
 * threads, so there is no need to have a mutex around nsHtml5StreamParserPtr to
 * prevent it from double-releasing nsHtml5StreamParser.
class nsHtml5StreamListener
  : public nsIStreamListener
  , public nsIThreadRetargetableStreamListener
  explicit nsHtml5StreamListener(nsHtml5StreamParser* aDelegate);


  inline nsHtml5StreamParser* GetDelegate() { return mDelegate; }

  void DropDelegate();

  virtual ~nsHtml5StreamListener();

  nsHtml5StreamParserPtr mDelegate;

#endif // nsHtml5StreamListener_h