パッケージ jakarta.servlet.jsp.el

クラス ImplicitObjectELResolver


  • public class ImplicitObjectELResolver
    extends ELResolver
    JSP 仕様で定義されている EL 暗黙オブジェクトの変数解決動作を定義します。

    次の変数は、JSP 仕様に従って、この ELResolver によって解決されます。

    • pageContext - PageContext オブジェクト。
    • pageScope - ページスコープの属性名をそれらの値にマップする Map 
    • requestScope - リクエストスコープの属性名をそれらの値にマップする Map 
    • sessionScope - セッションスコープの属性名をその値にマップする Map 
    • applicationScope - アプリケーションスコープの属性名をそれらの値にマップする Map 
    • param - パラメーター名を単一の String パラメーター値にマップする Map (ServletRequest.getParameter(String name) を呼び出すことにより取得)
    • paramValues - パラメーター名をそのパラメーターのすべての値の String[] にマップする Map (ServletRequest.getParameterValues(String name)) を呼び出すことにより取得)
    • header - ヘッダー名を単一の String ヘッダー値にマップする Map (HttpServletRequest.getHeader(String name)) を呼び出すことで取得)
    • headerValues - ヘッダー名をそのヘッダーのすべての値の String[] にマップする Map (HttpServletRequest.getHeaders(String)) を呼び出すことにより取得)
    • cookie - Cookie 名を単一の Cookie オブジェクトにマップする Map Cookie は HttpServletRequest.getCookies() のセマンティクスに従って取得されます。同じ名前が複数の Cookie で共有されている場合、実装では、getCookies() メソッドによって返された Cookie オブジェクトの配列で最初に見つかったものを使用する必要があります。ただし、Cookie 暗黙オブジェクトのユーザーは、Cookie の順序がサーブレット仕様で現在指定されていないことに注意する必要があります。
    • initParam - コンテキスト初期化パラメーター名を文字列パラメーター値にマップする Map (ServletContext.getInitParameter(String name)) を呼び出すことにより取得)
    導入:
    JSP 2.1
    関連事項:
    ELResolver
    • コンストラクターの詳細

      • ImplicitObjectELResolver

        public ImplicitObjectELResolver()
    • メソッドの詳細

      • getValue

        public ObjectSE getValue​(ELContext context,
                               ObjectSE base,
                               ObjectSE property)
        基本オブジェクトが null で、プロパティが JSP 暗黙オブジェクトの名前と一致する場合、暗黙オブジェクトを返します。

        ELContext オブジェクトの propertyResolved プロパティは、暗黙的なオブジェクトが一致する場合に戻る前に、このリゾルバーによって true に設定する必要があります。このメソッドが呼び出された後、このプロパティが true でない場合、呼び出し元は戻り値を無視する必要があります。

        次で指定:
        クラス ELResolvergetValue 
        パラメーター:
        context - この評価のコンテキスト。
        base - null のみがこのリゾルバーによって処理されます。他の値はすぐに戻ります。
        property - 解決する暗黙のオブジェクトの名前。
        戻り値:
        ELContext の propertyResolved プロパティが true に設定されている場合、暗黙のオブジェクト。それ以外は未定義。
        例外:
        NullPointerExceptionSE - コンテキストが null の場合
      • getType

        public ClassSE<?> getType​(ELContext context,
                                ObjectSE base,
                                ObjectSE property)
        基本オブジェクトが null であり、プロパティが JSP の暗黙オブジェクトの名前と一致する場合、null を返し、setValue() に受け入れられる型がないことを示します。

        ELContext オブジェクトの propertyResolved プロパティは、暗黙的なオブジェクトが一致する場合に戻る前に、このリゾルバーによって true に設定する必要があります。このメソッドが呼び出された後、このプロパティが true でない場合、呼び出し元は戻り値を無視する必要があります。

        次で指定:
        クラス ELResolvergetType 
        パラメーター:
        context - この評価のコンテキスト。
        base - null のみがこのリゾルバーによって処理されます。他の値はすぐに戻ります。
        property - 解決する暗黙のオブジェクトの名前。
        戻り値:
        ELContext の propertyResolved プロパティが true に設定されている場合、null です。それ以外は未定義。
        例外:
        NullPointerExceptionSE - コンテキストが null の場合
      • setValue

        public void setValue​(ELContext context,
                             ObjectSE base,
                             ObjectSE property,
                             ObjectSE val)
        基本オブジェクトが null で、プロパティが JSP 暗黙オブジェクトの名前と一致する場合、PropertyNotWritableException をスローして、暗黙オブジェクトを上書きできないことを示します。

        ELContext オブジェクトの propertyResolved プロパティは、暗黙的なオブジェクトが一致する場合に戻る前に、このリゾルバーによって true に設定する必要があります。このメソッドが呼び出された後、このプロパティが true でない場合、呼び出し元は戻り値を無視する必要があります。

        次で指定:
        クラス ELResolversetValue 
        パラメーター:
        context - この評価のコンテキスト。
        base - null のみがこのリゾルバーによって処理されます。他の値はすぐに戻ります。
        property - 暗黙的なオブジェクトの名前。
        val - 暗黙的なオブジェクトに関連付けられる値。
        例外:
        NullPointerExceptionSE - コンテキストが null の場合。
        PropertyNotWritableException - 暗黙のオブジェクト名がこのリゾルバーによって認識される場合、常にスローされます。
      • isReadOnly

        public boolean isReadOnly​(ELContext context,
                                  ObjectSE base,
                                  ObjectSE property)
        基本オブジェクトが null であり、プロパティが JSP 暗黙オブジェクトの名前と一致する場合、true を返し、暗黙オブジェクトを上書きできないことを示します。

        ELContext オブジェクトの propertyResolved プロパティは、暗黙的なオブジェクトが一致する場合に戻る前に、このリゾルバーによって true に設定する必要があります。このメソッドが呼び出された後、このプロパティが true でない場合、呼び出し元は戻り値を無視する必要があります。

        次で指定:
        クラス ELResolverisReadOnly 
        パラメーター:
        context - この評価のコンテキスト。
        base - null のみがこのリゾルバーによって処理されます。他の値はすぐに戻ります。
        property - 暗黙的なオブジェクトの名前。
        戻り値:
        ELContext の propertyResolved プロパティが true に設定されている場合、true です。それ以外は未定義。
        例外:
        NullPointerExceptionSE - コンテキストが null の場合。
      • getFeatureDescriptors

        @DeprecatedSE(forRemoval=true,
                    since="JSP 3.1")
        public IteratorSE<FeatureDescriptorSE> getFeatureDescriptors​(ELContext context,
                                                                 ObjectSE base)
        非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
        このメソッドは EL 5.0 で廃止され、EL 6.0 (Jakarta EE 11) で削除される予定です。JSP 4.0 では削除されます。
        ベースオブジェクトが null であり、プロパティが JSP 暗黙オブジェクトの名前と一致する場合、このリゾルバーによって解決された各 JSP 暗黙オブジェクトに関する情報を含む FeatureDescriptor オブジェクトを含む Iterator を返します。それ以外の場合は、null を返します。

        返される Iterator には、JSP 仕様で定義されている EL 暗黙オブジェクトごとに FeatureDescriptorSE のインスタンスが 1 つ含まれている必要があります。各 info オブジェクトには、単一の暗黙オブジェクトに関する情報が含まれており、次のように初期化されます。

        displayName
        - 暗黙的なオブジェクトの名前。
        名前
        - displayName プロパティと同じです。
        shortDescription
        - 暗黙的なオブジェクトの適切な説明。実装によって異なります。
        専門家
        false
        隠された
        false
        優先
        true
        さらに、返される FeatureDescriptor には、次の名前付き属性を設定する必要があります。
        ELResolver.TYPE
        - 暗黙的なオブジェクトの実行時型。
        ELResolver.RESOLVABLE_AT_DESIGN_TIME
        true.
        オーバーライド:
        クラス ELResolvergetFeatureDescriptors 
        パラメーター:
        context - この評価のコンテキスト。
        base - このリゾルバーによって処理されるのは null のみです。他の値は null 戻り値になります。
        戻り値:
        暗黙オブジェクトごとに 1 つの FeatureDescriptor オブジェクトを含む Iterator、または base が null でない場合は null
        関連事項:
        FeatureDescriptorSE
      • getCommonPropertyType

        public ClassSE<StringSE> getCommonPropertyType​(ELContext context,
                                                   ObjectSE base)
        ベースオブジェクトが null の場合、String.class を返します。それ以外の場合は、null を返します。
        次で指定:
        クラス ELResolvergetCommonPropertyType 
        パラメーター:
        context - この評価のコンテキスト。
        base - このリゾルバーによって処理されるのは null のみです。他の値は null 戻り値になります。
        戻り値:
        ベースが null でない場合は null ; それ以外の場合は String.class