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

本文將介紹如何在Java Web工程中集成YMP框架，操做過程基於IntelliJ IDEA作爲開發環境，工程結構採用Maven構建：

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

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

建立項目

1. 打開IDEA開發環境並點擊Create New Project按鈕開始建立新項目嚮導，以下圖-1所示：

2. 在New Project窗口中選中左側Maven項目，而後勾選Create from archetype選項，最後在列表中選擇maven-archetype-webapp後，點擊Next按鈕，如圖-2所示：

3. 填寫Maven項目的GroupId、ArtifactId、Version座標信息後，點擊Next按鈕，如圖-3所示：

4. 確認Maven路徑及配置和項目信息無誤後，點擊Next按鈕，如圖-4所示：

5. 爲你的新工程起個名字吧，點擊Finish按鈕完成嚮導並開始建立，如圖-5所示：

6. Maven項目建立過程須要一點點時間，耐心等待控制檯輸出BUILD SUCCESS時，恭喜你新工程建立完成了，如圖-6所示：

添加YMP框架依賴包

1. 打開項目pom.xml文件，添加依賴配置，內容以下：

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

添加依賴配置後，能夠看到YMP相關的依賴包將自動被載入，如圖-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所示：

PS： 

1. ymp.dev_model參數，是設置當前項目以開發模式運行，會輸出更多框架日誌便於調試。

2. ymp.autoscan_packages參數，是設置框架自動掃描的包路徑。

小結

到此，咱們已經完成了YMP框架與JavaWeb工程的集成，下一篇將詳細介紹控制器的使用。

感興趣的小夥伴兒們能夠加入 官方QQ羣480374360，一塊兒交流學習，幫助YMP成長！ 瞭解更多有關YMP框架的內容，請訪問官網：http://www.ymate.net/