如何使長參數列表可讀？

Question

我已經開發了一個自然規避函數中的長參數列表。雖然這在某種程度上是一件好事，但與「代碼複製」相比，由於「手動內聯」，有時候長參數列表是兩個惡意中的較小者。至少使這些怪物中的某些人可讀的好方法是什麼？例如：

SomeClass[string] someFunction(SomeClass!(TemplateParam) foo, 
    string[][string] someAA, uint[] dataToProcess, SomeEnumType flag) { 
    // Do stuff. 
} 

這在可讀性範圍內得分不高，但在很多情況下四個參數是相當合理的。

Answer 1

對於這種情況，我傾向於像這樣進行格式化：

SomeClass[string] someFunction(
    SomeClass!(TemplateParam) foo, 
    string[][string] someAA, 
    uint[] dataToProcess, 
    SomeEnumType flag 
) 
{ 
    // Do stuff. 
} 

Answer 2

我重新組合在一個（主要是內）類（或結構），以避免廣泛的函數聲明的參數/調用

Answer 3

我喜歡亞倫的回覆，只是給每個參數添加一個換行符。

當它變得太多的時候，是時候重構一下了。

如果你仍然需要這麼多參數，切換到傳入一個包裝你的屬性的類，而不是。然後，您可以輕鬆添加默認參數到您的方法中，而無需搞亂簽名。

Answer 4

• 的可讀性的原因 - 把每一個參數上新的生產線
• 可用性和更好的DESGIN API的目的 - 將相關參數到新類，從而縮短參數的數目。

Answer 5

您可以引入參數對象：

class ParameterObject { 
    public final SomeClass!(TemplateParam) foo; 
    public final string[][string] someAA; 
    public final uint[] dataToProcess; 
    public final SomeEnumType flag; 

    private ParameterObject(
     SomeClass!(TemplateParam) foo, 
     string[][string] someAA, 
     uint[] dataToProcess, 
     SomeEnumType flag) { 
     this.foo = foo; 
     this.someAA = someAA; 
     this.dataToProcess = dataToProcess; 
     this.flag = flag; 
    } 

    private static class Builder { 
     public SomeClass!(TemplateParam) foo; 
     public string[][string] someAA; 
     public uint[] dataToProcess; 
     public SomeEnumType flag; 

     public Builder foo(SomeClass!(TemplateParam) foo) { 
      this.foo = foo; 
      return this; 
     } 

     public Builder someAA(string[][string] someAA) { 
      this.someAA = someAA; 
      return this; 
     } 

     public Builder dataToProcess(uint[] dataToProcess) { 
      this.dataToProcess = dataToProcess; 
      return this; 
     } 

     public Builder flag(SomeEnumType flag) { 
      this.flag = flag; 
      return this; 
     } 

     public ParameterObject build() { 
      if (null == foo) throw Exception("init foo!"); 
      if (null == someAA) throw Exception("init someAA!"); 
      if (null == dataToProcess) throw Exception("init dataToProcess!"); 
      if (null == flag) throw Exception("init flag!"); 
      return new ParameterObject(foo, someAA, dataToProcess, flag); 
     } 
    } 
} 

現在，您的通話將查找例如：

SomeClass[string] myValue = 
    someFunction(
     new ParameterObject.Build(). 
      foo(myFoo). 
      someAA(myAA). 
      dataToProcess(myData). 
      flag(false). 
      build() 
    ); 

它在語言允許內嵌的創作更容易處理類似案件地圖：

someFunction(
    Map.new(
     foo => myFoo, 
     someAA => myAA, 
     dataToProcess => myData, 
     flag => false 
    ) 

限定符final意味着一個字段只能從類的構造函數中設置。在類之前的限定符static意味着該類不與其外部類相關聯，即不能訪問/變更其字段。