struts2でFreemarkerを使っているとそのままでは、テンプレートにエラーが
あった場合に、そのまま黄色画面でエラー(StackTrace)が表示されてしまう。

それを出力されないようにするための、FreemarkerManagerを作って設定する。
(これよりもっとスマートな方法はないものか…)

import javax.servlet.ServletContext;

import freemarker.template.TemplateException;
import freemarker.template.TemplateExceptionHandler;

public class FreemarkerManager extends
		org.apache.struts2.views.freemarker.FreemarkerManager {

	@Override
    protected freemarker.template.Configuration createConfiguration(ServletContext servletContext) throws TemplateException {
        freemarker.template.Configuration configuration = new freemarker.template.Configuration();

        configuration.setTemplateLoader(getTemplateLoader(servletContext));

        configuration.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);

        configuration.setObjectWrapper(getObjectWrapper());

        if( mruMaxStrongSize > 0 ) {
            configuration.setSetting(freemarker.template.Configuration.CACHE_STORAGE_KEY, "strong:" + mruMaxStrongSize);
        }

        if (encoding != null) {
            configuration.setDefaultEncoding(encoding);
        }

        loadSettings(servletContext, configuration);

        return configuration;
    }

}

struts.xmlに以下を記述。

	<!--  freemarker settings -->
	<constant name="struts.freemarker.manager.classname" value="com.bbt757.ktai.freemarker.FreemarkerManager" />

Popularity: 44% [?]

以下のようなFunctionを作った。
引数に、リスト、ページあたりに表示する行数、現在ページ数。

<#function paginator list num page>
	<#assign has_pre = false>
	<#assign has_next = false>
	<#if list?size == 0>
		<#return list>
	</#if>
	<#local start = (page - 1) * num>
	<#local end = start + num - 1>
	<#if page gt 1>
		<#assign has_pre = true>
	</#if>
	<#if end gte list?size - 1>
		<#local end = list?size - 1>
		<#assign has_next = false>
	<#else>
		<#assign has_next = true>
	</#if>
	<#return list[start..end]>
</#function>

使い方的には以下のようになる。

<#list paginator(["a", "b", "c", "d", "e"], 2, page) as item>
	${item}<br />
</#list>
<#if has_pre><a href="?page=${page - 1}">pre</a></#if>
<#if has_next><a href="?page=${page + 1}">next</a></#if>

Popularity: 29% [?]

気づけばというか、きっとドキュメントをちゃんと読めば書いてあったのだろうけど、
はまったのでメモ。

http://hogehoge.com/

上記のようなアドレスにアクセスした際に、仮にJSPを表示したい場合は、
web.xmlに以下のような記述を行うと思う。

<filter-mapping>
	<filter-name>struts2</filter-name>
	<url-pattern>/*</url-pattern>
</filter-mapping>
<welcome-file-list>
	<welcome-file>index.jsp</welcome-file>
</welcome-file-list>

今回、つまづいたのは、上記のようなアドレスにアクセスした際に、Actionを
呼びたかったのだけど、その方法がわからなかった。

で、答えは・・・

class IndexAction extends....(省略{

	@Actions( { @Action("/") })
	public String execute(...省略

とするだけでよかったのだ。
welcom-file-listでどうやって指定すればいいのだろうと悩んでしまったのが、
“/*”がすべてstruts2にマッピングされていたので、@Action(“/”)とするだけで
よかった。気づけばなんともない。。。

Popularity: 22% [?]

FreemarkerのXMLパーサとネームスペース(ns_prefixes)について

例えば、以下のようにネームスペースが付けられているような、
XMLをFreemarkerのテンプレートでパースして表示しようとすると、
若干躓くことになる。

<?xml version="1.0" encoding="UTF-8" ?>
<root xmlns="http://hogehoge.com/xmlns">
	<key>hogehoge</key>
	<value>hogehoge</value>
</root>

というのも、以下のようなコードでは値が取得できないのだ。

key=${doc.root.key}<br/>
value=${doc.root.value}
<#-- docはNodeModel -->

これは、ネームスペースを使っているためである。
ので、取得するにはこのように書くことになる。

<#ftl ns_prefixes={"xmlns": "http://hogehoge.com/xmlns"}>
<#-- 先頭に書くのがいいっぽい。-->

<#assign root = doc["xmlns:root"] />
key = ${root["xmlns:key"]}<br/>
value = ${root["xmlns:value"]}

というような感じで、エレメントを取得するたびにネームスペース
を付けてあげる必要がある。

これでは、面倒くさい。
Freemarkerでは、”D”がデフォルトとして割り当てられているので、

<#ftl ns_prefixes={"D": "http://hogehoge.com/xmlns"}>

と、宣言してあげると、一番最初のコードで各値を取得することが
できるようになる。

というメモ。

Popularity: 14% [?]

ということで、FreemarkerでXMLの内容を表示したいときに、どんなエレメントが紐づいているのか知りたかったので、
FreemarkerのFunctionを使って表示させｔみた。

<#function pprint xmlroot depth>
	<#local ret>
		<#list xmlroot?children as c>
			<#list 0..depth as x>  </#list>
			<#if c?node_type = 'element'>
				- ${c?node_type}
				<#local d = depth + 1>
				${c?node_name}
				${pprint(c, d)}
			</#if><br />
		</#list>
	</#local>
	<#return ret>
</#function>

使い方はこんな感じ

${pprint(xmldoc, 0)}

Popularity: 13% [?]