手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)

转载请注明出处:http://blog.csdn.net/anxpp/article/details/51415366,谢谢!

    本文会介绍从一个最基本的java工程,到Web工程,到集成Spring、SpringMVC、SpringDataJPA+Hibernate。

    平时我们可能是通过一个模板搭建一个工程,或者是直接导入一个项目,而本文选择从最基本的java工程开始,目的是为了展示更多原理。

    当然,我们还是从一个最基本的Maven工程开始,其实普通的非Maven工程,搭建过程几乎是一模一样的,只是Jar包需要我们手动的添加到工程中,而Maven工程就只是修改配置文件即可。推荐几篇相关文章:

  1.     Maven介绍及安装和在eclipse中的配置
  2.     Eclipse中使用Maven创建基本的web项目
  3.     Eclipse搭建Maven工程集成Spring4MVC
  4.     Eclipse搭建Maven工程集成Spring4+MVC+Hibernate5
  5.     JPA规范介绍及实例(Java数据持久化解决方案)

    对 Spring Data JPA 更详细的介绍,请戳->Spring ORM+Hibernate?Out!换 Spring Data JPA 吧!

    下面就正式开始。

1、基于Maven(如果不使用Maven也可以用传统的工程)创建最基本的Java工程

    新建工程,选择Maven Project,Next:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第1张图片

    勾选为简单的工程(Create a simple project),Next:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第2张图片

    Group id为你的域名反序,通常跟工程源码的包名对应,Artifact id为这个Group id中工程的唯一名,根据你的爱好,怎么填都行,然后Finish:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第3张图片

    这是得到的工程目录结构是这样的:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第4张图片

    pom.xml就是Maven的核心文件。

2、将工程设置为动态网页模式

    接下来就将工程转换为Web工程,右键打开工程属性,如图,点击左边菜单中的Project Facets,然后点击Convert to faceted from...:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第5张图片

    在右边,我们勾选Dynamic Web Module(动态网页),然后点OK:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第6张图片

    这时会多出一个WebContent目录:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第7张图片

    在WEB-INF目录下,添加web.xml文件,内如如下:

   
   
   
   
  1. xml version="1.0" encoding="UTF-8"?>
  2. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xmlns="http://java.sun.com/xml/ns/javaee"
  4. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
  5. version="3.0">
  6. SpringDataJPA
  7. index.html

    然后添加一个欢迎页index.html:

   
   
   
   
  1. Hello Word!

    这时目录结构如下:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第8张图片

    这时,就可以右键工程,Run On Server了,可以看下效果:

    10

3、集成Spring+SpringMVC

    新建包,并添加一些接口和类(具体代码后面会列出来),包结构如图:

    手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第9张图片

    需要添加jar包,直接修改pom文件即可,如果为普通工程,按pom.xml中的jar包,添加到工程中即可。

    首先添加使用的spring版本,方便统一管理,然后再添加所有需要的jar包,下面把此处需要的所有jar包添加进来,完成后的pom.xml如下:

   
   
   
   
  1. xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  2. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  3. 4.0.0
  4. com.anxpp
  5. SpringDataJPA
  6. 0.0.1-SNAPSHOT
  7. 4.2.5.RELEASE
  8. org.springframework
  9. spring-core
  10. ${spring.version}
  11. org.springframework
  12. spring-web
  13. ${spring.version}
  14. org.springframework
  15. spring-orm
  16. ${spring.version}
  17. org.springframework
  18. spring-tx
  19. ${spring.version}
  20. org.springframework
  21. spring-jdbc
  22. ${spring.version}
  23. org.springframework
  24. spring-webmvc
  25. ${spring.version}
  26. org.springframework
  27. spring-aop
  28. ${spring.version}
  29. org.springframework
  30. spring-context-support
  31. ${spring.version}
  32. org.springframework
  33. spring-test
  34. ${spring.version}
  35. org.springframework
  36. spring-orm
  37. ${spring.version}
  38. org.springframework.data
  39. spring-data-jpa
  40. 1.10.1.RELEASE

    在WEB-INF目录下添加Spring配置文件applicationContext.xml,并添加如下内容:

   
   
   
   
  1. xml version="1.0" encoding="UTF-8"?>
  2. xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
  4. xmlns:aop="http://www.springframework.org/schema/aop" xmlns:p="http://www.springframework.org/schema/p"
  5. xmlns:tx="http://www.springframework.org/schema/tx" xmlns:mvc="http://www.springframework.org/schema/mvc"
  6. xsi:schemaLocation="http://www.springframework.org/schema/beans
  7. http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
  8. http://www.springframework.org/schema/context
  9. http://www.springframework.org/schema/context/spring-context-4.2.xsd
  10. http://www.springframework.org/schema/tx
  11. http://www.springframework.org/schema/tx/spring-tx-4.2.xsd
  12. http://www.springframework.org/schema/aop
  13. http://www.springframework.org/schema/aop/spring-aop-4.2.xsd
  14. http://www.springframework.org/schema/mvc
  15. http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd">
  16. base-package="com.anxpp.demo" />
  17. />

    修改web.xml,将spring添加进去:

   
   
   
   
  1. xml version="1.0" encoding="UTF-8"?>
  2. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xmlns="http://java.sun.com/xml/ns/javaee"
  4. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
  5. version="3.0">
  6. SpringDataJPA
  7. org.springframework.web.context.ContextLoaderListener
  8. contextConfigLocation
  9. WEB-INF/applicationContext.xml
  10. springmvc
  11. org.springframework.web.servlet.DispatcherServlet
  12. contextConfigLocation
  13. classpath*:springmvc-servlet.xml
  14. 1
  15. springmvc
  16. /*
  17. index.html

    下面开始编写代码,注意注解不要忘记写,在本小节开始部分已经给出了包的层次结构。

    实体User:


    
    
    
    
  1. package com.anxpp.demo.core.entity;
  2. public class User {
  3. private Integer id;
  4. private String name;
  5. public User(Integer id, String name) {
  6. this.id = id;
  7. this.name = name;
  8. }
  9. public Integer getId() {
  10. return id;
  11. }
  12. public void setId(Integer id) {
  13. this.id = id;
  14. }
  15. public String getName() {
  16. return name;
  17. }
  18. public void setName(String name) {
  19. this.name = name;
  20. }
  21. @Override
  22. public String toString() {
  23. return "id:"+id+",name:"+name;
  24. }
  25. }

    dao层接口UserDao:


    
    
    
    
  1. package com.anxpp.demo.core.dao;
  2. import com.anxpp.demo.core.entity.User;
  3. public interface UserDao {
  4. User getUser(Integer id,String name);
  5. }

    dao层实现UserDaoImpl:


    
    
    
    
  1. package com.anxpp.demo.core.dao.impl;
  2. import org.springframework.stereotype.Repository;
  3. import com.anxpp.demo.core.dao.UserDao;
  4. import com.anxpp.demo.core.entity.User;
  5. @Repository
  6. public class UserDaoImpl implements UserDao{
  7. @Override
  8. public User getUser(Integer id, String name) {
  9. return new User(id, name);
  10. }
  11. }

    service层接口UserService:


    
    
    
    
  1. package com.anxpp.demo.core.service;
  2. import com.anxpp.demo.core.entity.User;
  3. public interface UserService {
  4. User getUser(Integer id, String name);
  5. }

    service层实现:


    
    
    
    
  1. package com.anxpp.demo.core.service.impl;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.stereotype.Service;
  4. import com.anxpp.demo.core.dao.UserDao;
  5. import com.anxpp.demo.core.entity.User;
  6. import com.anxpp.demo.core.service.UserService;
  7. @Service
  8. public class UserServiceImpl implements UserService{
  9. @Autowired
  10. UserDao userDao;
  11. @Override
  12. public User getUser(Integer id, String name) {
  13. return userDao.getUser(id, name);
  14. }
  15. }

    controller层DemoController:


    
    
    
    
  1. package com.anxpp.demo.controller;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.stereotype.Controller;
  4. import org.springframework.web.bind.annotation.RequestMapping;
  5. import org.springframework.web.bind.annotation.ResponseBody;
  6. import com.anxpp.demo.core.service.UserService;
  7. @Controller
  8. @RequestMapping("/")
  9. public class demoController {
  10. @Autowired
  11. UserService userService;
  12. @RequestMapping("/")
  13. @ResponseBody
  14. public String index(){
  15. return "index";
  16. }
  17. @RequestMapping("/getuser")
  18. @ResponseBody
  19. public String getUser(Integer id, String name){
  20. return userService.getUser(id, name).toString();
  21. }
  22. }

    这是还不能直接Run On Server,因为jar包不会被一同发布,我们需要如下配置:

    右键工程选择属性,按下图配置:手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载)_第10张图片

    这时候就可以运行测试了,效果如下:

    12

    13

    到这里,我们还没有操作数据库的。

4、添加返回Json格式数据支持

    现在,我们常使用json作为数据传输的格式,下面就为SpringMVC添加返回json的支持

    首先添加jar包:

   
   
   
   
  1. com.fasterxml.jackson.core
  2. jackson-databind
  3. 2.5.0
  4. com.fasterxml.jackson.core
  5. jackson-core
  6. 2.5.0
  7. com.fasterxml.jackson.core
  8. jackson-annotations
  9. 2.5.0

    然后改写getUser()方法如下:


    
    
    
    
  1. @RequestMapping("/getuser")
  2. @ResponseBody
  3. public Map<String, Object> getUser(Integer id, String name){
  4. Map<String, Object> map = new HashMap<String, Object>();
  5. map.put("state", "success");
  6. map.put("data", userService.getUser(id, name));
  7. return map;
  8. }

    重新运行后访问效果如下:

    14

    此时,就可以返回json数据了。

5、配置静态资源访问

    通常情况下,WEB-INF目录下的资源,我们是无法直接访问的,如果我们的网站是html+ajax构成的,那么就可以在WEB-INF之外新建html的目录,并为web.xml配置默认的过滤器,不过注意要放到SpingMVC过滤器之前:

   
   
   
   
  1. default
  2. *.html

    如果一定要访问WEB-INF目录内的资源,通过查阅Spring官方文档,发现有两种方式:

    1、手写一个资源映射器:


    
    
    
    
  1. @Configuration
  2. @EnableWebMvc
  3. public class WebConfig extends WebMvcConfigurerAdapter {
  4. @Override
  5. public void addResourceHandlers(ResourceHandlerRegistry registry) {
  6. registry.addResourceHandler("/resources/**")
  7. .addResourceLocations("/public-resources/")
  8. .setCacheControl(CacheControl.maxAge(1, TimeUnit.HOURS).cachePublic());
  9. }
  10. }

    可以看到,还可以设置缓存时间的,而更简单的方式,就是xml配置:


    
    
    
    
  1. mapping="/resources/**" location="/public-resources/">
  2. max-age="3600" cache-public="true"/>

    也可以加上下面的这个:

   
   
   
   
  1. />

6、乱码解决

    我们通常使用ajax提交请求,但也常用地址栏直接测试。请求提交分get和post。

    使用post提交请求是,一般是不会出现中文乱码的,但是如果确实出现了乱码,可以通过在web.xml添加一个编码过滤器解决:


    
    
    
    
  1. CharacterEncoding
  2. org.springframework.web.filter.CharacterEncodingFilter
  3. encoding
  4. UTF-8
  5. forceEncoding
  6. true
  7. CharacterEncoding
  8. /*

    上面只能解决post的中文乱码,对于get(含浏览器地址栏直接提交方式),我们需要修改tomcat配置,在conf目录下的server.xml中找到并如下修改:

   
   
   
   
  1. connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" URIEncoding="UTF-8"/>

    如果我们只是测试,项目并没有部署,可以直接在eclipse中的server下,找到server.xml,做出上面一样的改动即可:

18

7、整合SpringDataJPA+Hibernate

    你可以通过这篇文字了解JPA:JPA规范介绍及实例(Java数据持久化解决方案)

    SpringDataJPA也正是这样一种轻量级的解决方案,而首选的Hibernate就实现了JPA。

    首先还是jar包,SpringDataJPA的jar包,在之前整合Spring时已经一并加入,下面是Hibernate(和mysql驱动)的jar包:


    
    
    
    
  1. org.hibernate
  2. hibernate-core
  3. ${hibernate.version}
  4. org.hibernate
  5. hibernate-ehcache
  6. ${hibernate.version}
  7. org.hibernate
  8. hibernate-entitymanager
  9. ${hibernate.version}
  10. org.hibernate
  11. hibernate-c3p0
  12. ${hibernate.version}
  13. mysql
  14. mysql-connector-java
  15. 5.1.9

    统一管理的版本为:

   
   
   
   
  1. 5.1.0.Final

    添加Jpa的配置文件persistence.xml到META-INF目录下,本文介绍时数据库使用MySQL。并添加如下内容:

   
   
   
   
  1. xml version="1.0" encoding="UTF-8"?>
  2. version="1.0"
  3. xmlns="http://java.sun.com/xml/ns/persistence"
  4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5. xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd">
  6. name="demo" transaction-type="RESOURCE_LOCAL">
  7. org.hibernate.ejb.HibernatePersistence
  8. com.ninelephas.meerkat.pojo.User
  9. name="hibernate.connection.driver_class" value="com.mysql.jdbc.Driver" />
  10. name="hibernate.connection.url" value="jdbc:mysql://127.0.0.1:3306/demo?createDatabaseIfNotExist=true" />
  11. name="hibernate.connection.username" value="root" />
  12. name="hibernate.connection.password" value="root" />
  13. name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect" />

    Spring配置文件applicationContext.xml中增加JPA支持后的完整内容:

   
   
   
   
  1. xml version="1.0" encoding="UTF-8"?>
  2. xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
  4. xmlns:aop="http://www.springframework.org/schema/aop" xmlns:p="http://www.springframework.org/schema/p"
  5. xmlns:tx="http://www.springframework.org/schema/tx" xmlns:mvc="http://www.springframework.org/schema/mvc"
  6. xmlns:jpa="http://www.springframework.org/schema/data/jpa"
  7. xsi:schemaLocation="http://www.springframework.org/schema/beans
  8. http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
  9. http://www.springframework.org/schema/context
  10. http://www.springframework.org/schema/context/spring-context-4.2.xsd
  11. http://www.springframework.org/schema/tx
  12. http://www.springframework.org/schema/tx/spring-tx-4.2.xsd
  13. http://www.springframework.org/schema/aop
  14. http://www.springframework.org/schema/aop/spring-aop-4.2.xsd
  15. http://www.springframework.org/schema/mvc
  16. http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd
  17. http://www.springframework.org/schema/data/jpa
  18. http://www.springframework.org/schema/data/jpa/spring-jpa.xsd">
  19. base-package="com.anxpp.demo" />
  20. id="entityManagerFactory"
  21. class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">
  22. name="jpaVendorAdapter">
  23. class="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter">
  24. name="generateDdl" value="true" />
  25. name="database" value="MYSQL" />
  26. name="persistenceUnitName" value="demo" />
  27. />
  28. class="org.springframework.web.servlet.view.ContentNegotiatingViewResolver">
  29. name="viewResolvers">
  30. class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  31. name="prefix" value="/WEB-INF/view/" />
  32. name="suffix" value=".html" />
  33. name="defaultViews">
  34. class="org.springframework.web.servlet.view.json.MappingJackson2JsonView" />
  35. />
  36. id="transactionManager" class="org.springframework.orm.jpa.JpaTransactionManager">
  37. name="entityManagerFactory" ref="entityManagerFactory" />
  38. transaction-manager="transactionManager" />
  39. base-package="com.anxpp.demo" />

    修改实体:


    
    
    
    
  1. package com.anxpp.demo.core.entity;
  2. import javax.persistence.Entity;
  3. import javax.persistence.GeneratedValue;
  4. import javax.persistence.GenerationType;
  5. import javax.persistence.Id;
  6. import javax.persistence.Table;
  7. @Entity
  8. @Table
  9. public class User {
  10. @Id
  11. @GeneratedValue(strategy = GenerationType.AUTO)
  12. private Integer id;
  13. private String name;
  14. public User() {
  15. }
  16. public User(String name) {
  17. this.name = name;
  18. }
  19. public Integer getId() {
  20. return id;
  21. }
  22. public void setId(Integer id) {
  23. this.id = id;
  24. }
  25. public String getName() {
  26. return name;
  27. }
  28. public void setName(String name) {
  29. this.name = name;
  30. }
  31. @Override
  32. public String toString() {
  33. return "id:"+id+",name:"+name;
  34. }
  35. }

    可以删掉dao层实现了,我们记住将dao层接口继承自强大的JpaRepository:


    
    
    
    
  1. public interface UserDao extends JpaRepository<User, Serializable>{
  2. User findById(Integer id);
  3. }

    是不是看上去特别简洁,而且都不需要写实现的,SpringDataJPA会自动帮我们完成。

    修改service层接口:


    
    
    
    
  1. package com.anxpp.demo.core.service;
  2. import java.util.List;
  3. import com.anxpp.demo.core.entity.User;
  4. public interface UserService {
  5. User findById(Integer id);
  6. User save(String name);
  7. List<User> findAll();
  8. }

    修改service层实现:


    
    
    
    
  1. package com.anxpp.demo.core.service.impl;
  2. import java.util.List;
  3. import org.springframework.beans.factory.annotation.Autowired;
  4. import org.springframework.stereotype.Service;
  5. import com.anxpp.demo.core.dao.UserDao;
  6. import com.anxpp.demo.core.entity.User;
  7. import com.anxpp.demo.core.service.UserService;
  8. @Service
  9. public class UserServiceImpl implements UserService{
  10. @Autowired
  11. UserDao userDao;
  12. @Override
  13. public User findById(Integer id) {
  14. return userDao.findById(id);
  15. }
  16. @Override
  17. public User save(String name) {
  18. return userDao.save(new User(name));
  19. }
  20. @Override
  21. public List<User> findAll() {
  22. return userDao.findAll();
  23. }
  24. }

    修改controller,提供多个测试接口:


    
    
    
    
  1. package com.anxpp.demo.controller;
  2. import java.util.HashMap;
  3. import java.util.Map;
  4. import org.springframework.beans.factory.annotation.Autowired;
  5. import org.springframework.stereotype.Controller;
  6. import org.springframework.web.bind.annotation.RequestMapping;
  7. import org.springframework.web.bind.annotation.ResponseBody;
  8. import com.anxpp.demo.core.service.UserService;
  9. @Controller
  10. @RequestMapping("/")
  11. public class demoController {
  12. @Autowired
  13. UserService userService;
  14. @RequestMapping("/")
  15. @ResponseBody
  16. public String index(){
  17. return "index";
  18. }
  19. @RequestMapping("/info")
  20. public String info(){
  21. return "info";
  22. }
  23. @RequestMapping("/findall")
  24. @ResponseBody
  25. public Map<String, Object> getUser(){
  26. Map<String, Object> map = new HashMap<String, Object>();
  27. map.put("state", "success");
  28. map.put("data", userService.findAll());
  29. return map;
  30. }
  31. @RequestMapping("/findbyid")
  32. @ResponseBody
  33. public Map<String, Object> findById(Integer id){
  34. Map<String, Object> map = new HashMap<String, Object>();
  35. map.put("state", "success");
  36. map.put("data", userService.findById(id));
  37. return map;
  38. }
  39. @RequestMapping("/add")
  40. @ResponseBody
  41. public Map<String, Object> save(String name){
  42. Map<String, Object> map = new HashMap<String, Object>();
  43. map.put("state", "success");
  44. map.put("data", userService.save(name));
  45. return map;
  46. }
  47. }

    运行效果:

    15

    16

17

    那么,如果需要添加一个查找id大于指定值的指定姓氏的数据呢?

    如果是SQL,我们会这样写(?表示参数):


    
    
    
    
  1. SELECT * FROM user WHERE id>? AND name like '?%';

    但是这里,我们连SQL(或者HQL)都可以不用写,直接在dao层接口添加一个方法即可:


    
    
    
    
  1. List<User> findByIdGreaterThanAndNameLike(Integer id,String name);

    你不需要怀疑,上面的方法执行偏偏就是能成功(注意:service实现的使用,调用该方法记得name+"%")!


源码:

    github地址:https://github.com/anxpp/SpringMVC-SpringDataJpa-Hibernate-Demo

    本地下载:SpringMVC + Spring Data JPA + Hibernate

    CSDN下载(不需要积分):http://download.csdn.net/download/anxpp/9520498

你可能感兴趣的:(手把手教你从最基本的Java工程搭建SpringMVC+SpringDataJPA+Hibernate(含源码下载))