クラス ImplicitObjectELResolver
- java.lang.ObjectSE
-
- jakarta.el.ELResolver
-
- jakarta.servlet.jsp.el.ImplicitObjectELResolver
public class ImplicitObjectELResolver extends ELResolver
JSP 仕様で定義されている EL 暗黙オブジェクトの変数解決動作を定義します。次の変数は、JSP 仕様に従って、この
ELResolverによって解決されます。pageContext-PageContextオブジェクト。pageScope- ページスコープの属性名をそれらの値にマップするMaprequestScope- リクエストスコープの属性名をそれらの値にマップするMapsessionScope- セッションスコープの属性名をその値にマップするMapapplicationScope- アプリケーションスコープの属性名をそれらの値にマップするMapparam- パラメーター名を単一の 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オブジェクトにマップするMapCookie はHttpServletRequest.getCookies()のセマンティクスに従って取得されます。同じ名前が複数の Cookie で共有されている場合、実装では、getCookies()メソッドによって返されたCookieオブジェクトの配列で最初に見つかったものを使用する必要があります。ただし、Cookie 暗黙オブジェクトのユーザーは、Cookie の順序がサーブレット仕様で現在指定されていないことに注意する必要があります。initParam- コンテキスト初期化パラメーター名を文字列パラメーター値にマップするMap(ServletContext.getInitParameter(String name))を呼び出すことにより取得)
- 導入:
- JSP 2.1
- 関連事項:
ELResolver
フィールドのサマリー
クラス jakarta.el.ELResolver から継承されたフィールド
RESOLVABLE_AT_DESIGN_TIME, TYPE
コンストラクターの概要
コンストラクター コンストラクター 説明 ImplicitObjectELResolver()
方法の概要
すべてのメソッド インスタンスメソッド 具象メソッド 非推奨のメソッド 修飾子と型 メソッド 説明 ClassSE<StringSE>getCommonPropertyType(ELContext context, ObjectSE base)基本オブジェクトがnullの場合、String.classを返します。IteratorSE<FeatureDescriptorSE>getFeatureDescriptors(ELContext context, ObjectSE base)非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。このメソッドは EL 5.0 で非推奨となり、EL 6.0 (Jakarta EE 11) で削除される予定です。ClassSE<?>getType(ELContext context, ObjectSE base, ObjectSE property)基本オブジェクトがnullであり、プロパティが JSP の暗黙オブジェクトの名前と一致する場合、nullを返し、setValue()に受け入れられる型がないことを示します。ObjectSEgetValue(ELContext context, ObjectSE base, ObjectSE property)基本オブジェクトがnullで、プロパティが JSP 暗黙オブジェクトの名前と一致する場合、暗黙オブジェクトを返します。booleanisReadOnly(ELContext context, ObjectSE base, ObjectSE property)基本オブジェクトがnullであり、プロパティが JSP 暗黙オブジェクトの名前と一致する場合、trueを返し、暗黙オブジェクトを上書きできないことを示します。voidsetValue(ELContext context, ObjectSE base, ObjectSE property, ObjectSE val)基本オブジェクトがnullで、プロパティが JSP 暗黙オブジェクトの名前と一致する場合、PropertyNotWritableExceptionをスローして、暗黙オブジェクトを上書きできないことを示します。クラス jakarta.el.ELResolver から継承されたメソッド
convertToType, invoke
メソッドの詳細
getValue
public ObjectSE getValue(ELContext context, ObjectSE base, ObjectSE property)
基本オブジェクトがnullで、プロパティが JSP 暗黙オブジェクトの名前と一致する場合、暗黙オブジェクトを返します。ELContextオブジェクトのpropertyResolvedプロパティは、暗黙的なオブジェクトが一致する場合に戻る前に、このリゾルバーによってtrueに設定する必要があります。このメソッドが呼び出された後、このプロパティがtrueでない場合、呼び出し元は戻り値を無視する必要があります。- 次で指定:
- クラス
ELResolverのgetValue - パラメーター:
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でない場合、呼び出し元は戻り値を無視する必要があります。- 次で指定:
- クラス
ELResolverのgetType - パラメーター:
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でない場合、呼び出し元は戻り値を無視する必要があります。- 次で指定:
- クラス
ELResolverのsetValue - パラメーター:
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でない場合、呼び出し元は戻り値を無視する必要があります。- 次で指定:
- クラス
ELResolverのisReadOnly - パラメーター:
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.
- オーバーライド:
- クラス
ELResolverのgetFeatureDescriptors - パラメーター:
context- この評価のコンテキスト。base- このリゾルバーによって処理されるのはnullのみです。他の値はnull戻り値になります。- 戻り値:
- 暗黙オブジェクトごとに 1 つの
FeatureDescriptorオブジェクトを含むIterator、またはbaseがnullでない場合はnull。 - 関連事項:
FeatureDescriptorSE
getCommonPropertyType
public ClassSE<StringSE> getCommonPropertyType(ELContext context, ObjectSE base)
ベースオブジェクトがnullの場合、String.classを返します。それ以外の場合は、nullを返します。- 次で指定:
- クラス
ELResolverのgetCommonPropertyType - パラメーター:
context- この評価のコンテキスト。base- このリゾルバーによって処理されるのはnullのみです。他の値はnull戻り値になります。- 戻り値:
- ベースが
nullでない場合はnull; それ以外の場合はString.class。