mysql+hibernate

这是我学习《Example #1: Struts with Hibernate》的笔记和练习,原文在http://homepage.mac.com/edahand/projects/java/example1.html
注意，本文不是原文的完整翻译,有不当之处，请参考原文。
（一）目标
    这个例子的主要目标是创建一个基于Jakarta Struts的简单WEB应用，它使用Hibernate访问MySQL数据库中的一个单一的表。这个例子不探求解释Struts and Hibernate应用的原理，而是一步一步地提供一个简单和完整的实例。

-------------------------------------------------------------------------------

（二）说明
这个应用程序提供下列的功能:

1、通过一个web页面列出数据库中当前所有的条目,一个条目包含条目的名称和描述。
2、在页面的底部，用户能提交一个新的条目，它带着名称和描述。
3、如果提交了一个非空名称, 新的条目将增加到数据库并重新显示带有新条目的页面。
4、如果提交中有错误，将返回一个带有上面错误的列表页。


--------------------------------------------------------------------------------

（三）假设
这个例子的准备工作, 我将假设你的系统配置：

1、安装JDK 1.4。
2、安装Apache Tomcat4.1.29以上
3、安装MySQL数据库
4、JDBC驱动程序已经安装。我用的是mysql-connector-java-3.0.14-production-bin.jar，可以将其复制到$Tomcat/common/lib里，或下面提到的$TOMCAT/webapps/example1/web-inf/lib下面。
5、安装Ant1.6以上。

--------------------------------------------------------------------------------

（四）用法说明

以下提到的所有文件和整个WEB应用的目录结构请在本站下载。

（五）Struts 准备
1、从http://jakarta.apache.org/struts/下载Jakarta Struts， 我用的jakarta-struts-1.1.zip。

2、在 $TOMCAT/webapps下创建目录example1

3、将与Struts相关的jar文件复制到$TOMCAT/webapps/example1/WEB-INF/lib，tld文件复制到$TOMCAT/webapps/example1/WEB-INF下。

4、在$TOMCAT/webapps/example1/WEB-INF/下创建web.xml文件。 
5、在$TOMCAT/webapps/example1/WEB-INF/下创建struts-config.xml文件。这个文件包含了表单和动作映射信息，我们将使用唯一的表单, AddItemForm, 它包含验证用户的输入。

    <form-beans>
        <form-bean name="addItemForm" type="com.edhand.example1.AddItemForm"/>
    </form-beans>

    定义了两个action mappings。
    <action-mappings>
    
        <action
        path="/items"
        type="org.apache.struts.actions.ForwardAction"
        parameter="/pages/AddItem.jsp"/>
    
        <action
           path="/addItem"
           type="com.edhand.example1.AddItemAction"
           name="addItemForm"
           scope="request"
           validate="true"
           input="/pages/AddItem.jsp">
           <forward name="success" path="/pages/AddItem.jsp" />
         </action>
    
    </action-mappings>

（六）MySQL 准备
在数据库test中创建唯一的表item,
CREATE TABLE `item` (
  `id` bigint(11) NOT NULL auto_increment,
  `name` varchar(32) NOT NULL default '',
  `description` longtext,
  PRIMARY KEY  (`id`)
)



（七）Hibernate 准备
1、从http://www.hibernate.org/下载Hibernate，我用的hibernate-2.1.2.zip
2、将下载的文件解压并复制hibernate2.jar到$TOMCAT/webapps/example1/WEB-INF/lib，再从解压文件中找   到lib目录，复制*.jar到$TOMCAT/webapps/example1/WEB-INF/lib。
3、创建Hibernate属性文件hibernate.properties, 并放到$TOMCAT/webapps/example1/WEB-INF/src/java下。    下面这个片断介绍怎样连接到我们的数据库: 

hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
hibernate.connection.driver_class org.gjt.mm.mysql.Driver
hibernate.connection.driver_class com.mysql.jdbc.Driver
hibernate.connection.url jdbc:mysql:///test
hibernate.connection.username testuser
hibernate.connection.password testuser


（八）创建Item bean
 1、在$TOMCAT/webapps/example1/WEB-INF/src/java/com/edhand/example1下创建Item.java源文件，这个类有三个属性：id,name, 和description。
 2、在$TOMCAT/webapps/example1/WEB-INF/src/java/com/edhand/example1下创建Hibernate映射文件Item.hbm.xml, 
<hibernate-mapping>
   <class name="com.edhand.example1.Item" table="item" >
      <id name="id" column="id" type="java.lang.Long" unsaved-value="0">
         <generator class="identity"/>
      </id>
      <property name="name" column="name" type="java.lang.String" />
      <property name="description" column="description" type="java.lang.String" />
   </class>
</hibernate-mapping>
  当我们用Ant构建文件build.xml构建时，将拷贝这个文件到 $TOMCAT/example1/WEB-INF/classes目录树。
 
（九）创建ItemService 和ConnectionFactory 类
1、在$TOMCAT/webapps/example1/WEB-INF/src/java/com/edhand/example1目录下创建文件ItemService.java   。这个Java类提供方法访问Item对象。
2、在$TOMCAT/webapps/example1/WEB-INF/src/java/com/edhand/example1目录下创建文件 ConnectionFactory.java。当请求时这个类提供ItemService和一个Hibernate session。

（十）创建AddItemForm类
    在$TOMCAT/webapps/example1/WEB-INF/src/java/com/edhand/example1目录下创建源文件 AddItemForm.java。 这个类装入用户从AddItem.jsp页面提交的数据。

（十一）创建AddItemAction类
    在$TOMCAT/webapps/example1/WEB-INF/src/java/com/edhand/example1目录下创建JAVA源文件AddItemAction.java，这个AddItemAction 类将处理用户的请求并产生回应的JSP页面。 实际上，这个类通过ItemService类与Hibernate连接, 并在数据库中增加用户提交的条目。

（十二）创建AddItem.jsp
   在$TOMCAT/webapps/example1/pages/目录下创建AddItem.jsp文件。
<%@ taglib uri="/tags/struts-bean" prefix="bean" %>
<%@ taglib uri="/tags/struts-html" prefix="html" %>
<%@ taglib uri="/tags/struts-logic" prefix="logic" %>
<%@ page import="com.edhand.example1.ItemService" %>
<%@ page import="java.util.List" %>

<html:html locale="true">
<head>
   <title>Example 1</title>
   <html:base/>
</head>
<body bgcolor="white">

   <h3>Example 1</h3>
   <html:errors/>
   <%
      /*
       * This code will generate a list of objects from the
       * database and place a reference to this list in the
       * request object.
       *
       */
      List itemList = ItemService.getInstance().getItemList();
      request.setAttribute("items", itemList);
   %>

   <p>List of items in <code>item</code> table of database <code>test</code>.</p>
   <table border=1>
   <!-- This code will iterate over the list of items, creating a table
row for each item. -->
   <logic:iterate id="element" name="items" scope="request" type="com.edhand.example1.Item" >
   <tr>
      <td><bean:write name="element" property="name" /></td> 
      <td><bean:write name="element" property="description" /></td>
   </tr>
   </logic:iterate>
   </table>

   <p>Sumbit to add an item:</p>
   
   <!-- This form will post the submitted data 
   to the addItem Action Mapping -->
   <html:form action="addItem.do" method="post">
      <table border=1>
         <tr><td>name:</td><td><html:text property="name" /></tr>
         <td>description:</td><td><html:text property="description" /></td></tr>
      </table><br/>
      <html:submit/>
   </html:form>
</body>

</html:html>

（十三）用Ant Build 
   为了编译这个例子中的源文件可以使用提供的build.xml文件，这将产生一个War压缩文件和帮助文档。

1、在 $TOMCAT/webapps/example1/WEB-INF/src目录下创建build.xml。

2、在$TOMCAT/webapps/example1/WEB-INF/src 目录下执行ant.

（十四）运行这个例子
重启Tomcat。