到哪里看懂春天？答案

【问题标题】：Where to look to understand spring?到哪里看懂春天？
【发布时间】：2015-10-26 23:33:45
【问题描述】：

我真正的问题是如何在 Spring 中查找对方法（方法的“合同”）的期望。我一直在问问题，除非我找到一些博客或堆栈溢出来解决该特定问题，否则似乎没有信息文档。我找错地方了吗？我需要买一些书吗？

在当前的特定情况下：我正在通过将我的 SQL 表映射到 Spring 的默认值来查找用户/密码，但是当用户不存在时，它会遇到空指针异常。我看到JdbcUserDetailsManager 的“void setUserExistsSql( anSQLString)”，我想知道那个 sql-string 是否应该返回一个布尔值？一个空？以及它应该“命名”什么。谷歌搜索没有出现任何使用示例，也没有任何文档。 javadocs I'm finding 未注释。我可以猜测和测试，但似乎应该有更好的方法来查找它？

【问题讨论】：

我刚刚搜索了 JdbcUserDetailsManagerConfigurer 并点击了第一个结果，然后通过在页面中搜索它跳转到了有关 authorityByUsernameQuery 的部分。它很容易找到，文档看起来很清晰，并包含一个示例。你真的有什么问题？您不了解委托人的概念（该方法中根本没有提到）或权威的概念吗？ API 文档通常不会教授基础主题。
@Engineer Dollery - 在 JdbcUserDetailsManagerConfigurer 的示例中 - 如何从文档中知道用户名必须命名为“principal”？更相关的问题/示例在 setUserExistsSql 上——文档中没有评论
是什么让你觉得它需要被称为原则？我假设您知道在这种情况下原则是什么？您是否已经阅读了 Spring Security 的介绍并具备了解这些方法的用途所需的背景知识？这是在春天做任何事情的必要先兆，尽管我在下面回答。
@Engineer Dollery - 似乎我模仿了几个人标记为工作的内容：stackoverflow.com/a/19598587/155631 正如你所指出的 - 似乎不需要重命名。谢谢！

标签： java spring spring-mvc code-documentation

【解决方案1】：

好的，我从版本 1 开始就一直在使用 spring，许多其他开源项目都遵循相同的模式。编写文档既困难又昂贵，而且免费贡献时间的程序员通常不想编写它。不过，就文档而言，Spring 是更好的项目之一。

但是，我一直觉得有必要将 spring 的源代码链接到我的项目中。如果您使用的是 maven，您可以下载源代码以及 jar，而 IntelliJ（可能还有 eclipse）等工具将允许您深入研究源代码并使用其调试器跟踪其执行情况。

对于这些类型的项目，几乎总是需要在某些时候深入了解并阅读源代码，这是一件好事，因为源代码始终是最新的，并且始终准确地描述了您尝试使用的行为。另一方面，文档通常使用非正式语言（例如英语）编写得很糟糕，并且它永远无法准确地描述任何内容，尤其是如果它是由非母语人士编写或阅读的，这种情况经常发生。

所以，回答你的问题 - 看看源代码。

【讨论】：