AFA4J Java引擎组件参数填写规则说明书.docx

1、AFA4J Java引擎组件参数填写规则说明书Java引擎组件参数填写规则说明书项目名称AFA4J项目代号文档名称Java引擎组件参数填写规则说明书文档版本V0.1起草刘戈，林智、李儒汉、林盛、林耿彬起草日期20151117审批刘戈审批日期版权声明：本文档的版权归北京赞同科技有限公司所有，XX不得复制和引用。本文档若有改动，恕不另行通知。本书约定：1、通用格式约定宋体：正文采用小四宋体。 楷体：警告、说明等提示等内容一律用楷体，并且在内容前后增加线条与正文隔离。 屏幕显示描述：对于来自屏幕的显示信息，采用如下格式：英文Courier New ，中文宋体，文字大小为小四号；信息中夹杂的用户从终端

2、输入的信息，使用加粗字体表示。2、各类标志本书还采用各种醒目标志来表示在操作过程中应该特别注意的地方，这些标志意义如下： ：警告、危险、提醒操作中应注意的事项。 ：说明、注意、提醒操作中应注意的事项。变更记录序号修改内容页号修改人完成日期123456注：对该文件内容增加、删除或修改均需填写此变更记录，详细记载变更信息，以保证其可追溯性。第一章 概述 本文档用于描述AFA4J 2.0 Java引擎技术组件参数填写规则，Java引擎是一个纯Java的脚本引擎（技术组件用Java编写、业务组件及服务流程编译成Java语言），因此原生就支持Java语言规范的参数填写方式（例如获取_REQ_里的name

3、字段： _REQ_.getItem(“name”)， getItem是_REQ_对象的一个方法）。鉴于Java语言方式操作字典、列表、JavaBean过于繁琐，因此AFA4J同时支持类Python语法的参数填写方式（例如获取_REQ_里的name字段： _REQ_“name”），以简化参数填写，提高应用的开发效率。第二章 入参 本章主要描述技术组件入参的填写规则，涵盖了Java语言的各种常见的类型：基础数据类型、String、JavaDict、JavaList、其它类型。二.1 基础数据类型基础数据类型的填写遵守Java语言规范，例如 ：1、 int ：1 2、 long：1 或者 1L3、

4、short: 14、 float：0.1 或者 0.1f5、 double：0.1或者 0.1d6、 byte：0X01或 17、 char：x8、 boolean：ture 或者 false范例：技术组件定义：public static TCResult calculate(int a1,long a2,short a3,float a4,double a5,byte a6,char a7,boolean a8)参数填写：入参一：1，入参二：1，入参三：1，入参四：0.1，入参五：0.1，入参六：0X01， 入参七：y，入参八：true二.2 StringString的填写规则遵守Java语

5、言规范，例如： “xxxxx” 或者 “xx” + “yy” 或者 “xxx” + 1 或者 “xxxx” + _REQ_（相当于”xxxx” + _REQ_.toString()）。注意：Java引擎的字符串要用双引号包住，例如：“xxx” / 合法xxx / 非法二.3 JavaDictJavaDict类似Python的dict，key是String类型，value可以是任何类型的数据。二.3.1 字典取值JavaDict的取值方式与Python的dict方式一致，例如：1、 获取_REQ_的name字段值：_REQ_“name”2、 获取_REQ_的student字段的name字段值：_

6、REQ_“student”“name”，其中_REQ_的student字段值的类型是JavaDict3、 获取_REQ_的_REQ_“student”字段值：_REQ_REQ_“student”4、 获取_REQ_的list字段的第_REQ_“i”个值：_REQ_“list”_REQ_“i”.toInt()，其中_REQ_的list字段值的类型是JavaList范例：技术组件定义：public static TCResult calculate(int a1,String a2)参数填写：参数一：_REQ_“age”，参数二：_REQ_“name”二.3.2 创建字典JavaDict的创建方式

7、与Python的dict方式一致，例如：“name”: “richie”, “age”: 18, “address”: _REQ_“addr” key必须是String， value可以是任何类型，可以填写常量（如：18），也可以填写变量（例如：_REQ_“addr”）。JavaDict可以嵌套JavaDict或JavaList，例如：“name”: “richie”, “address”: “province”: “广东” 范例：技术组件定义：public static TCResult calculate(JavaDict a1)参数填写：参数一：“name”: “richie”二.4 J

8、avaListJavaList类似Python的list，value可以是任何类型的数据。二.4.1 列表取值JavaList的取值方式与Python的list方式一致，例如：1、 获取list的第一个元素：list02、 获取list的第一个元素的第一个元素：list00，其中list第一个元素的类型是JavaList3、 获取list的第_REQ_“i”个元素：list_REQ_“i”.toInt()范例：技术组件定义：public static TCResult calculate(int a1,String a2)参数填写：参数一：list0，参数二：names0二.4.2 创建列表J

9、avaList的创建方式与Python的list方式一致，例如：“richie”, 18, _REQ_addrvalue可以是任何类型，可以填写常量（如：18），也可以填写变量（例如：_REQ_“addr”）。JavaList可以嵌套JavaDict或JavaList，例如：“richie”, 18, 2, 3, 4, “name”:”sam”范例：技术组件定义：public static TCResult calculate(JavaList a1)参数填写：参数一：“richie”, 18, _REQ_addr二.5 其它类型本节描述其它类型（自定义、JDK自带）的取值规则，以下以User

10、类为例子说明自定义类型的取值规则。User类定义：package demo;public class User private String name;public void setName(String name) this.name = name;public String getName() return name;如果要取User对象的name属性的值，有以下两种方式：1、 调用对象方法，如：(demo.User)_REQ_“user”).getName()2、 类python语法，如：_REQ_“user”(“name”)，在对象后面以圆括号取属性的值。其中_REQ_“user”是一

11、个User对象。二.6 类型转换支持在填写参数时做类型转换，如： _REQ_xxx.toStr()， 把_REQ_xxx转成String _REQ_xxx0.toInt()， 把_REQ_xxx0转成int_REQ_xxx(yyy).toBoolean()， 把_REQ_xxx(yyy)转成boolean_REQ_innerDict1.asDict()， 把_REQ_innerDict1转成JavaDict_REQ_innerDict1innerDict2.asDict()， 把_REQ_innerDict1innerDict2转成JavaDict 支持的转换函数有：toStr()、toShort()、toInt()、toLong()、toFloat()、toDouble()、toBoolean()、asDict()、asList()第三章 出参 技术组件出参只能存放在容器内，只能以如下所示形式填写：dict“name” 或 dict“subdict”“name”或dict“subdict”“name”.其中dict只能是_REQ_或_RSP_或_BUILTIN_