BME3.0本地搭建及简单例子-陈江.doc

1 检查软件配置1 检查软件配置搭建环境需要具备的软件设施。在搭建环境前，需要检查软件配置，具体配置如表1-1所示。表1-1 软件配置软件配置支持的软件类型及版本操作系统Windows 2000/2003/XPSuse Linux9.0/ Suse Linux10.0IBM AIX 5.3HP 11.23服务器JDK1.5/JDK1.6 Tomcat 5.5.17/Tomcat 6.0.26 数据库Oracle9i/10g/11gInformix9/11 浏览器IE7.0/ IE8.0Firfox3.6文档版本 ()华为专有和保密信息 版权所有 华为技术有限公司1-12 搭建开发环境2 搭建开发环境2.1 禁止文件的校验禁止文件的校验的过程。操作步骤步骤 1 启动MyEclipse程序。步骤 2 选择“Window Preferences Validation”。步骤 3 单击“Disable All”，如2-1所示。图2-1 禁止文件校验对话框步骤 4 单击“Apply”应用设置。步骤 5 单击“OK”保存设置。-结束2.1.2 修改encoding在MyEclipse中修改encoding。操作步骤步骤 1 启动MyEclipse程序。步骤 2 选择“Window Preferences General Workspace”。步骤 3 在“Text file encoding”区域，单击“Others”，在下拉列表中选择“UTF-8”，如图3-4所示。图2-2 修改encoding设置步骤 4 单击“Apply”应用设置。步骤 5 单击“OK”保存设置。-结束2.1.3 添加JRE添加JRE的过程。操作步骤步骤 1 启动MyEclipse程序。步骤 2 选择“Window Preferences Java Installed JREs”。步骤 3 选中列表中的选项，单击“Edit”，如图3-5所示。图2-3 添加JRE对话框步骤 4 在“JRE home”栏选择实际JRE的路径。步骤 5 单击“OK”。-结束2.1.4 设置Tomcat设置Tomcat的过程。操作步骤步骤 1 启动MyEclipse程序。步骤 2 选择“Window Preferences MyEclipse Enterprise Workbench Servers” ，如2-4所示。图2-4 设置Tomcat对话框步骤 3 设置本机tomcat所在目录，选择tomcat的“JDK”，如图2-5所示。图2-5 设置Tomcat JDK对话框 单击Add，添加本地jdk目录步骤 4 单击“Apply”，单击“OK”完成服务器设置。-结束2.2 导入BME工程将BME工程导入到容器中。背景信息l 将工程目录解压到本地目录。操作步骤步骤 1 启动Myeclipse程序。步骤 2 选择“File Import”。步骤 3 选择“General Existing Projects into Workspace”，单击“Next”。步骤 4 单击“Browse”选择BME工程的文件夹。步骤 5 选中“Copy projects into workspace”前的复选框。如图2-6所示。图2-6 导入工程文件夹对话框步骤 6 单击“Finish”。完成导入工程文件夹的操作。-结束2.3 配置数据库初始化数据库和设置数据库密码。2.3.1 初始化数据库连接数据库，初始化数据库数据。2.3.2 设置数据库密码使用加密算法设置数据库密码。2.3.1 初始化数据库连接数据库，初始化数据库数据。背景信息l 数据库客户端程序安装完成，用户可以正常访问数据库。l 数据库客户端工具已经启动。l 以下数据库脚本齐备： oracle-create_seq.sql oracle-generateSequence.sql bme_oracle.sql bme_oracle_data.sql bme_oracle_demo.sql本手册中数据库脚本的存放路径为：.BMEsetupdbscript。目前支持的数据库类型有两种：Oracle、Informix。本手册以使用PLSQL Developer 工具进行初始化Oracle数据库操作为例。操作步骤步骤 1 启动PLSQL Developer程序。步骤 2 选择“File New SQL Window”，显示“SQL”窗口。步骤 3 双击打开“oracle-create_seq.sql”文件，将文件中所有内容复制到“SQL”窗口，按F8。此操作的作用是创建BME系统表。步骤 4 选择“File New Command Window”，打开“Command Window”。步骤 5 双击打开“oracle-generateSequence.sql”文件，将文件中所有内容复制到“Command Window”，按F8。此操作的作用是创建系统存储过程。步骤 6 双击打开“bme_oracle.sql”文件，将文件中所有内容复制到“Command Window”中，系统会自动执行脚本。此操作的作用是完成BME业务表的创建。步骤 7 双击打开“bme_oracle_data.sql”文件，将文件中所有内容复制到“Command Window”中，系统会自动执行脚本。此操作的作用是完成BME出厂数据的初始化。步骤 8 双击打开“bme_oracle_demo.sql”文件，将文件中的所有内容复制到“Command Window”中，系统会自动执行脚本。此操作的作用是完成实例数据的初始化-结束2.3.2 设置数据库密码使用加密算法设置数据库密码。背景信息执行此步操作之前，需要先安装JRE，并且设置“JAVA_HOME”的环境变量。出于安全考虑，系统中对数据库访问密码作了加密处理，加密算法是由版本中的“mons.encryption-3.0.0.*.jar”文件提供的。操作步骤步骤 1 选择“开始 运行”，输入cmd，进入DOS命令行窗口。步骤 2 进入到目录“.BME setupencrypt”。步骤 3 输入encrypt.bat 0 abc(abc为密码)。界面显示加密的数据库访问密码：D9nRB80nbOjVcK0R7JqDJg=，如图2-7所示。图2-7 生成密码“0”表示采用AES加解密算法，也是默认的加解密算法，“1”表示采用SHA-256加解密算法。步骤 4 修改数据库配置文件“perties”。本手册举例中，该文件的存放路径为：“d:wtpworkspaceBMEsrcmainresources”。1. 修改参数“bme.url”和“bme.username”的值为实际值。修改“perties”配置文件时，如果参数值中存在逗号，需要在逗号前加转义字符“”，如：“bme.url=jdbc:informix-sqli:/78:9008/gbk:INFORMIXSERVER=bme_online_net;CLIENT_LOCALE=en_US.utf8;DB_LOCALE=en_US.8859-1;NEWLOCALE=en_US,en_US;NEWCODESET=UTF8,8859-1,819”2. 修改数据库用户密码。修改如下内容：“bme.password= D9nRB80nbOjVcK0R7JqDJg=”。本例使用的数据库为157的数据库，连接信息如下：bme.url=jdbc:oracle:thin:57:1521:seedbbme.username=cjbme.password=ve939Wjdq7g4ylYaIY3Oag=注：也可换其他数据库，只要保证数据库脚本和数据库连接信息的正确即可。-结束2.4 部署BME到Tomcat容器将BME工程部署到Tomcat容器中。操作步骤步骤 1 启动MyEclipse程序。步骤 2 在“Package Explorer”中，右键单击“BME”，选择“New Other”，输入Server选项，如图：。步骤 3 单击“Next”：选择Tomcat 6.0。步骤 4 单击“Next”：配置上图两项的属性，Tomcat的路径，使用JDK。1. 单击“Next”，在显示的窗口选择“Add All”，如图2-8所示。图2-8 选择工程2. 单击“Finish”。3. 选择Windowshow viewother,点击server下的server，如图：系统将显示如图2-9。注：此步骤完成后，Package Explorer将多出一个Servers的工程。图2-9 Server页签步骤 5 双击图3-14中的Tomcat v6.0 Server at localhost服务，修改基本信息，如图3-15所示。图2-10 修改部署信息1. 在“Server Locations”设置区域中设置BME工程部署的路径，选择“Use Tomcat installation”。这里选择将BME部署到tomcat中。系统默认的部署路径为：“workspace.metadata.pluginsorg.eclipse.wst.server.core”。2. 在“Deploy Path”中选择“webapps”目录，表示将工程部署在“webapps”目录下。如图3-16所示。图2-11 设置部署目录3. 在“Automatic Publishing”设置区域中选择“Never publish automatically”，表示设置禁止自动部署功能。如图3-17所示。图2-12 设置禁止自动部署功能进入Server：Launching中：说明：如若不把上图中选中的勾掉，则tomcatconfserver.xml在每次tomcat启动时都会被初始化，导致我们往里面添加的用于登陆的代码不起作用，无法登陆。如果无法登陆，直接访问http:/localhost:8080/BME亦可。步骤 6 右键单击“Server”选项卡中的BME，选择“Publish”。如图3-18所示。图2-13 手动部署功能系统开始启动部署操作。部署成功后，Servers中的BME服务的状态变为“Synchronized”，如图3-19所示。图2-14 部署成功部署完成后，在“.tomcatwebapps”目录下会产生一个“BME”文件夹。-结束2.5 配置Tomcat配置Tomcat容器，创建并安装证书。（提供的文件夹中有证书相关，如果不想创建证书，跳过本节按提供文件夹中操作）2.5.1 创建证书keystore创建证书keystore的过程。2.5.2 创建自签名的证书创建自签名的证书的过程。2.5.3 配置HTTPS配置HTTPS的过程。2.5.1 创建证书keystore创建证书keystore的过程。操作步骤步骤 1 使用JDK自带的命令keytool创建“keystore”文件，其中包含了密钥。在命令行窗口中输入以下命令：keytool -genkey -keystore keystore -alias myself步骤 2 根据系统提示输入“keystore”的密码，例如：“password”。步骤 3 根据系统提示，输入其他数据。输入完成后，系统将询问用户输入的信息是否正确，如果正确，请输入“y”，否则请输入“n”。步骤 4 输入私钥的密码，如“password”。步骤 5 输入私钥的密码。系统将在当前路径下生成一个keystore文件。-结束2.5.2 创建自签名的证书创建自签名的证书的过程。操作步骤步骤 1 使用JDK自带的命令keytool创建自签名证书。keytool -selfcert -alias myself -keystore keystore步骤 2 输入创建keystore时输入的密码。步骤 3 对keystore进行验证。keytool -list -keystore keystore步骤 4 验证成功后，将证书导出。keytool -keystore keystore -export -alias myself -file bmecert.cer 系统将根据前面的keystore文件在当前目录导出一个cer文件。-结束2.5.3 配置HTTPS配置HTTPS的过程。操作步骤步骤 1 将keystore文件部署到“$TOMCAT_HOME/conf”目录中。步骤 2 将证书文件部署到“$TOMCAT_HOME/webapps/BME/ssl”目录中。步骤 3 修改“$TOMCAT_HOME/conf/server.xml”文件。增加HTTPS-SSL对应的Connector：其中：l keystoreFile为“keystore”文件所在的路径。l keystorePass为创建“keystore”的密码。-结束2.6 检验开发环境搭建是否成功如果服务可以正常启动，并且可以进入到登录页面，说明该环境搭建成功。2.6.1 启动服务启动Tomcat容器的过程。2.6.2 登录页面打开浏览器，登录BME页面，并下载证书。2.6.1 启动服务启动Tomcat容器的过程。操作步骤步骤 1 启动eclipse程序。步骤 2 进入“Servers”选项卡，在BME这条记录上单击右键，选择“Start”，如图3-20所示。图2-15 启动服务启动成功，BME服务状态为“Started”，如图3-21所示。图2-16 启动服务成功WTP支持调试方式的运行。启动服务时，选择“Debug”即可进入调试状态，选择“Start”则进入直接运行状态。-结束2.6.2 登录页面打开浏览器，登录BME页面，并下载证书。操作步骤步骤 1 启动浏览器程序。步骤 2 在地址栏输入http:/本地IP地址:端口号/BME/login.action，在本手册中具体的地址为http:/localhost:8080/BME/login.action。如果部署成功，可以看到登录页面，如图3-22所示。图2-17 登录页面步骤 3 选择“查看证书 安装证书”，进入证书导入向导。如图3-23所示。图2-18 证书导入向导步骤 4 在“选择证书存储”窗口中选择“受信任的根证书颁发机构”，单击“确定”。如图3-24所示。图2-19 选择证书存储步骤 5 单击“下一步”。系统提示完成证书导入。步骤 6 单击“完成”。-结束文档版本 ()华为专有和保密信息 版权所有 华为技术有限公司2-233 简单例子3 简单例子关于本章描述在搭建起来的BME环境中完成一个增删改查的例子。3.1 创建目录节点打开src/main/java/demo.menus.xml该文件中详细配置了节点信息，如图：其中“产品管理“是新加的节点，该节点有三个子节点，在demo.menus.xml中配置：标注的为本例所使用的节点。代码概述：图中authID中的值是在srcmainwebappWEB-INFi18n目录下配置的，action是跳转的路径。3.2 页面流程在这以添加为例。1.当点击“产品添加“时，根据demo.menus.xml中该节点的配置，跳转的action路径为：/business.action?BMEBussiness=product&targetstep=addProduct。在web.xml中有相应的过滤器过滤以*.action结尾的请求。当请求发送时，进入BME3.0的体系寻找对应的路径，找到src/main/java/product.business.xml中。进行相应的业务流程。注：由于过滤器BME3.0没有开放出来，位于jar文件中。如何找到business.xml中，我也没有研究出来。由于在BME3.0中，*.business.xml是业务流程配置文件，所以最终将走到product.business.xml进行相应的业务流程配置2.product.business.xml文件本例中配置如下：大致说明如下：1，name的值表示业务名称(如新增，删除)。本例是新增产品。2，do的值表示对