除了我们现在将使用Spring MVC而不是原始servlet之外,该文章将与我们以前的文章Simple Gradle Web Application相似。 使用Gradle运行基本的Spring MVC应用程序确实很容易。 您可以在Github上下载本教程的源代码。
先决条件
我们的基本项目结构将是:
- spring-mvc
- src
- main
- java
- com
- codetutr
- controller
- HomeController.java
- springconfig
- WebConfig.java (for Java-based Spring configuration)
- webapp
- WEB-INF
- web.xml
- spring
- sample-servlet.xml (for XML-based Spring configuration)
- view
- home.jsp
首先,创建一个名为spring-mvc
的文件夹,然后创建基本文件夹结构:src / main / java,src / main / webapp / WEB-INF。 然后,让我们在根文件夹中创建Gradle构建文件:
build.gradle
- apply plugin: 'war'
- apply plugin: 'jetty'
- apply plugin: 'eclipse-wtp'
-
- repositories {
- mavenCentral()
- }
-
- dependencies {
- providedCompile 'javax.servlet:servlet-api:2.5'
- compile 'org.springframework:spring-webmvc:3.2.2.RELEASE'
- runtime 'javax.servlet:jstl:1.1.2'
- }
-
- /* Change context path (base url). otherwise defaults to name of project */
- jettyRunWar.contextPath = ''
现在,打开命令提示符到spring-mvc
文件夹并运行gradle eclipse
。 您将看到gradle下载Spring-webmvc依赖的所有(许多)必需的Spring jar。 现在,将项目导入Eclipse(文件->导入->现有项目到工作区)。 现在,我们将创建web.xml,Spring配置和基本控制器。 配置Spring应用程序的经典方法是通过XML配置。 从Spring 3.1开始,还可以使用Java配置轻松配置Spring应用程序(Spring 3.0支持此功能,但是Spring 3.1带来了自定义名称空间支持,这确实很吸引人)。 我的首选是Java配置,但是我将向仍在使用XML配置的用户展示这两种方法。 遵循Java配置或XML配置。 如果要使用XML配置,请跳过本部分并滚动到XML配置部分。
基于Java的Spring配置
在src/main/webapp/WEB-INF
创建web.xml
文件:
web.xml
- <?xml version="1.0" encoding="UTF-8"?>
- <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
-
- <servlet>
- <servlet-name>sample</servlet-name>
- <servlet-class>
- org.springframework.web.servlet.DispatcherServlet
- </servlet-class>
- <init-param>
- <param-name>contextClass</param-name>
- <param-value>org.springframework.web.context.support.AnnotationConfigWebApplicationContext</param-value>
- </init-param>
- <init-param>
- <param-name>contextConfigLocation</param-name>
- <param-value>com.codetutr.springconfig</param-value>
- </init-param>
- </servlet>
-
- <servlet-mapping>
- <servlet-name>sample</servlet-name>
- <url-pattern>/</url-pattern>
- </servlet-mapping>
-
- </web-app>
注意,我们创建了一个Spring DispatcherServlet映射到所有URL“ /”。 我们还告诉DispatcherServlet在com.codetutr.springconfig
包中查找我们基于Java的Spring配置类。 让我们在com.codetutr.springconfig
包中创建一个名为WebConfig
Java配置类:
WebConfig.java
- package com.codetutr.springconfig;
-
- import org.springframework.context.annotation.Bean;
- import org.springframework.context.annotation.ComponentScan;
- import org.springframework.context.annotation.Configuration;
- import org.springframework.web.servlet.config.annotation.EnableWebMvc;
- import org.springframework.web.servlet.view.InternalResourceViewResolver;
-
- @Configuration
- @EnableWebMvc
- @ComponentScan(basePackages="com.codetutr.controller")
- public class WebConfig {
-
- @Bean
- public InternalResourceViewResolver viewResolver() {
- InternalResourceViewResolver resolver =
- new InternalResourceViewResolver();
- resolver.setPrefix("/WEB-INF/view/");
- resolver.setSuffix(".jsp");
- return resolver;
- }
-
- }
首先,请注意@Configuration
批注。 这告诉Spring这是一个配置类(等同于<beans> XML文件)。 接下来, @EnableWebMvc
行初始化一些Spring MVC魔术(用于转换器,序列化等)。 等效于<mvc:annotation-driven/>
。下一行带有@ComponentScan
行告诉Spring寻找带有Spring @Service, @Component, @Repository, @Controller
型注释( @Service, @Component, @Repository, @Controller
)的类。在本例中,我们将拥有列出的软件包中的某些MVC控制器。 我们将在稍后讨论视图解析器。 跳过以下基于XML的配置部分,因为我们已经通过Spring Java-Configuration配置了应用程序。
基于Spring XML的配置(如果您选择不使用上述基于Java的配置)
在src/main/webapp/WEB-INF
创建web.xml
文件:
web.xml
- <?xml version="1.0" encoding="UTF-8"?>
- <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
-
- <servlet>
- <servlet-name>sample</servlet-name>
- <servlet-class>
- org.springframework.web.servlet.DispatcherServlet
- </servlet-class>
- <init-param>
- <param-name>contextConfigLocation</param-name>
- <param-value>/WEB-INF/spring/sample-servlet.xml</param-value>
- </init-param>
- </servlet>
-
- <servlet-mapping>
- <servlet-name>sample</servlet-name>
- <url-pattern>/</url-pattern>
- </servlet-mapping>
-
- </web-app>
注意,我们创建了一个Spring DispatcherServlet映射到所有URL“ /”。 我们还告诉DispatcherServlet在WEB-INF/sping/sample-servlet.xml
查找我们的Spring配置文件。 让我们现在创建它:
sample-servlet.xml
- <?xml version="1.0" encoding="UTF-8"?>
- <beans xmlns="http://www.springframework.org/schema/beans"
- xmlns:mvc="http://www.springframework.org/schema/mvc"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:context="http://www.springframework.org/schema/context"
- xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
- http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd
- http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd">
-
- <context:component-scan base-package="com.codetutr.controller" />
- <mvc:annotation-driven />
-
- <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
- <property name="prefix" value="/WEB-INF/view/"/>
- <property name="suffix" value=".jsp"/>
- </bean>
-
- </beans>
第一行带有context:component-scan
告诉Spring寻找带有Spring @Service, @Component, @Repository, @Controller
型注释( @Service, @Component, @Repository, @Controller
)的类。 <mvc:annotation-driven />
告诉Spring添加一些MVC好东西。 我们将在稍后讨论视图解析器。
构建一个控制器(每个人都这样做–对于XML和Java配置都是一样的)
现在,我们已经告诉Spring在com.codetutr.controller
包中寻找MVC控制器,让我们构建一个简单的控制器。 在com.codetutr.controller
包中创建一个名为SampleController
的新类。 输入以下内容:
SampleController.java
- package com.codetutr.controller;
-
- import org.springframework.stereotype.Controller;
- import org.springframework.ui.Model;
- import org.springframework.web.bind.annotation.RequestMapping;
-
- @Controller
- public class SampleController {
-
- @RequestMapping("home")
- public String loadHomePage(Model m) {
- m.addAttribute("name", "CodeTutr");
- return "home";
- }
- }
还记得我们在sample-servlet.xml
Spring配置文件中创建viewResolver
bean的时候吗? 我们将前缀设置为WEB-INF/view
,后缀设置为.jsp
。 使用此解析器,在上述方法以返回值home
执行之后,Spring将寻找一个名为WEB-INF/view/home.jsp
来呈现视图。 现在创建该文件:
home.jsp
- <!DOCTYPE HTML>
- <html>
- <head>
- <title>Sample Application</title>
- </head>
- <body>
- <h1>Hello, ${name}!</h1>
- </body>
- </html>
而已! 现在,您已经建立了一个基本的Spring-MVC应用程序。 打开命令提示符到项目目录的根目录,然后键入gradle jettyRunWar
。 这将在端口8080上启动嵌入式Jetty服务器。导航到http:// localhost:8080 / home ,您应该看到:
现在您已经运行了基本的Spring MVC应用程序,请遵循Spring MVC Form Submission教程 。
全文: ZIP , GitHub
要运行本教程中的代码:必须已安装Gradle 。 下载ZIP。 提取。 打开命令提示符以提取位置。 运行gradle jettyRunWar。 在浏览器中导航到http:// localhost:8080 / home。
资源资源
SpringSource博客– MVC命名空间的增强和配置
SpringSource Docs – EnableWebMvc文档
翻译自: https://www.javacodegeeks.com/2013/04/simple-spring-mvc-web-application-using-gradle.html