2011年11月6日日曜日

Struts2 + Spring + mybatis! web.xmlとstruts.xml

できる限りXMLレスで行こうという今回のアプリ作成。
でも、やっぱり必要なXMLは書かなきゃね。

まずは、web.xml。当然。
<?xml version="1.0" encoding="UTF-8" ?>

<web-app xmlns="http://java.sun.com/xml/ns/javaee"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 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>TagDiary</display-name>

 <context-param>
  <param-name>contextConfigLocation</param-name>
  <param-value>/WEB-INF/applicationContext.xml</param-value>
 </context-param>

 <listener>
  <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
 </listener>

 <filter>
  <filter-name>struts2</filter-name>
  <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
 </filter>

 <filter-mapping>
  <filter-name>struts2</filter-name>
  <url-pattern>/*</url-pattern>
 </filter-mapping>

 <jsp-config>
  <jsp-property-group>
   <url-pattern>*.jsp</url-pattern>
   <el-ignored>false</el-ignored>
   <page-encoding>UTF-8</page-encoding>
   <scripting-invalid>false</scripting-invalid>
   <include-prelude>/WEB-INF/include/jsp_header.jsp</include-prelude>
  </jsp-property-group>
 </jsp-config>
</web-app>
context-paramとlistenerがSpringのため。
filterとfilter-mappingがStruts2のため。

で、JSPではJSTLとStruts2のカスタムタグをよく使う予定なのですが、
いちいち<%@ taglib ... %>を書くのが嫌なので、
JSPに共通の宣言は、 jsp_header.jsp ファイルに押しやって、
そいつをinclude-prelude。
これはほんとうに便利だ・・・。

次は、struts.xml。これは、クラスパスが通っているところに置くと、勝手に読み込んでくれるらしいので便利。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
 "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
 "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
 <constant name="struts.objectFactory" value="org.apache.struts2.spring.StrutsSpringObjectFactory"/>
</struts>
org.apache.struts2.spring.StrutsSpringObjectFactoryを使わないと、ActionにサービスをInjectできないっぽい。
でも、基本的にアノテーションでやりたいので、struts.xmlには全然書きません。

次のエントリでは、Springとmybatisの設定であるところの、
applicationContext.xml を書くと思います。

2011年11月2日水曜日

Struts2 + Spring + mybatis! ライブラリをmavenで揃える

Struts2, Spring, mybatis。
これでアプリを作りたくなったのです。

以前、Sturts1 + Spring + iBATIS という、わりとありがちなフレームワークでアプリを作ったことがあったのですが、

やっぱりXML地獄は嫌だ・・・。

XMLそのものが嫌いではなく、いや、むしろ、XML自体は好きで、Ajaxなど通信で取り交わされるテキストはXMLがいいなーと思うのですが、
これらのフレームワークのXMLはどうも好きになれません。

これらのXMLの利点は、ある設定(アクションと遷移先だとか、Springが管理するBeanだとか、SQL文だとか)を一元的に管理するという利点があるとは思うのですが、
でも、まとめたいことって人それぞれなわけで、
「アクションのクラスとコードとそのアクションが関連する設定をひとつにまとめたい!」
という要望には、XMLは答えてくれないのです。

そこで、今回のやつらを使ってみようというわけです。

mybatisも、アノテーションにより、インタフェースとSQLががっつり結びつくので好きです。
ただ、動的SQLになるとXMLしかないので、実際にそれなりのアプリを作るなら、SQLはXMLに統一すべきですが。

作ってみるアプリは、まあお遊び的ですが、付箋をペタペタ貼る日記というものをWebアプリで作りたいと思います。
jQuery UIとか使って。

まずは、環境準備。

DBはMySQL。とってきてインストール。

次は、eclipseだ。現時点で最新っぽい3.7.1を持ってくる。

今まで全然使ったことなくて、さっぱりわからないけど、いろいろダウンロードするのが面倒なので、
mavenを使ってみる。
最新は3らしいので、そいつをダウンロード(現時点の最新は3.0.3)。
http://maven.apache.org/download.html

次の、m2eclipse・・・なんか、m2eという名前になったらしい。
eclipseから
http://download.eclipse.org/technology/m2e/releases
を使ってインストール。
で、Window →Preferences → Maven → Installations で、さっき入れたmaven3.0.3を指定。
してみたら、Embeddedのバージョンが3.0.2だった。あんま意味ないかなぁ。

しかし、これだけでは足りない。
Mavenプロジェクトを作成したときに、Webプロジェクトっぽくするために、WTP連携を入れる必要があるらしい。ここが、日本語のページをぐぐってもなかなか分からず、詰まったところ。
英語のページ読んでやっと分かった。
eclipseのWindow →Preferences → Maven → Discovery → Open Catalog
で、「m2e-wtp」をインストール。

そしてやっと、Mavenプロジェクトを作成。
Archetypeはmaven-archetype-webapp、Artifact Idは、今回のアプリ 「付箋をペタペタ貼る日記」ということで、「TagDiary」、Group Idは、ルートパッケージにしようと思っている、「com.motchi.tagdiary」で決定。

できたら、とりあえずライブラリを入れてしまいたいので、pom.xmlを編集。
こうなった。
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.motchi.tagdiary</groupId>
  <artifactId>TagDiary</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>TagDiary Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
     <groupId>org.apache.struts</groupId>
     <artifactId>struts2-core</artifactId>
     <version>2.2.3.1</version>
    </dependency>
    <dependency>
     <groupId>org.springframework</groupId>
     <artifactId>spring-core</artifactId>
     <version>3.0.6.RELEASE</version>
    </dependency>
    <dependency>
     <groupId>org.mybatis</groupId>
     <artifactId>mybatis</artifactId>
     <version>3.0.6</version>
    </dependency>
    <dependency>
     <groupId>org.mybatis</groupId>
     <artifactId>mybatis-spring</artifactId>
     <version>1.0.2</version>
    </dependency>
    <dependency>
     <groupId>org.apache.struts</groupId>
     <artifactId>struts2-convention-plugin</artifactId>
     <version>2.2.3.1</version>
    </dependency>
    <dependency>
     <groupId>jstl</groupId>
     <artifactId>jstl</artifactId>
     <version>1.2</version>
    </dependency>
    <dependency>
     <groupId>mysql</groupId>
     <artifactId>mysql-connector-java</artifactId>
     <version>5.1.18</version>
    </dependency>
    <dependency>
     <groupId>org.springframework</groupId>
     <artifactId>spring-web</artifactId>
     <version>3.0.6.RELEASE</version>
    </dependency>
    <dependency>
     <groupId>org.aspectj</groupId>
     <artifactId>aspectjweaver</artifactId>
     <version>1.6.11</version>
    </dependency>
    <dependency>
     <groupId>cglib</groupId>
     <artifactId>cglib</artifactId>
     <version>2.2.2</version>
    </dependency>
    <dependency>
     <groupId>org.apache.struts</groupId>
     <artifactId>struts2-spring-plugin</artifactId>
     <version>2.2.3.1</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>TagDiary</finalName>
  </build>
</project>
中身としては、
strus2, spring, mybatisを持ってきているのは当然として、

mybatis-spring名前の通り、mybatisとspringを連携させるため
struts2-convention-pluginstruts2のアクションの設定をアノテーションでできるようにするため
jstljspでJSTLを使うため。<c:forEach>とかよく使いそうだから
mysql-connector-javaDBにMySQLを使うため
aspectjweaver, cglibAspectJを利用してAOPしまくるため
struts2-spring-pluginstruts2とspringを連携させるため

後のものは・・・記憶にございません。思い出したら書いてみます。

長くなったので、続きはエントリを改めて。