【spring boot】SpringBoot初学（1） - Hello World

前言

此文只是记录自己简单学习spring boot的笔记。所以，文章很多只是初步理解，可能存在严重错误。

一、Spring boot的初步理解

1、spring boot的目标（摘自：spring-boot参考指南 official 中文）

为所有的Spring开发提供一个从根本上更快的和广泛使用的入门经验。
开箱即用，但你可以通过不采用默认设置来摆脱这种方式。
提供一系列大型项目常用的非功能性特征（比如，内嵌服务器，安全，指标，健康检测，外部化配置）。
绝对不需要代码生成及XML配置。

2、spring boot代替了什么，Spring、SpringMVC/Struts2、hibernate/Mybatis？

个人理解：代替了spring。用代替/取代来解释貌似都不好，更准确的可能是封装了spring，使搭建SSH/SSM更快捷。

传统的spring有很多xml配置，例如：dataSource、transactionManager、AOP、bean等等xml的配置。即便用注解，也要在xml中配置component-scan等。

但在spring boot，遵循“约定大于配置”，所以尽可能的避免了xml配置。

3、spring boot避免了哪些xml？

主要是spring的application.xml、context等xml。但例如：mybatis.xml、log4j.xml等还是要的。

4、什么是Starter POMs？

Starter POMs是可以包含到应用中的一个方便的依赖关系描述符集合。你可以获取所有Spring及相关技术的一站式服务，

而不需要翻阅示例代码，拷贝粘贴大量的依赖描述符。例如，如果你想使用Spring和JPA进行数据库访问，

只需要在你的项目中包含 spring-boot-starter-data-jpa 依赖，然后你就可以开始了。

参考参考指南13.4，pdf页数56/420。

二、Sping boot的建议

1、推荐使用jdk1.8+。（虽然可以在1.6-1.7中使用）

2、servlet容器。

3、Spring Boot兼容Apache Maven 3.2或更高版本；

Spring Boot兼容Gradle 1.12或更高版本。

4、建议使用thymeleaf、velocity、beetl等模版引擎。而不建议使用jsp（虽然可以配置jsp支持）。

三、demo

1、代码结构（idea）

2、解释

application.java：入口

GreetingController.java：controller层代码。

index.html：默认首页。localhost:8080访问的页面即index.html。

greeting.html：请求页面。

（1、为什么html是在resources中。2、为什么结构是static、templates。3、如何修改此“约定”，把html放到webapp/WEB-INF下。

这些问题在以后学习，此文不讨论。）

3、source code

<?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>VergiLyn</groupId>
    <artifactId>Spring boot</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.4.3.RELEASE</version>
    </parent>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <!-- 模版框架thymeleaf -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <optional>true</optional>
        </dependency>
        <!-- spring boot 单元测试依赖 BEGIN-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!-- spring boot 单元测试依赖 END-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

pom.xml

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

@Controller
//@RestController
public class GreetingController {
    @RequestMapping("/greeting")
    public String greeting(@RequestParam(value="name", required=false, defaultValue="VergiLyn") String name
            , Model model) {
        model.addAttribute("name", name);
        return "greeting";
    }

}

index.html

<!DOCTYPE HTML>
<html>
<head>
    <title>Getting Started: Serving Web Content</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
<p>Get your greeting <a href="/greeting">here</a></p>
</body>
</html>

greeting.xml

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Getting Started: Serving Web Content</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
<p th:text="'Hello, ' + ${name} + '!'" />
</body>
</html>

spring boot的单元测试模版

@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class TestOfficialDemo {

    @LocalServerPort
    private int port;

    @Autowired
    private TestRestTemplate restTemplate;

    @Test
    public void testGreetingDefault() throws Exception {
        assertThat(this.restTemplate.getForObject("http://localhost:" + port + "/greeting",String.class))

                .contains("VergiLyn");
    }
}

4、测试

运行application.java的main()方法，控制台打印：

请求访问localhost:8080

点击超链接“here”：可以看到用的是defaultValue。

自定义请求greeting：localhost:8080/greeting?name=VergiLyn淡无欲

四、部分解释

1、@Controller、@RestController、@RequestMapping、@RequestParam是spring的注解，而非spring boot提供的注解。

2、@Controller与@RestController的区别

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface Controller {
    String value() default "";
}

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Controller
@ResponseBody
public @interface RestController {
	String value() default "";
}

通过sourceCode的定义可以看出：@RestController在@Controller的基础上多了@ResponseBody。简单理解就是：@RestController不能返回html、jsp。

（Rest即webservice中RESTful的rest，可以理解成@RestController主要用来返回json等数据，而非页面）

3、@SpringBootApplication

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
    excludeFilters = {@Filter(type = FilterType.CUSTOM,classes = {TypeExcludeFilter.class}
 )}
)
public @interface SpringBootApplication {
    Class<?>[] exclude() default {};

    String[] excludeName() default {};

    @AliasFor(
        annotation = ComponentScan.class,
        attribute = "basePackages"
    )
    String[] scanBasePackages() default {};

    @AliasFor(
        annotation = ComponentScan.class,
        attribute = "basePackageClasses"
    )
    Class<?>[] scanBasePackageClasses() default {};
}

摘自：参考指南

很多Spring Boot开发者总是使用 @Configuration ， @EnableAutoConfiguration 和 @ComponentScan 注解他们的main类。由于这些
注解被如此频繁地一块使用（特别是你遵循以上最佳实践时），Spring Boot提供一个方便的 @SpringBootApplication 选择。
该 @SpringBootApplication 注解等价于以默认属性使用 @Configuration ， @EnableAutoConfiguration 和 @ComponentScan 。

附录

玩转spring boot——快速开始

Serving Web Content with Spring MVC （官方demo）

spring-boot参考指南 official 中文

posted @ 2017-01-08 02:50 淡丶无欲阅读(2206) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

淡丶无欲

一只凄惨的中华田园犬

【spring boot】SpringBoot初学（1） - Hello World

前言

一、Spring boot的初步理解

三、demo

四、部分解释

附录

公告