Eclipse完成Maven + Spring Boot + Mybatis + jsp
Spring Boot 完成WEB项目开发
开发工具:eclipse
框架:Maven;Spring Boot;Mybatis
界面:jsp;javascript;css
前言:
在SpringBoot的学习中,遇到很多问题,也在网上找过许多文档,但大多数都是使用IDE开发工具完成的,所以在此记录使用Eclipse开发工具完成的SpringBootWeb项目。
感谢在学习中看到过的文章的作者们,让我学习少走许多弯路。
一、 Eclipse关联Maven
- 首先下载Maven,将Maven放置在除开C盘的任意盘中。
- 修改Maven的settings.xml文件,该文件的目录在*/Maven/conf
- 在settings.xml中配置本地仓库。如图:
apache-maven-3.2.1是我的Maven文件夹,解压后懒得改了。。。
maven_repository就是我的本地仓库,以后从maven新下载的包都会放到这个本地仓库中。
settings.xml已经有loaclRepository标签,不过被注释了,只需要找到修改完并打开注释即可
4. 修改settings.xml中配置阿里云链接。如图:
同样,找到mirrors标签,按图中配置修改即可。这个配置是为了提高查找源码或下载包时的速度,原配置中是连接国外的服务器,相对而言十分慢。
5. 在eclipse中加入Maven的关联
在window-preferences-maven中添加Maven的关联
修改settings.xml的关联。查看本地仓库是否正确。
以上5步就已经将eclipse和maven关联起来了。
二、 使用Maven创建Spring Boot Web 项目
- 创建Maven项目
1.1、 点击File – New – Other,选中Maven
1.2、 然后点击Next,进入Maven Project,默认选项,点击Next
1.3、 选中web项目,点击Next如图:
1.4、 填写项目基本数据
这里的工作空间已经拥有了MyMavenSpringBootWeb项目,所以出现报错且不能创建。
2.构建SpringBoot的目录结构
创建出来的SpringBoot目录可能会有所缺失,所以我们将其补全
在main包下面添加resources和webapp包,分别用于放置配置文件和web界面
3. 修改pom.xml,引入SpringBoot的相关配置
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion>
<groupId>cn.com</groupId> <artifactId>MyMavenSpringBootWeb</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>war</packaging>
<name>MyMavenSpringBootWeb Maven Webapp</name> <!-- FIXME change it to the project's website --> <url>http://www.example.com</url>
<properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <maven.compiler.source>1.7</maven.compiler.source> <maven.compiler.target>1.7</maven.compiler.target> </properties>
<!-- Spring Boot父依赖 --> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.9.RELEASE</version> </parent>
<dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.11</version> <scope>test</scope> </dependency>
<!-- Spring Boot web依赖 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
<!-- Spring Boot 热部署 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> </dependency>
<!-- 引入thymelaf 则不需要引入web依赖,若不需要thymelaf则需要添加spring-boot-starter-web --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency>
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> </dependency>
<!-- mybatis依赖 --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.3.1</version> </dependency>
<!-- tomcat的支持. --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> <scope>provided</scope> </dependency>
<!-- 访问JSP页面必须配置 --> <dependency> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-jasper</artifactId> <scope>provided</scope> </dependency>
<!-- jsp对servlet容器的支持 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> </dependency>
<!-- 解析jsp页面,跳转所需配置 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> </dependency> </dependencies>
<build> <finalName>MyMavenSpringBootWeb</finalName> <pluginManagement> <!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) --> <plugins> <!--springframework插件配置 --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin </artifactId> </plugin>
<plugin> <artifactId>maven-clean-plugin</artifactId> <version>3.1.0</version> </plugin> <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging --> <plugin> <artifactId>maven-resources-plugin</artifactId> <version>3.0.2</version> </plugin> <plugin> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.0</version> </plugin> <plugin> <artifactId>maven-surefire-plugin</artifactId> <version>2.22.1</version> </plugin> <plugin> <artifactId>maven-war-plugin</artifactId> <version>3.2.2</version> </plugin> <plugin> <artifactId>maven-install-plugin</artifactId> <version>2.5.2</version> </plugin> <plugin> <artifactId>maven-deploy-plugin</artifactId> <version>2.8.2</version> </plugin> </plugins> </pluginManagement> </build> </project>
|
Pom配置文件配置好后,选中项目右键-Maven-Update Project下载jar包
想要正确的访问到jsp界面,我们需要将项目的打包方式改war,即<packaging>标签
4. 配置properties文件
#数据库配置 spring.datasource.url=jdbc:mysql://localhost:3306/my_local_sql spring.datasource.username=root spring.datasource.password=root #spring.datasource.driverClassName=com.mysql.jdbc.Driver spring.datasource.max-active=20 spring.datasource.max-idle=8 spring.datasource.max-maxWait=100 spring.datasource.min-idle=8 spring.datasource.initial-size=10 spring.session.store-type=none #mybatis.mapper-locations=classpath:/mybatis/*Mapper.xml
#jsp访问路径 spring.mvc.view.suffix=.jsp spring.mvc.view.prefix=/WEB-INF/jsp/
#关闭默认模板引擎 spring.thymeleaf.cache=false spring.thymeleaf.enabled=false |
三、 编写代码
- 编写启动类
import org.mybatis.spring.annotation.MapperScan; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.boot.builder.SpringApplicationBuilder; import org.springframework.boot.web.support.SpringBootServletInitializer;
// 该注解的作用是:排除自动注入数据源的配置(取消数据库配置),一般使用在客户端(消费者)服务中 // 消费者是微服务的概念;消费者指的是客服端,服务者指的是服务端 //@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class}) // 当作为服务端时,需要去掉排除,我们使用的myBatis需要注入数据源的配置,而数据源的配置就是该工程的application.properties @SpringBootApplication @MapperScan(basePackages = {"cn.com.service","cn.com.mapper"}) public class MyFirstApplication extends SpringBootServletInitializer{ public static void main(String[] args) throws Exception { SpringApplication.run(MyFirstApplication.class, args); }
@Override protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) { // 注意这里要指向原先用main方法执行的Application启动类 return builder.sources(MyFirstApplication.class); } } |
启动类命名均以*Application格式,文件同时放在根目录中,如图:
到这一步,Spring Boot Wed项目基本上已经配置好了。然后加入service、访问数据看的mapper、控制界面的controller和实体类的entity
2. 编写Mapper接口
import java.util.List;
import org.springframework.stereotype.Repository;
import cn.com.entity.MyFirstEntity;
@Repository public interface MyFirstMapper {
public List<MyFirstEntity> crateEntity() ; } |
这里的Mapper需要用@Repository标签来声明
3. 编写serivce接口和实现类
import java.util.List;
import cn.com.entity.MyFirstEntity;
public interface MyFirstService {
public List<MyFirstEntity> crateEntity() ; } |
import java.util.ArrayList; import java.util.List;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service;
import cn.com.entity.MyFirstEntity; import cn.com.mapper.MyFirstMapper; import cn.com.service.MyFirstService;
@Service("firstService1") public class MyFirstServiceImpl implements MyFirstService {
@Autowired private MyFirstMapper myFirstMapper ;
@Override public List<MyFirstEntity> crateEntity() { // List<MyFirstEntity> list = myFirstDao.crateEntity() ; MyFirstEntity firstEntity = new MyFirstEntity() ; firstEntity.setId("1") ; firstEntity.setName("One") ;
MyFirstEntity secondEntity = new MyFirstEntity() ; secondEntity.setId("2") ; secondEntity.setName("Second") ;
List<MyFirstEntity> list = new ArrayList<MyFirstEntity>() ; list.add(firstEntity) ; list.add(secondEntity) ;
return list ; } } |
@Service声明service类,firstService1是给该类的一个别名。
@Autowired为自动装载的标签,装载类的名字默认为被装载类型的首字母小写,如文中的myFirstMapper
4. Entity实体类的编写
public class MyFirstEntity {
private String id; private String name;
public String getId() { return id; } public void setId(String id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } } |
5. 编写Controller
import java.util.List;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping;
import cn.com.entity.MyFirstEntity; import cn.com.service.MyFirstService;
@Controller public class MyFirstController {
@Autowired private MyFirstService firstService1 ;
@RequestMapping("/hello") public String start(){
List<MyFirstEntity> list = firstService1.crateEntity() ; int size = list.size() ;
System.out.println("后台测试成功!" + size);
return "hello"; } } |
@Controller Spring默认返回view对象,在使用html界面时完全没有问题
当界面换成使用jsp时,需要做些配置,首先是pom.xml的配置。
加入spring-boot-starter-web依赖,SpringBoot有默认的模板引擎,若使用jsp需要禁用默认的模板引擎,所以需要该依赖;
加入spring-boot-starter-tomcat依赖,本次案例是基于外部tomcat完成,
所以加入tomcat依赖,注意这里的依赖需要使用<scope>provided</scope>标签;
加入tomcat-embed-jasper依赖,访问jsp不需要的依赖;
加入jstl依赖,解析jsp页面,跳转所需配置;
在application.properties配置文件中加入spring.thymeleaf.cache=false和spring.thymeleaf.enabled=false
起到禁用默认模板引擎的作用;
如果controller需要分会实体,如Json则使用@ResponseBoby标签,才能使页面具体展示,否则会
报 Error resolving template "hello", template might not exist or might not be accessible by any of the configured Template Resolvers的错误
@RestContreller标签内含了@Contreller和@ResponseBoby标签。所以一般使用该标签来代替其余两标签
@RequestMapping能让程序在url中找到对应的controller,而该标签还能在文件名中进行定义。
如我在MyFirstController上加@RequestMapping(“/test”),那么访问路径就是localhost:8080/MyMavenSpringBootWeb/test/hello。
6. 编写jsp
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Insert title here</title> </head> <body> Hello Spring Boot Project </body> </html> |
jsp默认放在webapp-WEB-INF文件夹下,这里编写jsp时需要注意下application.preperties中的配置,如此次的项目jsp文件在/WEB-INF/jsp/的文件夹下。
四、 运行
接下来的运行就如普通的web开发一样,将项目加入到tomcat运行
出现上图就代表启动成功了,典型的SpringBoot启动啊。
接下来就是直接进行访问了。上图
五、 后语
翻阅了许多资料,发现不少博客里都有不需要项目名就能访问jsp界面的。但这些例子大多都是用IDE开的工具完成。
IDE和Eclipse还是有很多不同,这里说说个人是怎么完成不需要项目名直接访问界面的。
首先Eclipse项目部署tomcat后,会在原项目文件下生成一个Server文件夹。打开该文件夹可以看到server.xml。
我的方法就是直接修改这个文件,找到Context标签,将该标签里的属性path值清空即可。
至于怎么将端口去掉也能完成访问就需要后续研究了。。。