除了我们现在将使用Spring MVC而不是原始servlet之外,该文章将与我们以前的文章Simple Gradle Web Application相似。 使用Gradle运行基本的Spring MVC应用程序确实很容易。 您可以在Github上下载本教程的源代码。
先决条件
安装Gradle
我们的基本项目结构将是:
spring-mvcsrcmainjavacomcodetutrcontrollerHomeController.javaspringconfigWebConfig.java (for Java-based Spring configuration)webappWEB-INFweb.xmlspringsample-servlet.xml (for XML-based Spring configuration)viewhome.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 {@Beanpublic 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.xsdhttp://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsdhttp://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