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,也不是任何静态类型的语言。文档没有说它想要一个字符串,因为它没有:它想要包含名称的类似字符串的东西。
别忘了,您可以立即访问代码。看不懂功能?好吧,看看
更好的是,在 Python 中,您有一个在 Java 中根本没有的选项:查看 shell。执行
如果你坚持像 Java 一样编程 Python,你会发现它很困难。如果您像编写 Python 一样编写 Python,您会发现它要简单得多。
虽然我同意 Daniel Roseman 的回答,但我对你的困惑表示同情,我认为界面及其参数可以更好地解释。
Django 的界面非常支持动态类型或"鸭子类型"的概念——例如,如果它像鸭子一样走路,如果它像鸭子一样游泳,那么就称它为鸭子。 Django 的接口不需要你传递一个字符串类型,它需要你传递一个行为类似于字符串的实体。
在您链接到的文档中仔细查看
我已经强调了提示接口期望或返回的动态类型的词。 object 表示一种对象类型,具有一组方法。名称暗示字符串。 200 的例子意味着状态码是一个整数。
我认为如果 Django 文档更明确地说明它期望或返回的动态类型的词汇表,它会更清晰。它可以说类似"请求是实现请求对象接口的对象",然后准确定义对象需要实现哪些方法才能成为该接口。在像状态这样的情况下,文档也可以是显式的而不是隐式的,它可以从字面上说"整数"。
但除了这些警告之外,Django 的界面被设计为"pythonic",以支持鸭子类型。丹尼尔是对的,"如果你坚持像 Java 一样编程 Python,你会发现它很困难。"这可能是阅读 Django 的 Design Philosophies 和 Python 的 PEP 20 -- The Zen of Python 的好时机。请注意,两者都没有提到"由于强类型而进行的编译时语法检查"作为目标。 Toto,我认为我们不再使用 Java。