Sun Java System Application Server Platform Edition 8.2 Developer's Guide

key-field

Specifies a component of the key used to look up and extract cache entries. The web container looks for the named parameter, or field, in the specified scope.

If this element is not present, the web container uses the Servlet Path (the path section that corresponds to the servlet mapping that activated the current request). See the Servlet 2.4 specification, section SRV 4.4, for details on the Servlet Path.

Superelements

cache-mapping (sun-web.xml)

Subelements

none

Attributes

The following table describes attributes for the key-field element.

Table A–52 key-field Attributes

Attribute  

Default  

Description  

name

none 

Specifies the input parameter name. 

scope

request.parameter

(optional) Specifies the scope from which the input parameter is retrieved. Allowed values are context.attribute, request.header, request.parameter, request.cookie, session.id, and session.attribute.