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

L

level

Specifies the name of a hierarchical fetch group. The name must be an integer. Fields and relationships that belong to a hierarchical fetch group of equal (or lesser) value are fetched at the same time. The value of level must be greater than zero. Only one is allowed.

Superelements

fetched-with (sun-cmp-mappings.xml)

Subelements

none - contains data

local-home-impl

Specifies the fully-qualified class name of the generated EJBLocalHome impl class.


Note –

This value is automatically generated by the server at deployment or redeployment time. Do not specify it or change it after deployment.


Superelements

gen-classes (sun-ejb-jar.xml)

Subelements

none - contains data

local-impl

Specifies the fully-qualified class name of the generated EJBLocalObject impl class.


Note –

This value is automatically generated by the server at deployment or redeployment time. Do not specify it or change it after deployment.


Superelements

gen-classes (sun-ejb-jar.xml)

Subelements

none - contains data

locale-charset-info

Deprecated. For backward compatibility only. Use the parameter-encoding subelement of sun-web-app instead. Specifies information about the application’s internationalization settings.

Superelements

sun-web-app (sun-web.xml)

Subelements

The following table describes subelements for the locale-charset-info element.

Table A–56 locale-charset-info Subelements

Element  

Required  

Description  

locale-charset-map

one or more 

Maps a locale and an agent to a character encoding. Provided for backward compatibility. Used only for request processing, and only if no parameter-encoding is defined.

parameter-encoding

zero or one 

Determines the default request character encoding and how the web container decodes parameters from forms according to a hidden field value. 

Attributes

The following table describes attributes for the locale-charset-info element.

Table A–57 locale-charset-info Attributes

Attribute  

Default  

Description  

default-locale

none 

Although a value is required, the value is ignored. Use the default-charset attribute of the parameter-encoding element.

locale-charset-map

Maps locales and agents to character encodings. Provided for backward compatibility. Used only for request processing. Used only if the character encoding is not specified in the request and cannot be derived from the optional parameter-encoding element. For encodings, see http://java.sun.com/j2se/1.4/docs/guide/intl/encoding.doc.html.

Superelements

locale-charset-info (sun-web.xml)

Subelements

The following table describes subelements for the locale-charset-map element.

Table A–58 locale-charset-map Subelements

Element  

Required  

Description  

description

zero or one 

Specifies an optional text description of a mapping. 

Attributes

The following table describes attributes for the locale-charset-map element.

Table A–59 locale-charset-map Attributes

Attribute  

Default  

Description  

locale

none 

Specifies the locale name. 

agent

none 

(optional) Specifies the type of client that interacts with the application server. For a given locale, different agents can have different preferred character encodings. The value of this attribute must exactly match the value of the user-agent HTTP request header sent by the client. See Table A–60 for more information.

charset

none 

Specifies the character encoding to which the locale maps. 

Example Agents

The following table specifies example agent attribute values.

Table A–60 Example agent Attribute Values

Agent  

user-agent Header and agent Attribute Value

Internet Explorer 5.00 for Windows 2000 

Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)

Netscape 4.7.7 for Windows 2000 

Mozilla/4.77 [en] (Windows NT 5.0; U)

Netscape 4.7 for Solaris 

Mozilla/4.7 [en] (X11; u; Sun OS 5.6 sun4u)

localpart

Specifies the local part of a QNAME.

Superelements

service-qname, wsdl-port (sun-web.xml, sun-ejb-jar.xml, sun-application-client.xml)

Subelements

none - contains data

lock-when-loaded

Places a database update lock on the rows corresponding to the bean whenever the bean is loaded. How the lock is placed is database-dependent. The lock is released when the transaction finishes (commit or rollback). While the lock is in place, other database users have read access to the bean.

Superelements

consistency (sun-cmp-mappings.xml)

Subelements

none - element is present or absent

lock-when-modified

This element is not implemented. Do not use.

Superelements

consistency (sun-cmp-mappings.xml)

log-service

Specifies configuration settings for the log file.

Superelements

client-container (sun-acc.xml)

Subelements

The following table describes subelements for the log-service element.

Table A–61 log-service subelement

Element  

Required  

Description  

property (with attributes)

zero or more 

Specifies a property, which has a name and a value. 

Attributes

The following table describes attributes for the log-service element.

Table A–62 log-service attributes

Attribute  

Default  

Description  

log-file

your-ACC-dir/logs/client.log

(optional) Specifies the file where the application client container logging information is stored. 

level

SEVERE

(optional) Sets the base level of severity. Messages at or above this setting get logged to the log file. 

login-config

Specifies the authentication configuration for an EJB web service endpoint. Not needed for servlet web service endpoints. A servlet’s security configuration is contained in the web.xml file.

Superelements

webservice-endpoint (sun-web.xml, sun-ejb-jar.xml)

Subelements

The following table describes subelements for the login-config element.

Table A–63 login-config subelements

Element  

Required  

Description  

auth-method

only one 

Specifies the authentication method.