本文适用于WeX5 3.2及以下版本,3.3及以上版本请参阅“Baas for .NET”

1、概述

baas是WeX5的轻量级后端服务框架,可以用于为WeX5页面快速构建后端数据服务。WeX5版本中在”apache-tomcat\webapps\baas”目录下自带了Java的版本,这里带来的是它的孪生兄弟.NET版本。

2、案例部署与测试

2.1、部署

1、下载baas.net.zip,解压到D:\baas.net。

2、打开IIS管理工具,在网站下面“添加应用程序”:

baas.net.01

(别名:baas.net;物理路径:d:\baas.net;应用程序池:ASP.NET v4.0)

baas.net.01.1

3、进入X5开发工具,打开“/UI2/demo/baas/baas.js”,修改BASE_URL与上面的配置一致。

baas.net.02

4、启动X5自带的MySql数据库,启动X5自带的Tomcat

(数据库的配置在“D:\baas.net\App_Code\ X5BaasService.cs”中)

5、打开浏览器,进入“http://loalhost:8080”,打开里面的外卖及baas相关案例,这时的数据就是来源于.NET的后端baas服务了。

baas.net.03

2.2、测试

如果上面的过程顺利的话,那么打开外卖就能看到菜单,就能下订单了。但是由于大家各自的环境差异,难免会遇到各种问题。下面提供一系列的测试手段,希望能帮助大家快速定位解决问题。

  • 首先判断IIS是否部署成功和URL是否正确

用浏览器访问“http://127.0.0.1/baas.net/index.html”,正常的话应该显示hello。

baas.net.04

如果这里就没通过,那么先去检查IIS是否启动,检查网站配置的端口是否是80。如果不是也没关系,可以按你自己的配置来,把baas.js里面的BASE_URL改一致就好了。

  • 判断.NET应用服务是否能正常运行

用浏览器访问“http://127.0.0.1/baas.net/X5BaasService.asmx/HelloWorld”,正常的话应该显示外面案例中的菜单数据。

baas.net.05

如果是这里没通过,那么首先参照上面IIS配置的要求进行检查,重点是.NET版本。

如果是提示数据库异常,请检查数据库是否启动,数据库配置是否与“D:\baas.net\App_Code\ X5BaasService.cs”中的配置相同。

baas.net.06

 

baas.net.07

 

如果上面几项都没问题,那么接下来就可以确定服务已经正常了。如果baas.js中的BASE_URL配置正确的话,那么就可以正常运行了。如果要跨机器访问的话,关注一下防火墙就可以了。

3、开发扩展与调试

大家可以基于baas.net去自己扩展,实现自己的后端服务。用Virsual Studio 2015(我用的就是这个版本~)打开网站,选择“D:\baas.net”就可以了。

baas.net.08

 

baas.net.09

Virsual Studio中F5进入调试模式,会自动启动IIS Express做为调试服务(.NET程序员都知道的了)。这里唯一要注意的是:将baas.js的BASE_URL改成IIS Express提供的地址就好了。

  • 浏览器中调试

开发过程中总会遇到各种问题,我们经常需要查看ajax的执行是否成功,查看执行结果,我们可以利用浏览器的开发人员工具来进行监控。下面我简单展示在Chrome中的调试方法。

  • F12打开“开发人员工具”,选择Network页,然后运行功能。在列表中可以监控网络请求的返回。

baas.net.10

  • 控制台错误监控

baas.net.11

 

上面的错误“Access-Control-Allow-Origin”很像是跨域访问的错误,但事实上是由于发生异常,导致请求返回的头部中少了支持跨域访问的信息。大家仔细找一下从返回的内容里是找到真正的错误信息的。

4、代码结构

baas.net.12

代码里有完整的注释,类库结构和调用方法都与Java版本基本一致,大家也可以参考Java版本的相关文档http://doc.wex5.com/wex5-baas-guide/。

本文由WeX5君整理,WeX5一款开源免费的html5开发工具H5 App开发就用WeX5!

阅读其他app 开发相关文章:http://doc.wex5.com/?p=3443