课程表

Spring Boot课程

工具箱
速查手册

Boot Hello World

当前位置:免费教程 » Java相关 » Spring Boot
注意:本页面内容为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 的开始界面,如下图所示:

1.png

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

2.png

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

3.png

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 会帮你自动下载,简直不要太爽:

1副本.png

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

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

5.png

简要介绍一下,这里,“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配置界面:

6.png

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

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

7.png

我们回到”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依赖文件,需要相当长的时间,请耐心等待:

11.png

下载完成后,即可在项目的根目录发现多了一个”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