web-services - 是否有命名 SOAP 接口(interface)方法和变量的最佳实践？

Question

在 .NET 中，Microsoft 在开发类库时有命名类、成员等的准则。其他语言可能也有如何命名类、如何/是否使用某些符号的最佳实践。

现在 SOAP 是一种可用于跨语言边界通信的协议(protocol)。是否有最佳实践如何命名函数、变量名等？或者我应该使用我的语言(如果有的话)使用什么？或者当我通过工具(例如 WCF 服务契约(Contract))生成 SOAP 接口(interface)时，我应该使用该工具生成的任何内容吗？

Answer 1

服务方法名称似乎没有正式的 W3C 命名约定。

一些常用的指南:

• 方法名称应该从客户的角度清楚地表明它们的作用

• 使用不同的方法名而不是重载

• 一般来说，PascalCasing 似乎更受欢迎(无下划线)。对于 .Net，请遵循常规方法的 .Net 命名约定。

您还可以找到 this blog post来自 Oracle 很有用。