文档地址:

1.struts2sh项目安装运行手册.pdf 1.6MB

http://sshplus.googlecode.com/files/1.struts2sh%E9%A1%B9%E7%9B%AE%E5%AE%89%E8%A3%85%E8%BF%90%E8%A1%8C%E6%89%8B%E5%86%8C.pdf

本文档简要描述struts2sh系统的使用手册。

作者: 刘长炯

日期: 2009-5-1

Emal: beansoft@126.com

1 管理员界面

管理员界面可对系统的用户进行管理，并对网站的全局信息如站点名称，敏感词等进行配置，最重要的是还可对站点的资源进行安全访问配置。

1.1 以管理员身份登录

进入http://localhost:8080/struts2sh 站点首页后，选择按钮即可进行登录，默认的管理员用户名和密码是 admin/123456，登录成功后即可进入后台首页。

1.2 用户管理

点击左侧功能导航菜单上的用户管理，即可对用户进行增删改查。出于安全考虑，不允许对管理员用户进行删除操作。

这里只能添加网上交易员和财务经理两种用户信息。

1.3 站点全局配置

点击左侧的站点全局设置链接，可对站点的标题，公告，以及敏感词过滤进行配置。

1.4 站点安全中心

点击左侧的站点安全中心，可对全站所有的敏感资源进行访问角色控制。也可添加和修改用户角色及资源访问许可。

2 其它用户功能

2.1 概述

除了管理员之外的其他用户都通过在站点首页登录后进入功能页面。能够注册的用户主要包括普通用户和供应商。

2.2 注册

用户进入系统之前必须进行注册，点击首页的按钮即可进入登录页面，然后选择页面左下方的注册链接即可完成用户注册。

2.3 登录

点击首页的按钮，选择好正确的用户类型后，即可完成登录。

2.4 商店首页

登录成功后进入商店首页，在此处可进行绝大多数的操作，不同角色的用户将显示不同的功能菜单。

2.5 系统公告

使用 ExtJS 实现.

本文档描述Windows系统下如何安装和配置运行struts2sh系统。

作者: 刘长炯

日期: 2009-5-1

Email: beansoft@126.com

1 安装所需的软硬件环境

1.1 运行环境

操作系统：Windows/Linux/Mac，支持Java环境即可

磁盘剩余空间：100MB以上

内存：最低256MB，推荐512MB或更高

CPU：PIII 800 MHz或更高

1.2 开发环境

操作系统：Windows XP，支持Java环境即可

磁盘剩余空间：1GB以上

内存：最低512MB，推荐1GB或更高

CPU：1GHz或更高

2 如何运行

2.1 下载并解压缩项目

将下载得到的struts2sh.zip 解压缩到硬盘上，得到目录struts2sh，包括项目源代码和二进制文件。

2.2 安装运行环境软件

2.2.1 下载和安装JDK

安装JDK 1.5。

注意: 由于Struts 2和最新版的JDK 1.6有冲突, 此处不建议使用JDK 1.6.

下载JDK可以访问官方网站http://java.sun.com/javase/downloads/index.jsp。双击下载后的带有 图标的JDK安装程序EXE文件，接着就会使用Windows Installer开始安装过程，按照向导提示一步步进行安装即可。

小提示：您一般需要把JDK安装到一个不带空格和中文字符的目录下，例如c:\JDK1.6，不建议使用默认目录，因为那样可能导致服务器无法正常启动和其他异常。

2.2.2 设置环境变量

需要配置的环境变量是JAVA_HOME。在我的电脑上点击右键, 选择 属性，在弹出的对话框中选择高级标签，然后点击环境变量按钮, 在出现的环境变量对话框的系统变量(S)栏目中点击新建按钮, 出现新建系统环境变量的对话框, 输入变量名为JAVA_HOME, 值为 JDK 安装目录，例如：C:\JDK1.5.0(例如Tomcat需要这个环境变量来查找 JDK)。

2.2.3 下载和安装Tomcat

安装好Tomcat 6.0(或者5.5及更高版本)

注意: 由于 Struts 2和 Tomcat 5.0 有冲突, 因此不能用Tomcat 5.

Tomcat是一款开源免费的JSP服务器，可以在 http://tomcat.apache.org/ 下载并安装。

建议下载压缩包版本（文件名是apache-tomcat-6.x.xx.zip），而不是Windows Service Installer的EXE安装文件。 解压缩到磁盘目录，记下安装路径例如c:\apache-tomcat-6.0.14, 和JDK的安装一样，为了避免日后产生问题错误，解压缩的路径不要带有空格，如c:\Program Files。

2.2.4 安装MySQL 5.0/6.0 数据库

可以访问 MySQL 官方网站下载原版安装程序和JDBC驱动，请访问：http://dev.mysql.com/downloads/mysql/5.0.html#win32，下载安装包（如文件mysql-essential-6.0.5-alpha-win32.msi）双击进行安装，在最后一个屏幕点击启动Configure the MySQL Server now启动实例配置工具即可，如下图所示。

配置过程请参考视频mysql_server_config.exe。此向导也可以通过选择菜单 开始 > 所有程序 > MySQL > MySQL Server 6.0 > MySQL Server Instance Config Wizard来打开。

2.2.5 安装MySQL客户端管理软件Navicat Lite(可选)

MySQL管理工具，导航猫免费版(Navicat Lite)，可获得不低于SQL Server的易用度, 例如可视化建表, 修改表结构, 创建外键, 修改数据, 执行查询等功能,此软件的中文版可以在http://www.navicat.com.cn/download.html 下载*非商业 - 免费精简版。

2.2.6 安装和配置邮件服务器Forward Mail Server(可选)

可以下载5用户版免费的邮件服务器 Forward Mail Server 4.175来作为项目的测试邮件服务器. 安装时候注意选择默认的安装路径 C:\Caretop\FMS , 不要修改此路径. 而且不支持Vista操作系统.

启动后的界面:

启动其中的SMTP和POP3服务即可. 如果希望通过浏览器访问邮件服务器, 首页是http://localhost:1086/。

在开始菜单中可启动邮件服务器配置工具，然后添加一个beansoft.cn的域名，之后再点击左侧导航中的本地邮箱，添加必要的测试用邮箱地址。

选择 Forward Mail Server Manager.

注意: 邮箱密码都是1234.

2.3 手工发布运行项目

2.3.1 创建数据库

使用任意软件连接至MySQL服务器，然后创建数据库struts2sh。

2.3.2 创建数据库表

执行文件struts2sh.sql来创建应用程序运行所需的表和基本数据。

2.3.3 修改Hibernate配置文件中的数据库连接信息

打开文件WebRoot\WEB-INF\classes\hibernate.cfg.xml，修改文件中的数据库连接信息：

请将代码中红色内容修改为您自己的数据库连接IP，用户名和密码。

2.3.4 手工发布项目

请将WebRoot目录完整复制到Tomcat安装目录/webapps下，然后将WebRoot文件夹重名为struts2sh (理论上修改为其他路径也可以运行)。

2.3.5 使用WAR打包发布工具

双击根目录下的 WAR打包发布(需要先安装JRE).exe ，可以启动BeanSoft自行开发的WAR打包工具，启动后按照界面提示进行即可完成和打包发布工具。

2.3.6 运行项目

启动Tomcat, 然后在浏览器键入地址 http://localhost:8080/struts2sh/index.jsp, 如果能看到正常的页面输出，那么项目即运行成功，这是因为站点的标题信息和版权信息都是通过后台数据库配置的。

2.4 自动发布运行项目

为了方便最终用户使用、体验此软件，特地开发了自动发布向导，类似于一个安装程序。双击根目录下的 配置发布向导(需要先安装JRE).exe，即可启动此向导，但是必须已经完成了JDK，Tomcat和MySQL的安装。然后安装图示一步步执行即可完成数据库设置，发布和启动服务器的过程。

注：部分截图稍有路径出入，以实际运行时为准。

3 搭建开发环境

本系统使用MyEclipse 开发，可导入到MyEclipse 4或者更高版本，随后即可进行修改和开发。如果读者没有MyEclipse，也可导入Eclipse。

点击菜单File > Import，然后在弹出的Import对话框中展开General目录，选择Existing Projects into Workspace，接着点击Next按钮。当选中单选钮Select root directory:时可以点击Browse…按钮选中包含项目的文件夹，如果包含项目的话就可以在中间的Projects列表框中显示；而当选中单选钮Select archive file:时可以点击Browse…按钮选中包含项目的ZIP压缩包，如果包含项目的话就可以在中间的Projects列表框中显示。最后点击Finish按钮就可以导入项目并打开了。如下图所示：

。

导入后可在MyEclipse 6.0或者6.5选择发布或者菜单 Run > Run As > 3 MyEclipse Server Application，然后即可启动浏览器进行测试。

下载地址:

http://sshplus.googlecode.com/files/struts2sh.zip　27.1 MB
Spring, Struts2, Hibernate 整合演示项目

相关文档:

1.struts2sh项目安装运行手册.pdf    1.6 MB

Struts 2 + Spring  2 + Hibernate 3 整合演示

作者: 刘长炯 beansoft@126.com
日期: 2009.5.1
官方 Blog: http://beansoft.blogjava.net/

本项目仅仅是一个简单的 demo, 不是最佳实践, 也不适宜直接作为商业项目使用. 本项目演示了 Struts 2 + Spring  2 + Hibernate 3 的整合.

本项目是以 JSP 为核心, 提供基于SSH的后台, 并兼顾表示层, 给开发人员提供开发参考.

相关项目:
前台: ExtJS(一点点, 公告) EasyValidation(现名 RapidValidation) jQuery CSSMenu XloadTree FckEditor

开发工具为 MyEclipse 6.0, 也可导入其它开发工具编译运行.

相关文档 struts2sh 手把手开发文档以及 Struts 1 版本的整合即将陆续出炉, 敬请密切关注.

许可协议: LGPL, 详情参考 LGPL-LICENSE.txt.

建议您阅读目录 struts2sh\文档 下的文档

推荐的开发用配套软件 MySQL 5 绿色精简版( Portable MySQL 5, JDBC Driver, MySQL-Front ):
http://tomcatmonitor.googlecode.com/files/portable_mysql5.exe

Spring, Struts1/2, Hibernate 整合的演示参考实现框架.

暂时未发布文件.

输入: select ID as 编号, NAME as 姓名, AGE as 年龄 from XXX

输出:

要求是如果SQL变动, 仍然要显示出来所有的别名字段信息和数据.

因为现在Hibernate用的比较广泛, 所以优先考虑用Hibernate来实现, 结果发现如果是实体映射查询语句, 可以方便的用:List<String> Query.getReturnAliases() 获得别名, 然而我们知道查询时有时候语句是很复杂的, 不全是HQL, 这时候用SQLQuery的时候, 惊讶的提示这个方法尚未实现(最新版的Hibernate 3.3 是否实现尚未测试), 用的版本是Hibernate 3.2, 对应的代码是:

DAO

/**
 * 根据查询语句返回结果, 并包含结果的列名
 * @param hql
 * @param args
 * @return
 */
public List queryAllForReport( final String hql, final Object... args) {
    List list = getHibernateTemplate().executeFind(new HibernateCallback() {
         public Object doInHibernate(Session session)
         throws HibernateException, SQLException {
         Query query = session.createQuery(hql);
         
         for(int i =0; i < args.length; i++) {
             query.setParameter(i, args[i]);
         }
         

         List list = query.list();
         list.add(0, query.getReturnAliases());
         
         return list;
         }
        });
    
    // Hibernate做count计算返回一般都是对象
    
    return list;        
}

测试代码:

List<Object[]> list = dao.queryAllForReport("select id as 编号, name as 登录名, address as 地址, realName from User");

  System.out.println(list.size());

for(Object[] row : list) {
    for(Object v : row) {
        System.out.print(v + "\t");
        
    }
    
    System.out.println();
}

最后不得不回到JDBC, 用 ResultSet和ResultSetMetaData实现了这个功能, 详细代码(自己进行修改即可实现)如下:

<%@ page language="java" import="java.util.*, java.sql.*" pageEncoding="UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    
    <title>SQL报表</title>
    
    <meta http-equiv="pragma" content="no-cache">
    <meta http-equiv="cache-control" content="no-cache">
    <meta http-equiv="expires" content="0">    


  </head>
  
  <body>
   <form action="">
   <textarea name=sql cols=80 rows=10>${param.sql}</textarea><br>
   <input type=submit value=查询>
   </form>
   
  <c:if test="${!empty param.sql}">

   <%
  //new oracle.jdbc.driver.OracleDriver();
   Connection conn = DriverManager.getConnection("jdbc:oracle:thin:@192.168.1.41:1521:xe", "hr", "hr");
   Statement stmt = conn.createStatement();
   ResultSet rs = stmt.executeQuery(request.getParameter("sql"));
   
   if(rs == null) {
       stmt.close();
       conn.close();
       return;
   }
   
   // 取列名
   ResultSetMetaData meta = rs.getMetaData();
   int cols = meta.getColumnCount();
   ArrayList colNames = new ArrayList();
   
   for(int i = 1; i <= cols; i++) {
       colNames.add(meta.getColumnLabel(i));
   }
   
   request.setAttribute("colNames", colNames);
   %>
   <table border="1"  cellpadding="0" style="border-collapse: collapse; "  width="100%" bordercolor="#000000" align=center >
   
   <tr>
       <c:forEach items="${colNames}" var="c">
       <td>${c}</td>
       </c:forEach>
       </tr>
       
   <%
  while(rs.next()) {
      colNames.clear();
      
       for(int i = 1; i <= cols; i++) {
           Object value = rs.getObject(i);
           System.out.println(value.getClass());
           
           // TODO 更多格式化控制
           if(value instanceof java.sql.Date) {
               value = rs.getTimestamp(i);// 取出精确日期
               java.text.SimpleDateFormat df = new java.text.SimpleDateFormat("yyyy年MM月dd日HH点mm分ss秒EEE");
               value = df.format(value);
           }
           
           if(value instanceof java.math.BigDecimal) {
               java.math.BigDecimal v = (java.math.BigDecimal)value;
               value = v.doubleValue();
                // 要求输出时候最少显示两位小数, 最多输出小数点后3个数
                java.text.NumberFormat format = java.text.NumberFormat.getInstance();// 只对小数格式化
                format.setMaximumFractionDigits(2);// 最多3位小数
                format.setMinimumFractionDigits(1);// 最少2位小数
                value = format.format(value);// ==> String
           }
           
           colNames.add(value);
       }
       
      request.setAttribute("colNames", colNames);
      
      %>
      <tr>
           <c:forEach items="${colNames}" var="c">
           <td>${c}</td>
           </c:forEach>
         </tr>
      <%
      
  }
   
   rs.close();
   stmt.close();
   conn.close();
   %>
   </table>
   </c:if>
  </body>
</html>

用到了JSTL和EL, 总的来说要改版还是很方便的. 但是运行需要比较高的Tomcat版本, 如5.5以上, 并需要JSTL类库. 不过, 类似的模版项目开源框架应该是很多很多的, 例如众多的Report框架.