servicepropertyhandler.java

intra_mart是日本NDD公司开发的著名企业应用解决方案中间件。集成了J2ee服务器

/*
 * ServicePropertyHandler.java
 *
 * Created on 2001/12/17, 14:23
 */

package jp.co.intra_mart.framework.base.service;

import java.util.Locale;

import jp.co.intra_mart.framework.system.property.PropertyHandler;

/**
 * 僒乕價僗偺愝掕忣曬偵愙懕偡傞僋儔僗偱偡丅
 *
 * @author INTRAMART
 * @version 1.0
 */
public interface ServicePropertyHandler extends PropertyHandler {

    /**
     * 傾僾儕働乕僔儑儞ID偺僨僼僅儖僩偺僷儔儊乕僞柤
     * @deprecated 偙偺幚憰偼攑巭偝傟傑偟偨丅
     */
    public static final String DEFAULT_APPLICATION_PARAMETER = "application";

    /**
     * 僒乕價僗ID偺僨僼僅儖僩偺僷儔儊乕僞柤
     * @deprecated 偙偺幚憰偼攑巭偝傟傑偟偨丅
     */
    public static final String DEFAULT_SERVICE_PARAMETER = "service";

    /**
     * 椺奜懏惈偺僨僼僅儖僩偺懏惈柤
     */
    public static final String DEFAULT_EXCEPTION_ATTRIBUTE = "exception";

    /**
     * 儘僌僀儞儐乕僓偺僄儞僐乕僨傿儞僌偺僨僼僅儖僩偺懏惈柤
     */
    public static final String DEFAULT_ENCODING_ATTRIBUTE =
        "jp.co.intra_mart.framework.base.service.encoding";

    /**
     * 儘僌僀儞儐乕僓偺儘働乕儖偺僨僼僅儖僩偺懏惈柤
     */
    public static final String DEFAULT_LOCALE_ATTRIBUTE =
        "jp.co.intra_mart.framework.base.service.locale";

    /**
     * 僾儘僷僥傿偺摦揑撉傒崬傒偑壜擻偐偳偆偐挷傋傑偡丅
     *
     * @return true丗僾儘僷僥傿偺摦揑撉傒崬傒偑壜擻丄false丗僾儘僷僥傿偺摦揑撉傒崬傒晄壜
     * @throws ServicePropertyException 僠僃僢僋帪偵椺奜偑敪惗
     * @since 3.2
     */
    public boolean isDynamic() throws ServicePropertyException;

    /**
     * 僋儔僀傾儞僩偺僄儞僐乕僪傪庢摼偟傑偡丅
     *
     * @return 僋儔僀傾儞僩偺僄儞僐乕僨傿儞僌
     * @throws ServicePropertyException 僋儔僀傾儞僩偺僄儞僐乕僪偺庢摼帪偵椺奜偑敪惗
     */
    public String getClientEncoding() throws ServicePropertyException;

    /**
     * 儘僌僀儞儐乕僓偑巊梡偡傞僄儞僐乕僪傪曐懚偟偰偍偔偲偒偺懏惈柤傪庢摼偟傑偡丅
     * 愝掕偝傟偰偄側偄応崌丄{@link #DEFAULT_ENCODING_ATTRIBUTE}偱掕媊偝傟偰偄傞抣傪曉偟傑偡丅
     *
     * @return 僄儞僐乕僪偺懏惈柤
     * @throws ServicePropertyException 懏惈柤偺庢摼帪偵椺奜偑敪惗
     */
    public String getEncodingAttributeName() throws ServicePropertyException;

    /**
     * 僋儔僀傾儞僩偺儘働乕儖傪庢摼偟傑偡丅
     *
     * @return 僋儔僀傾儞僩偺儘働乕儖乮愝掕偝傟偰偄側偄応崌偼null乯
     * @throws ServicePropertyException 僋儔僀傾儞僩偺儘働乕儖偺庢摼帪偵椺奜偑敪惗
     * @since 4.2
     */
    public Locale getClientLocale() throws ServicePropertyException;

    /**
     * 儘僌僀儞儐乕僓偑巊梡偡傞儘働乕儖傪曐懚偟偰偍偔偲偒偺懏惈柤傪庢摼偟傑偡丅
     * 愝掕偝傟偰偄側偄応崌丄{@link #DEFAULT_LOCALE_ATTRIBUTE}偱掕媊偝傟偰偄傞抣傪曉偟傑偡丅
     *
     * @return 儘働乕儖偺懏惈柤
     * @throws ServicePropertyException 懏惈柤偺庢摼帪偵椺奜偑敪惗
     * @since 4.2
     */
    public String getLocaleAttributeName() throws ServicePropertyException;

    /**
     * 慗堏愭偺儁乕僕偺僷僗傪庢摼偟傑偡丅
     * 僒乕價僗偐傜慗堏愭偑堦堄偵寛傑傞応崌偵偙偺儊僜僢僪傪巊梡偟傑偡丅
     * 偙偺儊僜僢僪偼{@link #getNextPagePath(String, String, Locale) getNextPagePath(application, service, (java.util.Locale)null)}傪屇傫偩偲偒偲摨偠寢壥偵側傞傛偆偵幚憰偝傟傞昁梫偑偁傝傑偡丅
     *
     * @param application 傾僾儕働乕僔儑儞ID
     * @param service 僒乕價僗ID
     * @return 慗堏愭偺儁乕僕偺僷僗
     * @throws ServicePropertyException 慗堏愭偺儁乕僕偺僷僗偺庢摼帪偵椺奜偑敪惗
     * @deprecated 偙偺儊僜僢僪偱偼側偔{@link #getNextPagePath(String, String, Locale)}傪巊梡偟偰偔偩偝偄丅
     */
    public String getNextPagePath(String application, String service)
        throws ServicePropertyException;

    /**
     * 慗堏愭偺儁乕僕偺僷僗傪庢摼偟傑偡丅
     * 僒乕價僗偐傜慗堏愭偑堦堄偵寛傑傞応崌偵偙偺儊僜僢僪傪巊梡偟傑偡丅
     *
     * @param application 傾僾儕働乕僔儑儞ID
     * @param service 僒乕價僗ID
     * @param locale 儘働乕儖
     * @return 慗堏愭偺儁乕僕偺僷僗
     * @throws ServicePropertyException 慗堏愭偺儁乕僕偺僷僗偺庢摼帪偵椺奜偑敪惗
     * @since 4.2
     */
    public String getNextPagePath(
        String application,
        String service,
        Locale locale)
        throws ServicePropertyException;

    /**
     * 慗堏愭偺儁乕僕偺僷僗傪庢摼偟傑偡丅
     * 僒乕價僗偐傜慗堏愭偑堦堄偵寛傑傜側偄応崌偵偙偺儊僜僢僪傪巊梡偟傑偡丅<CODE>key<CODE>偑<CODE>null<CODE>偺応崌丄{@link #getNextPagePath(String, String)}偲摨偠摦嶌偵側傝傑偡丅
     * 偙偺儊僜僢僪偼{@link #getNextPagePath(String, String, String, Locale) getNextPagePath(application, service, key, (java.util.Locale)null)}傪屇傫偩偲偒偲摨偠寢壥偵側傞傛偆偵幚憰偝傟傞昁梫偑偁傝傑偡丅
     *
     * @param application 傾僾儕働乕僔儑儞ID
     * @param service 僒乕價僗ID
     * @param key 慗堏愭偺僉乕
     * @return 慗堏愭偺儁乕僕偺僷僗
     * @throws ServicePropertyException 慗堏愭偺儁乕僕偺僷僗偺庢摼帪偵椺奜偑敪惗
     * @deprecated 偙偺儊僜僢僪偱偼側偔{@link #getNextPagePath(String, String, String, Locale)}傪巊梡偟偰偔偩偝偄丅
     */
    public String getNextPagePath(
        String application,
        String service,
        String key)
        throws ServicePropertyException;

    /**
     * 慗堏愭偺儁乕僕偺僷僗傪庢摼偟傑偡丅
     * 僒乕價僗偐傜慗堏愭偑堦堄偵寛傑傜側偄応崌偵偙偺儊僜僢僪傪巊梡偟傑偡丅<CODE>key<CODE>偑<CODE>null<CODE>偺応崌丄{@link #getNextPagePath(String, String)}偲摨偠摦嶌偵側傝傑偡丅
     *
     * @param application 傾僾儕働乕僔儑儞ID
     * @param service 僒乕價僗ID
     * @param key 慗堏愭偺僉乕
     * @param locale 儘働乕儖
     * @return 慗堏愭偺儁乕僕偺僷僗
     * @throws ServicePropertyException 慗堏愭偺儁乕僕偺僷僗偺庢摼帪偵椺奜偑敪惗
     * @since 4.2
     */
    public String getNextPagePath(
        String application,
        String service,
        String key,
        Locale locale)
        throws ServicePropertyException;

    /**
     * 擖椡椺奜帪偺儁乕僕偺僷僗傪庢摼偟傑偡丅
     * 奩摉偡傞儁乕僕偺僷僗偑庢摼偱偒側偄応崌丄{@link #getInputErrorPagePath(String, String)}偱庢摼偝傟傞儁乕僕傪曉偟傑偡丅
     * 偙偺儊僜僢僪偼{@link #getInputErrorPagePath(String, String, String, Locale) getInputErrorPagePath(application, service, key, (java.util.Locale)null)}傪屇傫偩偲偒偲摨偠寢壥偵側傞傛偆偵幚憰偝傟傞昁梫偑偁傝傑偡丅
     *
     * @param application 傾僾儕働乕僔儑儞ID
     * @param service 僒乕價僗ID
     * @param key 慗堏愭偺僉乕
     * @return 慗堏愭偺儁乕僕偺僷僗
     * @throws ServicePropertyException 慗堏愭偺儁乕僕偺僷僗偺庢摼帪偵椺奜偑敪惗
     * @deprecated 偙偺儊僜僢僪偱偼側偔{@link #getInputErrorPagePath(String, String, String, Locale)}傪巊梡偟偰偔偩偝偄丅
     */
    public String getInputErrorPagePath(
        String application,
        String service,
        String key)
        throws ServicePropertyException;

    /**
     * 擖椡椺奜帪偺儁乕僕偺僷僗傪庢摼偟傑偡丅
     * 奩摉偡傞儁乕僕偺僷僗偑庢摼偱偒側偄応崌丄{@link #getInputErrorPagePath(String, String)}偱庢摼偝傟傞儁乕僕傪曉偟傑偡丅
     *
     * @param application 傾僾儕働乕僔儑儞ID
     * @param service 僒乕價僗ID
     * @param key 慗堏愭偺僉乕
     * @param locale 儘働乕儖
     * @return 慗堏愭偺儁乕僕偺僷僗
     * @throws ServicePropertyException 慗堏愭偺儁乕僕偺僷僗偺庢摼帪偵椺奜偑敪惗
     * @since 4.2
     */
    public String getInputErrorPagePath(
        String application,
        String service,
        String key,
        Locale locale)
        throws ServicePropertyException;

    /**
     * 擖椡椺奜帪偺儁乕僕偺僷僗傪庢摼偟傑偡丅
     * 奩摉偡傞儁乕僕偺僷僗偑庢摼偱偒側偄応崌丄{@link #getInputErrorPagePath(String)}偱庢摼偝傟傞儁乕僕傪曉偟傑偡丅
     * 偙偺儊僜僢僪偼{@link #getInputErrorPagePath(String, String, Locale) getInputErrorPagePath(application, service, (java.util.Locale)null)}傪屇傫偩偲偒偲摨偠寢壥偵側傞傛偆偵幚憰偝傟傞昁梫偑偁傝傑偡丅
     *
     * @param application 傾僾儕働乕僔儑儞ID
     * @param service 僒乕價僗ID