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

cyouagain發表於2021-01-11

原文來自公眾號【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="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://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="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
                        http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
                        http://www.springframework.org/schema/context
                        http://www.springframework.org/schema/context/spring-context-3.1.xsd http://www.springframework.org/schema/tx http://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="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans 
       http://www.springframework.org/schema/beans/spring-beans.xsd 
       http://www.springframework.org/schema/context 
       http://www.springframework.org/schema/context/spring-context.xsd 
       http://www.springframework.org/schema/mvc 
       http://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" 
"http://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" 
"http://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" 
"http://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;
	}
}

最後檢查程式碼,啟動服務,在瀏覽器位址列輸入:http://localhost:8080/sshDemo/test.jsp檢視效果。

7、下載相關

下載專案所需Jar包請在公眾號【C you again】回覆“Jar”。

下載完整專案原始碼請在公眾號【C you again】回覆“ssh”。

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

精彩推薦

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

相關文章