Introduce ContextObserver

third_party/WebKit/Source/core/dom/ContextLifecycleObserver.h

 /*
  * Copyright (C) 2008 Apple Inc. All Rights Reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
@@ skipping 17 matching lines @@
 #define ContextLifecycleObserver_h
 
 #include "core/CoreExport.h"
 #include "core/dom/ExecutionContext.h"
 #include "platform/LifecycleObserver.h"
 
 namespace blink {
 
 class LocalFrame;
 
+// ContextClient and ContextLifecycleObserver are helpers to associate a
+// class with an ExecutionContext. ContextLifecycleObserver provides an
+// additional contextDestroyed() hook to execute cleanup code when a
+// context is destroyed. Prefer the simpler ContextClient when possible.
+//
+// getExecutionContext() returns null after the observing context is detached.
+// frame() returns null after the observing context is detached or if the
+// context doesn't have a frame (i.e., if the context is not a Document).
+
+class CORE_EXPORT ContextClient : public GarbageCollectedMixin {
+ public:
+  ExecutionContext* getExecutionContext() const;
+  LocalFrame* frame() const;
+
+  DECLARE_VIRTUAL_TRACE();
+
+ protected:
+  explicit ContextClient(ExecutionContext* executionContext)
+      : m_executionContext(executionContext) {}
+  explicit ContextClient(LocalFrame*);
+
+ private:
+  WeakMember<ExecutionContext> m_executionContext;
+};
+
 class CORE_EXPORT ContextLifecycleObserver
     : public LifecycleObserver<ExecutionContext, ContextLifecycleObserver> {
  public:
-  // Returns null after the observing context is detached.
   ExecutionContext* getExecutionContext() const { return lifecycleContext(); }
-
-  // Returns null after the observing context is detached or if the context
-  // doesn't have a frame (i.e., if the context is not a Document).
   LocalFrame* frame() const;
 
   enum Type {
     GenericType,
     SuspendableObjectType,
   };
 
   Type observerType() const { return m_observerType; }
 
  protected:
   explicit ContextLifecycleObserver(ExecutionContext* executionContext,
                                     Type type = GenericType)
       : LifecycleObserver(executionContext), m_observerType(type) {}
 
  private:
   Type m_observerType;
 };
 
 }  // namespace blink
 
 #endif  // ContextLifecycleObserver_h