借助Maven入手Spring Boot第一个程序

    目前网上有不少Spring Boot的入门文章,都很有帮助,本人最近在深入学习Spring Cloud,在搭建第一个Hello World程序时,感觉对于新手而言,介绍文章怎么详细都不为过,因为其中坑不少,所以这里就把第一次实践的步骤贴出来,以求和大家一起进步。 

1 Maven是什么?能带来什么帮助?

    我们在用Eclipse开发项目时,一定会引入支持特定功能的jar包,比如从下图里,我们能看到这个项目需要引入支持mysql的jar包。

 

    从上图里我们能看到,支持mysql的jar包是放在本地路径里,这样如果在本地运行自然是没问题了。但如果我们要把这个项目发布到服务器上,就会有问题了,因为在这个项目的.classpath文件,已经指定mysql的jar包在本地d盘下的某个路径,如下图所示。 

    一旦发布到服务器上,项目依然会根据.classpath的配置,从d盘下这个路径去找,事实上服务器上是不可能有这样的路径和jar包的。

    我们也可以通过在.classpath里指定相对路径来解决这个问题,在下面的代码里,我们可以指定本项目将引入“本项目路径/WebRoot/lib“目录里的jar包。

            <classpathentry kind="lib" path="WebRoot/lib/jar包名.jar"/>

    这样做,发布到服务器时,由于会把整个项目路径里的文件都上传,所以不会出错。但这样依然会给我们带来不便。比如这个服务器上我们部署了5个项目,它们都会用到这个mysql支持包,这样我们就不得不把这个jar包上传5次,再扩展一下,如果5个项目里会用到20个相同的jar包,那么我们还真就不得不做多次复制。如果我们要升级其中的一个jar包,那么还真就得做很多重复的复制粘贴动作。

    期望中的工作模式应该是,应该有个“仓库“同一放置所有的jar包,在开发项目时,可以通过配置文件引入必要的包,而不是把包复制到本项目里。这就是Maven的做法。

    用通俗的话来讲,Maven是套Eclipse的插件,它的核心价值是能理顺项目间的依赖关系,具体来讲,能通过其中的pom.xml配置文件来统一管理本项目所要用到的jar包,在项目里引入Maven插件后,开发者就不必手动添加jar包了,这样也能避免因此来带来的一系列问题。

2 通过Maven开发Spring Boot的HelloWorld程序

    第一步,创建Maven项目。本书使用MyEclipse作为开发环境,在其中已经引入了Maven插件,所以我们可以通过“File”->”New”菜单,如下图所示,直接创建Maven项目。

    

    在上图里,点击“Next”按钮后,会见到如下图所示的界面,在其中我们可以设置Group Id等属性。

    

    其中,Group Id代表公司名,这里设置成“com.springBoot”,而Artifact Id则是项目名,Version和Packag采用默认值。完成设置后,能看到新建的项目MyFirstSpringBoot

     第二步,改写pom.xml。当我们创建好Maven项目后,能看到pom.xml文件。在Maven项目里,一般是通过pom.xml来指定本项目的基本信息以及需要引入的jar包,这里的关键代码如下。   

1   <groupId>com.springboot</groupId>
2      <artifactId>MyFirstSpringBoot</artifactId>
3      <version>0.0.1-SNAPSHOT</version>
4      <packaging>jar</packaging>
5      <name>MyFirstSpringBoot</name>
6      <url>http://maven.apache.org</url>
7      <dependencies>
8       <dependency>
9                <groupId>org.springframework.boot</groupId>
10                <artifactId>spring-boot-starter-web</artifactId>
11                <version>1.5.4.RELEASE</version>
12        </dependency>
13        <dependency>
14          <groupId>junit</groupId>
15          <artifactId>junit</artifactId>
16          <version>3.8.1</version>
17          <scope>test</scope>
18        </dependency>
19      </dependencies>

    其中,第1到第4行的代码是自动生成的,用来指定本项目的基本信息,这和我们在之前创建Maven项目时所填的信息是一致的。

    从第7到第19行的dependencies属性里,我们可以指定本项目所用到的jar包,这里在第8和第13行分别通过两个dependency来指定该引入两类jar包。其中从第8到12行,指定了需要引入用以开发Spring Boot项目的名为spring-boot-starter-web的jar的集合,而在第13到18行,指定了需要引入用以单元测试的junit包。

    从中上述代码里,我们能见到通过Maven管理项目依赖文件的一般方式,比如在下面的代码片段里,是通过第2到第4行的代码,说明需要引入org.springframework.boot这个公司组织(发布Spring Boot jar包的组织)发布的名为spring-boot-starter-web的一套支持Spring Boot的jar包,而且通过第4行指定了引入包的版本号是1.5.4.RELEASE。

    这样一来,在本项目里,我们就无需在本地在手动地添加jar包,这些包事实上是在远端的仓库里,我们这个项目是通过pom.xml的配置,来指定需要引入这些包。

     第三步,改写App.java。

    在创建Maven项目时,我们指定的package是com.springboot.MyFirstSpringBoot,在其中会有个App.java,我们把这个文件改写成如下的样式。    

1    package com.springboot.MyFirstSpringBoot;
2    import org.springframework.boot.SpringApplication;
3    import org.springframework.boot.autoconfigure.SpringBootApplication;
4    import org.springframework.web.bind.annotation.RequestMapping;
5    import org.springframework.web.bind.annotation.RestController;
6    
7    @RestController
8    @SpringBootApplication
9    public class App {
10        @RequestMapping("/HelloWorld")
11        public String sayHello() {
12            return "Hello World!";
13        }
14        public static void main(String[] args) {
15            SpringApplication.run(App.class, args);
16        }
17    }    

    由于是第一次使用Maven,我们在这里再强调一次,虽然我们没有在项目里手动地引入jar,但由于在pom.xml里指定了待引入的依赖包,具体而言需要依赖org.springframework.boot组织所提供的spring-boot-starter-web,所以在代码的第2到第5行里,我们可以通过import语句,使用spring-boot-starter-web(也就是Spring Boot)的类库。

    在第8行里,我们引入了@SpringBootApplication注解,以此声明该类是个Spring Boot的应用。在第10到第13行里,我们通过@RequestMapping,指定了用于处理/HelloWorld请求的sayHello方法,在第14行的main函数里,我们通过第15行的代码启动了Web服务。

至此我们完成了代码编写工作。启动MyFirstSpringBoot项目里的App.java,在浏览器里输入http://localhost:8080/HelloWorld。由于/HelloWorld请求能被第11到13行的sayHello方法的@RequestMapping对应上,所以会通过sayHello方法输出Hello World!的内容,如下图所示。

    

    从这个程序里我们能体会到开发Spring Boot和传统Spring程序的不同。

    第一,在之前的Spring MVC框架里,我们不得不在web.xml定义采用Spring的监听器,而且为了采用@Controller控制器类,我们还得加上一大堆配置,但在Spring Boot里,我们只需要添加一个@SpringBootApplication注解。

    第二,我们往往需要把传统的Spring MVC项目发布到诸如Tomcat的Web服务器上,启动Web服务器后我们才能在浏览器里输入请求查看运行的效果,这里我们只需启动App.java这个类即可达到类似的效果,就可以省去部署到Web服务器上的步骤。

3 最后是寻求帮助

    本人在写完java web轻量级开发面试教程后,再想写一本Spring Cloud方面的书,请各位大神告诉我该写哪些方面的内容,或者是提些建议,谢谢了。

原文地址:https://www.cnblogs.com/JavaArchitect/p/8468934.html