手把手教你搭建SSH框架(Eclipse版)

原文來自公眾號【C you again】,若需下載完整源碼,請在公眾號後台回復「ssh」。

本期文章詳細講解了SSH(Spring+SpringMVC+Hibernate)框架的搭建過程,語言簡潔、通俗易懂,適合初級程序員閱讀。在開始教程之前,先來了解SSH框架的基本概念:

在文章《手把手教你搭建SSM框架(Eclipse版)》中已經對Spring、SpringMVC做了詳細介紹,這裡只對Hibernate做介紹。

Hibernate是一個開放源代碼的對象關係映射框架,它對JDBC進行了非常輕量級的對象封裝,它將Pojo與數據庫表建立映射關係,是一個全自動的ORM框架。

Hibernate可以自動生成SQL語句,自動執行,使得Java程序員可以隨心所欲的使用面向對象編程思想來操縱數據庫。

Hibernate可以應用在任何使用JDBC的場合,既可以在Java的客戶端程序使用,也可以在Servlet/JSP的Web應用中使用。

看完以上概念,我們就正式開始今天的教程了。製作不易,多多轉發分享哦!!

1、前期準備

  • 安裝配置JDK1.8
  • 安裝配置Tomcat9.0
  • 安裝配置MySql5.7
  • 開發工具Eclipse

2、新建動態Web項目

在開發工具中:

File–>New–>Project–>Dynamic Web Project

輸入項目名稱(本教程項目名:sshDemo),最後點擊Finish即可。

3、補充、完善項目目錄

為使得項目符合MVC開發規範,我們需要在src下新建controller、service、entity幾個包和resources目錄。完成後目錄結構如下圖:

4、導入所需Jar包

本期教程用最原始的方法手動導入項目所需Jar包。手動導入會存在Jar包版本衝突等很多問題,建議直接下載使用。在公眾號【C you again】後台回復「Jar」自行下載,若不能正常下載,請在後台私信。

將下載好的Jar包複製到WebContent–>WEB-INF–>lib文件夾下,然後選中所有Jar包–>鼠標右擊–>Build Path–>Add to Build Path。

5、添加相關配置文件

完成以上基本步驟後,接下來就是SSH整合的關鍵步驟了。

首先在項目的WebContent–>WEB-INF下的web.xml文件中加入以下配置,如果沒有web.xml文件就需要自己新建一個。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="//www.w3.org/2001/XMLSchema-instance"
    xmlns="//java.sun.com/xml/ns/javaee"
    xmlns:web="//java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    xsi:schemaLocation="//java.sun.com/xml/ns/javaee //java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    id="WebApp_ID" version="2.5">
    
    <welcome-file-list>
        <welcome-file>test.jsp</welcome-file>
    </welcome-file-list>
    <!-- 加載spring容器 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath*:application.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- 解決post亂碼 -->
    <filter>
        <filter-name>CharacterEncodingFilter</filter-name>
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>utf-8</param-value>
        </init-param>

    </filter>
    <filter-mapping>
        <filter-name>CharacterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>


    <servlet>
        <servlet-name>springMvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath*:springmvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springMvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

完成web.xml的配置後,在前面建好的resources文件夾下新建application.xml,具體解釋看文件內部。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="//www.springframework.org/schema/beans"
       xmlns:xsi="//www.w3.org/2001/XMLSchema-instance"
       xmlns:context="//www.springframework.org/schema/context" xmlns:tx="//www.springframework.org/schema/tx"
       xsi:schemaLocation="//www.springframework.org/schema/beans
                        //www.springframework.org/schema/beans/spring-beans-3.1.xsd
                        //www.springframework.org/schema/context
                        //www.springframework.org/schema/context/spring-context-3.1.xsd //www.springframework.org/schema/tx //www.springframework.org/schema/tx/spring-tx.xsd">
    <!-- 自動掃描 -->
    <context:component-scan base-package="com.cya"/>

    <!-- 引入配置文件 -->
    <bean id="propertyConfigurer"
          class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">    
        <property name="locations">
                <value>classpath*:dbconfig.properties</value>
        </property>
    </bean>

    <!-- 配置數據庫連接池 -->
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"
        destroy-method="close">
        <property name="url" value="${jdbc.url}" />
        <property name="username" value="${jdbc.username}" />
        <property name="password" value="${jdbc.password}" />
        <property name="driverClassName" value="${jdbc.driver}" />
        <property name="maxActive" value="10" />
        <property name="minIdle" value="5" />
    </bean>
    
    
    <!-- spring與hibernate整合 -->
    <bean id="sqlSessionFactory"
        class="org.springframework.orm.hibernate3.LocalSessionFactoryBean">
        <property name="dataSource" ref="dataSource"></property>
        <!-- hibernate配置信息 -->
        <property name="hibernateProperties">
            <props>
            <prop key="hibernate.dialect">${hibernate.dialect}</prop>
            <prop key="hibernate.show_sql">${hibernate.show_sql}</prop>
            <prop key="hibernate.format_sql">${hibernate.format_sql}</prop>
            <prop key="hibernate.hbm2ddl.auto">${hibernate.hbm2ddl.auto}</prop>
            </props>
        </property>

        <property name="configLocations">
            <list>
                <value> classpath*:hibernate.cfg.xml</value>
            </list>
        </property>
    </bean>

    <!-- 配置hibernateTemplate(可將Hibernate 的持久層訪問模板化) -->
    <bean id="hibernateTemplate" class="org.springframework.orm.hibernate3.HibernateTemplate">
        <property name="sessionFactory" ref="sqlSessionFactory"></property>
    </bean>

    <!-- 事務管理 -->
    <bean id="transactionManager"
          class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>

    <!--支持事務註解的(@Transactional)-->
    <tx:annotation-driven transaction-manager="transactionManager"/>

</beans>

接着在resources文件夾下新建springmvc.xml,代碼如下:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="//www.springframework.org/schema/beans"
       xmlns:xsi="//www.w3.org/2001/XMLSchema-instance"
       xmlns:context="//www.springframework.org/schema/context"
       xmlns:mvc="//www.springframework.org/schema/mvc"
       xsi:schemaLocation="//www.springframework.org/schema/beans 
       //www.springframework.org/schema/beans/spring-beans.xsd 
       //www.springframework.org/schema/context 
       //www.springframework.org/schema/context/spring-context.xsd 
       //www.springframework.org/schema/mvc 
       //www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 自動裝配 -->
    <context:component-scan base-package="com.cya.controller" />
    <!-- 啟用spring mvc 註解 -->
    <mvc:annotation-driven />

    <!--視圖解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--前綴-->
        <property name="prefix" value="/WEB-INF/"/>
        <!--後綴-->
        <property name="suffix" value=".jsp"></property>
    </bean>
    
    <!-- 文件上傳 -->
    <bean id="multipartResolver"
          class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!-- 默認編碼 -->
        <property name="defaultEncoding" value="utf-8"/>
        <!-- 文件大小最大值 -->
        <property name="maxUploadSize" value="10485760000"/>
        <!-- 內存中的最大值 -->
        <property name="maxInMemorySize" value="40960"/>
    </bean>

</beans>

同上面的步驟,繼續在resources文件夾下新建hibernate.cfg.xml、dbconfig.properties、log4j.properties三個文件。

hibernate.cfg.xml文件:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"//hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>
    <!-- 設置映射的xml文件  -->
        
    </session-factory>
</hibernate-configuration>

dbconfig.properties文件:

#database connection config
jdbc.driver = com.mysql.jdbc.Driver
jdbc.url = jdbc:mysql://localhost:3306/test?characterEncoding=utf-8&useSSL=false
jdbc.username = root
jdbc.password = root

#hibernate config
hibernate.dialect = org.hibernate.dialect.MySQLDialect
hibernate.show_sql = true
hibernate.format_sql = true
hibernate.hbm2ddl.auto = update

log4j.properties文件:

# Set root logger level to error
log4j.rootLogger=INFO, Console, File

###### Console appender definition #######

# All outputs currently set to be a ConsoleAppender.
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d{ABSOLUTE} %-5p [%c{3}] %m%n
#log4j.appender.Console.layout.ConversionPattern=%d{ABSOLUTE} %-5p [%c] %m%n

###### File appender definition #######
log4j.appender.File=org.apache.log4j.DailyRollingFileAppender
log4j.appender.File.File=spring.log
log4j.appender.File.Append=false
log4j.appender.File.layout=org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern=%d{ABSOLUTE} %-5p [%c] %m%n

至此,所有的整合步驟已經完成了,最後的目錄結構如下所示,接下來就是設計測試用例了。

6、測試項目能否正常運行

完成上述步驟後,接下來就測試下整合是否成功吧!

在src–>com.cya.entity下創建Person.java實體類

package com.cya.entity;

public class Person {
	private int id;
	private String name;
	private int age;
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
	
}

在resources下新建mapping目錄,用來保存所有的數據庫映射文件。mapping目錄下創建映射文件:Person.hbm.xml,具體配置如下:

<?xml version="1.0" encoding="utf-8"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"//hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
    <class name="com.cya.entity.Person" table="t_person">
        <id name="id" type="java.lang.Integer" column="p_id" >
            <generator class="increment"></generator>
        </id>
        <property name="name" type="java.lang.String" column="p_name"></property>
        <property name="age" type="java.lang.Integer" column="p_age"></property>
    </class>
</hibernate-mapping>

修改hibernate.cfg.xml,添加配置:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC 
"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"//hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>
    <!-- 設置映射的xml文件  -->
        <mapping resource="mapping/Person.hbm.xml"/>
    </session-factory>
</hibernate-configuration>

修改完成後啟動web項目,待項目啟動成功以後刷新test數據庫,我們發現已經創建好了名為t_person的數據表。

在WebContent文件夾下新建test.jsp。

<%@ page language="java" contentType="text/html; charset=utf-8"
	pageEncoding="utf-8"%>
<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>測試SSH整合</title>
</head>
<body>
	<h3>
		<a href="addPerson">添加並查看Person信息</a>
	</h3>
</body>
</html>

在src–>com.cya.service下創建IPersonService.java接口。

package com.cya.service;

import java.util.List;

import com.cya.entity.Person;

public interface IPersonService {
	
	public boolean addPerson(Person person);
	
	public List<Person> getPerson(String sql);
	
}

在src下新建com.cya.service.impl包,並創建PersonServiceImpl.java類實現IPersonService.java接口中的getPerson()和addPerson()兩個方法。

package com.cya.service.impl;

import java.util.List;

import javax.annotation.Resource;

import org.springframework.orm.hibernate3.HibernateTemplate;
import org.springframework.stereotype.Service;

import com.cya.entity.Person;
import com.cya.service.IPersonService;


@Service
public class PersonServiceImpl implements IPersonService{

	@Resource(name="hibernateTemplate")
	private HibernateTemplate hibernateTemplate;
	
	@Override
	public boolean addPerson(Person person) {
		// TODO Auto-generated method stub
		boolean result=true;
		try {
			hibernateTemplate.save(person);
		} catch (Exception e) {
			// TODO: handle exception
			result=false;
		}
		return result;
		
	}

	@Override
	public List<Person> getPerson(String sql) {
		// TODO Auto-generated method stub
		return (List<Person>) hibernateTemplate.find(sql);
	}

}

在src–>com.cya.controller包下新建class,這裡取名為Test.java,去調用PersonServiceImpl.java中的方法。

package com.cya.controller;

import java.util.List;

import javax.annotation.Resource;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

import com.cya.entity.Person;
import com.cya.service.IPersonService;

@Controller
@ResponseBody
public class Test {
	
	@Resource
	private IPersonService personServiceImpl;
	
	@RequestMapping("addPerson")
	public List<Person> getPerson() {
	  Person person=new Person();
	  person.setAge(15);
	  person.setName("test");
	  boolean status=personServiceImpl.addPerson(person);
	  if(status)return personServiceImpl.getPerson("from com.cya.entity.Person");
	  else return null;
	}
}

最後檢查代碼,啟動服務,在瀏覽器地址欄輸入://localhost:8080/sshDemo/test.jsp查看效果。

7、下載相關

下載項目所需Jar包請在公眾號【C you again】回復「Jar」。

下載完整項目源碼請在公眾號【C you again】回復「ssh」。

本期分享就到這裡,因本人技術有限,文章難免會出現一些錯誤,歡迎指正。創作不易,大家多多轉發點贊,感謝。

精彩推薦

《手把手教你搭建SSM框架(Eclipse版)》