准备步骤
1. 安装Maven,下载解压即可。官网下载
2. 修改maven_home/conf/settings.xml中的<localRepository>D:/MavenRepo</localRepository>指定本地仓库位置,这个位置是本地计算机上用来存放所有jar包的地方。
3. 修改settings.xml中的<mirrors></mirrors>标签,添加常用的maven远程仓库地址。这些仓库地址就是用来下载jar包的时候用的。由于中央仓库的访问速度较慢(或者因为某些原因导致你根本不能访问),因此一般需要设置其他的仓库地址以提高访问速度。比如:
<mirror> <id>oschina</id> <mirrorOf>central</mirrorOf> <url>http://maven.oschina.net/content/groups/public/</url> </mirror> <mirror> <id>repo2</id> <mirrorOf>central</mirrorOf> <url>http://repo2.maven.org/maven2/</url> </mirror> <mirror> <id>net-cn</id> <mirrorOf>central</mirrorOf> <url>http://maven.net.cn/content/groups/public/</url> </mirror>
如果使用mvn命令行来创建、构建和运行maven项目,则需要配置环境变量,路径指向maven_home/bin即可。配置好后,可以查看mvn命令:
由于使用命令太麻烦而且难记,我直接使用Eclipse的maven插件来创建和运行maven项目。
4. 在Eclipse中集成Maven。
- 先安装Eclipse的maven插件(具体过程网上一大堆,比如:安装Eclipse Maven插件的几种方法)
- 在Eclipse中通过Windows->Preferences->Maven菜单下指定安装的maven:
并指定自己的配置文件settings.xml:
创建Maven项目
5. New->Maven Project->Next,选择webapp类型的项目结构。由于不同类型的项目有不同的项目结构,因此Maven自带了很多套项目骨架(archetype),这里我们选择webapp类型的骨架即可:
下一步即可。
最后创建的工程如下:
8. 先把默认使用的JRE环境替换成当前Eclipse中使用的JRE环境。
9. 每个Maven项目都有一个pom.xml文件,这个文件描述了这个项目的依赖关系,以及自身的一些属性,包括properties的定义,以及Maven Modules的版本声明,父模块以及子模块的名字等。同时这个文件还包括了该项目在构建过程中做的事情的定义。现在打开这个pom.xml文件,先在<dependencies>标签上方添加该项目用到的属性定义(为了集中管理spring的版本,因此将其定义为属性,在依赖spring的jar包时直接使用这个属性即可):
<properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <spring.version>4.0.0.RELEASE</spring.version> </properties>
并在<dependencies></dependencies>标签中添加如下依赖关系,其他的内容无需修改:
<dependencies> <!-- MyBatis相关 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.2.0</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.2.0</version> </dependency> <!-- DB2相关 --> <dependency> <groupId>db2jcc4</groupId> <artifactId>db2jcc4</artifactId> <version>1.0</version> <scope>system</scope> <systemPath>${project.basedir}/src/main/webapp/WEB-INF/lib/db2jcc4.jar</systemPath> </dependency> <dependency> <groupId>c3p0</groupId> <artifactId>c3p0</artifactId> <version>0.9.1.2</version> </dependency> <!-- Spring相关,这里的spring.version就是上方声明的版本号,这样引用更方便修改和维护 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-ibatis</artifactId> <version>2.0.8</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>${spring.version}</version> </dependency> <!-- 测试相关 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.10</version> <scope>test</scope> </dependency> <!-- Servlet相关 --> <dependency> <groupId>tomcat</groupId> <artifactId>servlet-api</artifactId> <version>5.5.23</version> </dependency> <!-- Log相关 --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> </dependencies>
10. 在Maven的世界中,每一个jar包都可以通过Group ID, Artifact ID, Version这三个字段(一般简写为GAV)来唯一定位,因此如果需要使用哪个jar包,只需要提供这三个字段即可。
如果不知道版本号或者GroupID,可以去公共的Maven仓库搜索关键字。比如搜索:log4j,即可出现仓库中已经收录的关于log4j的jar包:
如图,我在oschina提供的maven库中搜索log4j,出现了一些可用的jar包列表(这里需要注意:有些jar包名称看上去很相近,因此需要注意区别,选择正确的jar包)。选择某一个,右下方会有该包的GAV属性。直接将这一段拷贝到maven项目pom.xml文件中即可。
还有一个很好用的maven仓库地址,推荐给大家:http://mvnrepository.com/
11. Jar包准备完毕后,开始项目接口的定义了。修改后的结构如图:
12. web.xml仅仅定义了基本的DispatchServlet,用于转发请求:
<servlet> <servlet-name>spring</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>spring</servlet-name> <url-pattern>/*</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list>
13. applicationContext.xml
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx" xmlns:jdbc="http://www.springframework.org/schema/jdbc" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation=" http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc-3.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"> <context:component-scan base-package="com.uxun" /> <!-- 属性注入器,用于读取项目配置文件中的属性 --> <bean id="PropertiesConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> <property name="locations"> <list> <value>classpath:log4j.properties</value> <value>classpath:application.properties</value> </list> </property> </bean> <!-- 数据源,不需要解释 --> <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" destroy-method="close"> <property name="driverClass" value="${jdbc.driverClassName}" /> <property name="jdbcUrl" value="${jdbc.url}" /> <property name="user" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> </bean> <!-- SqlSessionFactory --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource" /> <!-- <property name="mapperLocations" value="classpath*:com/abc/dao/*.xml" /> --> <property name="configLocation" value="classpath:mybatis-config.xml" /> </bean> <!-- Mybatis sql session --> <bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate"> <constructor-arg index="0" ref="sqlSessionFactory" /> </bean> <!-- Mybatis mapper scanner, scans for java mapper --> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.uxun.dao" /> <property name="sqlSessionTemplateBeanName" value="sqlSession" /> </bean> </beans>
14. log4j.properties,用于定义Log4j的日志输出内容及格式。
# Output pattern : date [thread] priority category - message log4j.rootLogger=INFO, Console, RollingFile #Console log4j.appender.Console=org.apache.log4j.ConsoleAppender log4j.appender.Console.layout=org.apache.log4j.PatternLayout log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n #RollingFile log4j.appender.RollingFile=org.apache.log4j.DailyRollingFileAppender log4j.appender.RollingFile.File=/home/epay/log/release.log log4j.appender.RollingFile.layout=org.apache.log4j.PatternLayout log4j.appender.RollingFile.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n log4j.appender.RollingFile.Encoding=UTF-8 log4j.logger.com.uxun=DEBUG log4j.logger.com.blueder=DEBUG
application.properties,上方的配置中引用到的关于数据库的配置,请在这个文件中配置
jdbc.driverClassName=com.ibm.db2.jcc.DB2Driver jdbc.url=jdbc:db2://16.16.16.132:50000/emall jdbc.username=emallusr jdbc.password=emallusr
15. mybatis-config.xml文件,这里面指定了哪些xml文件可以作为DAO接口的映射文件:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <mappers> <mapper resource="com/uxun/entity/UserMap.xml"/> </mappers> </configuration>
16. UserMap.xml文件定义了对于User对象的操作的sql语句:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.uxun.dao.UserDao"> <resultMap id="UserResultMap" type="com.uxun.entity.User"> <id column="id" jdbcType="INTEGER" property="id" /> <result column="userName" jdbcType="VARCHAR" property="name" /> <result column="userAge" jdbcType="INTEGER" property="age" /> <result column="userAddress" jdbcType="VARCHAR" property="address" /> </resultMap> <select id="testQuery" resultMap="UserResultMap"> SELECT * FROM user </select> </mapper>
17. Controller, Service和DAO的声明,都是很标准很简单的Controller调用Service,Service再调用DAO接口的过程。
UserDao(完成数据读写):
package com.uxun.dao; import java.util.List; import com.uxun.entity.User; public interface UserDao { public List<User> testQuery() throws Exception; }
TestService(接口编程,在面向多实现的时候非常有用):
package com.uxun.service; public interface UserService { public String testQuery() throws Exception; }
TestServiceImpl(完成主要的业务逻辑):
package com.uxun.service.impl; import java.util.List; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import com.uxun.dao.UserDao; import com.uxun.entity.User; import com.uxun.service.UserService; @Service public class UserServiceImpl implements UserService{ @Autowired private UserDao dao; public String testQuery() throws Exception { List<User> users = dao.testQuery(); String res = ""; if (users != null && users.size() > 0) { for (User user : users) { res += user.toString() + "|"; } } else { res = "Not found."; } return res; } }
TestController(完成请求转发,响应封装):
package com.uxun.controller; import java.io.IOException; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.log4j.Logger; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import com.uxun.service.UserService; @Controller @RequestMapping("/userController") public class UserController { static final Logger LOGGER = Logger.getLogger(UserController.class); @Autowired private UserService testService; @RequestMapping("/test") public void test(HttpServletRequest request, HttpServletResponse response) { try { String result = testService.testQuery(); response.getWriter().print(result); } catch (IOException e) { e.printStackTrace(); } catch (Exception e) { e.printStackTrace(); } } }
代码部分到此就结束了。
18. 编写好以后,在项目上右键->Run As->Maven Build…准备构建这个maven项目。
19. 在BaseDirectory中指定需要构建的项目(点击图中的Brose Workspace或Browse File System按钮可以选择),并在Goals框中指定构建的目标(Maven有自己的构建的阶段,有的地方又叫生命周期,如果不清楚的同学,可以参看Maven生命周期详解)。并可以选择一些附加的属性(绿色框中),如图:
20. 如果构建成功,则会出现类似于下面的输出:
21. 当构建成功后,可以像普通的Web Project一样来运行这个项目。这里将其添加到Tomcat中,并启动之。
23. 在浏览器中访问指定的接口,查看结果(在我的实现类TestServiceImpl中,仅仅是打印了查询到的结果):
db2数据库脚本
create table user ( id integer, name varchar(10), age integer, address varchar(300) ) insert into user values(1,‘AAA‘,25,‘XXXXXXXXXXXXXXXX‘); insert into user values(2,‘BBB‘,25,‘YYYYYYYYYYYYYYYY‘); insert into user values(3,‘CCC‘,25,‘ZZZZZZZZZZZZZzZZ‘);