命名异步方法的最佳方法

Question

比方说,API的一个方法是:"DoSomething()".该方法应该有两个版本:异步和同步.我们应该鼓励API用户使用异步,因此同步一个可能应该得到更复杂和明确的名称.所以问题是:我们应该如何命名这一对.到目前为止我们已经提出:

• DoSomethingAndWaitForResult()/ DoSomething()
• DoSomething()/ DoSomethingAsync()
• DoSomethingSync()/ DoSomething()
• DoSomething()/ RequestSomething()

上述方案似乎都不适合我们.有什么建议吗？

更新.如果适合你,BTW会毫不犹豫地发布以上其中一个作为答案.

Answer 1

如果你想鼓励你的用户使用异步的同步,那么我会选择这个: DoSomethingSync() / DoSomething()

但是,如果没有另外说明,请大声告诉您的用户所有方法都是异步的.

示例:node.js使用此表示法:fschmodSync和fschmod

但最重要的是坚持你选择的那个.

Answer 2

将它们命名为相同并使用不同的签名来区分它们（一个带有回调函数，一个不带回调函数）怎么样？

否则，Adobe 对 ActionScript 使用“Async”后缀，这似乎也足够好：http ://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/filesystem/FileStream.html