“公开” 是否嵌套类

Question

假设我有一个“应用程序”类。 为了进行初始化，需要在构造函数中进行某些设置。 我们还假设设置的数量如此之多，以至于必须将它们放在自己的类别中。

比较此场景的以下两个实现。

实施 1：

class Application 
{
   Application(ApplicationSettings settings) 
   {
       //Do initialisation here
   }
}

class ApplicationSettings 
{
   //Settings related methods and properties here
}

实施 2：

class Application 
{
   Application(Application.Settings settings) 
   {
       //Do initialisation here
   }

   class Settings 
   {
      //Settings related methods and properties here
   }
}

对我来说，第二种方法是非常可取的。 它更具可读性，因为它强烈强调两个类之间的关系。 当我编写代码在任何地方实例化 Application 类时，第二种方法看起来更漂亮。

现在想象一下，Settings 类本身也有一些类似的“相关”类，而该类也同样如此。 只有三个这样的级别，类命名在“非嵌套”情况下就会失控。 然而，如果你嵌套，事情仍然保持优雅。

尽管存在上述情况，我在 StackOverflow 上看到有人说嵌套类只有在外部世界不可见的情况下才是合理的； 也就是说，如果它们仅用于包含类的内部实现。 最常见的反对意见是包含类的源文件的大小膨胀，但部分类是该问题的完美解决方案。

我的问题是，为什么我们对嵌套类的“公开暴露”使用保持警惕？ 还有其他反对这种使用的论据吗？

Answer 1

我觉得还好。 这基本上是构建器模式，并且使用嵌套类效果很好。 它还允许构建器访问外部类的私有成员，这非常有用。 例如，您可以在构建器上有一个 Build 方法，它调用外部类上的私有构造函数，该构造函数采用构建器的实例：

public class Outer
{
    private Outer(Builder builder)
    {
        // Copy stuff
    }

    public class Builder
    {
        public Outer Build()
        {
            return new Outer(this);
        }
    }
}

这确保构建外部类实例的唯一方式是通过建设者。

我在 Protocol Buffers 的 C# 端口中使用了非常类似的模式。

Answer 2

您可以使用名称空间来关联...相关的事物。

例如：

namespace Diner
{
    public class Sandwich
    {
        public Sandwich(Filling filling) { }
    }

    public class Filling { }
}

与像使用命名空间一样使用类的优点是，您可以选择在调用方使用 using 来缩写事物：

using Diner;

...

var sandwich = new Sandwich(new Filling());

如果您使用 Sandwich 类就像 Filling 的命名空间一样，您必须使用全名 Sandwich.Filling 来引用 Filling。

知道了这一点你晚上怎么睡觉呢？

Answer 3

您可能想查看 Microsoft 的说法 关于该主题。 我想说，基本上这是一个风格问题。

Answer 4

我有效使用公共嵌套类的另一个实际示例是在 MVC 模式中，当我使用具有 IEnumerable 属性的视图模型时。 例如：

public class OrderViewModel
{
public int OrderId{ get; set; }
public IEnumerable<Product> Products{ get; set; }

public class Product {
public string ProductName{ get; set; }
public decimal ProductPrice{ get; set; }
}

}

我使用它是因为我不希望在外部重用 Product 类，因为它是仅为包含它的特定视图模型定制的。 但我无法将其设为私有，因为 Products 属性是公共的。

Answer 5

我主要使用嵌套类来微调对嵌套和/或容器类的访问。

要记住的一件事是，嵌套类定义基本上是类成员，并且可以访问容器的所有私有变量。

您还可以使用它来控制特定类的使用。

示例：

public abstract class Outer
{
  protected class Inner
  {
  }
}

现在，在这种情况下，如果用户（您的类的）实现了外部类，则他只能访问内部类。

Answer 6

我不知道这是否被认为是糟糕的设计，但我创建了一些搜索类，用户调用 Run() 方法，传入一个包含搜索条件的对象。 然后它返回搜索结果对象的集合。

这些 SearchCriteria 和 SearchResult 类除了与 Search 类一起使用之外没有其他用途。 因此，我将它们嵌套在 Search 类下，以表明它们是在一起的。

我必须将嵌套类公开，以便搜索类的客户端可以将 SearchCriteria 传递到搜索类中，以便他们可以获得搜索的结果。

public class PersonSearch
{
    public PersonSearchCriteria
    {
        string FirstName {get; set;}
        string LastName {get; set;}
    }

    public PersonSearchResult
    {
        string FirstName {get;}
        string MiddleName {get;}
        string LastName {get;}
        string Quest {get;}
        string FavoriteColor {get;}
    }

    public static List<PersonSearchResult> Run(PersonSearchCriteria criteria)
    {
        // create a query using the given criteria

        // run the query

        // return the results 
    }
}


public class PersonSearchTester
{
    public void Test()
    {
        PersonSearch.PersonSearchCriteria criteria = new PersonSearch.PersonSearchCriteria();
        criteria.FirstName = "George";
        criteria.LastName  = "Washington";

        List<PersonSearch.PersonSearchResults> results = 
            PersonSearch.Run(criteria);
    }
}