UAP_Mobile_JS编程API.docx

UAP MobileJS编程框架与编程模型此部分要记录该文档形成过程中的历次版本变更过程及变更的内容版本修改与参与人修改时间修改原因修改内容审批人V1.0勾成图2013-09-01原始文档建立勾成图V2.0勾成图2013-12-3更新至V2.0勾成图V3.0杜莎莎2015-01-04更新至V3.0概述本文将描述UAP Mobile端上的JS编程框架和编程模型，其中包括如下内容：JS编程框架JS数据编程模型JS控件编程模型JS编程JSController每一个页面都对应有一个JSController文件和一个JSControllerBase文件JSCotrollerBase是自动生成框架代码文件，JSController是书写JS代码逻辑的地方ControllerBase文件为系统框架文件，框架自动调用，每次生成代码都会重新生成Controller文件框架扩展文件，即应用开发人员代码文件，仅仅生成一次，删除后会重新生成每一个JSController文件中都有一个JSController类每一个控件的事件处理函数都在JSController中有对应的function生成Controller代码生成JSController代码有两种方式：双击控件生成事件处理函数双击生成的默认JS方法名为“控件id_onEvent”的形式，可以再属性栏中修改默认JS方法名。例如：label id=label19onclick=this.label19_onclick()点击选择/label其含义是当点击label19的时候，会执行JSController中的label19_onclick方法。其中this的含义代码当前JSController。选择页面文件通过鼠标右键菜单生成每一个window都对应一个Controller和一个ControllerBase，通过设计器可以生成指定window的jscontroller。操作如下：通过Action定义一个JS方法Action可以被事件调用Action都对应于JSControllerBase中的一个function，function的名称是Action的IDAction中的Method都对应于JSController类中的一个function，function的名称是method的值开发人员的JS代码逻辑只能写在JSController的function中每次生成JSController都会自动重新生成JSControllerBase文件JSController文件只会在第一次自动生成，除非删除后生成。DSL定义如下：com.yonou.um.View1中有action定义如下action id=myload method=login/生成JSController后，在com.yonyou.um.view1ControllerBase中会有一个myload function在com.yonyou.um.view1Controller中会有一个login的function数据（Context）编程基本概念基于Context的编程实际上是对数据结构进行编程，通过JS代码来对当前页面的数据结构进行操作来完成自己的业务逻辑。理解Context编程需要理解以下几个基本概念数据上下文Context绑定字段数据绑定数据上下文Context我们规定一个页面有且仅有一个数据上下文对象Context，在JS中通过$ctx对象访问Context是当前页面的数据源Context内部的数据结构是一个JSONObject，即一个JS 的JSON对象Context中的字段对应JSONObject中的一个Key-Value，字段名是Key，字段值是Value通常情况下；一个页面的数据结构总是一个JSONObject一个简单控件（例如Label、input）对应的一个字段一个列表对应的数据结构式JSONArray，同时JSONArray是Context中的一个字段Context API常用的API如下：$ctx.getString()//获取整个Context的字符串形式$cts.getString(fieldName)//获取指定字段的值，以字符串形式返回$ctx.getJSONObject()//获取整个Context的值，以JSONObject形式返回$ctx.getJSONObject(fieldName)//获取指定字段的值，以JSONObject形式返回$ctx.getJSONArray(fieldName)//获取指定字段的值，以JSONArray形式返回$ctx.put(fieldname,value)//修改执行字段值，不执行数据绑定$ctx.push(json)//重新提交Context，并自动实现数据绑定$ctx.d