4

人们通常说他们使用 API 文档和代码。

我的JAVA语言比较好，这意味着我可以编写简单的程序。最近，对于正在开展的项目，我被要求使用 SOAPUI 工具并正在阅读 SOAPUI API 以在 Groovy 中编写代码。在这样做的时候，我得到了这个问题。

如何开始使用 API 文档（适用于任何语言/事物）？可以说，我想开始使用 Google Map API 或 Yahoo developer API。

是否有任何结构化的方式来阅读和理解 API？首先使用哪些类或如何调用或使用各种方法。

在阅读特定 API 之前应该做什么？如何通过阅读和理解 API 来熟悉创建事物并开始构建事物？

要做到这一点，应该具备哪些技能？如何培养这样的技能。

4

4 回答 4

4

我建议您从教程和示例代码开始。API 文档实际上是一种参考。

于 2010-09-17T10:31:51.800 回答
1

当我开始使用新工具/API 时，我总是首先阅读文档以了解它是什么/它做什么/它是如何工作的。文档通常指向一个教程，这是我接下来要做的。然后我将尝试创建我自己的非常简单的测试应用程序，它以相当简单的方式使用 API。

到这个时候，我已经了解了主要的类，并且通常会为它们阅读 javadocs。我真的只会在需要时才使用其他较少使用的类或额外功能。

于 2010-09-17T10:40:33.747 回答
1
  1. 完整阅读 API 并了解每个方法调用的要求。例如，一些调用是 GET/POST 方法。了解它们需要哪些参数以及它们返回的响应。
  2. 使用 API。通常有一个沙盒系统，您可以在其中玩 API 调用等。
  3. 编写自己的代码（随心所欲）并使用它，直到您了解 API 的流程。

一旦掌握了窍门，就可以设计一个最适合 API 的架构。本质上，阅读文档对于理解 API 是必不可少的。

希望这可以帮助。

于 2010-09-17T10:43:31.443 回答
0

我最近也试图弄清楚它们，主要是试图找出我在为测试用例编写测试脚本时可以访问的对象是什么。我无法确定日志、上下文、testStep 等与 API 相关的类型。对我来说，错误消息是一座金矿。当我尝试错误时，它清楚地说明了对象的类型，并在 API 中为我指明了正确的方向。

另一个让我陷入循环的事情，如果有人没有仔细阅读有关 Groovy 的内容（比如我），他们可能会觉得很有帮助，那就是 Groovy 公开了所有属性，而无需调用 getter 或 setter。所以像 myObj.myProp = 5 这样的东西对应于 API 中的 setMyProp(5) 方法。简单的东西，但我为一些新手而挠头！

于 2010-09-21T19:14:32.610 回答