命名空间级访问

Question

我有以下情况：

namespace MyFramework {
  class A {
    void some_function_I_want_B_to_use() {}
  };
  class B {
    B() {
      some_function_I_want_B_to_use() {}
    }
  };
}

我希望 some_function_I_want_B_to_use 在 MyFramework 命名空间之外不可见，但我确实希望它对 MyFramework 内部的任何人可见（或者，仅对 B 类可见也可以）。我有很多这样的方法，是从 MyFramework 的公共 API 中隐藏它们以使 MyFramework 中的所有类成为朋友的唯一方法吗？我也在考虑将所有“低级”类放在 B 中，但我不想走那条路，直到我确定它能够从 B 内部而不是从 B 内部访问所有 A 的方法在 MyFramework 之外。

重申一下，我有一个在一个命名空间中创建的框架，每个类都有对使用该框架的公众有用的方法。但是，每个类也有一些使公共 API 复杂化但框架正常运行所必需的方法。

Answer 1

我希望some_function_I_want_B_to_use 在MyFramework 命名空间之外不可见，但我确实希望它对MyFramework 内部的任何人可见。

总而言之，您需要类似于 Java 中的包的东西。

不幸的是，使用命名空间不可能。命名空间中包含的每个类都可以从命名空间的外部访问：命名空间是开放的。

解决方案通常是为实现细节添加另一个命名空间：

namespace MyFramework
{
    // Implementation details
    // Should not be used by the user
    namespace detail
    {
        class A
        {
            public:
                void func();
        };
    }

    class B
    {
        public:
            B()
            {
                A a;
                a.func();
            }
    };
}

不要忘记添加注释说明detail 命名空间不被用户使用。

Answer 2

通用约定，例如在 Boost 中，是一个名为 detail 的嵌套命名空间。

如果您想实施可访问性，您始终可以使用嵌套的class，称为detail。该类提供可访问性检查，但缺乏像命名空间那样的可扩展性。但是，detail 范围很少需要扩展。

所以，尽管丑陋，

namespace my_framework {
    class detail
    {
    private:
        static void some_function_I_want_B_to_use() {}

    public:
        class A
        {};

        class B
        {
            B() { some_function_I_want_B_to_use(); }
        };
    };

    typedef detail::A A;        // "using detail::A"
    typedef detail::B B;        // "using detail::B"
}  // namespace my_framework

---

顺便提一下，B 类（直接来自问题）有一个私有的默认构造函数，因此不能创建它的实例。

Answer 3

Pimpl idiom，通常称为编译防火墙，正是您要找的。整个Qt都是用这个成语实现的。

// A.hpp
namespace MyFramework {
  class A {
  private:
    class Private;

    Private* implementation;
  };
}

// A_Private.hpp
#include "A.hpp"

namespace MyFramework {
  class A::Private {
  public:
    void some_function_I_want_B_to_use() {}
  };
}

// A.cpp
#include "A_Private.hpp"

namespace MyFramework {
A::A() {
  implementation->some_function_I_want_B_to_use();
}
}

// B.hpp
#include "A.hpp"

namespace MyFramework {
  class B {
    B();

    A a;
  };
}

// B.cpp
#include "A_Private.hpp"

namespace MyFramework {
B::B() {
  a.implementation->some_function_I_want_B_to_use();
}
}

注意：当然A_Private.hpp 不会进入你的框架最终发行版的include 目录，即它仍然是package private 你需要的。 p>

这个例子非常基础。当然，它可以做得更先进、更健壮。此外，Pimpl 还有许多其他优点。有关所有这些信息，请参阅：

• GotW #100: Compilation Firewalls (Difficulty: 6/10)
• GotW #101: Compilation Firewalls, Part 2 (Difficulty: 8/10)
• Pimp My Pimpl — Reloaded
• Pimp My Pimpl
• Dpointer