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所示:
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</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>
添加依赖配置后,可以看到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> </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框架唯一的配置文件)并编辑其内容,如下图所示:
PS:
ymp.dev_model参数,是设置当前项目以开发模式运行,会输出更多框架日志便于调试。
ymp.autoscan_packages参数,是设置框架自动扫描的包路径。
小结
到此,我们已经完成了YMP框架与JavaWeb工程的集成,下一篇将详细介绍控制器的使用。