SpringBoot_入门_创建一个新的SpringBoot项目_01

创建一个新的SpringBoot项目

1. 首先创建一个新的工程

2.项目创建完成,开始进行SpringBoot的配置

配置pmo文件:

<?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>org.gaosm</groupId>
    <artifactId>CommonSystem</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>    <!-- 项目产生的构件类型，例如jar、war、ear、pom。插件可以创建他们自己的构件类型，所以前面列的不是全部构件类型 默认为jar.-->
    <name>CommonSystem-maven</name> <!--项目的名称, Maven产生的文档用-->

    <developers>                   <!--开发者信息-->
        <developer>
            <id>617748345</id>
            <name>gaosm</name>
            <email>gaoshaomin21@163.com</email>
        </developer>
    </developers>
    
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.5.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <!-- web支持:直接启用一个嵌套了tomcat的web应用 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- web支持:加入mybatis的支持 -->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.3.2</version>
        </dependency>
        <!--
            MyBatis提供了拦截器接口，我们可以实现自己的拦截器，
           将其作为一个plugin装入到SqlSessionFactory中。
           目前比较常用的分页插件Mybatis-PageHelper
           Github项目地址： https://github.com/pagehelper/Mybatis-PageHelper
         -->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper</artifactId>
            <version>5.1.8</version>
        </dependency>
        <!-- 数据源支持:oracle数据源-->
        <dependency>
            <groupId>com.talent.oracle</groupId>
            <artifactId>ojdbc14</artifactId>
            <version>11.2.0.4</version>
        </dependency>
        <!-- springboot单元测试支持-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <!--热部署支持:dectools-->
        <!--
            spring为开发者提供了一个名为spring-boot-devtools的模块
            来使Spring Boot应用支持热部署，提高开发者的开发效率，
            无需手动重启Spring Boot应用
        -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
        </dependency>
        <!--web支持:servlet依赖-->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <scope>compile</scope>
        </dependency>
        <!--web支持:JSP依赖,现在项目基本都采用前后端分离,使用单独的前端框架,不用可以不加-->
        <!--
            JSTL（JSP Standard Tag Library，JSP标准标签库)是一个不断完善的开放源代码的JSP标签库，
            是由apache的jakarta小组来维护的。JSTL只能运行在支持JSP1.2和Servlet2.3规范的容器上，
            如tomcat 4.x。在JSP 2.0中也是作为标准支持的。
            不然报异常信息：
            javax.servlet.ServletException: Circular view path [/helloJsp]:
            would dispatch back to the current handler URL [/helloJsp] again.
            Check your ViewResolver setup! (Hint: This may be the result of an unspecified view, due to default view name generation.)
         -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
        </dependency>
        <!-- 外部容器支持1:tomcat 的支持.-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>       <!-- 部署到外部tomcat时就没必要引用了-->
        </dependency>
        <!-- 外部容器支持2:jsp 的支持.-->
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <scope>provided</scope>
        </dependency>
        <!--freemarker  的支持_不使用可以不配置-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-freemarker</artifactId>
        </dependency>
        <!--json转换支持-->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.7</version>
        </dependency>
        <!--测试支持:  Junit_不使用可以不配置-->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!--能够将Spring Boot应用打包为可执行的jar或war文件，然后以通常的方式运行Spring Boot应用-->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <fork>true</fork><!--//该配置必须,热部署用--><!-- 要使compilerVersion标签生效，还需要将fork设为true，用于明确表示编译版本配置的可用 -->
                </configuration>
            </plugin>
            
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <!-- 一般而言，target与source是保持一致的，但是，
                    有时候为了让程序能在其他版本的jdk中运行(对于低版本目标jdk，
                    源代码中不能使用低版本jdk中不支持的语法)，
                    会存在target不同于source的情况 -->
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding><!-- 字符集编码 -->
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

创建SpringBoot启动类:

 额外说明一下:这里的类创建在了二级目录下,原因是,如果使用@SpringBootApplication默认的注释组件包扫描	,会以SpringBoot启动类同级目录为相对路径开始扫描,如果放的目录深了,例如:common,system目录下的注释组件将不会自动注入!如果不使用@SpringBootApplication,也可单独使用@ComponentScan单独进行包扫描配置.

package org.gaosm;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

/**
 * User: gaosm
 * SpringBoot启动主类
 */

@SpringBootApplication
//加入打包成war包支持,必须继承SpringBootServletInitializer,起到web.xml相同的作用。
public class MainApplication extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(MainApplication.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

配置SpringBoot配置文件:

 这里我使用yml方式进行配置(也可以使用Properties方式,我感觉差不多,不过yml确实看起来清爽了很多)

#项目服务统一配置
server:
  port: 9090
  servlet:
    context-path: /CommonSystem
spring:
  thymeleaf:
    enabled: false
  #数据源配置
  datasource:
    url: jdbc:oracle:thin:@localhost:1521:orcl
    username: my_open_project
    password: my_open_project
    driver-class-name: oracle.jdbc.driver.OracleDriver
  #视图层配置
  mvc:
    date-format: yyyy-MM-dd HH:mm:ss
  freemarker:
    suffix: .html
    template-loader-path: classpath:/templates
#日志配置
logging:
  level:
    root: INFO
    org:
      springframework:
        web: INFO
        security: INFO
      gaosm:
        mapper: DEBUG

OK这样一个简单的SpringBoot框架就创建完成了,启动SpringBoot主类中的main方法工程启动成功,如下图所示:

下面我们来进行一下测试,做一个简单的请求来测试一下我们的框架是否能正常运行.

3. 测试

创建Model类Person和Controller测试类HellowHtml

Person:

package org.gaosm.system.test;

/**
 * User: gaosm
 */
public class Person {
        private long id;//主键.
        private String name;//测试名称.

    public long getId() {
        return id;
    }

    public void setId(long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

HellowHtml:

package org.gaosm.system.test;

import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * User: gaosm
 */
@Controller
public class HellowHtml {
    @RequestMapping("/hellowhtml")
    public String hellowHtml(ModelMap modelMap){
        Person person=new Person();
        person.setId(1);
        person.setName("张三");
        modelMap.addAttribute(person);
        return "hellow-word";
    }
}

hellow-word.html:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
hellow word !${person.name},您的ID为${person.id}
</body>
</html>

最后访问http://localhost:9090/CommonSystem/hellowhtml 测试成功返回!

小结:SpringBoot的开箱即用,真真是减少了大量的配置,让以前复杂的javaWeb门槛下降不少,当然也减少了非常多的学习曲线,能够让开发者更专注于业务逻辑和核心技术研究,之前都在有道云笔记写自己的技术贴,一方面书写相对比较随意,另一方面也感觉自己水平有限,写出来的东西不够清晰,以免对初学者造成困扰就不好了,但是最近有感于自己这些年从CSDN,博客园,简书等阅读了好多优秀的作品,从中受益良多,也就把自己云笔记中的一些学习经验和过程整理一下发布上来,仅供参考!