Grailsアップデート状況

本書「はじめてのGrails(工学社刊）」作成時、Grailsの「安定版」はGrails-1.1.1でした。その後、アップデートにともない、本書の記載事項が通用しなくなった箇所も出てきましたので、ここに御紹介します。

アプリケーションの作成にドメイン名が必要になりました（3-8節49ページ他）

grails generate-all Testdata

Domain class not found in grails-app/domain, trying hibernate mapped classes...

grails generate-all testapp.Testdata

grails generate-all glossary.Word

grails generate-all glossary.Categ

grails generate-all testapp.Cage

grails generate-all testapp.Bird

自動作成されるファイルの構造に「アプリケーション名」のフォルダが加わりました（3-7節47ページ他)

自動作成される「GSPファイル」に「インポート文」が追加されました

「アプリケーション名」が「パッケージ名」

自動記入される内容の変更点

<%@ page import="testapp.TestData" %>

<%@ page import="glossary.Word" %>

<%@ page import="glossary.Categ" %>

<%@ page import="testapp.TestData" %>

<%@ page import="glossary.Word" %>

「BootStrap.groovy」に本書で書き込む内容を変更する必要が生じました(8-5節 210ページ他)

「BootStrap.groovy」に「Cage」「Bird」を書き込むとエラーになる

一括インポート文

import testapp.*

    class BootStrap{
           ............

自動記入される内容に「message」メソッドが多用されるようになりました

説明のはじめに- 第6章は（かなり)必要なくなります-

まず、プロパティファイルについての詳細は、第5章124ページをお読みください。

その上で書いたのが、第6章です。第5章で設定された以外の場所も日本語化するには、「Contoller」ファイル及び「GSP」ファイル側のほうに、随所でプロパティファイルを参照するように指定する記述を書かなければなりません。でも、本書で扱ったGrailsのバージョン「1.2M2」では、自動作成にまかせていてはそのような記述が不十分だったので、自分で書き直しました。それが、第6章の主たる部分なのです。

それが正式版1.2.0以降では「改良」され、「Contoller」ファイル及び「GSP」ファイルの内容が強化されたので、これらを自分で書き直さなくても、プロパティファイルに追記するだけで、十分日本語化が可能になりました。つまり、 「Contoller」ファイル及び「GSP」ファイルを何度作り直しても、「日本語化」に関しては、書き直す必要がなくなります。
本書で言いますと、第7章187ページあたりで「今まで編集したviews/wordフォルダのGSPファイルが上書きされてしまいます」と嘆いている部分が、嘆く必要がなくなるのです。

そのかわり、第5章で各ファイルを解読する内容がややこしくなります。ですから、ここで説明しましょう。第5章の進行に沿って、各ファイルごとに説明していきます。特に、Contollerファイルには日本語化と関係ない変更も、小さいですがありますので御注意ください。

ただし、第6章の中にあるプロパティファイルの「書き方」は随所で使います。また、最後の6-5節「Grailsアプリケーションの実行に関する注意事項」は大事ですから、日本語化作業が（かなり）必要なくなってもゼヒお読みください。

WordController.groovyを例に見る「コントローラー」ファイルの変更点

index, list, create, save, show, edit, update, delete

でも、本をめくり直すよりは画面をスクロールするほうが速いと思われますので、これからの説明では、本書の記述順序で説明します。恐縮ですが、新しいバージョンの「WordController」ファイルのほうで該当アクション名を探して、比べてください。

リスト5-6に抜き出して書かれている部分です。

変更前:

params.max ? params.max.toInteger() : 10

変更後:

params.max ? params.int('max') : 10

茶色の背景色のコードは「そういう風に変更されているのを確認する」

紫色の背景色のコードは、実際にプロパティファイルに追記

flash.message = "Word not found with id ${params.id}"

変更後:

flash.message =
		"${message(
			code: 'default.not.found.message', 
			args: [
					message(code: 'word.label', default: 'Word'), 
					params.id
				]
			)
		}"

しかし、いきなり第6章の内容を読むというのも大変です。そこで、ここでざっと説明しますので、それを手がかりに、詳細は172ページ以降をお読みください。

まず、flash.messageの中身は、"$message(....)"という文字列です。「$」がついているのは、「コードを実行して得られる文字列」という意味です。ここでは、「messageメソッドで得られる文字列」です。
messageメソッドをどのように行うかが(...)の中に書いてあります。「code」と「args」という二つの項目が指定されています。

「code」は、プロパティファイルの中に、以下のように書きます。プロパティファイルは、「grails-app」フォルダの下「i18n」フォルダにある「messages_ja.properties」です。

default.not.found.message=ID{1}の{0}は見つかりません

word.label=用語

flash.message = "Word ${params.id} deleted"

変更後:

flash.message = "${message(code: 'default.deleted.message',
			 args: [message(code: 'word.label', default: 'Word'),
			 		 params.id])}"

default.deleted.message=ID{1}の{0}を削除しました

flash.message = "Word ${params.id} could not be deleted"

変更後:

flash.message = "${message(code: 'default.not.deleted.message', 
			args: [message(code: 'word.label', default: 'Word'), 
				params.id])}"

default.not.deleted.message=ID{1}の{0}は削除できませんでした

wordInstance.errors.rejectValue("version",
	 "word.optimistic.locking.failure", 
	 "Another user has updated this Word while you were editing.")

それをふまえて、変更後のコードを見てみましょう。
変更後:

 wordInstance.errors.rejectValue("version",
	 "default.optimistic.locking.failure",
	  [message(code: 'word.label', default: 'Word')] as Object[],
	   "Another user has updated this Word while you were editing")

default.optimistic.locking.failure=このデータはすでに他のユーザによって変更されていますというようなメッセージ

default.optimistic.locking.failure=
	この{0}の値はすでに他のユーザによって更新されています

flash.message = "Word ${params.id} updated"

変更後:

flash.message =
	 "${message(code: 'default.updated.message', 
	 			args: [message(code: 'word.label', default: 'Word'), 
	 				wordInstance.id])}"

default.updated.message=ID{1}の{0}を更新しました

flash.message = "Word ${wordInstance.id} created"

変更後:

flash.message =
	  "${message(code: 'default.created.message',
 				args: [message(code: 'word.label', default: 'Word'), 
 						 		wordInstance.id])}"

default.created.message=新しい{0}をID{1}で作成しました

「views/word」内の各ファイルの例に見る、GSPファイルの変更点

<title>${entityName} List</title>

<title><g:message code="default.list.label" args="[entityName]" /></title>

default.list.label={0}の一覧

New ${entityName}

<g:message code="default.new.label" args="[entityName]" />

default.new.label=新規の{0}

<span class="menuButton" >
    <a class="home" href="${resource(dir:' '}}">
       Home
    </a>
 </span>

<span class="menuButton">
  <a class="home" href="${createLink(uri: '/')}">
    <g:message code="default.home.label"/>
  </a%gt;
</span>

resource(dir:'')

createLink(url:'/')

<g:actionSubmit class="edit" value="Edit" />

<g:actionSubmit class="edit" action="edit" value="${message(code: 'default.button.edit.label', default: 'Edit')}" />

default.button.edit.label=編集

$message(code: 'view.edit', default: 'Edit')}を「buttonEdit」という変数で表わすことにするからネ

<g:actionSubmit class="delete" 
 		onclick="return confirm('Are you sure?');"  value="Delete"  />

<g:actionSubmit class="delete" action="delete"
		value="${message(code: 'default.button.delete.label', default: 'Delete')}"
 		onclick="return confirm(
 				'${message(code: 'default.button.delete.confirm.message', 
 				default: 'Are you sure?')}');"/>

onclick="return confirm(ナニナニ);"

'${message(ウニウニ)}'

code: 'default.button.delete.confirm.message', default: 'Are you sure?'

変更後は、プロパティファイルに二つのコードを追記します。

default.button.delete.label=削除
default.button.delete.confirm.message=よろしいですか？

では、残る「edit.gsp」及び「create.gsp」ファイルで「バージョンアップにより変更された箇所」と、それにともなう「ワレワレがプロパティファイルに追記すべき項目」を一気にまとめましょう。

プロパティファイル：
「コントローラ」ファイルの内容も含めて、結局これだけの追記をします。

default.not.found.message=ID{1}の{0}は見つかりません
default.updated.message=ID{1}の{0}を更新しました
default.created.message=新しい{0}をID{1}で作成しました
default.deleted.message=ID{1}の{0}を削除しました
default.not.deleted.message=ID{1}の{0}は削除できませんでした
default.create.label={0}の新規作成
default.list.label={0}の一覧
default.button.create.label=作成
default.edit.label={0}を編集
default.new.label=新規の{0}
default.button.update.label=更新
default.button.delete.label=削除
default.button.delete.confirm.message=よろしいですか？
default.show.label={0}を表示
default.button.edit.label=編集

word.id.label=ID
word.en.label=英語
word.ja.label=日本語

word.label=用語

[ edit.gspだけに加えられた変更 ]

• <title>タグの表記

  <title><g:message code="default.edit.label" args="[entityName]" /></title>
  

  
  
• フォームの一番下にある「更新」ボタンのラベル

  <g:actionSubmit class="save" action="update"
  		value="${message(code: 'default.button.update.label', default: 'Update')}"}");"/>

  
  
  

[ create.gspだけに加えられた変更 ]

• <title>タグの表記

  <title><g:message code="default.create.label" args="[entityName]" /></title>
  

  
  
• フォームの一番下にある「更新」ボタンのラベル

  <g:actionSubmitg:submitButton name="create" class="save" 
  		value="${message(code: 'default.button.create.label', default: 'Create')}" />

  
  
  

その他 GSPファイルにおける変更

「Grailsタグ」で書ける「コントロール」が増えました

<input type="hidden" name="id" value="${wordinstance?.id}" /$gt;

   <g:hiddenField name="id" value="${wordInstance?.id}" />

<input type="text" name="en" value="${wordinstance?.en}" />

 <g:textField name="en" value="${wordInstance?.en}" />