Django/Python API - 如何确定一个方法期望接收的对象类？

Question

我只花了两个小时调试一些 django 代码，因为 API 不清楚，在我看来。以下是 Django 文档中关于“渲染”方法的说明：https://docs.djangoproject.com/en/1.3/topics/http/shortcuts/#render

render(request, template[, dictionary][, context_instance][, content_type][, status][, current_app])

将给定模板与给定上下文字典组合并返回 具有该呈现文本的 HttpResponse 对象。

render() 与调用 render_to_response() 相同 强制使用 RequestContext 的 context_instance 参数。

现在，看到 render 方法需要的第二个参数是一个模板，我给它传递了一个 Template 对象。事实证明，该方法真正想要的是作为字符串给出的模板名称。我怎么会知道这个？什么是“状态”——一个整数？一个字符串？状态对象？一个列表？我在哪里可以获得明确的文档以供参考？

另外，我很想找到一个可以在我编程时检测到这类事情的 IDE——当我使用 Netbeans 和 Java 工作时，编辑器之前会用波浪形的红色下划线捕捉到这种错误我什至开始输入下一行代码。

Answer 1

我完全不明白如何更好地解释这一点。正如 miku 在评论中指出的那样，文档清楚地说明了“要使用的模板的全名”。另外，下面直接给出的示例显示了字符串的使用。

Python 不是 Java，也不是任何静态类型的语言。文档没有说它想要一个字符串，因为它没有：它想要包含名称的类似字符串的东西。

别忘了，您可以立即访问代码。看不懂功能？好吧，看看https://code.djangoproject.com/browser/django/trunk/django/shortcuts/__init__.py 就在那里。

更好的是，在 Python 中，您有一个在 Java 中根本没有的选项：查看 shell。执行from django.shortcuts import render，然后执行help(render) 以查看其内容，如果这无济于事，请尝试在此处使用几个不同的参数调用它以查看其作用。

如果你坚持像编写 Java 一样编写 Python，你会发现它很困难。如果您像编写 Python 一样编写 Python，您会发现它要简单得多。

Answer 2

虽然我同意 Daniel Roseman 的回答，但我对您的困惑表示同情，并且我认为界面及其参数可以更好地解释。

Django 的界面非常支持动态类型的概念，即“duck typing”——例如，如果它像鸭子一样走路，如果它像鸭子一样游泳，那么就称它为鸭子。 Django 的接口不需要你传递一个字符串类型，它需要你传递一个行为类似于字符串的实体。

在您链接到的文档中仔细查看render() 的每个参数的具体措辞。 request 是“请求对象”。 template 是“names 的完整name...或sequence。” dictionary 是“一个dictionary 值...”。 status 是“响应的状态码。默认为 200”[一个整数]。

我已经对暗示接口期望或返回的动态类型的词添加了重点。 object 表示一个对象类型，带有一组方法。 name 表示字符串。 200这个例子意味着状态码是一个整数。

我认为如果 Django 文档更明确地说明它期望或返回的动态类型的词汇表，它会更清晰。它可以说类似“request 是实现请求对象接口的对象”，然后准确定义对象需要实现哪些方法才能成为该接口。在 status 等情况下，文档也可以是显式的而不是隐式的，在这种情况下，它可以字面意思是“整数”。

但除了这些警告之外，Django 的界面被设计为“pythonic”，以包含鸭子类型。丹尼尔是对的，“如果你坚持像 Java 一样编程 Python，你会发现它很困难。”这可能是阅读Django's Design Philosophies 和Python's PEP 20 -- The Zen of Python 的好时机。请注意，两者都没有提到“由于强类型而进行的编译时语法检查”作为目标。 Toto，我认为我们不再使用 Java。