我的一位同事正在为php应用程序开发SOAP API,他想知道CamelCaps名称是否是SOAP方法的某种约定?
我们当前的API有lower_caps_and_underscores,但与其他SOAP API的随机子集相比,它似乎有点奇怪,我们真的不想用我们错误的约定来惹恼API的消费者。
答案 0 :(得分:2)
在几乎所有的标准SOAP API中,我都看到过CamelCaps。您可能希望查看标准SOAP API。即google SOAP api
我认为Underscore可能会惹恼用户。您可以遵循其中任何一个,但更重要的是遵循任何单一标准命名约定。
在命名服务时要考虑的其他重要事项是,命名应该清楚地确定服务在特定上下文中将执行的含义和上下文。
即
GetCustomerHistoryById =按身份获取单个客户历史记录 GetCustomersHistory =获取所有客户的历史记录
答案 1 :(得分:1)
你在用什么语言发展(不重要)?
根据我的经验,lower_with_underscores似乎是PHP开发的首选样式,但CamelCase似乎更常用。
只是一个想法
答案 2 :(得分:0)
对于SOAP,您可以看到Pascal Casing或Camel Casing。 SOAP名称空间是Pascal Cased(soap:Envelope everyone)。我猜你的用途取决于你画线的位置。
通常,我使用Pascal Casing进行方法和属性。这两个要素体现了合同的框架。考虑到这一点,我可能会拥有与方法和属性Pascal Cased相对应的SOAP元素。
至于参数和返回值,我必须考虑打破Pascal套管规则并在那里使用驼峰套管。 Fortunatley,我现在没有构建SOAP API,所以我有时间考虑它。
然而,我不会选择Pascal或Camel外壳之外的东西,因为它不是标准的。并不是说我认为人们会说“我没有使用你的API,因为它使用非标准命名”,但这只是一个惯例。但是,那些贬低惯例的人往往会提出下一个新的发展趋势。 ; - )