命名
类的命名(名词组合)
把关注点放在最前面
-
ProvinceInquiryController
- 优点:这种命名方式将 "Province" 放在前面,突出了控制器的主题是有关省份的查询。
- 例子:
ProvinceInquiryController
更直接地指出了控制器的作用是进行省份的查询,比如处理 "/province/inquiry" 这样的请求。
-
InquiryProvinceController
- 优点:这种命名方式将 "Inquiry" 放在前面,强调了控制器的主要操作是查询,而 "Province" 则是被查询的对象。
- 例子:
InquiryProvinceController
更强调了控制器的操作类型,比如处理 "/inquiry/province" 这样的请求。
选择哪种命名方式取决于你更希望强调控制器的主题还是操作类型。如果你更关注于控制器的主题(例如省份查询),那么
ProvinceInquiryController
更合适。如果你更关注于控制器的操作类型(例如查询操作),那么InquiryProvinceController
更合适。
请求路径
RESTful风格 /资源路径/动作
比例 applet/order/in-progress,这个路径就有一点瑕疵,变成applet/order/processing会更符号RESTful的风格
方法名
-
getOrdersInProcessing() 获取处理中状态的订单
/动作/资源/名词
-
handleProcessingOrders() 处理进行中的订单
/动作/名词/资源
-
handleOrdersProcessingStatus() 处理进行中的订单
/动作/资源/名词