CSP应用服务端开发快速入门手册

1、CSP应用服务端开发快速入门手册CSP应用服务端开发快速入门手册包括以下几个主题：环境搭建创建工程EO建模BO建模数据初始化部署测试1. 环境搭建JDK：1.7 （64位）下载地址： HYPERLINK /technetwork/java/javase/downloads/jdk7-downloads-1880260.html/technetwork/java/javase/downloads/jdk7-downloads-1880260.html设置环境变量：JAVA_HOME，指向 JDK安装目录， Path环境变量中增加：%JAVA_HOME%bin;具体可参考： HYPERLINK /

2、article/f96699bb8b38e0894e3c1bef.html/article/f96699bb8b38e0894e3c1bef.htmlMaven：3.0.5下载地址： HYPERLINK /download.cgi/download.cgi1、配置环境变量：MAVEN_HOME，指向 MAVEN安装目录,Path环境变量中增加：%MAVEN_HOME%bin;具体可参考： HYPERLINK /article/cb5d61050b8ee7005d2fe04e.html/article/cb5d61050b8ee7005d2fe04e.html2、请使用 HYPERLINK ./

3、files/settings.xml附件./files/settings.xml覆盖%MAVEN_HOME%/conf/settings.xmlGeronimo：3.0.1下载地址： HYPERLINK /downloads.html/downloads.html1、 修改geronimo设置：geronimo安装目录bingeronimo： JAVA_OPTS=-Xmx2048m -XX:MaxPermSize=512m2、 安装postgresql的JDBC驱动包jdbc41-9.3.1100.jar，安装路径为：geronimo安装目录repositoryorgpostgresqljdb

4、c419.3.1100jdbc41-9.3.1100.jar3、 安装jar包geronimo-system-3.0.1.jar，安装路径为： repositoryorgapachegeronimoframeworkgeronimo-kernel3.0.1geronimo-kernel-3.0.1.jar；下载地址： HYPERLINK ./files/geronimo-system-3.0.1.jar./files/geronimo-system-3.0.1.jar 4、安装jar包geronimo-system-3.0.1.jar，安装路径为：repositoryorgapachegero

5、nimoframeworkgeronimo-system3.0.1geronimo-system-3.0.1.jar；下载地址： HYPERLINK ./files/geronimo-system-3.0.1.jar./files/geronimo-system-3.0.1.jar5、 打开geronimo安装目录varconfigconfig.xml，修改下列几行，不加载这些moduleEclipse：4.2+ （推荐4.3+，已集成Maven插件，64位、JAVAEE版本）下载地址： HYPERLINK /downloads/downloads/1、 安装maven插件：通常已集成mave

6、n插件，判断是否集成maven插件：Windows-Preferences-Maven是否存在。如果没有集成，请安装maven插件：Help-Install New Software-Add-Locaton，Name设置插件名称（可随意），location为插件地址： HYPERLINK /sites/m2e/sites/m2e2、 配置maven：Preferences-Maven-User Settings3、 安装geronimo插件：Help-Install New Software-Add-Locaton，Name设置插件名称（可随意），location为插件地址： HYPERLIN

7、K /dist/geronimo/eclipse/updates/dist/geronimo/eclipse/updates4、 配置geronimo：Preferences-Server-Runtime Environments-Add/edit5、 安装cspide插件com.chanjet.csp.ide.2.0.0.jar，安装路径：eclipsedropins；下载地址： HYPERLINK ./files/com.chanjet.csp.ide.2.0.0.jar./files/com.chanjet.csp.ide.2.0.0.jar；安装geronimo server depl

8、oy app功能扩展包com.chanjet.csp.geronimo_3.0.1.jar，安装路径：eclipsedropins；下载地址： HYPERLINK ./files/com.chanjet.csp.geronimo_3.0.1.jar./files/com.chanjet.csp.geronimo_3.0.1.jar；安装jar包geronimo-kernel-3.0.1.jar，安装路径：eclipsepluginsorg.apache.geronimo.runtime.v30_3.0.1libgeronimo-kernel-3.0.1.jar；下载地址 HYPERLINK .

9、/files/geronimo-system-3.0.1.jar./files/geronimo-system-3.0.1.jar；安装jar包geronimo-system-3.0.1.jar，安装路径：eclipsepluginsorg.apache.geronimo.runtime.v30_3.0.1libgeronimo-system-3.0.1.jar；下载地址 HYPERLINK ./files/geronimo-system-3.0.1.jar./files/geronimo-system-3.0.1.jar。PostgreSQL：9.2+ （64位）下载地址： HYPERLIN

10、K /download/download/， 安装结束后，勾选stack builder下载和安装附加工具Spatial Extensions/PostGIS 2.0 for PostgreSQL，以便数据库支持PostGIS模板，安装过程中需要输入用户名和密码，本例创建了一个用户名postgres，密码1。GIT1、安装Git： HYPERLINK http:/msysgit.github.io/http:/msysgit.github.io/， 配置环境变量：Path中增加：git安装目录bin;2、安装TortoiseGit： HYPERLINK /2. 创建工程本工程以货物查询为例，简

11、单说明具体CSP应用服务器端的开发流程。 货物是一个物流公司具体存储的客户产品，是物流公司与客户之间的协议，货物信息具体包括货物编码，货物名称，货物类型，收货时间、送货时间、备注以及所属客户等信息。2.1 准备工作1、创建postgresql数据库（截图来自pgAdmin）如下图所示：名称为csp_test，如下图所示：模板必须选择gis模板，如下图所示：2、启动eclipse后，配置一下自己的开发信息：点击windows-preferences菜单，选择CSP-App： Archetype选择releases版本。输入enterpriseId和isv code，如下图所示：3、创建geron

12、imo server，如下图所示：点击 create new server，选择geronimo v3.0-finish。2.2 创建新工程创建一个名称为testCSP的项目2.2.1 创建testCSP项目点击菜单：File-New-Other，选择Chanjet CSP - 创建一个CSP APP工程-Next输入App名称testCSP，并点击更新按钮后在下拉框中选择最新的App模板，如下图所示，其中2.1.22为目前最新版本，其他的可以选择默认，点击Next字段说明如下：App名称：必填，同时也会作为eclipse工程的名字；Location：App工程的上级目录，比如说截图里的APP

13、会生成到D:worktestCSP；App模板：请选择最新的模板。模板是缓存到本地的，想获取最新的模板时，请单击后边的“更新”按钮，再进行选择；App版本号：要开发的app的版本号，默认1.0；模型布局共享给所有开发者：csp插件提供了可视化的建模工具，可视化视图中的节点摆放的位置等信息是否所有人共用同一配置，不勾选的话，节点的位置信息只会保存在各个开发者自己本地机器上。2.1.2 配置app在配置app的对话框中进行配置：这一步要输入申请创建app时，由CSP平台提供给开发者的一些信息（申请方法请参考开发者社区上的app开发流程），如果只是随意测试的话，可以勾选上“使用测试专用的默认配置”，

14、CSP平台提供了一个默认的testisv账号供开发者测试使用。这里我们选择使用测试专用的默认配置，效果如下，点击Next2.1.3 配置数据库连接这里配置的数据库，则为准备工作时创建数据库所用到的信息，见图2.1.4 创建完成Finish：工程创建完成，工程会自动加入到geronimo server中。创建出工程后的视图如下：注：工程创建完，第一次build all前，pom.xml文件报错属于正常现象，如图所示：3 EO建模从生成的项目结构图中可以看到，工程的根目录下有两个文件：entities.cspeo和entities.cspbo，其中cspeo用来eo建模，cspbo用来bo建模。E

15、O建模：创建 实体对象、实体关联、枚举；BO建模：在EO的基础上，对EO增加业务操作、关联字段引用、属性校验规则、创建Picker、创建NameQuery等等。本工程的主要功能是对货物进行相关查询等功能，故需要先创建货物的实体，进行EO建模。打开工程下的entities.cspeo，下图标出了设计器的各个区块：新建项目后生成的entities.cspeo中包括了一些实体内容，如不需要可以直接删除。在本项目中将其中内容清空，如下图：3.1 创建实体和枚举根据需求创建Goods（货物）和Customer（客户）实体。 新建实体：点击右侧的菜单创建对象-实体创建，并将鼠标移至设计器主面板单击，则创建

16、一个新的视图，如下图所示：双击图形节点编辑实体的基本信息，实体名称为Goods，标签为货物，如下图所示：选中节点，在属性视图中编辑节点的具体信息如下：类似的创建一个Customer实体，如下图所示：3.2 创建实体字段和枚举值为Goods实体创建货物名称、货物编码、收货时间、送货时间、备注、数量等属性。为Customer实体创建客户名称、客户编码、性别、地址等属性。选中对象节点，节点上方会出现图标，如下图所示，点击增加实体字段：字段name属性视图如下，索引、索引唯一、默认值、启用属性可以默认：类似的编辑实体其他字段和属性信息：具体属性信息如下表所示：Goods：名称 类型 标签name Te

17、xt 名称code Text 编码receiptTime Date 收货时间setTime Date 发货时间note Text 备注count Integer 数量Customer：名称 类型 标签name Text 名称code Text 编码address Text 地址email Email 邮箱注：系统已预置部分系统字段，不需开发者创建，创建字段时请不要使用这些名称createdBy=创建人createdDate=创建时间lastModifiedBy=修改人lastModifiedDate=修改时间owner=所有者ownerDepartment=创建部门isDeleted=删除标记

18、id=唯一IDobjectId=对象IDversion=版本号3.3 创建关联货物必定属于某个客户，所以货物与客户见存在关联关系1、实体关联实体关联是用来为EO创建ForeignKey类型字段，用来引用其它实体。例如由Goods引用实体Customer；在Goods点击创建ForeignKey型字段， 如下图所示弹出选择实体窗口，选择Customer点击OK，自动生成字段名和关联关系连线：2、枚举关联与实体关联类似，枚举关联用来引用枚举。创建枚举Type（类型），创建液体、固体字段，选择右侧的枚举关联，从Goods指向枚举Type，此操作需要为关联关系连线设置名称，并自动为EO生成相应的枚举型

19、字段，如下图所示，并需要手动为生成的枚举字段填写label。4 BO建模创建货物实体需要进行相关查询等操作，故需创建BO。BO建模：在EO的基础上，对EO增加业务操作、关联字段引用、属性校验规则、创建Picker、创建NameQuery等等。打开工程下的entities.cspbo文件，BO设计器的布局与EO设计器基本一致。4.1 创建BOBO在EO的基础上增加了operation（业务接口），并可以使用引用的其他EO的字段；选择右侧BO创建BO对象，创建BO时，需选择一个EO作为 BO对应的主EO，点击ok。分别为Goods和Customer创建BO对象，并可以在BO的属性视图中编辑BO的具

20、体信息。每个BO都会有一个相应的主EO，此外还可以为BO添加关联EO，通过在BO右上方点击，选择JionerEO进行加入：弹出关联关系窗口，选择Customer。为BO添加Field，通过在BO右上方点击 ，选择Field进行添加字段。选择要为BO添加的字段，这里我们选中全部字段，选择OK，如下图所示：可以为BO添加Operation，Operation为业务操作，提供用户自定义操作。通过在BO右上方点击 ，选择Operation进行添加点击operation，并在其属性视图中设置方法参数。本项目中为货物BO增加一个查找货物所属客户的操作，如下图所示因此BO可分为如下三部分：EO1、Prima

21、ryEO（BO对应的主EO），不允许修改和删除；2、JoinedEO（主EO通过关联关系关联的EO），通过在BO图元上游击加入；Field1、来源于选择的PrimaryEO和JoinedEO，BO右键选择Field进行添加；2、系统字段：EO中不显示系统默认创建的字段，通过BO右键选择SystemField进行添加3、虚拟字段：也叫计算型字段，这种字段不对应EO中实际存的的任何字段，它的值要自己写一个表达式，通过BO右键选择VirtualField进行添加Operation业务操作，实际是定义的一些Java方法，并会生成可对外访问的restful服务接口，build后，这些方法会生成到BO的H

22、omeClass对应的Java类中（因此BO的HomeClass必须填写，否则Operation无效），例如Goods.java中findCustomerByGoods()方法则可通过如下接口访问：http:/localhost:8080/cspdemo/testCSP/services/1.0/appext/Contact/findCustomerByGoods?goods=abc4.2 创建PickerPicker为针对BO设计的一个数据查询器，可以通过创建的Picker查询BO的数据。1、为Goods创建Picker，为货物实体提供相应的过滤查询操作。选中画板中的Picker图标，拖拽至

23、主面板中并在弹出的对话框中选择Goods,点击Next，选择字段选中name、code、receiptTime、serTime字段，点击Finish，效果如下:2、在属性视图中查看编辑GoodsPicker的具体查询条件RefBOName：表示这个Picker查询的是哪个BO的数据；JsonQuerySpec：是Picker的默认查询条件。通过点击输入框右侧的按钮对查询条件可进行可视化设计；单击上图中红色标记的图标，进入具体的查询条件设置对话框。在字段区域，选中name和code字段，表示我们需要查询的数据为name和code。在查询条件区域中，单击增加字段，并如上图填写字段值，表示我们需要查

24、询name值为aaa的数据。单击OK，则已创建完成我们需要的picker查询过滤条件。3、此外，Picker允许指定额外的查询条件，并与JsonQuerySpec 进行AND，一起作为查询条件。 对外提供的restful接口类似于：http:/localhost:8080/cspdemo/testCSP/services /1.0/bo/query/picker/GoodsPicker?JsonQuerySpec=查询条件的格式。4.3 创建QueryQuery跟Picker的设置方式基本一致，也要通过选择一个BO来创建。Query用来扩展BO的查询服务，支持自定义查询条件和字段、以及查询报表

25、。1、为Goods创建Picker，在画板中拖拽Query图标至主面板。点击Next，添加customer、name、code字段，主界面如下:2、属性视图中编辑GoodsQuery的详细信息：RefBOName：表示这个Query查询的是哪个BO的数据JsonQuerySpec：与Picker有点不一样，通过点击输入框右侧的按钮对查询条件可进行可视化设计；查询条件的Values中可以指定参数，外部传入后，底层会自动替换，点击右侧的图标，可进入编辑查询条件的对话框，如图所示：JsonReportSpec：用来设置报表查询的，点击输入框右侧的 按钮对查询条件可进行可视化设计；指定维度和指标后，会

26、自动产生报表需要的查询。对外提供的restful接口类似于： http:/localhost:8080/cspdemo/testCSP/services/1.0/bo/namedquery/GoodsQuery?$param1=参数的格式。5 数据初始化在project上点击右键，Csp Config菜单，提供如下配置功能：数据库配置：可以设置或修改数据数据库连接信息。初始化数据（SYS）：系统EO表，设置如下初始化数据（APP）：开发者建的EO表，添加数据如下6 部署Build在project上右击，Csp Tools菜单，提供如下功能：Build All： 对整个APP执行mvn build命令，当模型定义或初始化数据有变动时执行Build Web：只build webapp目录；Build BO：只build app-bo-extension目录选择Build All命令，如下图所示：当build的进度框为100%时表示build结束。发