scoped_refptr: support opaque pointed-to classes via extern template

base/memory/ref_counted.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 BASE_MEMORY_REF_COUNTED_H_
 #define BASE_MEMORY_REF_COUNTED_H_
 
 #include <cassert>
 #include <iosfwd>
 
@@ skipping 258 matching lines @@
 template <class T>
 class scoped_refptr {
  public:
   typedef T element_type;
 
   scoped_refptr() : ptr_(NULL) {
   }
 
   scoped_refptr(T* p) : ptr_(p) {
     if (ptr_)
-      ptr_->AddRef();
+      AddRef(ptr_);
   }
 
   scoped_refptr(const scoped_refptr<T>& r) : ptr_(r.ptr_) {
     if (ptr_)
-      ptr_->AddRef();
+      AddRef(ptr_);
   }
 
   template <typename U>
   scoped_refptr(const scoped_refptr<U>& r) : ptr_(r.get()) {
     if (ptr_)
-      ptr_->AddRef();
+      AddRef(ptr_);
   }
 
   ~scoped_refptr() {
     if (ptr_)
-      ptr_->Release();
+      Release(ptr_);
   }
 
   T* get() const { return ptr_; }
 
 #if !defined(DISABLE_SCOPED_REFPTR_CONVERSION_OPERATOR)
   // Allow scoped_refptr<C> to be used in boolean expression
   // and comparison operations.
   operator T*() const { return ptr_; }
 #endif
 
   T& operator*() const {
     assert(ptr_ != NULL);
     return *ptr_;
   }
 
   T* operator->() const {
     assert(ptr_ != NULL);
     return ptr_;
   }
 
   scoped_refptr<T>& operator=(T* p) {
     // AddRef first so that self assignment should work
     if (p)
-      p->AddRef();
+      AddRef(p);
     T* old_ptr = ptr_;
     ptr_ = p;
     if (old_ptr)
-      old_ptr->Release();
+      Release(old_ptr);
     return *this;
   }
 
   scoped_refptr<T>& operator=(const scoped_refptr<T>& r) {
     return *this = r.ptr_;
   }
 
   template <typename U>
   scoped_refptr<T>& operator=(const scoped_refptr<U>& r) {
     return *this = r.get();
@@ skipping 21 matching lines @@
   }
 
   template <typename U>
   bool operator<(const scoped_refptr<U>& rhs) const {
     return ptr_ < rhs.get();
   }
 #endif
 
  protected:
   T* ptr_;
+
+ private:
+  // Non-inline helpers to allow:
+  //     class Opaque;
+  //     extern template class scoped_refptr<Opaque>;
+  // Otherwise the compiler will complain that Opaque is an incomplete type.
+  static void AddRef(T* ptr);
+  static void Release(T* ptr);
 };
 
+template <typename T>
+void scoped_refptr<T>::AddRef(T* ptr) {
+  ptr->AddRef();
+}
+
+template <typename T>
+void scoped_refptr<T>::Release(T* ptr) {
+  ptr->Release();
+}
+
 // Handy utility for creating a scoped_refptr<T> out of a T* explicitly without
 // having to retype all the template arguments
 template <typename T>
 scoped_refptr<T> make_scoped_refptr(T* t) {
   return scoped_refptr<T>(t);
 }
 
 #if defined(DISABLE_SCOPED_REFPTR_CONVERSION_OPERATOR)
 // Temporary operator overloads to facilitate the transition...
 template <typename T, typename U>
@@ skipping 16 matching lines @@
   return !operator==(lhs, rhs);
 }
 
 template <typename T>
 std::ostream& operator<<(std::ostream& out, const scoped_refptr<T>& p) {
   return out << p.get();
 }
 #endif  // defined(DISABLE_SCOPED_REFPTR_CONVERSION_OPERATOR)
 
 #endif  // BASE_MEMORY_REF_COUNTED_H_