原文：http://zetcode.com/java/mvc/

Java MVC 教程是 Java MVC 框架的入门教程。 我们使用 Java MVC 创建一个简单的 Web 应用，并将其部署在 Tomcat 和 Glassfish 上。

MVC

模型视图控制器（MVC）架构模式将应用分为三个部分：模型，视图和控制器。 该模型表示应用中的数据，视图是数据的可视表示，控制器处理并响应事件（通常是用户操作），并且可以调用模型上的更改。 这个想法是通过引入一个中间组件：控制器，将数据访问和业务逻辑与数据表示和用户交互分开。

Java MVC

Java MVC 是针对新的基于 Java 动作的 Web 框架的规范（JSR-371）。 它是传统的基于组件的 JSF 的替代方案。 MVC API 位于 JAX-RS 之上，并与现有的 Java EE 技术（如 CDI 和 Bean 验证）集成。 Eclipse Ozark 是 Java MVC 的实现。 它当前包含对 RESTEasy，Jersey 和 Apache CXF 的支持。

MVC 控制器是由@Controller装饰的 JAX-RS 资源方法。 MVC 控制器负责组合数据模型和视图（模板）以生成 Web 应用页面。 模型承载在视图中显示的数据。 使用@Named注解或通过注入Models接口创建模型。

视图定义了输出页面的结构，可以引用一个或多个模型。 视图引擎的责任是通过提取模型中的信息并生成输出页面来呈现视图。

Tomcat 中的 Java MVC 示例

我们使用 Java MVC 创建一个简单的 Web 应用，并将其部署在 Tomcat 上。 在 JAX-RS 库中，我们选择了 Jersey。

  1. $ tree
  2. .
  3. ├── nb-configuration.xml
  4. ├── pom.xml
  5. └── src
  6.     ├── main
  7.     │   ├── java
  8.     │   │   └── com
  9.     │   │       └── zetcode
  10.     │   │           ├── conf
  11.     │   │           │   └── ApplicationConfig.java
  12.     │   │           ├── controller
  13.     │   │           │   └── HelloController.java
  14.     │   │           └── model
  15.     │   │               └── Message.java
  16.     │   ├── resources
  17.     │   └── webapp
  18.     │       ├── index.html
  19.     │       ├── META-INF
  20.     │       │   └── context.xml
  21.     │       └── WEB-INF
  22.     │           ├── beans.xml
  23.     │           └── views
  24.     │               └── hello.jsp
  25.     └── test
  26.         └── java

这是项目结构。

pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0" 
  3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
  5. http://maven.apache.org/xsd/maven-4.0.0.xsd">
  7.     <modelVersion>4.0.0</modelVersion>
  9.     <groupId>com.zetcode</groupId>
  10.     <artifactId>JavaMvcTomcatEx</artifactId>
  11.     <version>1.0-SNAPSHOT</version>
  12.     <packaging>war</packaging>
  14.     <name>JavaMvcTomcatEx</name>
  16.     <properties>
  17.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  18.         <maven.compiler.source>1.8</maven.compiler.source>
  19.         <maven.compiler.target>1.8</maven.compiler.target>
  20.     </properties>
  22.     <dependencyManagement>
  23.         <dependencies>
  24.             <dependency>
  25.                 <groupId>org.glassfish.jersey</groupId>
  26.                 <artifactId>jersey-bom</artifactId>
  27.                 <version>2.26</version>
  28.                 <type>pom</type>
  29.                 <scope>import</scope>
  30.             </dependency>
  31.         </dependencies>
  32.     </dependencyManagement>    
  34.     <dependencies>
  36.         <dependency>
  37.             <groupId>org.glassfish.jersey.inject</groupId>
  38.             <artifactId>jersey-hk2</artifactId>
  39.         </dependency>            
  41.         <dependency>
  42.             <groupId>org.glassfish.jersey.containers</groupId>
  43.             <artifactId>jersey-container-servlet</artifactId>
  44.         </dependency>
  46.         <dependency>
  47.             <groupId>org.glassfish.jersey.core</groupId>
  48.             <artifactId>jersey-server</artifactId>
  49.         </dependency>       
  51.         <dependency>
  52.             <groupId>org.glassfish.jersey.ext.cdi</groupId>
  53.             <artifactId>jersey-cdi1x</artifactId>
  54.         </dependency>
  56.         <dependency>
  57.             <groupId>org.glassfish.jersey.ext</groupId>
  58.             <artifactId>jersey-bean-validation</artifactId>
  59.         </dependency>
  61.         <dependency>
  62.             <groupId>javax.enterprise</groupId>
  63.             <artifactId>cdi-api</artifactId>
  64.             <version>2.0-EDR1</version>
  65.         </dependency>
  67.         <dependency>
  68.             <groupId>org.jboss.weld.servlet</groupId>
  69.             <artifactId>weld-servlet-shaded</artifactId>
  70.             <version>3.0.2.Final</version>
  71.         </dependency>              
  73.         <dependency>
  74.             <groupId>org.hibernate</groupId>
  75.             <artifactId>hibernate-validator</artifactId>
  76.             <version>5.2.2.Final</version>
  77.         </dependency>     
  79.         <dependency>
  80.             <groupId>javax.mvc</groupId>
  81.             <artifactId>javax.mvc-api</artifactId>
  82.             <version>1.0-pr</version>
  83.         </dependency>
  85.         <dependency>
  86.             <groupId>org.mvc-spec.ozark</groupId>
  87.             <artifactId>ozark-core</artifactId>
  88.             <version>1.0.0-m03</version>
  89.         </dependency>        
  91.         <dependency>
  92.             <groupId>org.mvc-spec.ozark</groupId>
  93.             <artifactId>ozark-jersey</artifactId>
  94.             <version>1.0.0-m03</version>
  95.         </dependency>          
  97.     </dependencies>
  99.     <build>
  100.         <plugins>
  101.             <plugin>
  102.                 <groupId>org.apache.maven.plugins</groupId>
  103.                 <artifactId>maven-war-plugin</artifactId>
  104.                 <version>2.3</version>
  105.                 <configuration>
  106.                     <failOnMissingWebXml>false</failOnMissingWebXml>
  107.                 </configuration>
  108.             </plugin>
  110.         </plugins>
  111.     </build>
  113. </project>

为了在 Tomcat 上运行 Java MVC，我们需要包括 Java MVC，Jersey，Bean Validation 和 CDI 的多个依赖项。

context.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <Context path="/JavaMvcTomcatEx">
  4.     <Resource name="BeanManager" 
  5.               auth="Container"
  6.               type="javax.enterprise.inject.spi.BeanManager"
  7.               factory="org.jboss.weld.resources.ManagerObjectFactory" />
  9. </Context>

在 Tomcat 的context.xml文件中，我们定义上下文路径并注册Weld的BeanManager工厂。

beans.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  3. <beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
  4.        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5.        xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee 
  6. http://xmlns.jcp.org/xml/ns/javaee/beans_1_1.xsd"
  7.        bean-discovery-mode="all">
  9. </beans>

在WEB-INF目录中，我们有一个空的beans.xml文件。 它是 CDI 的部署描述符。 它可用于配置拦截器，装饰器和其他内容。 即使没有配置，我们也需要添加一个空的beans.xml来注册 CDI。

ApplicationConfig.java

  1. package com.zetcode.conf;
  3. import com.zetcode.controller.HelloController;
  4. import java.util.HashSet;
  5. import java.util.Set;
  6. import javax.ws.rs.ApplicationPath;
  7. import javax.ws.rs.core.Application;
  9. @ApplicationPath("mvc")
  10. public class ApplicationConfig extends Application {
  12.     @Override
  13.     public Set<Class<?>> getClasses() {
  14.         Set<Class<?>> set = new HashSet<>();
  15.         set.add(HelloController.class);
  16.         return set;
  17.     }
  18. }

ApplicationConfig是应用配置类。 从 Servlet 3.0 开始，可以省略web.xml文件。 在 Jersey 中，我们创建一个配置类来扩展抽象Application并使用@ApplicationPath注解。 Application定义 JAX-RS 应用的组件并提供其他元数据。 在这里，我们注册应用所需的资源类，供应器或属性。

  1. set.add(HelloController.class);

我们注册HelloController。

Message.java

  1. package com.zetcode.model;
  3. import javax.enterprise.context.RequestScoped;
  4. import javax.inject.Named;
  6. @Named("message")
  7. @RequestScoped
  8. public class Message {
  10.     private String text;
  12.     public String getText() {
  13.         return text;
  14.     }
  16.     public void setText(String text) {
  17.         this.text = text;
  18.     }
  19. }

这是一个模型类。 它保存该视图的数据。 @Named注解为模型命名。 我们将在视图中引用该模型。 @RequestScoped使模型在请求期内有效。

HelloController.java

  1. package com.zetcode.controller;
  3. import com.zetcode.model.Message;
  4. import javax.inject.Inject;
  5. import javax.mvc.annotation.Controller;
  6. import javax.ws.rs.GET;
  7. import javax.ws.rs.Path;
  9. @Path("hello")
  10. @Controller
  11. public class HelloController {
  13.     @Inject
  14.     private Message message;
  16.     @GET
  17.     public String hello() {
  19.         message.setText("Today is a sunny day");
  21.         return "hello.jsp";
  22.     }
  23. }

用@Controller装饰的类是 Java MVC 控制器。 使用@Path，它绑定到hello路径段。

  1. @Inject
  2. private Message message;

使用@Inject，我们注入了模型对象。 它将数据从控制器传送到视图。

  1. @GET
  2. public String hello() {
  4.     message.setText("Today is a sunny day");
  6.     return "hello.jsp";
  7. }

hello()方法对 GET 请求作出反应。 它将数据设置到模型并返回视图。 从控制器方法返回的字符串被解释为视图路径。 视图引擎的默认视图目录为WEB-INF/views。

hello.jsp

  1. <%@page contentType="text/html" pageEncoding="UTF-8"%>
  2. <!DOCTYPE html>
  3. <html>
  4.     <head>
  5.         <meta charset="UTF-8">
  6.         <title>JSP Page</title>
  7.     </head>
  8.     <body>
  9.         <p>
  10.            The message: ${message.text}
  11.         </p>
  12.     </body>
  13. </html>

这是视图。 它使用${}语法显示数据。

index.html

  1. <!DOCTYPE html>
  2. <html>
  3.     <head>
  4.         <title>Home Page</title>
  5.         <meta charset="UTF-8">
  6.     </head>
  7.     <body>
  8.         <p>
  9.             <a href="mvc/hello">Get message</a>
  10.         </p>
  11.     </body>
  12. </html>

这是一个主页。 它包含一个调用控制器的链接。

Glassfish 中的 Java MVC 示例

要在 Glassfish 上运行该示例，我们不需要context.xml文件，并且需要以下三个依赖项：

  1. <dependencies>
  2.     <dependency>
  3.         <groupId>javax</groupId>
  4.         <artifactId>javaee-web-api</artifactId>
  5.         <version>7.0</version>
  6.         <scope>provided</scope>
  7.     </dependency>
  9.     <dependency>
  10.         <groupId>javax.mvc</groupId>
  11.         <artifactId>javax.mvc-api</artifactId>
  12.         <version>1.0-pr</version>
  13.     </dependency>
  14.     <dependency>
  15.         <groupId>org.mvc-spec.ozark</groupId>
  16.         <artifactId>ozark-jersey</artifactId>
  17.         <version>1.0.0-m03</version>
  18.     </dependency>    
  19. </dependencies>

Glasfish 已经包含许多 Tomcat 中不存在的库。 无需其他修改。

在本教程中，我们介绍了 Java MVC 框架。 您可能也对相关教程感兴趣： Java 教程， Java MVC Thymeleaf 教程，游戏简介，Stripes 简介， 或 Java Spark 教程。