Spring MVC 4.1.3 + MyBatis零基础搭建Web开发框架(注解模式)-eolink官网

Spring MVC 4.1.3 + MyBatis零基础搭建Web开发框架(注解模式)

首先感谢一下润和软件，指引我走上了spring MVC Web开发的道路。

下面进入正题

搭建开发环境：

Netbeans8.0.2 + mysql5.6 + JDK1.7 + tomcat8.0.15

本次采用的Spring MVC Jar包如下：

spring-aop-4.1.3.RELEASE.jar

spring-beans-4.1.3.RELEASE.jar

spring-context-4.1.3.RELEASE.jar

spring-context-support-4.1.3.RELEASE.jar

spring-core-4.1.3.RELEASE.jar

spring-expression-4.1.3.RELEASE.jar

spring-jdbc-4.1.3.RELEASE.jar

spring-oxm-4.1.3.RELEASE.jar

spring-tx-4.1.3.RELEASE.jar

spring-web-4.1.3.RELEASE.jar

spring-webmvc-4.1.3.RELEASE.jar

1.首先创建Web项目

web.mvc

2.引入所有的jar文件

3.配置web.xml

做web开发的都知道,web.xml是项目的入口，我们既然使用spring那么当然要添加Spring的支持啦！

spring默认加载的是applicationContext.xml，由于我们需要集成MyBatis

所以我把Spring的配置文件强制指定名称，并与MyBatis一起配置，减少配置文件数量

先指定spring配置文件名名称与路径

contextConfigLocation

classpath*:xmlconfig/springmvc-mybatis.xml

再执行Spring上下文监听配置

org.springframework.web.context.ContextLoaderListener

添加支持Spring mvc 的配置

说明：添加支持目前有3种方式。

第一种：拦截 /*.do

springmvc

org.springframework.web.servlet.DispatcherServlet

contextConfigLocation

classpath*:/xmlconfig/springmvc-servlet.xml

springmvc

/*.do

优势：拦截明确，不会和其他的拦截冲突

缺点：URL不美观

第二种：拦截 /*

springmvc

org.springframework.web.servlet.DispatcherServlet

contextConfigLocation

classpath*:/xmlconfig/springmvc-servlet.xml

springmvc

优点：支持rest风格，Url美观

缺点：会拦截静态资源

第三种，也是我推荐的一种：拦截 /

springmvc

org.springframework.web.servlet.DispatcherServlet

contextConfigLocation

classpath*:/xmlconfig/springmvc-servlet.xml

springmvc

优点：支持rest风格，URL美观，不拦截静态资源

我们采用第三种做为我们的拦截方案，将配置添加到web.xml中。

大家都知道，web项目最怕的就是乱码，而spring为我们提供了字符编码的过滤器，我们也给配置到web.xml中

characterEncodingFilter

org.springframework.web.filter.CharacterEncodingFilter

encoding

UTF-8

forceEncoding

true

characterEncodingFilter

我们采用的是tomcat服务器，为了让静态的资源直接交给tomcat处理，所以我们在web.xml中配置了以下配置

default

*.jpg

default

*.gif

default

*.png

default

*.js

default

*.css

4.配置springmvc-mybatis.xml和springmvc-servlet.xml

相信很多人都在这里卡主了，因为配置实在是太多了，各种方式都有

为了不妨碍大家，我决定直接将完整的配置直接贴出来

springmvc-mybatis.xml

xmlns:xsi="http://w3.org/2001/XMLSchema-instance"

xmlns:p="http://springframework.org/schema/p"

xmlns:mvc="http://springframework.org/schema/mvc"

xmlns:context="http://springframework.org/schema/context"

xmlns:util="http://springframework.org/schema/util"

xsi:schemaLocation="http://springframework.org/schema/beans

http://springframework.org/schema/beans/spring-beans-4.1.xsd

http://springframework.org/schema/context

http://springframework.org/schema/context/spring-context-4.1.xsd

http://springframework.org/schema/mvc

http://springframework.org/schema/mvc/spring-mvc-4.1.xsd

http://springframework.org/schema/util

http://springframework.org/schema/util/spring-util-4.1.xsd">

class="org.springframework.jdbc.datasource.DataSourceTransactionManager">

class="org.springframework.jdbc.support.lob.DefaultLobHandler"

lazy-init="true"/>

xmlns:xsi="http://w3.org/2001/XMLSchema-instance"

xmlns:p="http://springframework.org/schema/p"

xmlns:mvc="http://springframework.org/schema/mvc"

xmlns:context="http://springframework.org/schema/context"

xmlns:util="http://springframework.org/schema/util"

xsi:schemaLocation="http://springframework.org/schema/beans

http://springframework.org/schema/beans/spring-beans-4.1.xsd

http://springframework.org/schema/context

http://springframework.org/schema/context/spring-context-4.1.xsd

http://springframework.org/schema/mvc

http://springframework.org/schema/mvc/spring-mvc-4.1.xsd

http://springframework.org/schema/util

http://springframework.org/schema/util/spring-util-4.1.xsd">

class="org.springframework.jdbc.datasource.DataSourceTransactionManager">

class="org.springframework.jdbc.support.lob.DefaultLobHandler"

lazy-init="true"/>

class="org.springframework.jdbc.support.lob.DefaultLobHandler"

lazy-init="true"/>

spring-servlet.xml

xmlns:xsi="http://w3.org/2001/XMLSchema-instance"

xmlns:context="http://springframework.org/schema/context"

xmlns:mvc="http://springframework.org/schema/mvc"

xsi:schemaLocation="http://springframework.org/schema/mvc

http://springframework.org/schema/mvc/spring-mvc-4.1.xsd

http://springframework.org/schema/beans

http://springframework.org/schema/beans/spring-beans-4.1.xsd

http://springframework.org/schema/context

http://springframework.org/schema/context/spring-context-4.1.xsd">

Spring MVC Configuration

"org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter"/>

class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

5242880

xmlns:xsi="http://w3.org/2001/XMLSchema-instance"

xmlns:context="http://springframework.org/schema/context"

xmlns:mvc="http://springframework.org/schema/mvc"

xsi:schemaLocation="http://springframework.org/schema/mvc

http://springframework.org/schema/mvc/spring-mvc-4.1.xsd

http://springframework.org/schema/beans

http://springframework.org/schema/beans/spring-beans-4.1.xsd

http://springframework.org/schema/context

http://springframework.org/schema/context/spring-context-4.1.xsd">

Spring MVC Configuration

"org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter"/>

class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

5242880

class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

5242880

web.xml

xmlns:xsi="http://w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"

version="3.0">

default

*.jpg

default

*.gif

default

*.png

default

*.js

default

*.css

contextConfigLocation

classpath*:xmlconfig/springmvc-mybatis.xml

org.springframework.web.context.ContextLoaderListener

springmvc

org.springframework.web.servlet.DispatcherServlet

contextConfigLocation

classpath*:/xmlconfig/springmvc-servlet.xml

springmvc

characterEncodingFilter

org.springframework.web.filter.CharacterEncodingFilter

encoding

UTF-8

forceEncoding

true

characterEncodingFilter

/index.html

xmlns:xsi="http://w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"

version="3.0">

default

*.jpg

default

*.gif

default

*.png

default

*.js

default

*.css

contextConfigLocation

classpath*:xmlconfig/springmvc-mybatis.xml

org.springframework.web.context.ContextLoaderListener

springmvc

org.springframework.web.servlet.DispatcherServlet

contextConfigLocation

classpath*:/xmlconfig/springmvc-servlet.xml

springmvc

characterEncodingFilter

org.springframework.web.filter.CharacterEncodingFilter

encoding

UTF-8

forceEncoding

true

characterEncodingFilter

/index.html

接下来就是包的结构了

前缀大家可以自己定义自己喜欢的，但是后边的结构，是整个框架的核心，所以请大家按照我的格式去建

前缀com.ansitech

com.ansitech.orm

com.ansitech.orm.base

com.ansitech.orm.mapper

com.ansitech.service

com.ansitech.service.po

com.ansitech.service.impl

com.ansitech.web

com.ansitech.web.controller

大家可能不理解，为什么要这么建呢？

那么我们来以用户管理模块来解释，用户对象为User

那么我们需要建立基础对象：

com.ansitech.orm.base.User.Java

package com.ansitech.orm.base;

/**

* 用户对象

* @author qsyang

public class User {

private int id;

private String loginName;

private String loginPwd;

/**

* 用户类型 1 管理员 2 普通用户

private int typeId;

public int getId() {

return id;

}

public void setId(int id) {

this.id = id;

}

public String getLoginName() {

return loginName;

}

public void setLoginName(String loginName) {

this.loginName = loginName;

}

public String getLoginPwd() {

return loginPwd;

}

public void setLoginPwd(String loginPwd) {

this.loginPwd = loginPwd;

}

public int getTypeId() {

return typeId;

}

public void setTypeId(int typeId) {

this.typeId = typeId;

}

基础对象建好了，我们需要做一个Mapper来实现用户对象的增删改查

com.ansitech.orm.mapper.UserMapper.java

package com.ansitech.orm.mapper;

import com.ansitech.orm.base.User;

import org.apache.ibatis.annotations.Param;

/**

* 用户数据接口

* @author qsyang

public interface UserMapper {

void add(User user);

User get(@Param("id") int id);

void update(User user);

int delete(@Param("id") int id);

}

使用ORM模式，我们需要创建一个抽象的用户对象来解决额外属性查询的问题

com.ansitech.orm.AbstractUser.java

package com.ansitech.orm;

import com.ansitech.orm.base.User;

/**

* 抽象用户对象

* 提供其他属性获取

* @author qsyang

public abstract class AbstractUser extends User{

//获取当前用户所属分类名称

public abstract String findTypeName();

}

有了数据接口了，我们需要对外提供服务

com.ansitech.service.IUserService.java

package com.ansitech.service;

import com.ansitech.orm.AbstractUser;

import com.ansitech.orm.base.User;

/**

* 用户服务接口

* @author qsyang

public interface IUserService {

//添加系统管理员

void addSystemUser(String loginName, String loginPwd);

//添加普通用户

void addNormalUser(String loginName, String loginPwd);

//根据用户Id查询抽象用户

AbstractUser getAbstractUserById(int userId);

//根据用户Id查询用户

User getUserById(int userId);

//修改用户信息

void updateUser(int userId, String loginName, String loginPwd);

//根据用户Id删除用户

int deleteUser(int userId);

}

有了服务接口，就要有实现接口

com.ansitech.service.impl.UserService.java

package com.ansitech.service.impl;

import com.ansitech.orm.AbstractUser;

import com.ansitech.orm.base.User;

import com.ansitech.orm.mapper.UserMapper;

import com.ansitech.service.IUserService;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.stereotype.Service;

/**

* 用户接口实现类

* @author qsyang

@Service

public class UserService implements IUserService {

@Autowired

private UserMapper userMapper;

@Override

public void addSystemUser(String loginName, String loginPwd) {

User user = new User();

user.setLoginName(loginName);

user.setLoginPwd(loginPwd);

//用户类型 1 管理员 2 普通用户

user.setTypeId(1);

userMapper.add(null);

}

@Override

public void addNormalUser(String loginName, String loginPwd) {

User user = new User();

user.setLoginName(loginName);

user.setLoginPwd(loginPwd);

//用户类型 1 管理员 2 普通用户

user.setTypeId(2);

userMapper.add(null);

}

@Override

public AbstractUser getAbstractUserById(int userId) {

throw new UnsupportedOperationException("Not supported yet.");

}

@Override

public User getUserById(int userId) {

return userMapper.get(userId);

}

@Override

public void updateUser(int userId, String loginName, String loginPwd) {

//先根据用户Id查询用户对象

User user = userMapper.get(userId);

if (user != null) {

user.setLoginName(loginName);

user.setLoginPwd(loginPwd);

//修改用户

userMapper.update(user);

}

@Override

public int deleteUser(int userId) {

return userMapper.delete(userId);

}

细心的便宜，可能已经看到了，getAbstractUserById()这个方法我们还没有实现

因为AbstractUser还有具体的实现类，所以我们来新建实现类

package com.ansitech.service.po;

import com.ansitech.orm.AbstractUser;

import com.ansitech.orm.base.User;

import com.ansitech.service.impl.UserService;

/**

* 用户数据操作对象

* @author qsyang

public class UserPO extends AbstractUser {

private final UserService userService;

public UserPO(UserService userService) {

this.userService = userService;

}

public UserPO copyFrom(User obj) {

this.setId(obj.getId());

this.setLoginName(obj.getLoginName());

this.setLoginPwd(obj.getLoginPwd());

this.setTypeId(obj.getTypeId());

return this;

}

@Override

public String findTypeName() {

return userService.findTypeName(this.getTypeId());

}

对象已经创建好了，这个时候我们可以修改下service实现类的方法了，并且我们增加了一个方法

增加这个方法，只是因为我们有可能需要继续调用其他的Mapper去查询。

修改的实现方法

@Override

public AbstractUser getAbstractUserById(int userId) {

User user = userMapper.get(userId);

if (user != null) {

UserPO po = new UserPO(this);

po.copyFrom(user);

return po;

}

return null;

}

新增的方法：

public String findTypeName(int typeId) {

if (typeId == 1) {

return "系统管理员";

} else {

return "普通用户";

}

只有一来，Service架构和orm架构就已经完成了，下面只需要建立控制器就可以了

package com.ansitech.web.controller.user;

import com.ansitech.orm.base.User;

import com.ansitech.service.impl.UserService;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.annotation.RequestMapping;

/**

* 用户控制器

* @author qsyang

@Controller

public class UserController {

@Autowired

private UserService userService;

@RequestMapping("/user/user-index")

public String index() {

User user = userService.getUserById(1);

if (user != null) {

System.out.println("user name = " + user.getLoginName());

}

return "jsp/user/index";

}

大家到现在有没有理解这个架构呢？

Flask接口签名sign原理与实例代码浅析

210 2023-06-02

Spring MVC 4.1.3 + MyBatis零基础搭建Web开发框架(注解模式)

多平台统一管理软件接口，如何实现多平台统一管理软件接口

Flask接口签名sign原理与实例代码浅析

java中的接口是类吗

推荐文章

接口调用是什么意思？几种常用接口调用方式

接口设计原则

8款在线 API 接口文档管理工具

api管理系统是什么？

什么是接口调试？接口调试的步骤有哪些？

api 接口管理系统有哪些？

接口测试有几种测试方法

API文档生成工具有哪些？

微服务和api网关区别

交换机配置步骤

最近发表

热评文章

在线接口文档管理工具推荐，支持在线测试，HTTP接口

开源的在线接口文档wiki工具Mindoc的介绍与使

如何优雅的进行接口设计？接口设计的六大原则是什么？

什么是API测试,api检测公司

软件接口设计怎么做？前后端分离软件接口设计思路

接口管理平台推荐，几大接口管理平台总有一款适合你！