Spring Boot 快速入門指南
最近因?yàn)轫?xiàng)目的緣故,需要接觸 Spring Boot,詳細(xì)的介紹可以參考官方的文檔,這里主要根據(jù)自己學(xué)習(xí)的實(shí)踐進(jìn)行簡(jiǎn)單分享。版本:1.3.6
簡(jiǎn)介
Spring 框架是非常著名的 Java 開源框架,歷經(jīng)十多年的發(fā)展,整個(gè)生態(tài)系統(tǒng)已經(jīng)非常完善甚至是繁雜,Spring Boot 正是為了解決這個(gè)問題而開發(fā)的,為 Spring 平臺(tái)和第三方庫(kù)提供了開箱即用的設(shè)置,只需要很少的配置就可以開始一個(gè) Spring 項(xiàng)目。當(dāng)然,建議使用 Java 8 來進(jìn)行開發(fā)。
Spring Boot 實(shí)際上走的是 Servlet 的路線,所以需要一個(gè) Servlet 容器,什么 Tomcat/Jetty 都支持,比較意外的是居然還支持 Undertow(Undertow 大法好)。
安裝
簡(jiǎn)單粗暴直接上命令行,具體的簡(jiǎn)介參考注釋
# 確定 Java 版本 dawang:~ dawang$ java -version java version "1.8.0_91" Java(TM) SE Runtime Environment (build 1.8.0_91-b14) Java HotSpot(TM) 64-Bit Server VM (build 25.91-b14, mixed mode) # 安裝 Spring Boot CLI # 這是第一條語句 dawang:~ dawang$ brew tap pivotal/tap ==> Tapping pivotal/tap Cloning into '/usr/local/Library/Taps/pivotal/homebrew-tap'... remote: Counting objects: 16, done. remote: Compressing objects: 100% (14/14), done. remote: Total 16 (delta 2), reused 5 (delta 0), pack-reused 0 Unpacking objects: 100% (16/16), done. Checking connectivity... done. Tapped 9 formulae (50 files, 46.1K) # 這是第二條語句 dawang:~ dawang$ brew install springboot ==> Installing springboot from pivotal/tap ==> Downloading https://repo.spring.io/release/org/springframework/boot/spring-boot-cli/1.3.6.RELEASE/spring-boot-cli-1.3.6.RELEASE-bin.tar. ######################################################################## 100.0% ==> Caveats Bash completion has been installed to: /usr/local/etc/bash_completion.d zsh completion has been installed to: /usr/local/share/zsh/site-functions ==> Summary :beer: /usr/local/Cellar/springboot/1.3.6.RELEASE: 6 files, 8.9M, built in 4 minutes 39 seconds
然后我們就可以試試看 Spring CLI 的強(qiáng)大威力了!創(chuàng)建一個(gè)名為 app.groovy 的文件
@RestController class ThisWillActuallyRun { @RequestMapping("/") String home() { "Hello World" } }
只需要運(yùn)行 spring run app.groovy
即可!然而,在我的機(jī)器上并沒有這么順利, spring 已經(jīng)被 ruby 無情占用,只好在 .bashrc 中新建一個(gè)別名 alias springj="/usr/local/Cellar/springboot/1.3.6.RELEASE/bin/spring
" ,然后用 springj run app.groovy
運(yùn)行。
還不行!打開 localhost:8080 的時(shí)候發(fā)現(xiàn)機(jī)器啟動(dòng)著 nginx,所以要先把 nginx 關(guān)掉,具體的步驟是
# 查找對(duì)應(yīng)的進(jìn)程號(hào) ps aux | grep nginx # 發(fā)送關(guān)閉信號(hào) kill -QUIT [nginx 主進(jìn)程 pid]
解決掉各種攔路虎,我們?cè)俅芜\(yùn)行 springj run app.groovy ,就可以在瀏覽器中見到 Hello World 了。
dawang$ springj run app.groovy Resolving dependencies....... . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v1.3.6.RELEASE)
最后我們需要安裝的有Gradle 和 IntelliJ IDEA CE ,這里就不贅述了,安裝好了我們就可以進(jìn)行下一步了
Hello World
在 Spring INITIALIZR 進(jìn)行簡(jiǎn)單設(shè)置即可生成項(xiàng)目模板,如下圖所示:
然后我們把下載的文件解壓并導(dǎo)入 IntelliJ 中,稍作等待即可。
目錄結(jié)構(gòu)如上圖所示,我們直接運(yùn)行這個(gè) main 函數(shù)看看,控制臺(tái)中的輸出為
. ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v1.3.6.RELEASE) 2016-07-19 19:29:41.235 INFO 65812 --- [ main] wdx.helloworld.HellowordApplication : Starting HellowordApplication on dawang.local with PID 65812 (/Users/dawang/Documents/DJI/Code/helloword/build/classes/main started by dawang in /Users/dawang/Documents/DJI/Code/helloword) 2016-07-19 19:29:41.239 INFO 65812 --- [ main] wdx.helloworld.HellowordApplication : No active profile set, falling back to default profiles: default 2016-07-19 19:29:41.320 INFO 65812 --- [ main] s.c.a.AnnotationConfigApplicationContext : Refreshing org.springframework.context.annotation.AnnotationConfigApplicationContext@545997b1: startup date [Tue Jul 19 19:29:41 CST 2016]; root of context hierarchy 2016-07-19 19:29:42.336 INFO 65812 --- [ main] o.s.j.e.a.AnnotationMBeanExporter : Registering beans for JMX exposure on startup 2016-07-19 19:29:42.353 INFO 65812 --- [ main] wdx.helloworld.HellowordApplication : Started HellowordApplication in 1.865 seconds (JVM running for 3.141) 2016-07-19 19:29:42.354 INFO 65812 --- [ Thread-1] s.c.a.AnnotationConfigApplicationContext : Closing org.springframework.context.annotation.AnnotationConfigApplicationContext@545997b1: startup date [Tue Jul 19 19:29:41 CST 2016]; root of context hierarchy 2016-07-19 19:29:42.356 INFO 65812 --- [ Thread-1] o.s.j.e.a.AnnotationMBeanExporter : Unregistering JMX-exposed beans on shutdown Process finished with exit code 0
當(dāng)然,因?yàn)槲覀兊某绦蛑袥]有做任何操作,也沒有配合 Web 模塊,所以加載 Spring 完成之后就結(jié)束了。
我們看看項(xiàng)目對(duì)應(yīng)的 build.gradle ,其中只包含了兩個(gè)模塊:
dependencies { compile('org.springframework.boot:spring-boot-starter') testCompile('org.springframework.boot:spring-boot-starter-test') }
其中:
- spring-boot-starter :核心模塊,包括自動(dòng)配置支持、日志和 YAML
- spring-boot-starter-test :測(cè)試模塊,包括 JUnit、Hamcrest、Mockito
我們加入 spring-boot-starter-web 模塊,對(duì)應(yīng)的 dependencies 部分為
dependencies { compile('org.springframework.boot:spring-boot-starter') compile('org.springframework.boot:spring-boot-starter-web') testCompile('org.springframework.boot:spring-boot-starter-test') }
然后在 wdx.helloworld.web 這個(gè) package 中加入一個(gè) HelloController 類:
package wdx.helloworld.web; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; /** * Created by dawang on 16/7/20. */ @RestController public class HelloController { @RequestMapping("/hello") public String index() { return "Hello World! This is wdxtub."; } }
再啟動(dòng)主程序,訪問 localhost:8080/hello 時(shí)就可以看到結(jié)果了:
然后我們編寫一下對(duì)應(yīng)的測(cè)試 HellowordApplicationTests (單詞拼錯(cuò)了不要在意這些細(xì)節(jié)),注意需要引入一些 static 方法:
package wdx.helloworld; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.boot.test.SpringApplicationConfiguration; import org.springframework.http.MediaType; import org.springframework.mock.web.MockServletContext; import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; import org.springframework.test.context.web.WebAppConfiguration; import org.springframework.test.web.servlet.MockMvc; import org.springframework.test.web.servlet.request.MockMvcRequestBuilders; import org.springframework.test.web.servlet.setup.MockMvcBuilders; import wdx.helloworld.web.HelloController; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; import static org.hamcrest.Matchers.equalTo; @RunWith(SpringJUnit4ClassRunner.class) @SpringApplicationConfiguration(classes = MockServletContext.class) @WebAppConfiguration public class HellowordApplicationTests { private MockMvc mvc; @Before public void setUp() throws Exception { mvc = MockMvcBuilders.standaloneSetup(new HelloController()).build(); } @Test public void getHello() throws Exception { mvc.perform(MockMvcRequestBuilders.get("/hello").accept(MediaType.APPLICATION_JSON)) .andExpect(status().isOk()) .andExpect(content().string(equalTo("Hello World! This is wdxtub."))); } }
具體測(cè)試簡(jiǎn)單來說就是使用 MockServletContext 來創(chuàng)建一個(gè)新的 WebApplicationContext ,然后我們就可以模擬訪問 localhost:8080/hello 了,運(yùn)行該測(cè)試,可以發(fā)現(xiàn)一切正常。
至此,我們就了解了如何開始一個(gè) Spring Boot 項(xiàng)目,并編寫了一個(gè)簡(jiǎn)單的路由用來顯示對(duì)應(yīng)內(nèi)容。接下來我們會(huì)更多介紹開發(fā)相關(guān)的其他知識(shí)。
Starter POMs
簡(jiǎn)單來說,Starter POMs 是方便我們快速給應(yīng)用添加功能的,只需要在 build.gradle 中包含對(duì)應(yīng)的 starter,可以省去大量的配置和依賴管理,下面是一些常用的 starter
- spring-boot-starter : 核心 Spring Boot starter,包括自動(dòng)配置支持,日志和 YAML
- spring-boot-starter-actuator : 監(jiān)控和管理應(yīng)用
- spring-boot-starter-remote-shell : 添加遠(yuǎn)程 ssh shell 支持
- spring-boot-starter-amqp : 高級(jí)消息隊(duì)列協(xié)議,通過 spring-rabbit 實(shí)現(xiàn)
- spring-boot-starter-cloud-connectors : 簡(jiǎn)化在云平臺(tái)下服務(wù)的連接
- spring-boot-starter-elasticsearch : 對(duì) Elasticsearch 搜索和分析引擎的支持
- spring-boot-starter-data-jpa : 對(duì) Java 持久化 API 的支持,包括 spring-data-jpa , spring-orm 和 Hibernate
- spring-boot-starter-data-mongodb : 對(duì) MongoDB 的支持
- spring-boot-starter-mail : 對(duì) javax.mail 的支持
- spring-boot-starter-mobile : 對(duì) spring-mobile 的支持
- spring-boot-starter-redis : 對(duì) Redis 的支持
- spring-boot-starter-security : 對(duì) spring-security 的支持
- spring-boot-starter-test : 對(duì)常用測(cè)試依賴的支持,包括 JUnit, Hamcrest 和 Mockito,還有 spring-test 模塊
- spring-boot-starter-web : 對(duì)全棧 web 開發(fā)的支持,包括 Tomcat 和 spring-webmvc
- spring-boot-starter-websocket : 對(duì) WebSocket 開發(fā)的支持
- spring-boot-starter-ws : 對(duì) Spring Web Service 的支持
如果想要切換容器和日志系統(tǒng)可以用下面的包
- spring-boot-starter-jetty : 導(dǎo)入 Jetty HTTP 引擎
- spring-boot-starter-log4j : 對(duì) Log4J 日志系統(tǒng)的支持
- spring-boot-starter-logging : 導(dǎo)入 Spring Boot 的默認(rèn)日志系統(tǒng)
- spring-boot-starter-tomcat : 導(dǎo)入 Spring Boot 的默認(rèn) HTTP 引擎
- spring-boot-starter-undertow : 導(dǎo)入 Undertow HTTP 引擎
更多社區(qū)貢獻(xiàn)的 starter POMs 可以在 這里 查閱。
組織代碼最佳實(shí)踐
不要使用 default package ,建議使用反轉(zhuǎn)的域名來命名包
把 main 應(yīng)用類放在 root package 中,其他的類放在子包中,結(jié)構(gòu)如下所示
wdx +- helloworld +- HelloworldApplication.java <- main class | +- web | +- HelloController.java | +- service | +- CustomerService.java
- Spring Boot 提倡在代碼中進(jìn)行配置。通常定義了 main 方法的類是使用 @Configuration 注解的好地方
- 不需要將所有的 @Configufation 放進(jìn)一個(gè)單獨(dú)的類中,可以使用 @Import 注解可以導(dǎo)入其他的配置類。也可以用 @ComponentScan 注解自動(dòng)收集所有的組件,包括 @Configuration 類
- 如果要使用基于 XML 的配置,也最好從 @Configuration 類開始,然后使用 @ImportResource 注解來加載 XML 配置文件
- Spring Boot 另一個(gè)很好的特性是會(huì)根據(jù)所添加的 jar 依賴來配置 Spring 應(yīng)用,只需要簡(jiǎn)單把 @EnableAutoConfiguration 加入到 @Configuration 類即可
- SpringBootApplication 注解默認(rèn)等價(jià)于 @Configuration , @EnableAutoConfiguration 和 ComponentScan 這三個(gè)加起來的效果。
打包運(yùn)行
我們?cè)诮K端中執(zhí)行 gradle assemble 可以生成一個(gè) jar 包,也可以直接執(zhí)行這個(gè) jar 包來啟動(dòng)整個(gè)應(yīng)用,如
dawang:helloword dawang$ java -jar build/libs/helloword-0.0.1-SNAPSHOT.jar
. ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v1.3.6.RELEASE) 2016-07-20 13:11:01.859 INFO 36943 --- [ main] wdx.helloworld.HellowordApplication : Starting HellowordApplication on dawang.local with PID 36943 (/Users/dawang/Documents/DJI/Code/helloword/build/libs/helloword-0.0.1-SNAPSHOT.jar started by dawang in /Users/dawang/Documents/DJI/Code/helloword) 2016-07-20 13:11:01.864 INFO 36943 --- [ main] wdx.helloworld.HellowordApplication : No active profile set, falling back to default profiles: default 2016-07-20 13:11:01.960 INFO 36943 --- [ main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@67424e82: startup date [Wed Jul 20 13:11:01 CST 2016]; root of context hierarchy 2016-07-20 13:11:03.727 INFO 36943 --- [ main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat initialized with port(s): 8080 (http) 2016-07-20 13:11:03.750 INFO 36943 --- [ main] o.apache.catalina.core.StandardService : Starting service Tomcat 2016-07-20 13:11:03.752 INFO 36943 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet Engine: Apache Tomcat/8.0.36 2016-07-20 13:11:03.897 INFO 36943 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext 2016-07-20 13:11:03.897 INFO 36943 --- [ost-startStop-1] o.s.web.context.ContextLoader : Root WebApplicationContext: initialization completed in 1943 ms 2016-07-20 13:11:04.275 INFO 36943 --- [ost-startStop-1] o.s.b.c.e.ServletRegistrationBean : Mapping servlet: 'dispatcherServlet' to [/] 2016-07-20 13:11:04.282 INFO 36943 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean : Mapping filter: 'characterEncodingFilter' to: [/*] 2016-07-20 13:11:04.283 INFO 36943 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean : Mapping filter: 'hiddenHttpMethodFilter' to: [/*] 2016-07-20 13:11:04.283 INFO 36943 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean : Mapping filter: 'httpPutFormContentFilter' to: [/*] 2016-07-20 13:11:04.284 INFO 36943 --- [ost-startStop-1] o.s.b.c.embedded.FilterRegistrationBean : Mapping filter: 'requestContextFilter' to: [/*] 2016-07-20 13:11:04.658 INFO 36943 --- [ main] s.w.s.m.m.a.RequestMappingHandlerAdapter : Looking for @ControllerAdvice: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@67424e82: startup date [Wed Jul 20 13:11:01 CST 2016]; root of context hierarchy 2016-07-20 13:11:04.751 INFO 36943 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/hello]}" onto public java.lang.String wdx.helloworld.web.HelloController.index() 2016-07-20 13:11:04.755 INFO 36943 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error]}" onto public org.springframework.http.ResponseEntity<java.util.Map<java.lang.String, java.lang.Object>> org.springframework.boot.autoconfigure.web.BasicErrorController.error(javax.servlet.http.HttpServletRequest) 2016-07-20 13:11:04.755 INFO 36943 --- [ main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error],produces=[text/html]}" onto public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse) 2016-07-20 13:11:04.810 INFO 36943 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016-07-20 13:11:04.810 INFO 36943 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016-07-20 13:11:04.875 INFO 36943 --- [ main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 2016-07-20 13:11:05.028 INFO 36943 --- [ main] o.s.j.e.a.AnnotationMBeanExporter : Registering beans for JMX exposure on startup 2016-07-20 13:11:05.145 INFO 36943 --- [ main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http) 2016-07-20 13:11:05.151 INFO 36943 --- [ main] wdx.helloworld.HellowordApplication : Started HellowordApplication in 4.0 seconds (JVM running for 4.484)
當(dāng)然,因?yàn)樾枰械囊蕾?,整個(gè) jar 包會(huì)比較大。如果想要開啟遠(yuǎn)程調(diào)試,命令為
java -Xdebug -Xrunjdwp:server=y,transport=dt_socket,address=8000,suspend=n -jar build/libs/helloword-0.0.1-SNAPSHOT.jar
Gradle 運(yùn)行
當(dāng)然我們也可以簡(jiǎn)單使用內(nèi)置的 Gradle 腳本來運(yùn)行,直接 gradle bootRun 即可。
配置 Undertow
如果想要用 Undertow 來替換默認(rèn)的 Tomcat,也可以簡(jiǎn)單在 build.gradle 中進(jìn)行配置,比如:
configurations { compile.exclude module: "spring-boot-starter-tomcat" } dependencies { compile('org.springframework.boot:spring-boot-starter') compile('org.springframework.boot:spring-boot-starter-web') compile('org.springframework.boot:spring-boot-starter-undertow') testCompile('org.springframework.boot:spring-boot-starter-test') }
然后使用 gradle bootRun 即可。
以上所述是小編給大家介紹的Spring Boot 快速入門指南,希望對(duì)大家有所幫助,如果大家有任何疑問請(qǐng)給我留言,小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)腳本之家網(wǎng)站的支持!
相關(guān)文章
使用Spring?AOP實(shí)現(xiàn)用戶操作日志功能
這篇文章主要介紹了使用Spring?AOP實(shí)現(xiàn)了用戶操作日志功能,功能實(shí)現(xiàn)需要一張記錄日志的log表,結(jié)合示例代碼給大家講解的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2022-05-05SpringBoot整合Echarts繪制靜態(tài)數(shù)據(jù)柱狀圖和餅圖
這篇文章給大家介紹了SpringBoot整合Echarts繪制靜態(tài)數(shù)據(jù)柱狀圖和餅圖,文中通過代碼示例給大家介紹的非常詳細(xì),具有一定的參考價(jià)值,需要的朋友可以參考下2024-03-03SpringBoot利用EasyExcel實(shí)現(xiàn)導(dǎo)出數(shù)據(jù)
EasyExcel是一個(gè)基于Java的、快速、簡(jiǎn)潔、解決大文件內(nèi)存溢出的Excel處理工具,它能讓你在不用考慮性能、內(nèi)存的等因素的情況下,快速完成Excel的讀、寫等功能看,本文就將介紹如何利用EasyExcel實(shí)現(xiàn)導(dǎo)出數(shù)據(jù),需要的朋友可以參考下2023-07-07計(jì)算機(jī)二級(jí)考試java軟件操作教程 教大家如何學(xué)習(xí)java
如何成為一名知識(shí)豐富的Java程序員,順利通過計(jì)算機(jī)二級(jí)Java考試,這篇文章主要主要教大家如何學(xué)習(xí)java,java的學(xué)習(xí)路線是什么,從何學(xué)起,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-08-08淺談java中BigDecimal的equals與compareTo的區(qū)別
下面小編就為大家?guī)硪黄獪\談java中BigDecimal的equals與compareTo的區(qū)別。小編覺得挺不錯(cuò)的,現(xiàn)在就分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2016-11-11SpringCloud?Nacos?+?Ribbon?調(diào)用服務(wù)的實(shí)現(xiàn)方式(兩種)
這篇文章主要介紹了SpringCloud?Nacos?+?Ribbon?調(diào)用服務(wù)的兩種方法,分別是通過代碼的方式調(diào)用服務(wù)和通過注解方式調(diào)用服務(wù),每種方式給大家介紹的非常詳細(xì),需要的朋友可以參考下2022-03-03java異步調(diào)用的4種實(shí)現(xiàn)方法
日常開發(fā)中,會(huì)經(jīng)常遇到說,前臺(tái)調(diào)服務(wù),本文主要介紹了java異步調(diào)用的4種實(shí)現(xiàn)方法,文中通過示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-03-03