TDSjava开发工具使用说明.docx

TDS开发工具使用说明书

一：简要说明

开发工具配套于TDS平台，旨在方便用户在TDS平台下方便的进行交易开发、渠道开发、报文配置、平台文件配置(app.xml)、测试等一系列操作；

开发思想：

项目内容部署在TDS平台服务器上，启动开发工具时，需要用户输入相应的IP和用端口（默认1985）；工具会将该IP下启动的平台中的应用下载到本地，用户使用开发工具对应用中的内容进行编辑，编辑完成保存，在本地保存的同时，会将文件内容同步到TDS服务端相应的文件中；

提供针对不同类型文件编辑特别是XML编辑时的图形化界面；以拖拽式的开发便捷的提供XML节点编辑和开发；编辑器会根据不同类型的文件和平台特性，提供一些默认值，这样减少了用户在编辑过程中由于粗心造成的错误；拖拽式开发，自动生成代码；方便用户进开发；

二：开发说明

1：开发模式划分

TDS平台的主控开发也即应用开发目前支持两种语言，一种是XML格式的开发一种是Java格式的开发，开发工具提供相应的两种模式开发的透视图，用户根据自己的习惯或者需求选择不同的开发透视图进行相应的应用开发，两种不同的透视图开发模式：

TDS开发透视图

TDSJava应用工程

TDS开发透视图：负责开发以XML为主控开发语言的交易开发；

TDSJava应用工程视图：负责开发以Java为主控开发语言的交易开发；

两种开发模式：

关于两种开发模式的说明：在两种不同的透视图中，提供的菜单是不同的，在TDS开发透视图中，主要提供针对XML过程中需要的菜单，在TDSJava开发透视图中，则只提供关于Java开发过程中需要的菜单选项，但是两种透视图可随时切换，需要不同的菜单即可切换到不同的透视图下进行开发；应用工程本身与透视图没有关系；

2：TDS向导及编辑器使用

默认情况下，打开eclipse后，默认是在TDS开发透视图模式下，此模式下提供的菜单包括以下：

新建TDS应用：新建一个TDS应用工程（XML格式）；

新建主控文件：在当前应用下新建一个XML格式的主控文件，进行相应的交易代码编写；

新建渠道：在当前应用下新建一个XML格式的渠道文件；

新建测试报文：新建测试报文，对渠道、交易或者工作流进行测试工作；

新建文件：新建普通文件；

新建文件夹：新建文件夹；

新建Other

新建TDS应用Java工程：新建一个TDS应用工程（Java格式）；

新建TDS应用和新建TDS应用工程：这两个向导新建的目录结构基本相同，只是新建TDSJava应用工程是针对Java格式开发的应用工程，所以会在构建路径中，添加平台需求的jar包，并提供src目录里进行相应的java开发；用户编辑java源文件后，生成的class文件，工具会将该class文件同步到服务端相应的应用下的classes文件夹下，classes文件夹是平台是别的class文件存放位置；

新建TDS应用（xml）

向导为：

新建后目录结构：

目录结构介绍：

dat：应用使用文件（上传下载的文件、报表文件等）

etc：平台主要的xml文件

atr：存放渠道文件

ctl：存放主控交易文件

itf：存放报文配置ITF文件

test：存放测试文件

app.xml：平台配置文件

新建TDS应用Java工程（Java）：

Src：存放java源文件

Classes：存放java源文件相应的class文件

其他目录同上

新建交易定义文件（java）：

切换到TDSJava应用工程透视图下，右键新建java文件即可

新建JavaClass类之后，平台会生成java交易开发的模板内容，用户在AroundInvoke注解中进行before和after操作；在@Code注解中指定交易码，并进行交易开发；

交易定义文件编辑（java）：

新建交易定义文件（xml）：

右键应用下的etc目录下的ctl目录，出现新建交易菜单：

向导为：

新建结果：

XML格式的主控开发为图形化界面的拖拽式开发；右侧Palette提供平台支持的所有XML节点标签，用户点击右侧相应的节点，到左侧即可添加相应的节点到该XML文件，提供两页进行编写，左侧为图形化开发，第二页为code页（代码页）；

新建渠道：

右键应用下的etc目录下的atr目录，出现新建渠道菜单：

新建结果：

新建ITF报文配置文件：

在TDS透视图模式下，工程目录的etc目录下的itf文件夹上，右键出现新建itf报文菜单：

新建ITF报文向导为：

新建结果为：

新建测试报文：

右键应用目录下的test文件夹，新建测试文件报文：

新建文件：

在TDS开发透视图下，新建File出现以下向导，输入新建文件名称即可：

编辑器使用说明：

主控交易编辑器（xml）使用说明：

提供设计页