唐山微信公众号开发【唐山网络推广】唐山建站、唐山网站维护、唐山网页制作、唐山微信小程序代运营公司

唐山微信公众号开发【唐山网络推广】唐山建站、唐山网站维护、唐山网页制作、唐山微信小程序代运营公司

唐山，简称“唐”，河北省地级市，构建开放型经济新体制综合试点地区 [1]  。位于河北省东部、华北平原东北部，南临渤海，北依燕山，毗邻京津，地处华北与东北通道的咽喉要地，总面积为13472平方千米，是中国（唐山）跨境电子商务综合试验区 [2]  、中国（河北）自由贸易试验区组成部分。 [3-4] 

唐山因唐太宗李世民东征高句丽驻跸而得名，素有“北方瓷都”之称。这里诞生了中国第一座机械化采煤矿井、第一条标准轨距铁路、第一台蒸汽机车、第一桶机制水泥。唐山是中国评剧的发源地，素有“冀东三支花”之称的皮影、评剧、乐亭大鼓，为国家级非物质文化遗产。

2019年，唐山市下辖7个市辖区、3个县级市、4个县 [5]  ，常住人口796.4万人，地区生产总值6890.0亿元，其中，第一产业增加值531.2亿元，第二产业增加值3613.3亿元，第三产业增加值2745.5亿元，三次产业增加值结构为7.7：52.4：39.9。按常住人口计算，全年人均地区生产总值86667元（按年平均汇率折合12563美元）。

与你之前在浏览器地址栏中输入的URL相同。

图 24-10　将ServiceURL属性设置为http://yahoostocks.appspot.com

下一步是调用TinyWebDB.GetValue，向网站请求数据。这个操作可以放在一个Button.Click事件中：当用户在手机的应用界面中输入股票代码并点击“提交”按钮时，执行此调用；或者将其放在Screen.Initialize事件中，在应用启动时，自动获取某个股票的信息。无论哪种情况，都需要为GetValue设置tag——某个股票的代码，如图24-11所示，就像在网站http://yahoostocks.appspot.com上的操作一样。

图 24-11　请求股票信息

在第10章的“出题”应用中，我们已经讨论过数据库组件TinyWebDB，它的通信方式是异步的：应用中调用TinyWebDB.GetValue请求数据，之后程序将继续运行，必须为这次请求提供另一个事件TinyWebDB.GotValue的处理程序，当请求的数据从网络服务端返回时，来接收并处理这些数据。通过在用户界面http://yahoostocks.appspot.com上的操作，我们已经知道返回的数据为列表，每个列表项代表股票的不同信息（如，第二项代表股票的收盘价）。

客户端的应用可以利用网络所提供的部分或全部信息，如，如果你想显示股票的当前价格，并与开盘价进行比较，你就可以按照图24-12的方式来组织数据。

图 24-12　使用GotValue时间来处理从Yahoo返回的数据

如果从网页http://yahoostocks.appspot.com上直接向API提交请求，你会看到返回列表的第2项的确是股票的当前价格，而第5想是当前价格与当天开盘价之间的差。这个例子只是简单地从API的返回值中提取部分信息，并用两个label显示出来：PriceLabel与ChangeLabel，如图24-13所示。

图 24-13　股票应用的运行效果

创建自己的App Inventor兼容的API

在终端应用与网络之间，TinyWebDB起到了桥梁的作用。App Inventor程序员只需要依照GetValue内置的简单的tag-value协议，就可以实现应用与网络服务之间的通信。这种方式让程序员免于亲手处理那些标准格式的数据，如XML或JSON。

这种方便的代价是，用App Inventor开发的应用只能与少数网络服务通信，这些网络服务遵从TinyWebDB所设定的协议，协议中要求返回特殊格式的数据，因此API不得不提供对应格式的数据，如XML或JSON。如果找不到可用的与App Inventor兼容的API，那么就要靠那些有能力的程序员来创建。

从前，创建API是一件非常困难的事情，不但需要了解编程及网络协议，还要搭建服务器来运行自己创建的服务，另外还需要建立数据库来保存数据。但现在这件事变得容易多了，你可以借助于云计算工具，如谷歌公司的应用引擎（Google's App Engine）以及亚马逊公司的弹性计算云（Amazon's Elastic Compute Cloud），来部署自己创建的网络服务。这些平台不仅可以接受委托管理你的服务，还能在不必支付费用的情况下，让数以千计的用户访问你的服务。可以想象，这些平台为创新提供了巨大的支持。

定制的模板代码

编写API看似令人望而生畏，但令人欣慰的是你不必从零做起。利用某些现成的模板程序让创建App Inventor兼容的API变得非常容易。这些程序由python语言编写，并使用了谷歌应用引擎（App Engine）。模板程序提供了一段样板代码，可以将数据编辑成App Inventor所需要的格式，还提供了一个函数get_value，你可以按自己的需要进行修改。

下载模板程序及使用说明，并将其部署到谷歌应用引擎服务器上，网址是http://appinventorapi.com/using-tinywebdb-to-talk-to-an-api/。你会发现这个链接与第21章创建定制数据库时使用的网址都指向了相同的appinventorapi.com。实际上创建API类似与创建定制数据库，只是不必保存及提取数据，而是通过调用其他服务来获取所需要的数据。

为了创建自己的API，要先下载模板程序，并对几个关键代码做出修改，再上传到谷歌应用引擎。创建一个用TinyWebDB可以访问的API只是几分钟的事情。

以下是从模板程序中选出的一段代码，需要对其进行修改（不必理会那些“#”号后面的文字，它们就像App Inventor中的注释一样，用来说明接下来的代码的功能）：

def get_value(self, tag):
    #在这个简单的例子中，仅返回hello:tag，其中的tag来自于客户端应用
    value="hello:"+tag
    value = "\""+value+"\""
    # 如果value由多个单词组成，为其添加引号
    if self.request.get('fmt') == "html":
        WriteToWeb(self,tag,value )
    else:
        WriteToPhone(self,tag,value)复制代码

这段代码属于一个名为get_value的函数（与App Inventor中的procedure相同）,当你使用TinyWebDB.GetValue函数调用某个API时，需要调用这个函数。tag是函数的参数，并于GetValue中发送的tag相对应。

黑体字的代码是需要修改的部分。默认情况下，该函数从发来的请求中提取tag，并返回“hello：tag”。（也就是说，如果在调用该函数时使用的tag为“joe”，那么函数将返回“hello：joe”）。通过设定变量value的值就可以实现这一点，随后value值将传递给另一个函数：如果请求来自于web，则传给函数WriteToWeb，如果请求来自手机，则传给WriteToPhone。

　提示：即使你从未见过Python或其他程序的代码，根据使用App Inventor的经验，你也可以读懂上面的代码。其中第一行“def get_value”是对过程的定义，“vlue=...”行是为变量value赋值，“if...”后面的代码看起来很熟悉。是的，与App Inventor相比，它们的基本概念是相同的，只是用文字取代了块。

为了定制这段代码，需要将粗体字替换成你需要的某种计算，目的是为了给变量value赋值。通常你的API需要调用其他的API(被称为“封装”调用，更具体地说，就是get_value函数将调用其他的API)。

许多API过于复杂，拥有几百个函数以及复杂的用户认证方案。而另一些则相当简单，你可以找到一些例程，并在网络上访问它们，如下节所述。

封装雅虎金融API

本章所使用的App Inventor专用雅虎股票API就是通过对上述模板程序的修改而获得，该模板程序可以从网上搜索到。为了将雅虎股票API封装成App Inventor可以调用的API，开发者（Wolber教授）在网站http://www.gummy-stuff.org/Yahoo-data.htm【网站地址已经不存在了——译者注】上搜索"Python Yahoo Stocks API"，并发现了如下格式的URL:

http://download.finance.yahoo.com/d/quotes.csv?f=sl1d1t1c1ohgv&e=.cs v&s=IBM

上述URL将一个文本本件“quotes.csv”下载到本地计算机，文件中包含了如下格式的字符串：

"IBM",183.76,"5/29/2014","4:02pm",+0.68,183.68,183.78,182.33,2759978

唐山微信公众号开发【唐山网络推广】唐山建站、唐山网站维护、唐山网页制作、唐山微信小程序代运营公司