微信小程序开发图解案例教程 第4章 必备的微信小程序API

WX.UPLOADFILE(OBJECT)参数说明如表4.2所示。
表4.2 wx.uploadFile参数说明
下面演示一下WX.UPLOADFILE文件上传的使用，将选择的图片 传到服务器里。 （1）创建一个无APPID的项目，微信小程序选中上传的图片，利 用WX.UPLOADFILE上传图片到服务器。 （2）服务器端采用JAVA代码来编写接收文件上传过来的图片信息， 将图片保存到服务器上。 （3）文件上传成功后，利用WX.UPLOADFILE里的SUCCESS回调函数， 可以查看文件是否上传成功，如图4.4所示。
4.1Leabharlann 请求服务器数据APIWX.REQUEST是用来请求服务器数据的API，它发起的是HTTPS请 求，同时它需要在微信公众平台配置HTTPS服务器域名，一个月内 可申请修改3次，否则在有APPID创建的项目中无法使用WX.REQUEST 请求服务器数据这个API，WEBSOCKET会话、文件上传与下载服务器 域名都是如此，配置服务器域名如图4.1所示。
表4.3 wx. downloadFile参数说明
下面演示一下WX.DOWNLOADFILE文件下载接口的使用，服务器传递 一张图片给微信小程序客户端，将其下载到本地，并显示出来。 （1）在WXML文件里，添加IMAGE组件，用来显示服务器传递过来的图片。 <IMAGE SRC="{{SRC}}"STYLE="WIDTH:270PX;HEIGHT:126PX;"></IMAGE> （2）在JS文件里，下载一张服务器的图片，将它的临时路径赋值给 SRC。
图4.2
HTTP请求
从图4.2中可以看出，WX.REQUEST无法请求HTTP域名的服务器。 访问服务器路径的时候，会到公众开发平台里去找我们配置的 HTTPS服务器域名，如果域名存在，就可以访问，否则不可以访问。 DATA数据说明最终发送给服务器的数据是STRING类型，如果传入 的DATA不是STRING类型，会被转换成STRING类型。
2．请求HTTPS服务器数据 服务器返回数据如图4.3所示。
图4.3
服务器返回数据
CONTENT-TYPE默认为'APPLICATION/JSON'，客户端的HTTPS TLS版本为1.2，但ANDROID的部分机型还未支持TLS1.2，所以请 确保 HTTPS服务器的TLS版本支持1.2及以下版本；要注意METHOD 的VALUE必须为大写（例如：GET）；URL中不能有端口；REQUEST 的默认超时时间和最大超时时间都是60S，REQUEST的最大并发数 是5，网络请求的REFERER是不可以设置的，格式固定为HTTPS:// /{APPID}/{VERSION}/PAGE-FRAME.HTML，其 中{APPID}为小程序的APPID，{VERSION}为小程序的版本号，版 本号为0表示为开发版。
图4.1
配置服务器域名
WX.REQUEST(OBJECT)参数说明如表4.1所示。
表4.1 wx.request参数说明
下面演示WX.REQUEST请求服务器数据API的使用。 1．请求HTTP服务器数据 在JS文件中的ONLOAD函数里，使用WX.REQUEST请求猫眼电影 HTTP服务器数据。 请求错误信息如图4.2所示。
转换规则如下： 对于HEADER['CONTENT-TYPE']为'APPLICATION/JSON'的数据，会 对数据进行JSON序列化； 对于HEADER['CONTENT-TYPE']为'APPLICATION/X-WWW-FORMURLENCODED'的数据，会将数据转换成 QUERY STRING （ENCODEURICOMPONENT(K)=ENCODEURICOMPONENT(V)&ENCODEURIC OMPONENT(K)=ENCODEURI COMPONENT(V)...）。
4.2
文件上传与下载API
文件上传与下载API是我们经常会用到的API，它可以用来与 服务器进行文件的上传与下载，比如微信小程序客户端向服务器 传输一些图片，或者从服务器那里获得一些图片，这时就可以使 用文件上传与下载API，它们请求服务器地址也需要在微信公众 平台里进行配置。
4.2.1 WX.UPLOADFILE文件上传
界面效如图4.5所示。
图4.5
下载图片
WX.DOWNLOADFILE?文件下载最大并发限制是10个，默认超时时间和 最大超时时间都是60S,网络请求的REFERER是不可以设置的，格式固定为 HTTPS:///{APPID}/{VERSION}/PAGE-FRAME.HTML，其 中{APPID}为小程序的APPID，{VERSION}为小程序的版本号，版本号为0 表示为开发版。
4.3
WebSocket会话API
WEBSOCKET会话用来创建一个会话连接，创建完会话连接后 可以相互通信，像微信聊天和QQ聊天一样，进行通信。它会涉及 以下7个API的使用： （1）WX.CONNECTSOCKET(OBJECT)创建一个会话连接； （2）WX.ONSOCKETOPEN(CALLBACK)监听WEBSOCKET连接打开事件； （3）WX.ONSOCKETERROR(CALLBACK)监听WEBSOCKET错误；
微信小程序开发图解案例教程
第4章 必备的微信小程序API
请求服务器数据API ■ 文件上传与下载API ■ WEBSOCKET会话API ■ 图片处理API ■ 文件操作API ■ 数据缓存API ■ 位置信息API ■ 设备应用API ■ 交互反馈API ■ 登录API ■ 微信支付API ■ 分享API ■ 沙场大练兵：仿豆瓣电影微信小程序 ■ 小结 ■
图4.4
回调函数返回值
4.2.2 WX.DOWNLOADFILE文件下载
WX.DOWNLOADFILE是文件下载的API，WX.UPLOADFILE是文件 上传的API，WX.DOWNLOADFILE与WX.UPLOADFILE正好相反，是从 服务器获得数据，下载到微信小程序客户端本地，参数说明如表 4.3所示。