EAS扩展脚本编写指南.

定制平台系列扩展脚本编写指南简介扩展脚本运行引擎为Rhino，基于javascript语法，运行期解释执行。

jvm中的类的方法和属性均可应用于脚本中，调用方式类似于java代码编写。

其处在with(easNames){ …}中，所以不需要指定其全路径，即可调用getRemoteInstance()方法。

如果没使用with指定作用域，则必须使用全名称（包名+类名）。

变量的定义声明遵循javascript语法，接口实现使用function声明。

比如给一些控件增加监听器：上下文扩展脚本中封装了两种上下文，插件上下文（pluginCtx）和方法上下文（methodCtx）。

这两种上下文为系统内置，无需额外的声明或获取。

pluginCtx主要存放当前执行环境的相关信息，比如服务端的Context，客户端的界面控件、界面状态、编辑对象等。

methodCtx存放当前操作的相关信息，包含方法参数和方法返回值。

插件上下文：客户端和服务端的插件上下文存储的内容不一样，实现方式上，其分别对应于两个java类，com.kingdee.eas.ep.app.BeanParam和com.kingdee.eas.ep.client.UIParam。

这两个类中的方法均可以在脚本中直接使用。

上下文都存在get和put方法。

脚本中直接使用get(key)获取值，put(key,value)设置值。

客户端插件上下文封装了部分常用的内容，具体如下：直接通过pluginCtx调用即可，比如pluginCtx.getUI即可获取当前界面实例。

界面的控件可以通过get + 控件类型+ ( + 控件名+)的方式获得，比如获取单据分录的表格可以这样pluginCtx.getKDTable("kdtEntries")。

方法上下文：方法上下文存放了方法的相关信息，包括方法参数和方法返回值。

方法上下文提供了如下常过methodCtx.getParamValue(0)来获得model。

同时可以通过methodCtx.getResultValue()来获得方法的返回值。

注意：设置方法的返回值必须通过methodCtx.setResultValue(value)来设置，不可以用类似方法返回值的方式写（return value）。

可以通过定制平台的扩展定义中的上下文来快速编写一些常用脚本。

自定义业务方法在实体或Façade中新增一个业务方法后，如何调用该业务方法？自定义业务方法的调用是通过工具类来实现的。

工具类主要需要三个参数：元数据PK （IMetaDataPK pk），方法名称（String methodSignature），参数对象数组（Object[] args）。

其中方法名称请从该业务方法的扩展点的描述信息中拷贝获得，否则容易出错，如果方法没有返回值，注意名称前有空格，不要删除。

com.kingdee.bos.framework.BOClientTool.callCmethod(pk,methodSignature,args)com.kingdee.bos.framework.BOProxy.getProxy(ctx,pk).callCmethod(methodSignature,args)自定义异常业务异常定义后，可以通过工具类抛出异常。

服务器端调用方式：com.kingdee.eas.ep.plugin.ExceptionUtil.throwOnServer(pluginCtx.getContext(),name,subName, args)其中参数为：Context ctx-服务器上下文String name-异常名称String subName-子异常名称Object[] args-参数对象数组，可删去args[i]中的内容将会替代对应的{i}中的内容，如果没有参数，可以省略该参数。

客户端调用方式：com.kingdee.eas.ep.plugin.ExceptionUtil.throwOnClient(name,subName,args)参数含义如上。

自定义基础资料或单据定制平台支持自定义基础资料和单据的实现原理是先通过内置的模板拷贝生成新的动态元数据，然后通过模板这个壳来运行。

新生成的元数据可进行业务调整。

所有对动态内容的操作，最终都转换为对模板的操作，模板根据具体元数据的信息，进行相应的转换后，再执行操作。

模板通过EAS系统内置产生，目前只内置了基础资料和单据两种模板。

其他模板请到【定制模板】功能中查看。

业务单据的模板信息为：下面通过对基础资料的相关操作来展示如何在脚本中应用动态内容。

客户端调用新增、修改、查询等动作首先需要一个远程接口，可通过如下方式获得：”com.kingdee.eas.custom.app.Diploma”。

返回值为com.kingdee.eas.ep.IDataBaseCustom类型，这是由于其从该模板生成所致。

这样IDataBaseCustom上的所有操作，动态基础资料都有，也均可以通过该实例执行。

比如，新增操作ORMMapping的。

删除、更新、查看等动作由于值对象都存在id，所以其可以自动解析获得，不需要手工设置。

调试如果想调试某段脚本，请在扩展定义中勾选“调试模式执行”。

这样，在脚本运行时会弹出脚本调试窗口。

注意：如果调试的脚本为服务器端脚本，即实体或façade中基于业务方法编写的脚本，则必须在定制平台中启动“脚本远程调试”，否则将会抛出BOS异常，提示启动远程调试服务器。

调试支持单步执行、断点设置、变量查看、脚本控制台等。

关于Rhino/rhino/Rhino is an open-source implementation of JavaScript written entirely in Java. It is typically embedded into Java applications to provide scripting to end users.Rhino语法简介Rhino 是一种使用Java 语言编写的JavaScript 的开源实现。

与本系列的其他很多语言一样，Rhino 是一种动态类型的、基于对象的脚本语言，它可以简单地访问各种Java 类库。

Rhino 从JavaScript 中借用了很多语法，让程序员可以快速编写功能强大的程序。

最为明显的区别是，Rhino 不再使用语句结束符( ; )，放宽了变量声明规则，并且极大地简化了修改和检索对象属性的语法（没有求助于调用存取方法）。

由于Rhino 是JavaScript 的一种基于Java 的实现，所以对于Java 开发人员来说，它应该特别易于使用。

JavaScript 的（以及Rhino 的）语法非常类似于Java 编程语言。

这两种语言都采用了与Java 编程语言相似的循环和条件结构，并且遵循类似的语法模式来表示这些结构。

历史简介在开始学习Rhino 基础知识之前，先了解一下有关JavaScript 的起源和目的可能会非常有用，JavaScript 为Rhino 提供了很多独特的特性。

JavaScript 的历史与Web 浏览器动态表示和操作Web 页面内容的能力是相符合的。

JavaScript 的第一个版本（最初称为LiveScript）是由Netscape Communications 公司于1995 年发布的，它是Netscape Navigator 2.0 Web 浏览器的一部分。

JavaScript 打算为程序员提供一种简单而直观的方法，编写一些可以在Web 页面上下文中执行任务的简单脚本。

在随后的一年中，Microsoft 引入了JScript，它自己的用于Internet Explorer 的JavaScript 端口。

这两个版本的JavaScript 都包括一个基于对象的API，称为文档对象模型（Document Object Model）或DOM，用以访问和操作Web 页面的内容。

JavaScript 的第三个实现是一种新的脚本语言，称为EcmaScript，其目的是对自己和DOM 进行标准化。

不幸的是，Microsoft 和Netscape 都没有完全实现EcmaScript 标准，因此到今天都还存在兼容方面的问题。

随着Java 语言在20 世纪90 年代末期取得的成功，Netscape 计划发布Javagator，它是Navigator 中一个100% 的纯Java 实现。

虽然Javagator 从来没能开花结果，但是Netscape 对JavaScript 的移植（称为Rhino）已经经过时间的考验存活了下来。

Rhino 是JavaScript 1.5 脚本语言的一个100% 的纯Java 实现，不包含DOM API。

实际上，Rhino 有时仍然被当作Netscape 的基于Java 的JavaScript。

JavaScript 中的"Java"在Rhino 的第一个发行版本中，Netscape 显然想利用Java 编程语言所取得的成功。

在该公司自己的脚本语言中，很明显地从Java 语言中借用了一些基本的语法。

这使得它特别适合Java 开发人员学习和使用。

例如，考虑一下清单 1 中给出的Java 函数与Rhino 函数之间的相似性，Rhino 函数测试了给定的数字是否为素数：清单1. Rhino 函数：这个数字是素数吗？function isPrime (num){if (num <= 1) {print("Please enter a positive integer >= 2.")return false}var prime = truevar sqrRoot = Math.round(Math.sqrt(num))for (var n = 2; prime & n <= sqrRoot; ++n) {prime = (num % n != 0)}return prime}除了几处例外，该程序与Java 程序非常类似：圆括号用来分隔代码块。

for 和if 结构的语法与Java 语言的相同。

Rhino 与Java 语言采用相同的算术和条件操作符（例如，对sqrRoot变量的赋值），甚至可以支持类似的访问其他算术函数的方法。

Rhino 允许使用预先定义的布尔常量true 和false 。

虽然没有在这里显示，但您应该注意到，Rhino 的while 和do...while 循环的结构都与Java 语言的相同。

具体区别当然，Rhino 和Java 语言之间有一些显著的区别。