亚音速 3.0 一般问题答案

【问题标题】：Subsonic 3.0 General Questions亚音速 3.0 一般问题
【发布时间】：2009-07-17 02:20:15
【问题描述】：

好的，

我急切地等待亚音速 3.0 的发布以用作我的低级数据层，现在它已经发布了。我目前正在使用 ActiveRecord 模板（已尝试过存储库和高级模板），我有一个巨大的请求和几个问题：

请求：除了错误修复，Rob 请花时间提供文档。我不是指 5 个示例，我指的是 API 完整文档。原因如下：

我正在通过编写 ASP.NET MembershipProvider 和 RoleProvider 类来测试亚音速，而简单的问题不断地让我使用亚音速：

问。假设我有一个“用户”类，并且我使用

更新/保存/删除记录

user.Save();

我需要有关如何获得成功/失败的信息？我是否会寻找失败的例外情况，还是可以获得“受影响”记录的计数（老派？）

问。如果我得到一个异常，我可以期待哪些异常？

我会遇到更多问题，但我真的相信一个好的功能性 API 文档可以解决问题。

如果答案是“阅读源代码”，那么我敢肯定你会赶走相当多的开发人员远离亚音速。我真的很想使用该库，但重点是“使用”该库，而不是对其进行逆向工程。

-杰夫

【问题讨论】：

【解决方案1】：

问。我需要有关如何获得成功/失败的信息？我是否会寻找失败的例外情况，还是可以获得“受影响”记录的计数（老派？）

如果它没有抛出异常，那么它就可以工作

问。如果我得到一个异常，我可以期待哪些异常？

您可以期待DbException

【讨论】：

【解决方案2】：

我们不使用自定义异常。我花了 5 周时间写文档——所以我确实花了一些时间在这上面。您也可以在那里找到答案：http://subsonicproject.com/docs

【讨论】：

我看过您的文档页面 Rob，它们没有任何问题，但还不够，而且肯定不够有条理。我了解有限的资源和文档的复杂性，这是我自己完成的。教程和示例非常适合入门，但挑剔的 api 参考是令人惊奇的。我什至会接受生成自动文档类型信息的好 cmets。查找函数调用、参数及其作用的简单易行的地方。不过，感谢一个伟大的产品，我使用它的次数越多，我就越喜欢它。 -杰夫
开源不应该是一个人试图让别人“接受”一些东西。我不是在挑剔你——我也不是想成为一个混蛋。我需要帮助，我发现人们（在大多数情况下）更愿意抱怨而不是深入研究并提供帮助。这是风景。

【解决方案3】：

到目前为止，3.0 对我来说有点太麻烦了。我想我现在要回到 2.x，不过感谢所有的辛勤工作。

【讨论】：