rest service + spring boot + docker

开发 -> 测试 -> 部署，这是软件开发一般的简化流程，作为开发者我们总是希望能专注于开发，但往往会被一些开发之外的问题所折磨，比如繁多的spring依赖和不同的环境配置。带着这个问题，本文介绍运用springboot和docker开发和构建一个rest风格的web应用。

 

Spring 框架作为目前非常流行的一个 Java 应用开发框架，它包含几十个不同的子项目，涵盖应用开发的不同方面。要在这些子项目之间进行选择，并快速搭建一个可以运行的应用是比较困难的事情。Spring Boot 的目的在于快速创建可以独立运行的 Spring 应用，大大提升使用 Spring 框架时的开发效率。

 

对于我们的web应用来说，springboot相当于把web服务器嵌入发布包内，以少量的配置大大方便了程序的开发和发布。我们可以专注于项目本身，创建独立的Java应用，通过java -jar启动。

 

添加Spring Boot相关POM配置

 

<dependencies>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>1.2.5.RELEASE</version>
  </dependency>
</dependencies>

 

 

我们只需要将spring-boot-starter-web的依赖加入到pom文件即可，它提供了对web的支持。当然也有很多推荐让其作为parent加载，但这样会引入很多不必要的jar包。

 

Controller

 

@EnableAutoConfiguration
@RestController
@RequestMapping("/person")
public class Controller {
	@RequestMapping("/{name}")
	public Properties getPersion(@PathVariable("name") String name) {
		Properties p = new Properties();
		p.put("name", name);
		p.put("age", new Random().nextInt(100));
		return p;
	}

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

 

 

 

@EnableAutoConfiguration的作用在于让 Spring Boot 根据应用所声明的依赖来对 Spring 框架进行自动配置，这就减少了开发人员的工作量。比如说我们可以加入下面这段代码来制定contextpath和port。

 

@Bean
public EmbeddedServletContainerFactory servletContainer() {
  TomcatEmbeddedServletContainerFactory factory = new TomcatEmbeddedServletContainerFactory("/admin", 8091);
  return factory;
}

 

 

这样一个rest风格的web应用就搭建完成，可以访问http://localhost:8091/admin/person/kane查看结果。

 

Package

注意如果想到将应用打成一个可执行jar包的话，一定要用spring-boot-maven-plugin而不是其他的类似于maven-shade-plugin的插件。

<plugin>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-maven-plugin</artifactId>
  <version>1.2.5.RELEASE</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>repackage</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <mainClass>test.controller.Controller</mainClass>
  </configuration>
</plugin>

直接用java -jar <jar_name>即可启动web应用。

 

Docker安装和运行

Docker 是一个构建、部署以及运行应用的开放平台，应用可以在不同的环境（开发、测试、生产）中无差别的运行，为应用的开发提供了很大的灵活性。

 把可执行的jar包放入docker容器中，我们可以忽略所要部署的环境的差异性，而不需要关心环境配置。

 

Docker的安装和入门教程，推荐http://www.widuu.com/chinese_docker/userguide/dockerrepos.html，这里只是介绍最简单的流程。

 

• 对于ubuntu，可以用以下命令安装

$ sudo apt-get update
$ sudo apt-get install docker.io
$ sudo ln -sf /usr/bin/docker.io /usr/local/bin/docker
$ sudo sed -i '$acomplete -F _docker docker' /etc/bash_completion.d/docker.io

 

• 选择一个java docker image，我使用java：7

sudo docker pull java:7

 

• 假设我们的可运行jar包放在/tmp目录下，那么可以通过以下命令在docker容器中运行。

sudo docker run -d -v /tmp:/tmp java:7 java -jar /tmp/<jar_name>

这个命令使用java:7这个镜像创建一个container，并在后台执行java -jar <jar_name>。-d表示后台运行，-v表示目录映射，可以简单理解为ln -s。

 

• docker container启动起来之后,可以使用sudo docker ps命令查看该进程的端口映射，比如0.0.0.0:49155->8091/tcp，它表示将docker容器8091端口映射到容器宿主的49155端口，所以我们可以通过http://<hostname>:49155/admin/person/kane访问前文中的web应用。

评论

1 楼 yuechen323 2015-08-06  

兄弟，你是springboot＋docker，前面的rest service是啥框架，你没说啊