Eclipse + Spring boot で簡単な WEB アプリの作成

短期間で簡単に WEB アプリが作れるという Spring boot。実際、どれほど簡単なのか、試してみる。

Eclipse をベースに Spring 開発に役立つプラグインが組み込まれた Spring Tool Suite (STS) を使用している。

STS のインストール方法は、以下の記事で紹介している。

yyama1556.hateblo.jp

では、さっそく入門編アプリを作ってみる。

パッケージエクスプローラの何もない場所で右クリック → New → Other... を選択して、New ダイアログを表示させる。Spring boot フォルダを展開し、Spring Stater Project を選択する。

New Spring Stater Project ダイアログが開くので、名前や言語などを選択する。こんな感じにした。

Next をクリックすると、New Spring Stater Project Dependencies ダイアログが開く。Spring boot に組み合わせて使える、さまざまなフレームワークが選択できる。今回は Web だけを選択した。

Next をクリックすると、最後の確認ダイアログが表示される。

Finish を選択すると、Spring boot のプロジェクトが自動で作成される。
ファイル／フォルダ構成はこんな感じだ。

とりあえず実行してみる。プロジェクトを右クリック → Run As → Spring Boot App を選択すると、Spring のログがコンソールに表示された。一応起動はできているようだ。

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v1.5.7.RELEASE)

2017-09-22 10:01:11.784  INFO 3640 --- [           main] org.yyama.demo.DemoApplication           : Starting DemoApplication on yyama-PC with PID 3640 (C:\opt\sts-bundle\workspace\demo\target\classes started by yyama in C:\opt\sts-bundle\workspace\demo)
2017-09-22 10:01:11.784  INFO 3640 --- [           main] org.yyama.demo.DemoApplication           : No active profile set, falling back to default profiles: default
2017-09-22 10:01:11.862  INFO 3640 --- [           main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@6a79c292: startup date [Fri Sep 22 10:01:11 JST 2017]; root of context hierarchy
2017-09-22 10:01:13.284  INFO 3640 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat initialized with port(s): 8080 (http)
2017-09-22 10:01:13.292  INFO 3640 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2017-09-22 10:01:13.292  INFO 3640 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet Engine: Apache Tomcat/8.5.20
2017-09-22 10:01:13.401  INFO 3640 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2017-09-22 10:01:13.401  INFO 3640 --- [ost-startStop-1] o.s.web.context.ContextLoader            : Root WebApplicationContext: initialization completed in 1539 ms
2017-09-22 10:01:13.611  INFO 3640 --- [ost-startStop-1] o.s.b.w.servlet.ServletRegistrationBean  : Mapping servlet: 'dispatcherServlet' to [/]
2017-09-22 10:01:13.618  INFO 3640 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean   : Mapping filter: 'characterEncodingFilter' to: [/*]
2017-09-22 10:01:13.619  INFO 3640 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean   : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]
2017-09-22 10:01:13.619  INFO 3640 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean   : Mapping filter: 'httpPutFormContentFilter' to: [/*]
2017-09-22 10:01:13.619  INFO 3640 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean   : Mapping filter: 'requestContextFilter' to: [/*]
2017-09-22 10:01:14.059  INFO 3640 --- [           main] s.w.s.m.m.a.RequestMappingHandlerAdapter : Looking for @ControllerAdvice: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@6a79c292: startup date [Fri Sep 22 10:01:11 JST 2017]; root of context hierarchy
2017-09-22 10:01:14.168  INFO 3640 --- [           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)
2017-09-22 10:01:14.168  INFO 3640 --- [           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)
2017-09-22 10:01:14.219  INFO 3640 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-09-22 10:01:14.219  INFO 3640 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-09-22 10:01:14.276  INFO 3640 --- [           main] o.s.w.s.handler.SimpleUrlHandlerMapping  : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2017-09-22 10:01:14.482  INFO 3640 --- [           main] o.s.j.e.a.AnnotationMBeanExporter        : Registering beans for JMX exposure on startup
2017-09-22 10:01:14.558  INFO 3640 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)
2017-09-22 10:01:14.565  INFO 3640 --- [           main] org.yyama.demo.DemoApplication           : Started DemoApplication in 3.058 seconds (JVM running for 4.215)
2017-09-22 10:02:00.656  INFO 3640 --- [nio-8080-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring FrameworkServlet 'dispatcherServlet'
2017-09-22 10:02:00.656  INFO 3640 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : FrameworkServlet 'dispatcherServlet': initialization started
2017-09-22 10:02:00.679  INFO 3640 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet        : FrameworkServlet 'dispatcherServlet': initialization completed in 23 ms

ただ、この状態で localhost:8080 にアクセスするとエラーページが表示される。

ブラウザからのリクエストを受け付けるコントローラを作っていないので当然だ。

それでは、http://localhost:8080/　でアクセスした場合に簡単な文字列を返すように修正してみよう。

まず、パッケージ [org.yyama.demo] 配下に DemoController というクラスを作成する。
中身は↓

package org.yyama.demo;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class DemoController {
	@RequestMapping(value = "/", method = RequestMethod.GET)
	@ResponseBody
	public String index() {
		return "Hello! Spring Boot!!";
	}
}

[@ResponseBody]は return で返すテキストをそのままブラウザに返す指定。
[@RequestMapping]は別記事で基本をまとめている。
【Spring MVC】@RequestMapping の基本 - 山崎屋の技術メモ
　

1点注意事項。
デフォルトで、コントローラクラスは @SpringBootApplication アノテーションが付与されたクラス（今回は DemoApplication クラス）と同じパッケージかその配下のパッケージに所属する必要がある。
全く別のパッケージにコントローラクラスを置いたとしても、自動でコンポーネントスキャンしてくれない。
ただし設定を変更すればその限りではない。
java - RequestMapping of SpringBoot Not working - Stack Overflow

Spring boot を再起動し、再びブラウザからアクセスしてみる。