Java Standard EL Functions

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

* クイックスタート

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

   * {{http://sourceforge.jp/projects/amateras/releases/?package_id=10603}}
 
   []

 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/index.html}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>
----
