YMP开发框架快速上手（二）— JavaWeb工程中集成YMP框架

本文将介绍如何在Java Web工程中集成YMP框架，操作过程基于IntelliJ IDEA做为开发环境，工程结构采用Maven构建：

IntelliJ IDEA下载地址: https://www.jetbrains.com/idea/download/
Maven下载地址: http://maven.apache.org/

创建项目

1. 打开IDEA开发环境并点击Create New Project按钮开始创建新项目向导，如下图-1所示：

图-1

2. 在New Project窗口中选中左侧Maven项目，然后勾选Create from archetype选项，最后在列表中选择maven-archetype-webapp后，点击Next按钮，如图-2所示：

图-2

3. 填写Maven项目的GroupId、ArtifactId、Version坐标信息后，点击Next按钮，如图-3所示：

图-3

4. 确认Maven路径及配置和项目信息无误后，点击Next按钮，如图-4所示：

图-4

5. 为你的新工程起个名字吧，点击Finish按钮完成向导并开始创建，如图-5所示：

图-5

6. Maven项目创建过程需要一点点时间，耐心等待控制台输出BUILD SUCCESS时，恭喜你新工程创建完成了，如图-6所示：

图-6

添加YMP框架依赖包

1. 打开项目pom.xml文件，添加依赖配置，内容如下：

<dependency>
    <groupId>net.ymate.platform</groupId>
    <artifactId>ymate-platform-webmvc</artifactId>
    <version>2.0-SNAPSHOT</version>
</dependency>

添加依赖配置后，可以看到YMP相关的依赖包将自动被载入，如图-7所示：

图-7

如果你还没有安装编译YMP框架包，请查看上一篇博客：“YMP开发框架快速上手（一）：下载和编译YMP框架代码”

配置并集成YMP框架到Web工程

1. 修改web.xml文件

YMP框架在Web工程中是通过Listener进行初始化的，请求与控制器映射是通过Filter或Servlet完成的，所以需要在web.xml文件中添加相关配置，配置如图-8所示：

PS：

1. 基于Maven创建的Web工程的web.xml是2.3版本，需要替换为2.4或以上版本。

2. 分别提供了Filter和Servlet两种配置方式，推荐采用Filter对请求的处理。

完整的web.xml配置内容如下：

<?xml version="1.0" encoding="UTF-8"?><web-app id="WebApp_ID" 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">

    <listener>
        <listener-class>net.ymate.platform.webmvc.support.WebAppEventListener</listener-class>
    </listener>

    <filter>
        <filter-name>DispatchFilter</filter-name>
        <filter-class>net.ymate.platform.webmvc.support.DispatchFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>DispatchFilter</filter-name>
        <url-pattern>/*</url-pattern>
        <dispatcher>REQUEST</dispatcher>
        <dispatcher>FORWARD</dispatcher>
    </filter-mapping>

    <!--
    <servlet>
        <servlet-name>DispatchServlet</servlet-name>
        <servlet-class>net.ymate.platform.webmvc.support.DispatchServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>DispatchServlet</servlet-name>
        <url-pattern>/service/*</url-pattern>
    </servlet-mapping>
    -->

    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list></web-app>

3.2 添加YMP框架配置文件

在工程的资源目录resources的根路径下新建ymp-conf.properties文件（这也是YMP框架唯一的配置文件）并编辑其内容，如下图-9所示：

图-12