Spring MVC Framework4を試してみます。サーブレットコンテナはWildFlyを利用してみます。
普通Tomcat使うだろう、って言われそうですがWildFlyです。
環境はEclipse Lunaで、WildFlyは既に導入済みです。Eclipseの設定方法などは以前の記事をどうぞ。
Mavenプロジェクトの新規作成
まずはプロジェクトの新規作成。
New→Project..からMaven Projectを選択し、archetypeはmaven-archetype-webappにしました。
名前はべたにSpring4Testにしました。
このままだとJSPのコンパイルがエラーになっていたのでProperties→Java Build path→Libratiesから、Add Library…を選んでServer LibraryのWildFlyを追加します。
pom.xmlにSpring4の依存関係の追加
pom.xmlを編集してSpring4関連のjarを取り込みます。
<properties> <springframework.version>4.1.1.RELEASE</springframework.version> </properties> <dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>${springframework.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>${springframework.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${springframework.version}</version> </dependency> </dependencies> <build> <finalName>Spring4Test</finalName> </build>
Spring設定ファイルの準備
WEB-INFの下に「spring-servlet.xml」という設定ファイルを作成します。
XML作らなくても大丈夫な方法もあるようですが、旧来の方法でXML作ります。SpringのXML地獄は不評ですが、個人的にアノテーション地獄も設定が散らばるので苦痛です。
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd"> <context:component-scan base-package="com.tsu2t.spring8test.controller" /> <bean id="viewResolver" class="org.springframework.web.servlet.view.UrlBasedViewResolver"> <property name="viewClass" value="org.springframework.web.servlet.view.JstlView" /> <property name="prefix" value="/WEB-INF/jsp/" /> <property name="suffix" value=".jsp" /> </bean> </beans>
base-packageで指定した階層にコントローラーのクラスを探しに行くことになるのでここは環境依存で修正です。パッケージ名をspring4testにするつもりがなぜか8になってましたが気にしません。
このファイルをDispatherから読み込ませるためにweb.xmlを修正します。
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0"> <display-name>Spring4Test</display-name> <servlet> <servlet-name>dispatcher</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/spring-servlet.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcher</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
実装
設定はこんな感じで、ここから実装。
さっきの設定ファイルで指定したパッケージの下にコントローラークラスを作ります。
特に何かを継承する必要はなく、Springのアノテーションをつけてやります。
package com.tsu2t.spring8test.controller; import org.springframework.stereotype.Controller; import org.springframework.ui.ModelMap; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; @Controller @RequestMapping("/") public class HelloWorldController { @RequestMapping(method = RequestMethod.GET) public String method1(ModelMap model) { model.addAttribute("param1", "HelloWorld"); return "hello"; } @RequestMapping(value="/welcome", method = RequestMethod.GET) public String method2(ModelMap model) { model.addAttribute("param1", "WelcomeWorld"); return "hello"; } }
@ControllerアノテーションをつけることでSpringが勝手にbeanとして認識してくれます。
@RequestMappingアノテーションはその名の通り、リクエストパスに対するマッピングになります。この場合、ルートパスにアクセスするとHelloWorldControllerが呼ばれることになります。
method1とmethod2にもそれぞれ@RequestMappingがついていて、リクエストメソッドと追加パスの定義をしています。
どちらもGETメソッド時に呼び出され、method1が”/”、method2が”/welcome”パスのときに呼び出されることになります。
どちらのメソッドも”hello”という文字列を返していますが、これはviewを探すときの名前になります。先の設定ファイルでInternalResourceViewResolverを設定したパスにview用のファイルを探しに行くことになります。
設定は「/WEB-INF/jsp」の「*.jsp」なので、「/WEB-INF/jsp/hello.jsp」を作成します。
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Spring4Test</title> </head> <body> ${param1} </body> </html>
ビルド・デプロイ
次にServersに設定済みのWildFlyにHelloWorldを追加します。右クリックメニューのAdd and Removeから追加します。
起動をするとこんなログがでます。
18:22:57,794 INFO [org.wildfly.extension.undertow] (MSC service thread 1-1) JBAS017534: Registered web context: /Spring4Test 18:22:57,838 INFO [org.jboss.as.server] (ServerService Thread Pool -- 32) JBAS018559: Deployed "Spring4Test.war" (runtime-name : "Spring4Test.war")
画面の確認
「http://localhost:8080/Spring4Test/」にブラウザからアクセスると、画面が確認できます。
ん、何かが違う…。
どうやら、webapp直下にデフォルトで作成されたindex.jspが表示されたようです。とりあえずこいつを削除して再度実行します。
無事、表示されました。って、中身が悪かったですね。ほとんど文言一緒でやんの。
「http://localhost:8080/Spring4Test/welcome」にアクセスすると、「WelcomeWorld」が表示されます。
最終形のプロジェクトはこんな感じです。
まとめ
簡単に書きましたがはまりにはまって(いまだになぜはまったのかよくわかってない)凄い時間がかかってしまいました。
日本語の情報少ないですしね…。
基本的なことしか書いてないのでちゃんとアプリに仕立てるにはもっといろいろ仕込みが必要です。
[参考URL]
Spring 4 MVC HelloWorld Example
Simplest Spring MVC Hello World Example