第 13 章　亚马逊掌上书店

本章将学习以下内容：

此外我们将介绍用Python语言及谷歌的App引擎编写的源代码，并用它来创建自己的Web service API。

在开始设计组件和编写应用之前，我们来解释一下什么是API（应用程序接口），以及它如何工作。可以把API想象为一个网站，只是它不与人类交互，而是与其他计算机程序交互。

图 13-1　模拟器中的“亚马逊掌上书店”

API通常被称作“服务器端”程序，因为它们的特点就是为“客户端”程序提供信息。“客户端”程序负责实现与人类的接口——如App Inventor应用。如果你曾经在手机上使用Facebook 应用，你实际上是通过Facebook的客户端程序与Facebook的服务器端程序（API）进行通信。

本章将创建一个Android客户端应用，与Amazon API进行通信。应用将向Amazon API请求书的信息（书名、书号及价格等），而API将向应用返回最新的信息列表，用户将在应用中浏览到书的相关信息。

我们即将使用的Amazon API是App Inventor专用的API。这里我们不想过多地解释细节，但有关配置的知识是非常有用的，正是由于有了这些配置，我们才能用TinyWebDB组件与Amazon进行沟通。好在你已经学会了使用TinyWebDB！调用TinyWebDB.GetValue来请求信息，然后在TinyWebDB.GotValue事件处理程序中处理返回的信息，就像在用Web数据库一样。（如果忘记了，去复习一下第10章的“出题”应用。）

在创建应用之前，需要先了解一下Amazon API协议，协议规定了请求数据的方式以及返回数据的格式。就像不同的族群有不同的礼仪（两人相遇时，是握手、鞠躬还是点头？），计算机之间的互相则需要有协议 。

Amazon API为调用者提供了一个Web页面，来说明API的使用方法。虽然设计API的目的是为了与其它计算机交互，但在这个页面上，你可以看到这种交互的过程。 按照下列步骤，你可以尝试调用一个指定tag参数的GetValue，并在页面上看到返回的数据，这与你在App Inventor中使用TinyWebDB组件请求数据的结果完全一致：

图 13-2　App Inventor专用的Amazon API的说明及测试页面

图 13-3　调用Amazon API来搜索与tag（或关键字）“natural computing”有关的书籍

返回值是一个书的列表，每本书的信息由一对方括号包围[像这样]，提供了书名、售价及ISBN。如果仔细观察，你会发现每本书其实是另一主列表的子列表。主列表（natural computing）由外层的方括号包围，每个子列表（或书）被封闭在单独的一对方括号内。所以此API的返回值实际上是一个列表的列表，每个子列表提供一本书的信息。我们来细致地观察一下。

数据中的每个左括号（[）标志列表的开头。第一左括号标志外层列表（书籍列表）的开始，紧挨着它的左括号是第一个子列表，即第一本书的开头：

子列表包含三个部分：书名、该书在亚马逊书店的最低售价及这本书的ISBN。当你的App Inventor应用取得这些信息时，就可以使用select list item块来访问其中的每个部分，用索引值1访问书名，索引值2访问价格，索引值3访问ISBN。（如果淡忘了有关列表及索引的使用方法，请复习第十章的“出题”应用。）

返回结果中的双括号（[[）表示返回的仍然是一个列表的列表，虽然列表中只有一本书。这似乎有点奇怪，但这一点对需要访问这类信息的应用来说非常重要。

图 13-4　用ISBN替代关键字在AmazonAPI中查询书籍

“掌上书店”应用的用户界面比较简单：一个用于输入搜索词或ISBN的文本框，一个用于启动搜索（关键字或ISBN）的按钮，另一个启动扫描书的条码的按钮（稍后会用到），一个搜索结果标题的label，另一个显示搜索结果的label，还有两个非可视组件：TinyWebDB和条码扫描仪。表13-1列出了图13-5中所示的所有组件，对照检查你的结果。

图 13-5　组件设计器中“亚马逊掌上书店”的用户界面

表13-1 “亚马逊掌上书店”应用的组件列表

组件的属性设置如下：

在块编辑器中设定下列行为：

用户点击SearchButton时，从SearchTextbox中获取搜索内容，并以此为tag，使用TinyWebDB.GetValue块向Amazon API请求搜索数据。

当Amazon返回结果时，将触发TinyWebDB.GotValue事件。现在用ResultsLabel直接显示返回结果，如图13-6所示，当见到这些真实的数据后，可以采取更为复杂的方式来显示数据。

图 13-6　向API发送搜索请求，并将结果显示在ResultsLabel中

当点击SearchButton时，TinyWebDB1.GetValue开始向API发出请求。随请求一同发送的tag正是用户在 SearchTextBox中输入的内容。

从第十章“出题”应用中得知，TinyWebDB.GetValue发出的请求并不能立即获得结果，而是在收到从API返回的数据时，触发TinyWebDB1.GotValue事件。在GotValue块中，首先检查返回值是否为列表，如果是，则数据被写入ResultsLabel。（如果Amazon API离线或搜索的关键字不存在，将没有数据返回。）再输入ISBN“1118717376”试试看。

图 13-7　搜索“Android”返回的结果

在前几章中了解到，使用TinyWebDB请求数据的过程需要一点时间，在收到返回的数据之前，用户界面上悄无声息，这时用户会感到困惑，因此从用户友好的角度考虑，添加一点提示是非常必要的。这里我们用ResultLabel来显示提示信息。如图13-8所示。但如果网络速度很快，数据很快返回并触发GotValue事件，则几乎看不到提示，数据就显示出来了。

图 13-8　添加提示信息消除用户的困惑

现实情况是：在手机上输入字符通常不那么容易，而且总会出一些小错。如果能够在应用中使用条码扫描，那么问题会变得简单（并且几乎不会出错）。这是Android手机内置的另一项强大的功能，你可以用App Inventor轻而易举地实现它。

函数BarcodeScanner.DoScan用于启动扫描仪，可以在ScanButton被点击时调用它。一旦扫描操作完成，将触发BarcodeScanner.AfterScan事件。该事件带有一个参数result，其中保存了扫描所获得的信息。在本例中，result即是用于搜索的ISBN，如图13-9所示。

图 13-9　用户扫描书上的条码获得ISBN并启动搜索

点击ScanButton将启动扫描仪，即执行BarcodeScanner1.DoScan。扫描完成时触发AfterScan事件。该事件带有result参数，在本例中为书的ISBN。用ResultLabel告诉用户正在进行搜索，并在SearchTextBox中显示result（扫描获得的ISBN），最后调用TinyWebDB.GetValue来启动搜索。仍然使用之前定义的TinyWebDB.GotValue事件处理程序来处理返回的书籍信息。

我们所创建的这类客户端应用，可以按需要来处理收到的数据，可以与其他网上商店进行价格比较，也可以用书名信息来搜索其他图书馆中的同类书籍。

通常是将加载自API的信息保存到变量中再做处理，而目前只是在TinyWebDB.GotValue事件处理程序中，将Amazon API返回的所有信息直接写入到ResultsLabel中。

下面我们来处理（或这说安排）这些数据，方法是（1）将返回数据中的每本书的书名、售价以及ISBN分别保存到单独的变量中；（2）以一种有序的方式显示这些项目。

到目前为止，你已熟知了全局变量（global variable），与之对应的是局部变量（local variable），这是本章引入的一个新的概念。一个变量有它的有效范围：全局变量直接在块编辑器中定义，单独占一行，不属于任何一组块，而所有的块都可以调用全局变量；局部变量则定义在某个程序块内部，它将包含其它块，而且只对其包含的块有效，其余的所有块都无法访问到它。

下面将使用这些变量，并将它们显示出来，试试看按需要创建这些变量，并组织一些块来分行显示每一项搜索结果，完成之后与图13-10进行比较。

这里定义了四个变量：resultList、title、cost及ISBN，用来保存Amazon API返回数据中的每一条数据。从API返回的数据保存在参数valueFromWebDB中，这里将它另存为resultList。其实程序可以直接使用valueFromWebDB，但通常会将它另存为一个变量，以便在该事件处理程序之外也可以使用这一数据。（像valueFromWebDB这样的参数仅在事件处理程序内有效，事件处理程序之外无法访问该参数值。）

foreach循环用来遍历返回结果中的每个数据项。回想一下，从Amazon返回的数据是一个列表的列表，每个子列表代表一本书的信息，因此foreach块中的项变量被命名为bookItem，它保存了当前正在被遍历的书的信息。

现在我们要清醒地面对项变量bookitem，它是一个列表，其中第一项是书名，第二项是售价，第三项是ISBN，因此，select list item块利用索引值（index）将这些数据逐项提取出来，并保存在事先定义的变量中（title、cost及ISBN）。

图 13-10　在遍历过程中提取每本书的书名、售价及ISBN，并逐行显示它们

一旦数据被拆解成这种方式，就可以随意地摆布它们。程序中的局部变量只是作为join块的组成部分，来逐行显示书名、售价及ISBN。

图 13-11　用更有条理的方式显示搜索结果

我们所连接的API(http://aiamazonapi.appspot.com)是由Python(编程语言)和谷歌应用引擎(App Engine)创建的。开发者可以将应用引擎上创建并发布网站或服务(API)。只有当你的网站或服务非常受欢迎时(这意味着你使用了大量的谷歌服务)，才需要向App Engine付费。

这里使用的API只能访问全部Amazon API中的有限的部分：最多只能查询到五本书。如果想提供更多灵活的访问，例如，不仅是找书。你可以从http://appinventorapi.com/amazon/下载源代码，并按照自己的需要来修改它。

这种修改确实需要有Python编程的知识，所以要小心！但是加入你已经通过本书完成了App Inventor的学习，那么是该考虑迎接新的挑战了。想要学习Python，可以查看网上的文章《如何像计算机科学一样思考：学会使用Python》(http://openbookproject.net//thinkCSpy/)，并查看本书第24章的“创建App Inventor API”部分。

一旦应用运行起来，你可能会探索做一些改进。如：

以下是本章涵盖的内容：