• Tutorial:Create Spring 3 MVC Hibernate 3 Example using Maven in Eclipse

    Let us make a complete end-to-end application using Spring 3.0 MVC as front end technology and Hibernate as backend ORM technology. For this application we will also use Maven for build and dependency management and MySQL as database to persist the data.

    The application will be a simple Contact Manager app which will allow user to add new contacts. The list of contacts will be displayed and user will be able to delete existing contacts.

    Our Goal

    As describe above, our goal is to create a contact manager application which will allow the user to add a contact or remove it. The basic requirement of the Contact Manager app will be:

    1. Add new contact in the contact list.
    2. Display all contacts from contact list.
    3. Delete a contact from contact list.

    Following is the screenshot of end application.
    spring3-hibernate-contact-manager

    Application Architecture

    We will have a layered architecture for our demo application. The database will be accessed by a Data Access layer popularly called as DAO Layer. This layer will use Hibernate API to interact with database. The DAO layer will be invoked by a service layer. In our application we will have a Service interface called ContactService.
    spring3-hibernate-application-architecture

    Getting Started

    For our Contact Manager example, we will use MySQL database. Create a table contacts in any MySQL database. This is very preliminary example and thus we have minimum columns to represent a contact. Feel free to extend this example and create a more complex application.

    1
    2
    3
    4
    5
    6
    7
    8
    9
    CREATE TABLE CONTACTS
    (
        id              INT PRIMARY KEY AUTO_INCREMENT,
        firstname    VARCHAR(30),
        lastname    VARCHAR(30),
        telephone   VARCHAR(15),
        email         VARCHAR(30),
        created     TIMESTAMP DEFAULT NOW()
    );

    Creating Project in Eclipse

    The contact manager application will use Maven for build and dependency management. For this we will use the Maven Dynamic Web Project in Eclipse as the base architecture of our application.

    Download the below source code:
    Maven Dynamic Web Project (6.7 KB)

    spring3-hibernate-project-structureUnzip the source code to your hard drive and import the project in Eclipse. Once the project is imported in Eclipse, we will create package structure for Java source. Create following packages under src/main/java folder.

    • net.viralpatel.contact.controller – This package will contain Spring Controller classes for Contact Manager application.
    • net.viralpatel.contact.form – This package will contain form object for Contact manager application. Contact form will be a simple POJO class with different attributes such as firstname, lastname etc.
    • net.viralpatel.contact.service – This package will contain code for service layer for our Contact manager application. The service layer will have one ContactService interface and its corresponding implementation class
    • net.viralpatel.contact.dao – This is the DAO layer of Contact manager application. It consists of ContactDAO interface and its corresponding implementation class. The DAO layer will use Hibernate API to interact with database.

    Entity Class – The Hibernate domain class

    Let us start with the coding of Contact manager application. First we will create a form object or hibernate POJO class to store contact information. Also this class will be an Entity class and will be linked with CONTACTS table in database.
    Create a java class Contact.java under net.viralpatel.contact.form package and copy following code into it.

    File: src/main/java/net/viralpatel/contact/form/Contact.java

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    package net.viralpatel.contact.form;
     
    import javax.persistence.Column;
    import javax.persistence.Entity;
    import javax.persistence.GeneratedValue;
    import javax.persistence.Id;
    import javax.persistence.Table;
     
    @Entity
    @Table(name="CONTACTS")
    public class Contact {
     
        @Id
        @Column(name="ID")
        @GeneratedValue
        private Integer id;
     
        @Column(name="FIRSTNAME")
        private String firstname;
     
        @Column(name="LASTNAME")
        private String lastname;
     
        @Column(name="EMAIL")
        private String email;
     
        @Column(name="TELEPHONE")
        private String telephone;
     
        public String getEmail() {
            return email;
        }
        public String getTelephone() {
            return telephone;
        }
        public void setEmail(String email) {
            this.email = email;
        }
        public void setTelephone(String telephone) {
            this.telephone = telephone;
        }
        public String getFirstname() {
            return firstname;
        }
        public String getLastname() {
            return lastname;
        }
        public void setFirstname(String firstname) {
            this.firstname = firstname;
        }
        public void setLastname(String lastname) {
            this.lastname = lastname;
        }
        public Integer getId() {
            return id;
        }
        public void setId(Integer id) {
            this.id = id;
        }
    }

    The first thing you’ll notice is that the import statements import from javax.persistence rather than a Hibernate or Spring package. Using Hibernate with Spring, the standard JPA annotations work just as well and that’s what I’m using here.

    • First we’ve annotated the class with @Entity which tells Hibernate that this class represents an object that we can persist.
    • The @Table(name = "CONTACTS") annotation tells Hibernate which table to map properties in this class to. The first property in this class on line 16 is our object ID which will be unique for all events persisted. This is why we’ve annotated it with @Id.
    • The @GeneratedValue annotation says that this value will be determined by the datasource, not by the code.
    • The @Column(name = "FIRSTNAME") annotation is used to map this property to the FIRSTNAME column in the CONTACTS table.

    The Data Access (DAO) Layer

    The DAO layer of Contact Manager application consist of an interface ContactDAO and its corresponding implementation class ContactDAOImpl. Create following Java files in net.viralpatel.contact.daopackage.

    File: src/main/java/net/viralpatel/contact/dao/ContactDAO.java

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    package net.viralpatel.contact.dao;
     
    import java.util.List;
     
    import net.viralpatel.contact.form.Contact;
     
    public interface ContactDAO {
     
        public void addContact(Contact contact);
        public List<Contact> listContact();
        public void removeContact(Integer id);
    }

    File: src/main/java/net/viralpatel/contact/dao/ContactDAOImpl.java

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    package net.viralpatel.contact.dao;
     
    import java.util.List;
     
    import net.viralpatel.contact.form.Contact;
     
    import org.hibernate.SessionFactory;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Repository;
     
    @Repository
    public class ContactDAOImpl implements ContactDAO {
     
        @Autowired
        private SessionFactory sessionFactory;
     
        public void addContact(Contact contact) {
            sessionFactory.getCurrentSession().save(contact);
        }
     
        public List<Contact> listContact() {
     
            return sessionFactory.getCurrentSession().createQuery("from Contact")
                    .list();
        }
     
        public void removeContact(Integer id) {
            Contact contact = (Contact) sessionFactory.getCurrentSession().load(
                    Contact.class, id);
            if (null != contact) {
                sessionFactory.getCurrentSession().delete(contact);
            }
     
        }
    }

    The DAO class in above code ContactDAOImpl implements the data access interface ContactDAO which defines methods such as listContact(), addContact() etc to access data from database.

    Note that we have used two Spring annotations @Repository and @Autowired.

    Classes marked with annotations are candidates for auto-detection by Spring when using annotation-based configuration and classpath scanning. The @Component annotation is the main stereotype that indicates that an annotated class is a “component”.

    The @Repository annotation is yet another stereotype that was introduced in Spring 2.0. This annotation is used to indicate that a class functions as a repository and needs to have exception translation applied transparently on it. The benefit of exception translation is that the service layer only has to deal with exceptions from Spring’s DataAccessException hierarchy, even when using plain JPA in the DAO classes.

    Another annotation used in ContactDAOImpl is @Autowired. This is used to autowire the dependency of the ContactDAOImpl on the SessionFactory.

    The Service Layer

    The Service layer of Contact Manager application consist of an interface ContactService and its corresponding implementation class ContactServiceImpl. Create following Java files innet.viralpatel.contact.service package.

    File: src/main/java/net/viralpatel/contact/service/ContactService.java

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    package net.viralpatel.contact.service;
     
    import java.util.List;
     
    import net.viralpatel.contact.form.Contact;
     
    public interface ContactService {
     
        public void addContact(Contact contact);
        public List<Contact> listContact();
        public void removeContact(Integer id);
    }

    File: src/main/java/net/viralpatel/contact/service/ContactServiceImpl.java

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    package net.viralpatel.contact.service;
     
    import java.util.List;
     
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Service;
    import org.springframework.transaction.annotation.Transactional;
     
    import net.viralpatel.contact.dao.ContactDAO;
    import net.viralpatel.contact.form.Contact;
     
    @Service
    public class ContactServiceImpl implements ContactService {
     
        @Autowired
        private ContactDAO contactDAO;
     
        @Transactional
        public void addContact(Contact contact) {
            contactDAO.addContact(contact);
        }
     
        @Transactional
        public List<Contact> listContact() {
     
            return contactDAO.listContact();
        }
     
        @Transactional
        public void removeContact(Integer id) {
            contactDAO.removeContact(id);
        }
    }

    In above service layer code, we have created an interface ContactService and implemented it in classContactServiceImpl. Note that we used few Spring annotations such as @Service, @Autowired and@Transactional in our code. These annotations are called Spring stereotype annotations.

    The @Service stereotype annotation used to decorate the ContactServiceImpl class is a specialized form of the @Component annotation. It is appropriate to annotate the service-layer classes with @Service to facilitate processing by tools or anticipating any future service-specific capabilities that may be added to this annotation.

    Adding Spring MVC Support

    Let us add Spring MVC support to our web application.

    Update the web.xml file and add servlet mapping for org.springframework.web.servlet.DispatcherServlet. Also note that we have mapped url / with springServlet so all the request are handled by spring.

    File: /src/webapp/WEB-INF/web.xml

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    <?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">
        <display-name>Spring3-Hibernate</display-name>
        <welcome-file-list>
            <welcome-file>list.html</welcome-file>
        </welcome-file-list>
        <servlet>
            <servlet-name>spring</servlet-name>
            <servlet-class>
                org.springframework.web.servlet.DispatcherServlet
            </servlet-class>
            <load-on-startup>1</load-on-startup>
        </servlet>
        <servlet-mapping>
            <servlet-name>spring</servlet-name>
            <url-pattern>/</url-pattern>
        </servlet-mapping>
    </web-app>

    Once the web.xml is configured, let us add spring-servlet.xml and jdbc.properties files in /src/main/webapp/WEB-INF folder.
    File: /src/main/webapp/WEB-INF/jdbc.properties

    1
    2
    3
    4
    5
    jdbc.driverClassName= com.mysql.jdbc.Driver
    jdbc.dialect=org.hibernate.dialect.MySQLDialect
    jdbc.databaseurl=jdbc:mysql://localhost:3306/ContactManager
    jdbc.username=root
    jdbc.password=testpass

    The jdbc.properties file contains database connection information such as database url, username, password, driver class. You may want to edit the driverclass and dialect to other DB if you are not using MySQL.

    File: /src/main/webapp/WEB-INF/spring-servlet.xml

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    <?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:aop="http://www.springframework.org/schema/aop"
        xmlns:context="http://www.springframework.org/schema/context"
        xmlns:jee="http://www.springframework.org/schema/jee"
        xmlns:lang="http://www.springframework.org/schema/lang"
        xmlns:p="http://www.springframework.org/schema/p"
        xmlns:tx="http://www.springframework.org/schema/tx"
        xmlns:util="http://www.springframework.org/schema/util"
        xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
            http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd
            http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd
            http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee.xsd
            http://www.springframework.org/schema/lang http://www.springframework.org/schema/lang/spring-lang.xsd
            http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd
            http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util.xsd">
     
        <context:annotation-config />
        <context:component-scan base-package="net.viralpatel.contact" />
     
        <bean id="jspViewResolver"
            class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name="viewClass"
                value="org.springframework.web.servlet.view.JstlView" />
            <property name="prefix" value="/WEB-INF/jsp/" />
            <property name="suffix" value=".jsp" />
        </bean>
     
        <bean id="messageSource"
            class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
            <property name="basename" value="classpath:messages" />
            <property name="defaultEncoding" value="UTF-8" />
        </bean>
        <bean id="propertyConfigurer"
            class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"
            p:location="/WEB-INF/jdbc.properties" />
     
        <bean id="dataSource"
            class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"
            p:driverClassName="${jdbc.driverClassName}"
            p:url="${jdbc.databaseurl}" p:username="${jdbc.username}"
            p:password="${jdbc.password}" />
     
        <bean id="sessionFactory"
            class="org.springframework.orm.hibernate3.LocalSessionFactoryBean">
            <property name="dataSource" ref="dataSource" />
            <property name="configLocation">
                <value>classpath:hibernate.cfg.xml</value>
            </property>
            <property name="configurationClass">
                <value>org.hibernate.cfg.AnnotationConfiguration</value>
            </property>
            <property name="hibernateProperties">
                <props>
                    <prop key="hibernate.dialect">${jdbc.dialect}</prop>
                    <prop key="hibernate.show_sql">true</prop>
                </props>
            </property>
        </bean>
     
        <tx:annotation-driven />
        <bean id="transactionManager"
            class="org.springframework.orm.hibernate3.HibernateTransactionManager">
            <property name="sessionFactory" ref="sessionFactory" />
        </bean>
    </beans>

    The spring-servlet.xml file contains different spring mappings such as transaction manager, hibernate session factory bean, data source etc.

    • jspViewResolver bean – This bean defined view resolver for spring mvc. For this bean we also set prefix as “/WEB-INF/jsp/” and suffix as “.jsp”. Thus spring automatically resolves the JSP from WEB-INF/jsp folder and assigned suffix .jsp to it.
    • messageSource bean – To provide Internationalization to our demo application, we defined bundle resource property file called messages.properties in classpath. 
      Related: Internationalization in Spring MVC
    • propertyConfigurer bean – This bean is used to load database property file jdbc.properties. The database connection details are stored in this file which is used in hibernate connection settings.
    • dataSource bean – This is the java datasource used to connect to contact manager database. We provide jdbc driver class, username, password etc in configuration.
    • sessionFactory bean – This is Hibernate configuration where we define different hibernate settings. hibernate.cfg.xml is set a config file which contains entity class mappings
    • transactionManager bean – We use hibernate transaction manager to manage the transactions of our contact manager application.

    File: /src/main/resources/hibernate.cfg.xml

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    <?xml version='1.0' encoding='utf-8'?>
    <!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD//EN"
        "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
     
    <hibernate-configuration>
        <session-factory>
            <mapping class="net.viralpatel.contact.form.Contact" />
        </session-factory>
     
    </hibernate-configuration>

    File: /src/main/resources/messages_en.properties

    1
    2
    3
    4
    5
    6
    7
    8
    9
    label.firstname=First Name
    label.lastname=Last Name
    label.email=Email
    label.telephone=Telephone
    label.addcontact=Add Contact
     
    label.menu=Menu
    label.title=Contact Manager
    label.footer=&copy; ViralPatel.net

    Spring MVC Controller

    We are almost done with our application. Just add following Spring controller class ContactController.java to net.viralpatel.contact.controller package.

    File: /src/main/java/net/viralpatel/contact/controller/ContactController.java

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    package net.viralpatel.contact.controller;
     
    import java.util.Map;
     
    import net.viralpatel.contact.form.Contact;
    import net.viralpatel.contact.service.ContactService;
     
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Controller;
    import org.springframework.validation.BindingResult;
    import org.springframework.web.bind.annotation.ModelAttribute;
    import org.springframework.web.bind.annotation.PathVariable;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
     
    @Controller
    public class ContactController {
     
        @Autowired
        private ContactService contactService;
     
        @RequestMapping("/index")
        public String listContacts(Map<String, Object> map) {
     
            map.put("contact", new Contact());
            map.put("contactList", contactService.listContact());
     
            return "contact";
        }
     
        @RequestMapping(value = "/add", method = RequestMethod.POST)
        public String addContact(@ModelAttribute("contact")
        Contact contact, BindingResult result) {
     
            contactService.addContact(contact);
     
            return "redirect:/index";
        }
     
        @RequestMapping("/delete/{contactId}")
        public String deleteContact(@PathVariable("contactId")
        Integer contactId) {
     
            contactService.removeContact(contactId);
     
            return "redirect:/index";
        }
    }

    The spring controller defines three methods to manipulate contact manager application.

    • listContacts method – This method uses Service interface ContactServer to fetch all the contact details in our application. It returns an array of contacts. Note that we have mapped request “/index” to this method. Thus Spring will automatically calls this method whenever it encounters this url in request.
    • addContact method – This method adds a new contact to contact list. The contact details are fetched in Contact object using @ModelAttribute annotation. Also note that the request “/add” is mapped with this method. The request method should also be POST. Once the contact is added in contact list using ContactService, we redirect to /index page which in turn calls listContacts()method to display contact list to user. 
      Related: Forms in Spring MVC
    • deleteContact method – This methods removes a contact from the contact list. Similar to addContactthis method also redirects user to /index page once the contact is removed. One this to note in this method is the way we have mapped request url using @RequestMapping annotation. The url “/delete/{contactId}” is mapped thus whenever user send a request /delete/12, the deleteCotact method will try to delete contact with ID:12.

    Finally add following JSP file to WEB-INF/jsp folder.

    File: /src/main/webapp/WEB-INF/jsp/contact.jsp

    01
    02
    03
    04
    05
    06
    07
    08
    09
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    <%@taglib uri="http://www.springframework.org/tags" prefix="spring"%>
    <%@taglib uri="http://www.springframework.org/tags/form" prefix="form"%>
    <%@taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
    <html>
    <head>
        <title>Spring 3 MVC Series - Contact Manager | viralpatel.net</title>
    </head>
    <body>
     
    <h2>Contact Manager</h2>
     
    <form:form method="post" action="add.html" commandName="contact">
     
        <table>
        <tr>
            <td><form:label path="firstname"><spring:message code="label.firstname"/></form:label></td>
            <td><form:input path="firstname" /></td>
        </tr>
        <tr>
            <td><form:label path="lastname"><spring:message code="label.lastname"/></form:label></td>
            <td><form:input path="lastname" /></td>
        </tr>
        <tr>
            <td><form:label path="email"><spring:message code="label.email"/></form:label></td>
            <td><form:input path="email" /></td>
        </tr>
        <tr>
            <td><form:label path="telephone"><spring:message code="label.telephone"/></form:label></td>
            <td><form:input path="telephone" /></td>
        </tr>
        <tr>
            <td colspan="2">
                <input type="submit" value="<spring:message code="label.addcontact"/>"/>
            </td>
        </tr>
    </table>
    </form:form>
     
    <h3>Contacts</h3>
    <c:if  test="${!empty contactList}">
    <table class="data">
    <tr>
        <th>Name</th>
        <th>Email</th>
        <th>Telephone</th>
        <th>&nbsp;</th>
    </tr>
    <c:forEach items="${contactList}" var="contact">
        <tr>
            <td>${contact.lastname}, ${contact.firstname} </td>
            <td>${contact.email}</td>
            <td>${contact.telephone}</td>
            <td><a href="delete/${contact.id}">delete</a></td>
        </tr>
    </c:forEach>
    </table>
    </c:if>
     
    </body>
    </html>

    Download Source code

    Click here to download full source code of Contact manager application (16 KB)

    That’s All folks

    Compile and execute the Contact manager application in Eclipse.
    spring3-hibernate-contact-manager

    If you read this far, you should follow me on twitter here.
  • 相关阅读:
    Android Studio安装与配置
    T-SQL:qualify和window 使用（十七）
    《c#图解教程》
    c# 创建，加载，修改XML文档
    c# 使用迭代器来创建可枚举类型
    C#上手练习3（while、do while语句）(添加机器人聊天)
    C#上手练习2（FOR语句）
    C#上手练习1（if语句、Swich语句）
    解决java导入project出现红叉
    ABAP ALV显示前排序合并及布局显示
  • 原文地址：https://www.cnblogs.com/chenying99/p/2469580.html
Copyright © 2020-2023  润新知