Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer's Guide

- Previous: K
- Next: M

# 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–53 `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–54 `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–55 `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–56 `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–57 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–57 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–58 `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–59 `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–60 `login-config` subelements

Element | Required | Description
--- | --- | ---
auth-method | only one | Specifies the authentication method.

- Previous: K
- Next: M

- © 2010, Oracle Corporation and/or its affiliates