Hướng dẫn lập trình Spring MVC cho người mới bắt đầu - Hello Spring 4 MVC

Tóm Tắt

1- Giới thiệu

Tài liệu hướng dẫn này được viết dựa trên :

Eclipse 4.6 (NEON)
Spring 4.0.3.RELEASE

Gợi ý: Bạn nên xem trước tài liệu giới thiệu về cấu trúc Spring Framework, và bản chất Spring làm gì, thông qua một hướng dẫn HelloWorld Spring tại:

Hướng dẫn lập trình Spring cho người mới bắt đầu

(Mục tiêu: Giới thiệu về Spring, giải thích @Service, @Component, @Repository, … và ví dụ HelloWorld)

Bạn đang đọc: Hướng dẫn lập trình Spring MVC cho người mới bắt đầu – Hello Spring 4 MVC

Xem trước ví dụ :

2- Tạo Maven Project

Tạo một Project kiểu Maven. Maven giúp chúng ta quản lý thư viện một cách tốt nhất. Bạn sẽ rảnh tay để xử lý các vấn đề khác.

Trên Eclipse chọn:

File/New/Other…

Chọn nguyên mẫu (archetype) “maven-archetype-webapp”.

Nhập vào :

Group Id: org.o7planning
Artifact Id: HelloSpringMVC
Package: org.o7planning.hellospringmvc

Đây là cấu trúc Project được tạo ra :

Bạn đừng lo lắng với thông báo lỗi khi Project vừa được tạo ra. Lý do là bạn chưa khai báo thư viện Servlet.

Eclipse tạo ra project Maven có thể sai cấu trúc. Bạn cần phải kiểm tra.

Đảm bảo rằng bạn sử dụng Java >= 6

Project Properties:

3- Khai báo Maven và web.xml

Khai báo sử dụng thư viện :
pom.xml



  4.0.0
  org.o7planning
  HelloSpringMVC
  war
  0.0.1-SNAPSHOT
  HelloSpringMVC Maven Webapp
  http://maven.apache.org


    

        
            junit
            junit
            3.8.1
            test
        

        
        
        
            javax.servlet
            javax.servlet-api
            3.1.0
            provided
        

        
        
        
            org.springframework
            spring-core
            4.3.1.RELEASE
        

        
        
            org.springframework
            spring-web
            4.3.1.RELEASE
        

        
        
            org.springframework
            spring-webmvc
            4.3.1.RELEASE
        

    
   

    
        HelloSpringMVC
        
       
            
            
            
                org.apache.tomcat.maven
                tomcat7-maven-plugin
                2.2

Sử dụng Servlet API 3 hoặc mới hơn:

web.xml




   
    HelloSpringMVC

4- Cấu hình Spring MVC

SpringWebAppInitializer là class thi hành (implements) interface WebApplicationInitializer. Spring sẽ đọc các thông tin cấu hình trong class này để bắt đầu (initial) ứng dụng Web của bạn.

Thông thường trong lớp này bạn có thể đăng ký các Servlet, các Servlet Filter, và Servlet Listener thay cho việc đăng ký chúng trong web.xml.

Một servlet quan trọng là org.springframework.web.servlet.DispatcherServlet, bạn cần đăng ký nó.

SpringWebAppInitializer. java


package org.o7planning.hellospringmvc.config;

import javax.servlet.FilterRegistration;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import javax.servlet.ServletRegistration;

import org.springframework.web.WebApplicationInitializer;
import org.springframework.web.context.ContextLoaderListener;
import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.web.servlet.DispatcherServlet;

public class SpringWebAppInitializer implements WebApplicationInitializer {

    @Override
    public void onStartup(ServletContext servletContext) throws ServletException {
        AnnotationConfigWebApplicationContext appContext = new AnnotationConfigWebApplicationContext();
        appContext.register(ApplicationContextConfig.class);

        // Dispatcher Servlet
        ServletRegistration.Dynamic dispatcher = servletContext.addServlet("SpringDispatcher",
                new DispatcherServlet(appContext));
        dispatcher.setLoadOnStartup(1);
        dispatcher.addMapping("/");
        
        dispatcher.setInitParameter("contextClass", appContext.getClass().getName());

        servletContext.addListener(new ContextLoaderListener(appContext));
        
        // UTF8 Charactor Filter.
        FilterRegistration.Dynamic fr = servletContext.addFilter("encodingFilter", CharacterEncodingFilter.class);

        fr.setInitParameter("encoding", "UTF-8");
        fr.setInitParameter("forceEncoding", "true");
        fr.addMappingForUrlPatterns(null, true, "/*");        
    }

}

Class ApplicationContextConfig được sử dụng để khai báo các Spring BEAN. Nó được chú thích bởi @Configuration.

@ComponentScan(“org.o7planning.hellospringmvc.*”) – Nói với Spring tìm kiếm các Spring BEAN khác, và các Controller trong các package “con trực tiếp” của package org.o7planning.hellospringmvc.

ApplicationContextConfig. java


package org.o7planning.hellospringmvc.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.view.InternalResourceViewResolver;

@Configuration
@ComponentScan("org.o7planning.hellospringmvc.*") 
public class ApplicationContextConfig { 
 
     

    @Bean(name = "viewResolver")
    public InternalResourceViewResolver getViewResolver() {
        InternalResourceViewResolver viewResolver = new InternalResourceViewResolver();
        viewResolver.setPrefix("/WEB-INF/pages/");
        viewResolver.setSuffix(".jsp");
        return viewResolver;
    }
 

}

Class WebMvcConfig mở rộng từ WebMvcConfigurerAdapter, sử dụng để cấu hình các tài nguyên sử dụng trong Spring MVC, chẳng hạn các nguồn tài nguyên tĩnh (Image, CSS, Javascript,..)

WebMvcConfig. java


package org.o7planning.hellospringmvc.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;


@Configuration
@EnableWebMvc
public class WebMvcConfig extends WebMvcConfigurerAdapter {

 
 
   // Cấu hình để sử dụng các file nguồn tĩnh (html, image, ..)
   @Override
   public void addResourceHandlers(ResourceHandlerRegistry registry) {
       registry.addResourceHandler("/css/**").addResourceLocations("/css/").setCachePeriod(31556926);
       registry.addResourceHandler("/img/**").addResourceLocations("/img/").setCachePeriod(31556926);
       registry.addResourceHandler("/js/**").addResourceLocations("/js/").setCachePeriod(31556926);
   }

   
   @Override
   public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
       configurer.enable();
   }

}

5- Jsp & Spring Controller

Các lớp Controller sử dụng để điều khiển đường đi của ứng dụng.

HelloWorldController. java


package org.o7planning.hellospringmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloWorldController {

    @RequestMapping("/hello")
    public String hello(Model model) {
       
        model.addAttribute("greeting", "Hello Spring MVC");
       
        return "helloworld";
       
    }

}

/ WEB-INF / pages / helloworld.jsp








Spring MVC -HelloWorld




    ${greeting}

6- Chạy ứng dụng Spring MVC

Trong lần đầu tiên, trước khi chạy ứng dụng bạn cần phải build toàn bộ project.

Xem thêm: Bật mí cách viết mẫu CV chuẩn nhất mà bạn không thể bỏ qua

Nhấn phải chuột vào project chọn :

Run As/Maven install

Cấu hình để chạy ứng dụng :

Nhập vào :

Name: Run HelloSpringMVC
Base directory: ${workspace_loc:/HelloSpringMVC}
Goals: tomcat7:run

Nhấn Run để chạy:

Trong lần chạy đầu tiên sẽ hơi lâu do chương trình download các thư viện tomcat plugin về để chạy.

Mọi thứ đã triển khai xong :

Chạy URL :

7- Luồng đi của ứng dụng

Bạn đã triển khai xong xong project và chạy thành công xuất sắc ở bước trên. Lúc này tất cả chúng ta sẽ xem chương trình chạy thế nào .

8- Controller và các phương thức

8.1- HttpServletRequest & HttpServletResponse

Bạn có thể sử dụng HttpServletRequest, HttpServletResponse trong các phương thức của Controller.

OtherExampleController. java


package org.o7planning.tutorial.springmvc;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class OtherExampleController {

  ......

  @RequestMapping("/somePath")
  public String requestResponseExample(HttpServletRequest request,
          HttpServletResponse reponses, Model model) {

      // Todo something here

      return "someView";
  }

  ......
}

8.2- Redirect trong Controller

Sử dụng tiếp đầu ngữ “redirect:” trong String trả về của phương thức, bạn có thể redirect sang một trang khác. Hãy xem ví dụ minh họa:

RedirectExampleController. java


package org.o7planning.hellospringmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class RedirectExampleController {

 @RequestMapping(value = "/redirect", method = RequestMethod.GET)
 public String authorInfo(Model model) {

     // Làm gì đó tại đây ...

     return "redirect:/hello";
 }
}

Chạy URL :

8.3- Ví dụ @RequestParam

Sử dụng @RequestParam để trói buộc (bind) một tham số của request vào tham số của phương thức trong Controller của bạn.

Dưới đây là đoạn code sử dụng :
RequestParamExampleController. java


package org.o7planning.hellospringmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class RequestParamExampleController {
 
  @RequestMapping("/user")
  public String userInfo(Model model,
          @RequestParam(value = "name", defaultValue = "Guest") String name) {

      model.addAttribute("name", name);

      if ("admin".equals(name)) {
          model.addAttribute("email", "[email protected]");
      } else {
          model.addAttribute("email", "Not set");
      }
      return "userInfo";
  }

}

/ WEB-INF / pages / userInfo. jsp





User Info



  ${name}

  Email: ${email}

Chạy URL :

8.4- Ví dụ @PathVariable

Trong Spring MVC bạn có thể sử dụng @PathVariable để trói buộc một tham số của phương thức với một biến Template URI (URI Template variable).

Ví dụ đây là một mẫu URI :

/web/fe/{sitePrefix}/{language}/document/{id}/{naturalText}

Và các URI sau khớp với mẫu trên:

/web/fe/default/en/document/8108/spring-mvc-for-beginners
/web/fe/default/vi/document/8108/spring-mvc-cho-nguoi-moi-bat-dau
…..

Đoạn code dưới đây chỉ ra cách sử dụng nó :
PathVariableExampleController. java


package org.o7planning.hellospringmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class PathVariableExampleController {


  /**
   * @PathVariable Example:
   *
   *    *
   *   http://o7planning.org/web/fe/default/en/document/8108/spring-mvc-for-beginners
   *  
   *   or
   *  
   *   http://localhost:8080/HelloSpringMVC/web/fe/default/en/document/8108/spring-mvc-for-beginners
   *
   * 
   */

  @RequestMapping("/web/fe/{sitePrefix}/{language}/document/{id}/{naturalText}")

  public String documentView(Model model,

          @PathVariable(value = "sitePrefix") String sitePrefix,

          @PathVariable(value = "language") String language,

          @PathVariable(value = "id") Long id,

          @PathVariable(value = "naturalText") String naturalText) {
      model.addAttribute("sitePrefix", sitePrefix);

      model.addAttribute("language", language);

      model.addAttribute("id", id);

      model.addAttribute("naturalText", naturalText);
      String documentName = "Java tutorial for Beginners";

      if (id == 8108) {

          documentName = "Spring MVC for Beginners";

      }
      model.addAttribute("documentName", documentName);
      return "documentView";

  }

}



/ WEB-INF / pages / documentView. jsp




${documentName}



   ${documentName}

   Site Prefix: ${sitePrefix}
   
 Language: ${language}
   
 ID: ${id}
   
 Natural Text: ${naturalText}
   





Chạy URL :



8.5- Ví dụ @ResponseBody


Nếu bạn chú thích một phương thức trong Controller với @ResponseBody, Spring sẽ chuyển đổi giá trị trả về của phương thức thành String và ghi vào Http response một cách tự động. Trong trường hợp này bạn không cần một View cụ thể.


Chú ý: Phương thức không nhất thiết phải trả về kiểu String.


Ví dụ minh họa đơn giản với @ResponseBody, phương thức trả về kiểu String.

ResponseBodyExample1Controller. java

package org.o7planning.hellospringmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class ResponseBodyExample1Controller {

  // Một ví dụ đơn giản, method trả về kiểu String.
  @RequestMapping(value = "/saveResult")
  @ResponseBody
  public String authorInfo(Model model) {
      return "saved";
  }

 
}


Kết quả chạy ví dụ:

Xem thêm: 5 cách tuyển dụng online hiệu quả: Đơn giản nhưng ít người biết



Ví dụ với @ResponseBody, phương thức trả về kiểu Object.


TODO

9- Cấu hình Static Resource trong Spring MVC

Để sử dụng nguồn tài liệu tĩnh ( Static Resource ) ( *. css, *. js, image, .. ) bạn cần có một vài thông số kỹ thuật. Bạn hoàn toàn có thể xem tại :

Source: https://final-blade.com
Category : Kiến thức Internet

admin

final-blade.com