Framelet Prototype 2016

components/guest_view/renderer/guest_view_request.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef COMPONENTS_GUEST_VIEW_RENDERER_GUEST_VIEW_REQUEST_H_
 #define COMPONENTS_GUEST_VIEW_RENDERER_GUEST_VIEW_REQUEST_H_
 
 #include "base/macros.h"
 #include "ipc/ipc_message.h"
 #include "v8/include/v8.h"
 
 namespace guest_view {
 
 class GuestViewContainer;
 
 // A GuestViewRequest is the base class for an asynchronous operation performed
-// on a GuestView or GuestViewContainer from JavaScript. This operation may be
-// queued until the container is ready to be operated upon (it has geometry).
+// on a GuestView or GuestViewContainer. This operation may be queued until the
+// container is ready to be operated upon (it has geometry).
 // A GuestViewRequest may or may not have a callback back into JavaScript.
 // Typically, performing a request involves sending an IPC to the browser
 // process in PerformRequest. Handling a response involves receiving a related
 // IPC from the browser process in HandleResponse.
 class GuestViewRequest {
  public:
-  GuestViewRequest(GuestViewContainer* container,
-                   v8::Local<v8::Function> callback,
-                   v8::Isolate* isolate);
+  GuestViewRequest(GuestViewContainer* container);
   virtual ~GuestViewRequest();
 
   // Performs the associated request.
   virtual void PerformRequest() = 0;
 
   // Called by GuestViewContainer when the browser process has responded to the
   // request initiated by PerformRequest.
   virtual void HandleResponse(const IPC::Message& message) = 0;
 
-  // Called to call the callback associated with this request if one is
-  // available.
-  // Note: the callback may be called even if a response has not been heard from
-  // the browser process if the GuestViewContainer is being torn down.
+  // Called during tear down to perform the default response action.
+  virtual void HandleDefaultResponse() = 0;
+
+  GuestViewContainer* container() const { return container_; }
+
+ private:
+  GuestViewContainer* const container_;
+
+  DISALLOW_COPY_AND_ASSIGN(GuestViewRequest);
+};
+
+// A GuestViewJavaScriptRequest is an asynchronous GuestView operation initiated
+// from JavaScript
+class GuestViewJavaScriptRequest : public GuestViewRequest {
+ public:
+  GuestViewJavaScriptRequest(GuestViewContainer* container,
+                             v8::Local<v8::Function> callback,
+                             v8::Isolate* isolate);
+  ~GuestViewJavaScriptRequest() override;
+
   void ExecuteCallbackIfAvailable(int argc,
                                   scoped_ptr<v8::Local<v8::Value>[]> argv);
 
-  GuestViewContainer* container() const { return container_; }
+  // GuestViewRequest implementation:
+  void HandleDefaultResponse() override;
 
   v8::Isolate* isolate() const { return isolate_; }
 
  private:
-  GuestViewContainer* const container_;
   v8::Global<v8::Function> callback_;
   v8::Isolate* const isolate_;
-
-  DISALLOW_COPY_AND_ASSIGN(GuestViewRequest);
 };
 
 // This class represents an AttachGuest request from Javascript. It includes
 // the input parameters and the callback function. The Attach operation may
 // not execute immediately, if the container is not ready or if there are
 // other GuestViewRequests in flight.
-class GuestViewAttachRequest : public GuestViewRequest {
+class GuestViewAttachRequest : public GuestViewJavaScriptRequest {
   public:
   GuestViewAttachRequest(GuestViewContainer* container,
                          int guest_instance_id,
                          scoped_ptr<base::DictionaryValue> params,
                          v8::Local<v8::Function> callback,
                          v8::Isolate* isolate);
   ~GuestViewAttachRequest() override;
 
   void PerformRequest() override;
   void HandleResponse(const IPC::Message& message) override;
 
  private:
   const int guest_instance_id_;
   scoped_ptr<base::DictionaryValue> params_;
 
   DISALLOW_COPY_AND_ASSIGN(GuestViewAttachRequest);
 };
 
 // This class represents a DetachGuest request from Javascript. The Detach
 // operation may not execute immediately, if the container is not ready or if
 // there are other GuestViewRequests in flight.
-class GuestViewDetachRequest : public GuestViewRequest {
+class GuestViewDetachRequest : public GuestViewJavaScriptRequest {
  public:
   GuestViewDetachRequest(GuestViewContainer* container,
                          v8::Local<v8::Function> callback,
                          v8::Isolate* isolate);
   ~GuestViewDetachRequest() override;
 
   void PerformRequest() override;
   void HandleResponse(const IPC::Message& message) override;
 
  private:
   DISALLOW_COPY_AND_ASSIGN(GuestViewDetachRequest);
 };
 
 }  // namespace guest_view
 
 #endif  // COMPONENTS_GUEST_VIEW_RENDERER_GUEST_VIEW_CONTAINER_H_