Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bcsoft/bc-demo

bc平台
https://github.com/bcsoft/bc-demo

Last synced: 15 days ago
JSON representation

bc平台

Awesome Lists containing this project

README

        

BC平台演示

浏览: https://github.com/rongjihuang/bc-demo
源码: [内网]git@[serverIp]:bc-demo.git 或 [外网][email protected]:rongjihuang/bc-demo.git
打包:http://code.google.com/p/dragon-bc/

一) 浏览器兼容性
Chrome11、Firefox4、Safari5、Opera11、IE9、IE8

二) 目录结构及主要文件说明
bc-demo
|--src
| |--main
| | |--java
| | |--resources
| | | |--db
| | | | |--db.[dbType].drop.sql ->数据库删表脚本
| | | | |--db.[dbType].create.sql ->数据库建表脚本
| | | | |--db.[dbType].data.sql ->数据库初始化数据导入脚本
| | | |--META-INF
| | | | |--persistence.xml ->JPA配置文件
| | | |--log4j.xml ->log4j日志配置文件
| | | |--global.properties ->struts全局国际化配置文件
| | | |--db.properties ->数据库连接配置文件
| | | |--spring.xml ->spring主配置文件
| | | |--spring-db.xml ->spring子配置文件:数据库连接配置,与db.properties配合
| | | |--struts.xml ->struts主配置文件
| | | |--...
| | |--webapp
| | | |--bc ->bc平台的页面文件,对应bc-framework-webapp.git仓库
| | | |--bc-test ->bc平台测试和设计用的页面文件,对应bc-test-webapp.git仓库
| | | |--ui-libs ->开源UI组件库,对应ui-libs.git仓库
| | | |--ui-libs-demo ->开源UI组件库的demo,对应ui-libs-demo.git仓库
| | | |--WEB-INF
| | | | |--web.xml ->web主体配置文件
| | | |--...
| |--test
| | |--java
| | |--resources
|--.gitignore ->git仓库配置文件
|--build.xml ->ant脚本,用于合并sql脚本,清空临时文件等
|--pom.xml ->maven配置文件
|--readme.txt ->项目说明文件

三) 源码编译运行步骤:
1) 检出本工程
地址: [内网]git@[serverIp]:bc-demo.git 或 [外网][email protected]:rongjihuang/bc-demo.git
2) 检出ui-libs工程到本工程的src/main/webapp目录下
地址: [内网]git@[serverIp]:ui-libs.git 或 [外网][email protected]:rongjihuang/ui-libs.git
3) 检出ui-libs-demo工程到本工程的src/main/webapp目录下
地址: [内网]git@[serverIp]:ui-libs-demo.git 或 [外网][email protected]:rongjihuang/ui-libs-demo.git
4) 检出bc-framework工程到与本工程同级的目录
地址: [内网]git@[serverIp]:bc-framework.git 或 [外网][email protected]:rongjihuang/bc-framework.git
执行编译发布: >mvn clean install -Dmaven.test.skip=true
5) 检出bc-framework-webapp工程到本工程的src/main/webapp目录下
地址: [内网]git@[serverIp]:bc-framework-webapp.git 或 [外网][email protected]:rongjihuang/bc-framework-webapp.git
注:检出的目录名必须为bc
6) 部署数据库
6-1)使用 postgresql (9.1.2)
打开 pgAdmin III,创建用户bcdemo,密码也设为bcdemo,创建UTF8数据库bcdemo(属主设为用户bcdemo)
(如有异,可修改src/main/resource/db.properties文件);
按顺序执行如下脚本:
db.postgresql.drop.sql --> 删表(首次不需运行)
db.postgresql.create.sql --> 建表
db.postgresql.data.sql --> 导入初始化数据
6-2)使用 mysql (5.5.9 MySQL Community Server)
>cd bc-demo
>ant build
>cd src/main/resources/db
* 使用mysql命令行创建名为bcdemo的数据库(数据库编码须使用UTF-8),分配用户bcdemo,密码也设置为bcdemo
* (如有异,可修改src/main/resource/db.properties文件)
* 按顺序运行如下脚本
>mysql -ubcdemo -pbcdemo bcdemo < db.mysql.drop.sql --> 删表(首次不需运行)
>mysql -ubcdemo -pbcdemo bcdemo < db.mysql.create.sql --> 建表
>mysql -ubcdemo -pbcdemo bcdemo < db.mysql.data.sql --> 导入初始化数据
6-3)使用 oracle (11.2.0.1)
>cd bc-demo
>ant build
>cd src/main/resources/db
* 给数据库(数据库编码须使用ZHS16GBK)创建用户bcdemo,密码也设置为bcdemo,并假设数据库的本地连接服务名为orcl,如下登录sqlplus
* (如有异,可修改src/main/resource/db.properties文件)
>sqlplus bcdemo/bcdemo@orcl
* 按顺序运行如下脚本
SQL>set serveroutput on --> 设置控制台输出更多信息
SQL>start db.oracle.drop.sql --> 删表(首次不需运行)
SQL>start db.oracle.create.sql --> 建表
SQL>start db.oracle.data.sql --> 导入初始化数据
SQL>commit; --> 提交事务
7) 编译运行
7-1)使用mysql(默认)
>mvn jetty:run

>mvn jetty:run -Djetty.path=/bcdemo
7-2)使用oracle
>mvn jetty:run -Poracle -Ddb.name=[数据库的SID] -Ddb.ip=[数据库服务器的IP]

>mvn jetty:run -Djetty.path=/bcdemo -Poracle -Ddb.name=[数据库的SID] -Ddb.ip=[数据库服务器的IP]
8) 浏览器访问
http://localhost:8082

http://localhost:8082/bcdemo

四) 部署文档转换服务
如果要使用系统在线查看Office文档的功能,需要在服务器部署OpenOffice的文档转换服务:
1) 下载安装OpenOffice3
到 http://www.openoffice.org 下载 OpenOffice3,并安装到服务器;
如果是Windows版的服务器操作系统,安装完毕后先行打开openoffice一次并关闭,然后杀掉soffice.bin和soffice.exe两个进程。
2) 用命令行启动文档转换服务
打开命令行,进入openoffice安装目录下的program目录,输入如下命令:
>soffice -headless -accept="socket,port=8100;urp;"
注:如果附件文档为xls、xlsx、doc、docx格式,系统自动将其转换为pdf格式在线查看,客户端不需要安装Office软件了,
但需要浏览器支持直接查看pdf文件的功能。Chrome原生支持pdf查看,无须插件;Firefox、Safari等其他浏览器需安装pdf插件,
一般安装Adobe Reader软件会自动安装相应的浏览器插件。

五) 其他注意问题
由于项目依赖的一些包在标准maven仓库内没有,对于这些包需要自己手动将其deploy到你的nexus仓库(如果你使用nexus的话),这些包包括:
1) apache的batik,版本1.7
用于将svg导出为图片、pdf文件等;标准maven仓库内有1.6版的,但经过测试其导出的质量不如1.7版,且常会报错。
官方网站:http://xmlgraphics.apache.org/batik/
下载:http://mirror.bjtu.edu.cn/apache//xmlgraphics/batik/batik-1.7.zip
2) jodconverter,版本2.2.2
用于转换office文档为pdf文件在线查看等;标准maven仓库内有2.2.1版的,但其不支持office2010格式文件的转换。
官方网站:http://www.artofsolving.com/opensource/jodconverter
下载:http://nchc.dl.sourceforge.net/project/jodconverter/JODConverter/2.2.2/jodconverter-2.2.2.zip
3)对于不支持html5上传文件的浏览器,如IE等,附件上传使用了SWFUpload组件实现多文件选择上传功能,
这个组件需要flash插件的支持,因此这些浏览器需要安装flash才能正常使用。当前测试通过的flash版本为13.0。

六)测试发布注意事项:
1)备份原有数据库
2)发布测试系统
>mvn clean package -Pmysql -Ddb.type=mysql -Ddb.name=bcdemo -Ddb.ip=127.0.0.1 -Dapp.debug=false -Ddb.username=bcdemo -Ddb.password=bcdemo -Dapp.data.realPath=/bcdata4demo -Dapp.ts=20111102
修改WEB-INF/web.xml文件,将appRealDir参数的值修改为/bcdata4demo。
修改classess/log4j.xml,将日志级别统一设为ERROR,修改日志的文件名为bcdemo_vxx.log。
修改classess/db.properties,确认数据库连接参数正确:测试系统使用帐号bcdemo/bcdemo。
修改classess/global.properties,确认如下参数正确:
app.debug=false
app.ts=20111220
app.data.realPath=/bcdata4demo