Java Standard EL Functions

Webアプリケーションで一般的に使用されると思われるJSP-EL関数を提供します。

クイックスタート

JARファイルは以下からダウンロードすることができます。

functions-x.x.x.jarをWEB-INF/libに追加し、web.xmlに以下の記述を追加します。

  <filter>
    <filter-name>functionsFilter</filter-name>
    <filter-class>jp.sf.amateras.functions.filter.FunctionsFilter</filter-class>
  </filter>

  <filter-mapping>
    <filter-name>functionsFilter</filter-name>
    <url-pattern>*</url-pattern>
    <dispatcher>REQUEST</dispatcher>
  </filter-mapping>

JSPに以下のtaglibディレクティブを追加するとJava Standard EL Functionsが提供するEL関数を利用することができます。

<%@ taglib uri="http://amateras.sf.jp/functions" prefix="f" %>
<%@ taglib uri="http://amateras.sf.jp/log4j" prefix="log4j" %>

Java Standard EL Functionsが提供するEL関数の詳細についてはTLDDocを参照してください。

また、EL関数以外にJSPで以下の変数を利用することができます。

変数名 説明
context アプリケーションのコンテキストパス（pageContext.request.contextPathと等価です）
JSPで利用可能な変数

設定

f:date()、f:datetime()、f:time()などの関数はデフォルトのフォーマットパターンが決められています。 これらのフォーマットパターンを変更するにはクラスパスルートにfunctions.propertiesというプロパティファイルを 以下のような内容で作成してください。

# f:u()でURLエンコードするときの文字コード
defaultEncoding=UTF-8

# f:date()でフォーマットするパターン
datePattern=yyyy/MM/dd

# f:datetime()でフォーマットするパターン
datetimePattern=yyyy/MM/dd HH:mm:ss

# f:time()でフォーマットするパターン
timePattern=HH:mm:ss

デフォルトのfunctions.propertiesはfunctions-x.x.x.jarに含まれています。

Mavenからの利用

Mavenを使用している場合はProject Amaterasで運用しているMavenリポジトリから入手することもできます。 pom.xmlに以下の記述を追加してください。

<repositories>
  <repository>
    <id>amateras</id>
    <name>Project Amateras Maven2 Repository</name>
    <url>http://amateras.sourceforge.jp/mvn/</url>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>jp.sf.amateras.functions</groupId>
    <artifactId>functions</artifactId>
    <version>1.1.0</version>
  </dependency>
</dependencies>