C1-AppFrame基础培训

AppFrame基础培训CRMGZ-SRD参考资料•AppFrameV5.5二次开发手册V1.0.doc•AppFrameV5.5安装部署指南.doc•Appframe配置工具configtool使用手册.doc•Appframe组件样式风格配置指南.doc•WebFrame用户操作手册.doc•BLFrame用户操作手册.doc•OPFrame用户操作手册.doc•TLFrame用户操作手册.docAppFrame是什么1安装配置说明2开发流程简介3配置工具使用4页面组件使用5AppFrame是什么•为电信行业业务系统开发和维护量身定制的系统开发平台。•开发框架≠开发平台AppFrame平台演进过程传统开发基于框架►收集基于J2EE开发的最佳实践,以小组为单位定义开发规范并遵循►有一些通用的组件►有基于ORMAPPING的封装对象►……基于平台►提供统一的开发规范►提供易于单元测试的接口►提供合理的MVC实现框架、提升ORMAPPING的性能►提供通用Web组件►可视化的业务流程建模►可视化业务开发►提供通用组件、业务组件库►协助应用发布\规范发布的过程►系统在线维护,参数修改►运行期监控……为什么需要平台需要平台帮助您实现快捷开发需要平台帮助您的代码找到定位需要平台帮助您更好的服务管控需要平台帮助您剥离非功能性需求需要平台帮助您将性能优化做在前面需要平台帮助您实现高可用需要平台帮助您实现系统可维护需要平台帮助您实现灵活部署,利旧需要平台帮助您实现页面美化AppFrame的目标AppFrame版本演进AppFrame功能总体架构我们目前主要使用的功能AppFrame功能架构—界面层处理流程ConfigTool进行SET、DS对象定义SET对象定义信息，DS对象定义信息界面展现控制层HTML输出TAG对象JSP文件业务逻辑层局部HTML输出(XmlHttp)用户操作Action请求AppFrame功能架构—持久层处理流程数据库连接池管理（监控连接的申请和关闭）自定义数据库连接池JNDI数据库连接池ConfigTool进行BO对象定义，并自动产生相关对象文件BO对象定义信息数据持久化管理数据库CORBAOBD数据对象业务逻辑层AppFrame功能架构—OBD支持C++服务端业务逻辑OBD服务端OBDJava客户端Corba、Tuxdo、CISC等中间件Action（前台界面逻辑控制）界面管理层界面元素JSP辅助编辑工具ConfigToolAppframeForOBDOBD数据库AppFrame功能架构—OBD支持OBD2JAVA生成OBD定义的XML描述文件根据OBD定义XML描述文件批量生成BO文件根据OBDSTRUCT定义生成BOBEAN文件，在该BOBEAN中提供了两个方法：BOBeancopyFromStruct(struct)；voidcopyToStruct(struct)；作为AppFrame对OpenBroker的Adapter.用来实现两者之间的数据交互。安装配置说明2Appframe是什么1开发流程简介3配置工具使用4页面组件使用5环境要求•JDK1.4或以上版本，确认已经被加入到本机环境变量classpath•开发IDE：Jbuilderx＋tomcat4.1•浏览器IE6.0或以上版本•WebServer/AppServer：如果程序需要发布到weblogic，需要weblogic7.0以上版本，如果发布到webSphere，需要webSphere5.0以上版本；开发阶段使用JBuilderx自带的tomcat4.1•数据库oracle8.1.2以上版本，相应的jdbc版本。创建APPFrameV5.0必须的数据库表sys_id_generator•src：存放java源码。•config：配置工具configtools自动生成的java源码及set、ds、view、bo等配置工具生成的文件•html：webmodel目录，也可以为webmodel取另外一个名字，在这个目录下存放页面文件html、jsp、js等源码•lib：类库，appframe.jar及其他第三方jar包工程配置—目录结构*注意：ConfigTool所在的目录在路径中不能含有中文，因为ConfigTool在加载的时候需要读取jsptemplate模版，而这个模版现在还不支持中文工程配置—关键配置文件•aisystem.ini：定义系统的数据库连接方式和数据连接串，C++中间件方式下不需要。•Client.properties:C++中间件方式下的中间件服务连接定义。•AIConfig.xml：核心配置文件。定义了APPFrameV5.0框架中各个模块的管理器；还有CrossGrid，DBTreeNew的相关配置信息。•Log4j.properties：日志级别和日志输出定义•AppFrameCss.jsp：展现层各类组件样式定义。详细内容请参见《Appframe组件样式风格配置指南》工程配置—AIConfig.xml•AIConfig.xml文件要求能通过ClassPath搜索获得。•如果APPFrameV5.0框架中没有或缺少某一个模块的实现包，需要在此配置文件中注释掉对应的数据行。例如：ConfigKindname=AppFrameInitConfigItemname=DbDataSourceIniFileremarks=数据库连接配置文件aisystem.ini/ConfigItemConfigItemname=DefaultSrouceNameremarks=缺省数据源名称UserDataSource/ConfigItem……开发流程简介3Appframe是什么1安装配置说明2配置工具使用4页面组件使用5开发工作流程界面主要是jsp、html以及js文件，开发分为两步：•使用configtool完成bo、set、ds配置及生成相关java文件•按照jsp的语法规范，完成jsp的编写注意：在编写jsp代码的时候，别忘了包含对APPFrame提供的js文件、css文件的引用。（实际的开发引用项目的公共引用文件）如果只是数据查询而且是使用缺省DataModel（缺省DataModel是APPFrame提供的数据集获取方法，与此对应的还有自定义model），只要上面的工作就可以，如果应用涉及对数据库的新增、修改、删除操作，就需要进入第二步：界面控制第一步：界面开发•界面控制层需要写一个servlet，这个servlet必须继承BaseAction类。•这个servlet做业务逻辑的判断，决定调用哪个javaclass或者EJB进行业务逻辑处理。•APPFrame提供了数据保存的一个缺省实现com.ai.appframe2.web.defaultAction来实现新增、修改、删除操作的保存。在页面开发时指定这个类的方法作为保存方法就可以。前提是要保存的数据对应着一个或几个表BO，这几个表BO之间没有关联关系。•对一些逻辑关系复杂的表BO，还是需要自己写servlet。第二步：界面控制•使用配置工具configtool完成BO的配置，自动生成BO相应的java文件第三步：持久层开发•进行业务逻辑开发，也就是写javaclass或者EJB的过程，在此过程中，需要使用配置工具自动生成的java文件。•直接操作数据库的模式：在配置工具生成的3个java文件中，使用xxEngine.java的save()方法来实现保存。同时这个类还提供getNewID()、getSysTime()、getBeans()等常用方法。•OBD调用模式：通过调用appframe4OBD工具生成OBDJavaBean，以及OBD接口class实现后端中间服务的数据交互业务逻辑。第四步：业务逻辑开发•完成第一到第四步就可以进行最后的调试第五步：联调程序配置工具使用4Appframe是什么1安装配置说明2开发流程简介3页面组件使用5配置工具ConfigtoolConfigtool作为APPFrame开发平台的不可或缺的重要部分，主要提供以下功能：•数据源管理－连接数据库的方式•BO配置－BO对象，来自表、视图、sql•Set配置－页面数据的格式、来源•DS配置－下拉框的数据来源•代码自动生成－根据BO生成的java文件•OBD接口文件转换到BO文件（开发OBD环境的应用时使用）•JSP代码的快速编辑数据源管理（1）数据源管理提供新增、修改、删除数据源的功能。界面如下所示：数据源管理（2）数据源名称：数据源唯一标识数据源类型：有两种，SELF和JNDISELF——用标准的JDBC连接数据库JNDI——通过应用服务器的connectionpool来连接数据库注意：系统默认数据源命名为“UserDataSource”通过配置工具生成的数据源定义文件在工程目录config下aisystem.xml中，其中psd密码是经过加密的BO(业务对象)管理（1）•BO的创建根据数据库表结构生成BO根据sql查询生成BO根据OBD接口文件生成BO•BO多表关联BO(业务对象)管理（2）•新建BO界面如下：BO(业务对象)管理（3）•配置BO属性如下所示：SET(界面数据)配置管理(1)•可视化的界面元素定义–数据类型：数据长度，校验方式–展现方式：DBEdit、DBListBox、DBLabel、DBChecbox、DBDate…–数据选择来源：下拉数据源选择、动态关联参数设置…–编辑状态：是否可编辑•根据定义自动生成前台需要的数据集–TableRowSet–FormRowSet–NormalRowSet•自动将前台返回的数据转换为标准的数据对象Bean–可以将一个前台数据集自动拆分为多个后台数据对象数组SET(界面数据)配置管理(2)•支持的前台校验数据类型–String–Date–DateTime–Float–Integer–Email–Postcode•支持项目进行数据类型的定义扩展–例如：地址、客户经理、组织SET(界面数据)配置管理(3)•新增SET，需要选择BO来生成，界面如下：SET(界面数据)配置管理(4)•修改Field的属性SET(界面数据)配置管理(5)•高级设置——设置在页面显示的一些“是否可视、顺序”等属性。DS(数据枚举)配置管理（1）页面数据源是为界面的DBListBox下拉列表框提供数据，DS支持5类数据来源：•静态数据：直接在DS配置中定义显示的数据•BO数据：通过BO结合条件来查询数据•SQL数据：通过自定义的SQL语句查询数据•Function数据：通过自己写java方法查询数据作为数据源•Service数据：通过指定服务ID和实现服务接口作为数据源DS(数据枚举)配置管理（2）新建DS文件后，配置界面如下：JSP页面辅助编辑器(1)JSP页面辅助编辑器(2)•使用模板快捷的创建新JSP文件•方便快捷的TAG类属性编辑•对特殊的数据控件(Grid,Form)进行方便的排版编辑•方便的JavaScript编辑定位和查找•提供清晰的页面布局分区页面组件使用5Appframe是什么1安装配置说明2开发流程简介3配置工具使用4AppFrame开发术语（1）Session：存储特定用户会话所需的信息，当用户在应用程序的Web页之间跳转时，存储在Session对象中的变量将不会丢失，而是在整个用户会话中一直存在下去。O/Rmapping（ObjectRelationalMapping）：java对象和数据库对象之间的映射，通过O/Rmapping实现java对象对数据库的透明访问。XML文档：符合xml规范的文本，在APPFrameV3.0中，xml文档通常用于数据交互。DataModel：数据模型，即J2EE设计模式M-V-C中的M，又称model。RowSet：结果集，由此派生出FormRowSet、TableRowSet等。NormalRowSet：通用结果集，是不可视的结果集，有它自己的js的构造方式AppFra