SpringCloud学习第一天，helloWorld

spring cloud是这几年新兴的微服务框架，虽然现在的微服务框架很多，但是spring cloud还是被认为最好的微服务框架，尽管我也不知道为什么这么说，但是接下来我准备一点一点的探究，今天就是开始的第一步，大家可以一点一点的通过一个小小的例子，来看看为什么他被称为最好的微服务框架

Web项目

具体的虽然我不是很明白，但是我们先通过一个简单的例子来看看spring cloud是什么样子的吧。

创建maven项目

pom文件

<?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.springframework</groupId>
    <artifactId>gs-rest-service</artifactId>
    <version>0.1.0</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.2.RELEASE</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.jayway.jsonpath</groupId>
            <artifactId>json-path</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <properties>
        <java.version>1.8</java.version>
    </properties>


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

    <repositories>
        <repository>
            <id>spring-releases</id>
            <url>https://repo.spring.io/libs-release</url>
        </repository>
    </repositories>
    <pluginRepositories>
        <pluginRepository>
            <id>spring-releases</id>
            <url>https://repo.spring.io/libs-release</url>
        </pluginRepository>
    </pluginRepositories>
</project>

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30
• 31
• 32
• 33
• 34
• 35
• 36
• 37
• 38
• 39
• 40
• 41
• 42
• 43
• 44
• 45
• 46
• 47
• 48
• 49
• 50
• 51
• 52
• 53
• 54
• 55
• 56
• 57
• 58
• 59

添加必要的jar包，一切和spring有关的包都不需要版本号，springcloud会给你选择他最稳定的版本。而spring-boot-maven-plugin更是非常的强大，他提供了很多方便的功能。

1. 它收集类路径上的所有jar，并构建一个可运行的“über-jar”，这样可以更方便地执行和传输您的服务。
2. 他会定位public static void main()方法来标记为可运行类。
3. 他会为你默认选择jar包的版本号。

创建一个get请求

创建一个get请求，并且有一个可选的参数name，请求的结果中会返回一个json数据，就像这个样子

{
    "id": 1,
    "content": "Hello, World!"
}

• 1
• 2
• 3
• 4

创建pojo类

id是唯一标识符，content是返回的内容，首先创建一个简单的类，有id和content两个字段，有一个构造函数 
src/main/java/hello/Greeting.java

package hello;

public class Greeting {

    private final long id;
    private final String content;

    public Greeting(long id, String content) {
        this.id = id;
        this.content = content;
    }

    public long getId() {
        return id;
    }

    public String getContent() {
        return content;
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20

springboot自动使用jackson,他会吧Greeting转换成json格式的字符串。

创建controller

在spring中构建restful的web服务，http请求由controller处理，而springcloud可以轻松的通过@RestController来识别，下面的GreetingController通过返回Greeting类的新实例来处理GET请求/ greeting

package hello;

import java.util.concurrent.atomic.AtomicLong;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class GreetingController {

    private static final String template = "Hello, %s!";
    private final AtomicLong counter = new AtomicLong();

    @RequestMapping("/greeting")
    public Greeting greeting(@RequestParam(value="name", defaultValue="World") String name) {
        return new Greeting(counter.incrementAndGet(),
                            String.format(template, name));
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19

这个控制器看似非常的简单，但是我们慢慢来变化他。 
@RequestMapping来确保访问的方法正确的映射到greeting方法，但是细心的你发现为什么没有post,get请求，其实@RequestMapping默认允许所有的http请求，我们只需要@RequestMapping(method=GET)来制定需要的请求。 
@@RequestParam绑定了参数的name，这样我们在参数中输入name的参数的时候就可以制定该方法的name，此查询字符串参数被明确标记为可选（默认情况下为required = true）：如果请求中不存在，则使用“World”的defaultValue。而返回值很简单，id就是一个计数器的下一个值，并且返回格式化的content， 
传统的mvc和springcloud的不同就是相应主体的区别，我们不管学习springmvc,还是struts，都有一个view这么个概念，他会是主体，然后然会给html，但是在这里, 
这个RESTful Web服务简单的填充以后就可以返回给html的json对象 
代码用到了spring4.*的@RestController的注解，这个注解其实就是@Controller和@ResponseBody 的结合体.并且spring会自动的利用 MappingJackson2HttpMessageConverter来转化Greeting实体到json

运行你的程序

非常简单的方法创建一个独立的应用程序。并且我们默认发布到springboot支持的tomcat上边。

package hello;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

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

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12

@SpringBootApplication这个注释其实也是又好几个注释组合而成的。 
1. @Configuration将该类标记为应用程序上下文的bean定义的源 
2. @EnableAutoConfiguration指示Spring Boot根据类路径设置，其他bean和各种属性设置开始添加bean 
3. @ComponentScan告诉Spring在hello包中查找其他组件，配置和服务，让它找到控制器 
而且你也注意到了，我们再也不需要所谓的web.xml文件来保证项目的启动了SpringApplication.run方法能让我们的项目完美的启动，我们也不会去考虑404这些情况了，所谓的配置错误，滚蛋吧。运行main方法，我们就能看到我们的项目正确执行了，接下来方位

http://localhost:8080/greeting

• 1

结果如下：

{"id":1,"content":"Hello, World!"}

• 1

如果是get的请求加参数

http://localhost:8080/greeting?name=User

• 1

结果是

{"id":2,"content":"Hello, User!"}

• 1

小结

如果你发现id从1变成了2，说明我们的项目一直是很好的运行的。通过这一章的认识，我们了解了@RestController,@RequestMapping，@RequestParam, 
@SpringBootApplication,并且知道了如何运用springcloud启动一个项目，而不用配置web.xml文