何时在方法上使用Plural vs Collection单词

Question

我正在为模块创建一个API,在我在课程中创建了几个方法后,我问自己这个问题.

现在,作为一个例子,我这​​样做:

public Company GetMonitoredCompany( String companyName ) { ... }
public List<Company> GetMonitoredCompanies( ) { ... }

但我意识到,有几次,我使用其他API的/服务,有时他们的名字中的Collection可能像:

public List<Company> GetMonitoredCompanyCollection( ) { ... }

对此有规定吗？一种模式？或者两种方式都可以吗？

Answer 1

使用最简单,最简单的名称,清楚地显示方法的目的.并在您的项目中保持一致.

在这个例子中,如果没有其他考虑因素,我会使用名称:

GetMonitoredCompanies

因为它更短更清晰.

(我还会返回一个只读的ICollection或IEnumerable,除非你有一些特殊的理由不这样做.)