Redesign: Remove TsfEventRouter interface.

ui/base/ime/win/tsf_event_router.h

 // Copyright (c) 2012 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 UI_BASE_IME_WIN_TSF_EVENT_ROUTER_H_
 #define UI_BASE_IME_WIN_TSF_EVENT_ROUTER_H_
 
+#include <atlbase.h>
+#include <atlcom.h>
 #include <msctf.h>
 
+#include <set>
+
 #include "base/basictypes.h"
 #include "base/callback.h"
 #include "base/compiler_specific.h"
 #include "ui/base/ime/text_input_type.h"
 #include "ui/base/ui_export.h"
 
 struct ITfDocumentMgr;
 
 namespace ui {
 
-// This is an abstract interface that monitors events associated with TSF and
-// forwards them to the observer. In order to manage the life cycle of this
-// object by scoped_refptr and the implementation class of this interface is COM
-// class anyway, this interface is derived from IUnknown.
-class TsfEventRouter : public IUnknown {
+class TsfEventRouterObserver {
  public:
-  class Observer {
-   public:
-    virtual ~Observer() {}
+  TsfEventRouterObserver() {}
 
-    // Called when the text contents are updated.
-    virtual void OnTextUpdated() = 0;
+  // Called when the text contents are updated.
+  virtual void OnTextUpdated() = 0;
 
-    // Called when the number of currently opened candidate windows changes.
-    virtual void OnCandidateWindowCountChanged(size_t window_count) = 0;
-  };
+  // Called when the number of currently opened candidate windows changes.
+  virtual void OnCandidateWindowCountChanged(size_t window_count) = 0;
 
+ protected:
+  virtual ~TsfEventRouterObserver() {}
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(TsfEventRouterObserver);
+};
+
+// This class monitores TSF related events and forwards them to given
+// |observer|.
+class UI_EXPORT TsfEventRouter {
+ public:
+

[Peter Kasting, 2012/10/26 02:31:57]

Nit: Remove this blank line

[Seigo Nonaka, 2012/10/26 02:40:27]

Done.

+  // |observer| can be NULL.

[Peter Kasting, 2012/10/26 02:31:57]

Nit: Say why this is important, e.g. does test code need to pass NULL here?  If
it's never used, then ban passing NULL.

[Seigo Nonaka, 2012/10/26 02:40:27]

Done.

+  explicit TsfEventRouter(TsfEventRouterObserver* observer);
   virtual ~TsfEventRouter();
 
-  // Sets |manager| to be monitored and |observer| to be notified. |manager| and
-  // |observer| can be NULL.
-  virtual void SetManager(ITfThreadMgr* manager,
-                          Observer* observer) = 0;
+  // Sets |manager| to be monitored. |manager| can be NULL.
+  void SetManager(ITfThreadMgr* manager);
 
-  // Returns true if the IME is composing texts.
-  virtual bool IsImeComposing() = 0;
+  // Returns true if the IME is composing text.
+  bool IsImeComposing();
 
-  // Factory function, creates a new instance which the caller owns.
-  static UI_EXPORT TsfEventRouter* Create();
+  // Called when the text contents are updated, this function is called by
+  // |delegate_|.

[Peter Kasting, 2012/10/26 02:31:57]

Nit: Slightly less awkward:

  // Called by the TsfEventRouterDelegate when the text contents are updated.

Or, do this:

  // Callbacks from the TSfEventRouterDelegate:
  void OnTextUpdated();
  void OnCandidateWindowCountChanged();

This might be even better as the function names are already pretty clear as to
when they're reached.

[Seigo Nonaka, 2012/10/26 02:40:27]

Changed to the latter, thanks.

On 2012/10/26 02:31:57, Peter Kasting wrote:

+  void OnTextUpdated();
 
- protected:
-  // Create should be used instead.
-  TsfEventRouter();
+  // Called when the number of currently opened candidate window changes, this
+  // function is called by |delegate_|.
+  void OnCandidateWindowCountChanged(size_t window_count);
+
+ private:
+  class TsfEventRouterDelegate;
+
+  CComPtr<TsfEventRouterDelegate> delegate_;
+
+  TsfEventRouterObserver* observer_;
 
   DISALLOW_COPY_AND_ASSIGN(TsfEventRouter);
 };
 
 }  // namespace ui
 
 #endif  // UI_BASE_IME_WIN_TSF_EVENT_ROUTER_H_