Boot Hello World

注意：本页面内容为W3xue原创，未经授权禁止转载，违者必究！
来源：W3xue　　发布时间：2019/5/27 21:59:16

在创建第一个Spring Boot 项目之前，我们需要做3个准备工作：

1、根据项目对Java版本的要求，配置好Java运行环境。具体方法点击这里。

2、安装Maven。官方安装文件下载地址：http://maven.apache.org/download.cgi。这里，我们以Windows 10 系统为例，选择下载4个文件中第二个“Binary zip archive”。下载到本地磁盘后解压备用（暂时无需配置环境变量，IntelliJ IDEA中可以进行配置）。

3、下载、安装并注册、使用一个IDE。本教程使用的是 IntelliJ IDEA。在这里，w3xue强烈推荐使用这个编辑器。单纯开发 Spring Boot 项目的话，它比 Eclipse 好用。当然，如果你之前有 Eclipse 基础，你也可以使用Eclipse ，但那样的话，你就没办法和本站教程保持同步了。不建议使用其他的编辑器，它们虽然也能勉强胜任，但Spring Boot开发还是交给 IntelliJ IDEA 吧！另外，为了避免一些莫名其妙、没有养分的错误，建议先安装Java运行环境，然后再装IDE。

第一次启动 IntelliJ IDEA，会有一个简单的默认配置，你根据它的提示，选择相应的开发环境即可，万一配置错了，也可以更改，这里不再赘述。

第一次配置后，会进入 IntelliJ IDEA 的开始界面，如下图所示：

我们点击“Create New Project”，然后出现选择项目类型的界面：

选择“Spring Initializr”，右边的SDK就选择它原有的SDK就可以了。初始化的地址就默认用官方的地址“https://start.spring.io”。如果这时提示你没有SDK，没有关系，暂时忽略它，一会我们会对SDK进行选择性。接着出现的是项目的配置页：

Group是组的名字，一般建议用域名颠倒的办法，比如本站就使用com.w3xue。Artifact相当于程序的正式名称，它不允许含有Spring、Boot这样的关键字，它和Group共同组成了包的名字。在这里，我们就取一个汉语拼音的名字，不要怕low，那些认为汉语拼音low的人，本身就有深层次的自卑，英文好不代表就无需汉语拼音，哪个好用用哪个。当然考虑到后期维护方便，在某一项上如果要用汉语拼音，就要用到底。接下来，Type（项目类型）则选择默认的Maven Project，Language不动，Packaging是选择打包的文件类型，一般我们选择War包。War包和Java通用的Jar包有什么区别呢？Jar包基于ZIP，是跨平台的Java打包程序，而War包则是Web归档程序，在传到Linux服务器Tomcat的webapps目录下时，War包会自动解压、自动部署，可移植性非常强。这个时候，它不是按照目录层次结构来部署，而是作为一个部署单元部署的。

然后是选择Java版本，本站以Java 8作为开发版本。最后，底下的4个分别为：当前程序版本号、名字、描述、包名（默认是Group+Artifact，不建议修改）。都用默认的就好了，除了包名，其他3个后期也可以很方便的在配置文件里修改。

接下来是选择Spring Boot版本和依赖包，在这里，Spring Boot版本我们选择，2.1.8.RELEASE版本。依赖包方面，我们选择左侧“Core”的Session，和Web的“Web”即可。后期，可以根据需要，非常非常方便的导入各种依赖，IntelliJ IDEA 会帮你自动下载，简直不要太爽：

然后是选择项目路径，这里我就不放图了，大家根据需要选择自己的目录即可，项目文件会自动生成到这个目录里。

这下，我们终于进入IntelliJ IDEA 的主界面了，如果这时右下角提示你，Maven依赖有改动，你选择第一个“Import Changes”就行了，IntelliJ IDEA 会自动下载、导入依赖包。那么，我们来看看一个Spring Boot项目的典型结构（点击可看大图）：

简要介绍一下，这里，“1”是程序的存放地，目录为“src/main/java/com/w3xue/jiaocheng”，这里存放所有我们自己的Java类，当然，还可以在内部多建几个文件夹（即包），但现在我们暂时不要动它，后面的教程会做详细的说明。“2”即“static”文件夹，是存放css、js、images等辅助文件夹的地方如果有一个文件放在static的js文件夹，我们在页面中就可以使用js/xxx.js引用它。“3”即“templates”模板文件夹，是存放模板文件的地方，模板一般是.html文件。“4”是配置文件，名字叫“application.properties”，即程序属性的意思，在接下来的课程里我们会把它改成application.yml，因为.yml是一种更方便的配置办法。“5”是maven的配置文件，如果你需要引用什么依赖包，在这里通过几行配置代码就搞定了。如果你要开发一个完整的、相当完备的Spring Boot程序，这5个地方是你最常用到的，实际上，你如果只依赖这5个地方，也是完全可以完整的应用程序。

但是在正式开始开发之前，我们得对整个程序进行一次配置。首先，是JDK的配置。点击IntelliJ IDEA 右上角侧边栏的“Maven”图标，点开Lifecycle，点“clean”即是清除之前生成的包文件，而点击“package”即是打包整个程序。如果你没有配置JDK，IntelliJ IDEA 会有错误提示，你点“Configure”，即可看到JDK配置界面：

点击“New...”按钮，然后选择JDK安装的位置，即可导入JDK，最后点OK“保存”。

我们再来配置Maven。本站教程使用的Maven版本为3.6.1，从官网下载文件后，解压到相关位置备用。点击IntelliJ IDEA 菜单栏的“File”-->“Settings”，在搜索框搜索“maven”即可快速定位到Maven配置，下图的配置供参考，其中“Local repository”选项的值，是“.../repository”，是仓库文件夹，在这里是需要手动建的：

我们回到”src/main/java/com/w3xue/jiaocheng“文件夹，在里面点击鼠标右键，建立一个Java类”MainRestController“，含义为”主要的RestController类“。然后，我们在类声明语句的上面，加上一个注解：

@RestController

IntelliJ IDEA 会自动导入需要的”org.springframework.web.bind.annotation.RestController“包。这个注解是@ResponseBody注解和@Controller注解的组合。如果你有Spring基础就会明白它的含义，如果暂时不明白也没有关系，总之，只要是不需要引用模板文件的返回路径，都需要这个注解，特别是返回Json之类的接口数据。

我们再来建立一个类方法，但是这个方法也需要加一个RequestMapping注解：

    @RequestMapping(value="/hello",method= RequestMethod.GET)  //规定路径为/hello，响应方法为GET
    public String sayHello(){
        return "Hello World";
    }

同样的，IntelliJ IDEA 会自动导入需要的”org.springframework.web.bind.annotation.RequestMapping“和”org.springframework.web.bind.annotation.RequestMethod“两个包。如果你把项目从一台电脑移动到另一台电脑，出现无法引用包的情况，先确认Maven配置文件夹是正确的，然后在项目的pom.xml里，把“dependencies”大节、“build”大节和“repositories”大节剪切后，点击导入变化（Import Changes），然后，再粘贴进去，导入变化即可自动再导包。

点击IntelliJ IDEA 右上方的绿色三角形，点击后即可运行程序。在IntelliJ IDEA 底部出现一系列提示后，在没有错误的情况下，我们在浏览器中输入”http://localhost:8080/hello“，即可看到我们的第一个Spring Boot程序跑成功啦：

Hello World

这里需要提示的是，@RequestMapping这个注解，也可以放在类声明上面，这样，整个类的路径的基路径都会变成声明的值。

最后，我们来生成一下这个程序，点击IntelliJ IDEA 右上角侧边栏的“Maven”图标，点开Lifecycle，点“clean”清除一下之前生成的包文件（虽然现在是第一次生成包文件，但是我们建议你养成习惯），然后点击“package”打包整个程序。第一次清理旧包、打包，都会下载很多Maven依赖文件，需要相当长的时间，请耐心等待：

下载完成后，即可在项目的根目录发现多了一个”target“文件夹，里面会有一个War包：”jiaocheng-0.0.1-SNAPSHOT.war“。

把这个War包改名，把文件名后面的版本号”-0.0.1-SNAPSHOT“去掉，变成类似”jiaocheng.war“这样的文件名。然后，上传到装有Tomcat的Linux服务器的如下目录：

usr/local/java/tomcat/webapps

Tomcat会对该War包进行解压，然后，以包名为jiaocheng为例，你就可以通过如下地址，从互联网的任何一个地方访问你的程序啦：

http://www.xxx.com/jiaocheng

好了，这一节就讲到这里。如果有不明白的，欢迎您点击”优化或报错有奖“反馈给我们。

注意：本页面内容为W3xue原创，未经授权禁止转载，违者必究！
来源：W3xue　　发布时间：2019/5/27 21:59:16