本文將介紹如何在Java Web工程中集成YMP框架，操作過程基于IntelliJ IDEA做為開發(fā)環(huán)境，工程結(jié)構(gòu)采用Maven構(gòu)建：

IntelliJ IDEA下載地址: https://www.jetbrains.com/idea/download/

Maven下載地址: http://maven.apache.org/

創(chuàng)建項(xiàng)目

1. 打開IDEA開發(fā)環(huán)境并點(diǎn)擊Create New Project按鈕開始創(chuàng)建新項(xiàng)目向?qū)?，如下圖-1所示：

2. 在New Project窗口中選中左側(cè)Maven項(xiàng)目，然后勾選Create from archetype選項(xiàng)，最后在列表中選擇maven-archetype-webapp后，點(diǎn)擊Next按鈕，如圖-2所示：

3. 填寫Maven項(xiàng)目的GroupId、ArtifactId、Version坐標(biāo)信息后，點(diǎn)擊Next按鈕，如圖-3所示：

4. 確認(rèn)Maven路徑及配置和項(xiàng)目信息無誤后，點(diǎn)擊Next按鈕，如圖-4所示：

5. 為你的新工程起個(gè)名字吧，點(diǎn)擊Finish按鈕完成向?qū)Р㈤_始創(chuàng)建，如圖-5所示：

6. Maven項(xiàng)目創(chuàng)建過程需要一點(diǎn)點(diǎn)時(shí)間，耐心等待控制臺(tái)輸出BUILD SUCCESS時(shí)，恭喜你新工程創(chuàng)建完成了，如圖-6所示：

添加YMP框架依賴包

1. 打開項(xiàng)目pom.xml文件，添加依賴配置，內(nèi)容如下：

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

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

添加依賴配置后，可以看到Y(jié)MP相關(guān)的依賴包將自動(dòng)被載入，如圖-7所示：

如果你還沒有安裝編譯YMP框架包，請(qǐng)查看上一篇博客：“YMP開發(fā)框架快速上手（一）：下載和編譯YMP框架代碼”

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

1. 修改web.xml文件

YMP框架在Web工程中是通過Listener進(jìn)行初始化的，請(qǐng)求與控制器映射是通過Filter或Servlet完成的，所以需要在web.xml文件中添加相關(guān)配置，配置如圖-8所示：

PS：

1. 基于Maven創(chuàng)建的Web工程的web.xml是2.3版本，需要替換為2.4或以上版本。

2. 分別提供了Filter和Servlet兩種配置方式，推薦采用Filter對(duì)請(qǐng)求的處理。

完整的web.xml配置內(nèi)容如下：

<?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>
  </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 添加YMP框架配置文件

在工程的資源目錄resources的根路徑下新建ymp-conf.properties文件（這也是YMP框架唯一的配置文件）并編輯其內(nèi)容，如下圖所示：

PS：

ymp.dev_model參數(shù)，是設(shè)置當(dāng)前項(xiàng)目以開發(fā)模式運(yùn)行，會(huì)輸出更多框架日志便于調(diào)試。

ymp.autoscan_packages參數(shù)，是設(shè)置框架自動(dòng)掃描的包路徑。

小結(jié)

到此，我們已經(jīng)完成了YMP框架與JavaWeb工程的集成，下一篇將詳細(xì)介紹控制器的使用。