クラス TemplateUtil

java.lang.Object
org.iplass.mtp.web.template.TemplateUtil

public class TemplateUtil
extends java.lang.Object
テンプレートを作成する際利用可能なユーティリティメソッド。
  • ネストされたクラスの概要

    ネストされたクラス 
    修飾子とタイプ クラス 説明
    static class  TemplateUtil.TokenOutputType
    トランザクショントークン出力形式
  • コンストラクタの概要

    コンストラクタ 
    コンストラクタ 説明
    TemplateUtil()  
  • メソッドの概要

    修飾子とタイプ メソッド 説明
    static java.lang.String getAPIVersion()
    APIのバージョン番号を返します。
    static int getClientTenantId()  
    static java.sql.Timestamp getCurrentTimestamp()  
    static java.util.Map<java.lang.String,​java.lang.String> getEnableLanguages()  
    static java.lang.String getLanguage()  
    static java.lang.String getLanguageFonts​(java.lang.String langage)  
    static java.util.Locale getLocale()  
    static org.iplass.mtp.impl.i18n.LocaleFormat getLocaleFormat()  
    static MessageCategory getMessageCategory​(java.lang.String catName)
    指定のカテゴリ名のMessageCategoryを取得。
    static java.lang.String getMessageString​(java.lang.String catName, java.lang.String msgId, java.lang.Object... args)
    指定のカテゴリ名、メッセージIDでメッセージ文字列を取得。
    static java.lang.String getMessageString​(MessageItem message, java.lang.Object... args)
    指定のMessageItemでメッセージ文字列を取得。
    static java.lang.String getMultilingualString​(java.lang.String defaultString, java.util.List<LocalizedStringDefinition> localizedStringList)  
    static java.lang.String getMultilingualString​(java.lang.String viewString, java.util.List<LocalizedStringDefinition> viewLocalizedStringList, java.lang.String propDefString, java.util.List<LocalizedStringDefinition> propDefLocalizedStringList)  
    static RequestContext getRequestContext()
    RequestContextのインスタンスを取得します。
    static java.lang.String getResourceContentPath​(java.lang.String resourcePath)
    リソースパスからcssやjs、imgなどに指定するパスを返します。
    static java.lang.String getResourceString​(java.lang.String key, java.lang.Object... arguments)
    リソースファイルに定義した文字列を取得します。
    static java.lang.String getResourceString​(java.util.ResourceBundle resource, java.lang.String key, java.lang.Object... arguments)
    リソースファイルに定義した文字列を取得します。
    static java.lang.String getStaticContentPath()
    静的コンテンツパスを返します。
    static java.lang.String getString​(java.lang.String key)
    推奨されていません。
    getResourceString(String, Object...) を利用してください。
    static java.lang.String getString​(java.lang.String key, java.lang.Object... arguments)
    推奨されていません。
    getResourceString(String, Object...) を利用してください。
    static Tenant getTenant()  
    static java.lang.String getTenantContextPath()
    テナントコンテキストパスを返します。
    static java.util.TimeZone getTimeZone()  
    static void include​(java.lang.String actionName, javax.servlet.jsp.PageContext pageContext)
    別Actionをincludeします。
    static void include​(java.lang.String actionName, javax.servlet.jsp.PageContext pageContext, RequestContextWrapper requestContext)
    別Actionをincludeします。
    static void includeTemplate​(java.lang.String templateName, javax.servlet.jsp.PageContext pageContext)
    テンプレートを直接includeします。
    static void includeTemplate​(java.lang.String templateName, javax.servlet.jsp.PageContext pageContext, RequestContextWrapper requestContext)
    テンプレートを直接includeします。
    static java.lang.String outputToken​(TemplateUtil.TokenOutputType outputStyle)
    新規に生成されたトランザクショントークンを返します。
    static java.lang.String outputToken​(TemplateUtil.TokenOutputType outputStyle, boolean createNew)
    トランザクショントークンを返します。
    static void renderContent​(javax.servlet.jsp.PageContext pageContext)
    レイアウトテンプレートで、コンテンツをレンダリングする場所で呼び出す。

    クラスから継承されたメソッド java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • コンストラクタの詳細

  • メソッドの詳細

    • getStaticContentPath

      public static java.lang.String getStaticContentPath()

      静的コンテンツパスを返します。

      service-configに設定されたstaticContentPathを返します。

      戻り値:
      静的コンテンツパス
    • getTenantContextPath

      public static java.lang.String getTenantContextPath()

      テナントコンテキストパスを返します。

      • 通常は「HttpServletRequest#getContextPath() + テナントメタ#テナントURL」を返します。
      • テナントURLが「/」の場合は、最後に「/」は付与しません。
      • テナントメタに「リクエストパス構築用テナントURL」を指定している場合はその値を返します。
      • 「リクエストパス構築用テナントURL」が「/」の場合は空を返します。

        例えば通常の「http://host:port/tenant/」を「http://aaaaaa/」にマッピングしている場合、「リクエストパス構築用テナントURL」には「/」を指定します。 この場合このメソッドの戻り値は空です。

    • getResourceContentPath

      public static java.lang.String getResourceContentPath​(java.lang.String resourcePath)

      リソースパスからcssやjs、imgなどに指定するパスを返します。

      以下のルールによりパスを判断します。

      • 「/」で始まる場合は静的コンテキストパスからの指定と判断します。
      • 「http」で始まる場合は外部リソースと判断します。
      • 上記以外(actionなどの指定含む)の場合は、テナントコンテキストパスからの指定と判断します。

      パラメータ:
      resourcePath -
      戻り値:
    • getRequestContext

      public static RequestContext getRequestContext()
      RequestContextのインスタンスを取得します。
      戻り値:
    • getTenant

      public static Tenant getTenant()
    • getClientTenantId

      public static int getClientTenantId()
    • includeTemplate

      public static void includeTemplate​(java.lang.String templateName, javax.servlet.jsp.PageContext pageContext) throws java.io.IOException, javax.servlet.ServletException

      テンプレートを直接includeします。

      直接テンプレートをincludeするためCommandは実行されません。

      パラメータ:
      templateName - テンプレート名
      pageContext - 呼び出し元がjspの場合、jspのPageContextを引数に渡す
      例外:
      java.io.IOException
      javax.servlet.ServletException
    • includeTemplate

      public static void includeTemplate​(java.lang.String templateName, javax.servlet.jsp.PageContext pageContext, RequestContextWrapper requestContext) throws java.io.IOException, javax.servlet.ServletException

      テンプレートを直接includeします。

      直接テンプレートをincludeするためCommandは実行されません。 requestContextを指定した場合は、呼び出し先でその(上書きされた)requestContextで処理が実行されます。

      パラメータ:
      templateName - テンプレート名
      pageContext - 呼び出し元がjspの場合、jspのPageContextを引数に渡す
      requestContext - include先で利用するRequestContextを指定
      例外:
      java.io.IOException
      javax.servlet.ServletException
    • include

      public static void include​(java.lang.String actionName, javax.servlet.jsp.PageContext pageContext) throws java.io.IOException, javax.servlet.ServletException
      別Actionをincludeします。
      パラメータ:
      actionName - アクション名
      pageContext - 呼び出し元がjspの場合、jspのPageContextを引数に渡す
      例外:
      java.io.IOException
      javax.servlet.ServletException
    • include

      public static void include​(java.lang.String actionName, javax.servlet.jsp.PageContext pageContext, RequestContextWrapper requestContext) throws java.io.IOException, javax.servlet.ServletException

      別Actionをincludeします。

      requestContextを指定した場合は、呼び出し先でその(上書きされた)requestContextで処理が実行されます。

      パラメータ:
      actionName - アクション名
      pageContext - 呼び出し元がjspの場合、jspのPageContextを引数に渡す
      requestContext - include先で利用するRequestContextを指定
      例外:
      java.io.IOException
      javax.servlet.ServletException
    • renderContent

      public static void renderContent​(javax.servlet.jsp.PageContext pageContext) throws java.io.IOException, javax.servlet.ServletException
      レイアウトテンプレートで、コンテンツをレンダリングする場所で呼び出す。
      パラメータ:
      pageContext - 呼び出し元がjspの場合、jspのPageContextを引数に渡す
      例外:
      java.io.IOException
      javax.servlet.ServletException
    • outputToken

      public static java.lang.String outputToken​(TemplateUtil.TokenOutputType outputStyle)

      新規に生成されたトランザクショントークンを返します。

      createNew=trueでoutputToken(TokenOutputType, boolean)を呼び出します。

      パラメータ:
      outputStyle - 出力形式
      戻り値:
      トランザクショントークン
    • outputToken

      public static java.lang.String outputToken​(TemplateUtil.TokenOutputType outputStyle, boolean createNew)

      トランザクショントークンを返します。

      URLの場合、_t=254a-fa...形式で出力。
      FORM_HTMLの場合、<input type="hidden" name="_t" value="254a-fa..." >形式で出力。
      FORM_XHTMLの場合、<input type="hidden" name="_t" value="254a-fa..." />形式で出力。
      VALUEの場合、単純にトランザクショントークンの値のみを出力(WebApi(javaScript)でHTTPヘッダーやリクエストにセットする際に利用することを想定)。

      createNewがtrueの場合は、ワンタイムのトランザクショントークンとして新規にトークンを生成します。
      createNewがfalseの場合は、すでに発行済みの(セッション単位に固定の)トークンを返します。
      固定のトークンは、単純にCSRFを防ぎたい場合に利用可能です。 ワンタイムのトークンはCSRF対策に加えて、そのトークンに関連するトランザクションの重複起動を防御することが可能です。

      パラメータ:
      outputStyle - 出力形式
      createNew - 新規のトークンを発行する場合はtrue。すでに発行済みの(セッション単位に固定の)トークンを取得する場合はfalse。
      戻り値:
      トランザクショントークン
    • getCurrentTimestamp

      public static java.sql.Timestamp getCurrentTimestamp()
    • getString

      @Deprecated public static java.lang.String getString​(java.lang.String key)
      推奨されていません。
      getResourceString(String, Object...) を利用してください。
      リソースファイルに定義した文字列を取得します。
      パラメータ:
      key - KEY
      戻り値:
      リソース文字列
    • getString

      @Deprecated public static java.lang.String getString​(java.lang.String key, java.lang.Object... arguments)
      推奨されていません。
      getResourceString(String, Object...) を利用してください。
      リソースファイルに定義した文字列を取得します。
      パラメータ:
      key - KEY
      arguments - 引数
      戻り値:
      リソース文字列
    • getResourceString

      public static java.lang.String getResourceString​(java.lang.String key, java.lang.Object... arguments)
      リソースファイルに定義した文字列を取得します。
      パラメータ:
      key - KEY
      arguments - 引数
      戻り値:
      リソース文字列
    • getResourceString

      public static java.lang.String getResourceString​(java.util.ResourceBundle resource, java.lang.String key, java.lang.Object... arguments)
      リソースファイルに定義した文字列を取得します。
      パラメータ:
      resource - リソースバンドル
      key - KEY
      arguments - 引数
      戻り値:
      リソース文字列
    • getAPIVersion

      public static java.lang.String getAPIVersion()
      APIのバージョン番号を返します。
      戻り値:
      バージョン番号
    • getEnableLanguages

      public static java.util.Map<java.lang.String,​java.lang.String> getEnableLanguages()
    • getMessageCategory

      public static MessageCategory getMessageCategory​(java.lang.String catName)
      指定のカテゴリ名のMessageCategoryを取得。
      パラメータ:
      catName -
      戻り値:
    • getMessageString

      public static java.lang.String getMessageString​(java.lang.String catName, java.lang.String msgId, java.lang.Object... args)
      指定のカテゴリ名、メッセージIDでメッセージ文字列を取得。 取得されたメッセージ文字列は、多言語を考慮した形で、フォーマット済み。
      パラメータ:
      catName -
      msgId -
      args - メッセージをフォーマットする場合の引数
      戻り値:
    • getMessageString

      public static java.lang.String getMessageString​(MessageItem message, java.lang.Object... args)
      指定のMessageItemでメッセージ文字列を取得。 取得されたメッセージ文字列は、多言語を考慮した形で、フォーマット済み。
      パラメータ:
      message -
      args -
      戻り値:
    • getMultilingualString

      public static java.lang.String getMultilingualString​(java.lang.String defaultString, java.util.List<LocalizedStringDefinition> localizedStringList)
    • getMultilingualString

      public static java.lang.String getMultilingualString​(java.lang.String viewString, java.util.List<LocalizedStringDefinition> viewLocalizedStringList, java.lang.String propDefString, java.util.List<LocalizedStringDefinition> propDefLocalizedStringList)
    • getLanguage

      public static java.lang.String getLanguage()
    • getLocale

      public static java.util.Locale getLocale()
    • getTimeZone

      public static java.util.TimeZone getTimeZone()
    • getLocaleFormat

      public static org.iplass.mtp.impl.i18n.LocaleFormat getLocaleFormat()
    • getLanguageFonts

      public static java.lang.String getLanguageFonts​(java.lang.String langage)