关于 Django/Python API:Django/Python API – 如何确定方法期望接收的对象类别?

Django/Python API - how can I figure out what class of object a method is expecting to receive?

在我看来,我只花了两个小时调试一些 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])

Combines a given template with a given context dictionary and returns
an HttpResponse object with that rendered text.

render() is the same as a call to render_to_response() with a
context_instance argument that forces the use of a RequestContext.

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

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


我完全不明白如何更好地解释这一点。正如 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,您会发现它要简单得多。


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

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

在您链接到的文档中仔细查看 render() 的每个参数的具体措辞。 request 是"请求对象"。模板是"全名……或名称序列"。字典是"值的字典......"。 status 是"响应的状态码。默认为 200"[一个整数]。

我已经强调了提示接口期望或返回的动态类型的词。 object 表示一种对象类型,具有一组方法。名称暗示字符串。 200 的例子意味着状态码是一个整数。

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

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