Sun GlassFish Enterprise Server v3 Prelude Application Deployment Guide

L

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.



Note –

This element is not implemented for GlassFish v3 Prelude.


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.



Note –

This element is not implemented for GlassFish v3 Prelude.


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–42 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–43 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.5.0/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–44 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–45 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–46 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–46 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)

Subelements

none - contains data

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–47 login-config subelements

Element 

Required 

Description 

auth-method

only one 

Specifies the authentication method. 

realm

zero or one 

Specifies the name of the realm used to process all authentication requests.