已发布和公共方法/属性之间有什么区别？

Question

根据马丁·福勒的说法，“有些东西可以公开，但这并不意味着你已经发布了它。” 这是否意味着这样的事情：

public interface IRollsRoyceEngine
{
    void Start();
    void Stop();
    String GenerateEngineReport();
}

public class RollsRoyceEngine : IRollsRoyceEngine
{
    public bool EngineHasStarted { get; internal set; }

    public bool EngineIsServiceable { get; internal set; }

    #region Implementation of IRollsRoyceEngine

    public void Start()
    {
        if (EngineCanBeStarted())
            EngineHasStarted = true;
        else
            throw new InvalidOperationException("Engine can not be started at this time!");
    }

    public void Stop()
    {
        if (EngineCanBeStopped())
            EngineHasStarted = false;
        else
            throw new InvalidOperationException("Engine can not be started at this time!");
    }

    public string GenerateEngineReport()
    {
        CheckEngineStatus();
        return EngineIsServiceable ? "Engine is fine for now" : "Hmm...there may be some problem with the engine";
    }

    #endregion

    #region Non published methods

    public bool EngineCanBeStarted()
    {
        return EngineIsServiceable ? true : false;
    }

    public bool EngineCanBeStopped()
    {
        return EngineIsServiceable ? true : false;
    }

    public void CheckEngineStatus()
    {
        EngineIsServiceable = true;
        //_EngineStatus = false;
    }

    #endregion

}

可以说这个发布的接口是 IRollsRoyceEngine 而不是 RollsRoyceEngine 中的任何内容吗？

如果是这样，公开方法和发布方法之间的真正区别是什么？

Answer 1

我认为他的意思是契约为王——仅仅因为你的类中的方法是公共的，并不意味着客户就可以假设他们可以调用它，或者他们知道它的作用，或者它会在下一个中出现版本。 API 不是由源定义的，它们是由合同定义的，通常以文档的形式。

客户端有责任不调用未记录（未发布）的函数，而不是实现者有责任隐藏不应调用的方法。

有些人可能不同意这一点 - 通常是那些不信任文档的人，他们宁愿通过查看源代码来了解事物的工作原理，看看它实际上做什么，而不是作者做什么>声称确实如此。 他们很可能有一定的道理，尤其是在处理文档不足的代码的实践中。 但我认为这与福勒所说的相反，福勒所说的功能应该被正式定义，而不是通过检查特定实现来推断。

Answer 2

在我看来，提到的白皮书讨论的是 API 的目标受众，而不是接口及其实现之间的区别。

您可以在框架设计指南中找到类比，其中表示一旦您的 API 交付给您与消费者有合同。 例如，如果您在框架 IService 接口的 v1 中发布，则无法在 v2 中更改它，因为它会给最终开发人员带来重大更改。 相反，您必须创建继承自 IService 的新接口 IService2 并随 v2 一起发布。

因此，一旦您与最终开发人员“签订合同”，基本上公共 API 就会发布。

回到您的代码 - 例如，当您将其发送到开发社区时，它将被发布。

希望这个解释会有所帮助。