Describes the sas-context fields.
ior-security-config (sun-ejb-jar.xml)
The following table describes subelements for the sas-context element.
Table A–99 sas-context Subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies whether the target accepts propagated caller identities. The values are NONE, SUPPORTED, or REQUIRED. |
Specifies the file that contains a description of the database schema to which the beans in this sun-cmp-mappings.xml file are mapped. If this element is empty, the database schema file is automatically generated at deployment time. Otherwise, the schema element names a .dbschema file with a pathname relative to the directory containing the sun-cmp-mappings.xml file, but without the .dbschema extension. See Automatic Database Schema Capture in Sun GlassFish Enterprise Server 2.1 Developer’s Guide.
sun-cmp-mapping (sun-cmp-mappings.xml)
none - contains data
<schema/> <!-- use automatic schema generation -->
<schema>CompanySchema</schema> <!-- use "CompanySchema.dbschema" -->
Specifies field-specific column attributes in property subelements.
cmp-resource (sun-ejb-jar.xml)
The following table describes subelements for the schema-generator-properties element.
Table A–100 schema-generator-properties Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property name and value. |
The following table describes properties for the schema-generator-properties element.
Table A–101 schema-generator-properties Properties
Property |
Default |
Description |
---|---|---|
false |
Specifies that generated table names are unique within each application server domain. This property can be overridden during deployment. See Generation Options for CMP in Sun GlassFish Enterprise Server 2.1 Developer’s Guide. |
|
bean-name.field-name.attribute |
none |
Defines a column attribute. For attribute descriptions, see Table A–102. |
The following table lists the column attributes for properties defined in the schema-generator-properties element.
Table A–102 schema-generator-properties Column Attributes
Attribute |
Description |
---|---|
jdbc-type |
Specifies the JDBC type of the column created for the CMP field. The actual SQL type generated is based on this JDBC type but is database vendor specific. |
jdbc-maximum-length |
Specifies the maximum number of characters stored in the column corresponding to the CMP field. Applies only when the actual SQL that is generated for the column requires a length. For example, a jdbc-maximum-length of 32 on a CMP String field such as firstName normally results in a column definition such as VARCHAR(32). But if the jdbc-type is CLOB and you are deploying on Oracle, the resulting column definition is CLOB. No length is given, because in an Oracle database, a CLOB has no length. |
jdbc-precision |
Specifies the maximum number of digits stored in a column which represents a numeric type. |
jdbc-scale |
Specifies the number of digits stored to the right of the decimal point in a column that represents a floating point number. |
jdbc-nullable |
Specifies whether the column generated for the CMP field allows null values. |
<schema-generator-properties> <property> <name>Employee.firstName.jdbc-type</name> <value>char</value> </property> <property> <name>Employee.firstName.jdbc-maximum-length</name> <value>25</value> </property> <property> <name>use-unique-table-names</name> <value>true</value> </property> </schema-generator-properties>
Specifies a bean’s secondary table(s).
entity-mapping (sun-cmp-mappings.xml)
The following table describes subelements for the secondary-table element.
Table A–103 secondary table Subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the name of a database table. |
|
one or more |
Specifies the pair of columns that determine the relationship between two database tables. |
Defines the SSL security configuration for IIOP/SSL communication with the target server.
target-server (sun-acc.xml)
The following table describes subelements for the security element.
Table A–104 security Subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the SSL processing parameters. |
|
only one |
Not implemented. Included for backward compatibility only. |
Maps roles to users or groups in the currently active realm. See Realm Configuration in Sun GlassFish Enterprise Server 2.1 Developer’s Guide.
The role mapping element maps a role, as specified in the EJB JAR role-name entries, to a environment-specific user or group. If it maps to a user, it must be a concrete user which exists in the current realm, who can log into the server using the current authentication method. If it maps to a group, the realm must support groups and the group must be a concrete group which exists in the current realm. To be useful, there must be at least one user in that realm who belongs to that group.
sun-application (sun-application.xml), sun-web-app (sun-web.xml), sun-ejb-jar (sun-ejb-jar.xml)
The following table describes subelements for the security-role-mapping element.
Table A–105 security-role-mapping Subelements
Element |
Required |
Description |
---|---|---|
only one |
Contains the role-name in the security-role element of the corresponding Java EE deployment descriptor file. |
|
one or more if no group-name, otherwise zero or more |
Contains a principal (user) name in the current realm. In an enterprise bean, the principal must have the run-as role specified. |
|
one or more if no principal-name, otherwise zero or more |
Contains a group name in the current realm. |
Specifies the web service reference name relative to java:comp/env.
port-info (sun-web.xml, sun-ejb-jar.xml, sun-application-client.xml)
none - contains data
Specifies the name of the generated service implementation class.
service-ref (sun-web.xml, sun-ejb-jar.xml, sun-application-client.xml)
none - contains data
Specifies the WSDL service element that is being referred to.
service-ref (sun-web.xml, sun-ejb-jar.xml, sun-application-client.xml); webservice-endpoint (sun-web.xml, sun-ejb-jar.xml)
The following table describes subelements for the service-qname element.
Table A–106 service-qname subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the namespace URI. |
|
only one |
Specifies the local part of a QNAME. |
Specifies runtime settings for a web service reference. Runtime information is only needed in the following cases:
To define the port used to resolve a container-managed port
To define the default Stub/Call property settings for Stub objects
To define the URL of a final WSDL document to be used instead of the one associated with the service-ref in the standard Java EE deployment descriptor
sun-web-app (sun-web.xml), ejb (sun-ejb-jar.xml), sun-application-client (sun-application-client.xml)
The following table describes subelements for the service-ref element.
Table A–107 service-ref subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the web service reference name relative to java:comp/env. |
|
zero or more |
Specifies information for a port within a web service reference. |
|
zero or more |
Specifies JAX-RPC property values that can be set on a javax.xml.rpc.Call object before it is returned to the web service client. |
|
zero or one |
Specifies a valid URL pointing to a final WSDL document. |
|
zero or one |
Specifies the name of the generated service implementation class. |
|
zero or one |
Specifies the WSDL service element that is being referenced. |
Specifies the web service reference name relative to java:comp/env.
service-ref (sun-web.xml, sun-ejb-jar.xml, sun-application-client.xml)
none - contains data
Specifies a principal name for a servlet. Used for the run-as role defined in web-xml.
sun-web-app (sun-web.xml)
The following table describes subelements for the servlet element.
Table A–108 servlet Subelements
Element |
Required |
Description |
---|---|---|
only one |
Contains the name of a servlet, which is matched to a servlet-name in web.xml. |
|
zero or one |
Contains a principal (user) name in the current realm. |
|
zero or more |
Specifies information about a web service endpoint. |
Specifies the automatically generated name of the servlet implementation class.
webservice-endpoint (sun-web.xml, sun-ejb-jar.xml)
none - contains data
Specifies the name of a servlet, which is matched to a servlet-name in web.xml. This name must be present in web.xml.
cache-mapping, servlet (sun-web.xml)
none - contains data
Specifies session configuration information. Overrides the web container settings for an individual web module.
sun-web-app (sun-web.xml)
The following table describes subelements for the session-config element.
Table A–109 session-config Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Specifies session manager configuration information. |
|
zero or one |
Specifies session properties. |
|
zero or one |
Specifies session cookie properties. |
Specifies session manager information.
session-config (sun-web.xml)
The following table describes subelements for the session-manager element.
Table A–110 session-manager Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Specifies session manager properties. |
|
zero or one |
Specifies session persistence (storage) properties. |
The following table describes attributes for the session-manager element.
Table A–111 session-manager Attributes
Attribute |
Default |
Description |
---|---|---|
memory |
(optional) Specifies the session persistence mechanism. Allowed values are memory, file, and replicated. If HADB is installed and you have selected the enterprise profile, you can also specify ha. For production environments that require session persistence, use ha. |
Specifies session properties.
session-config (sun-web.xml)
The following table describes subelements for the session-properties element.
Table A–112 session-properties Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property, which has a name and a value. |
The following table describes properties for the session-properties element.
Table A–113 session-properties Properties
Defines SSL processing parameters.
security (sun-acc.xml)
none
The following table describes attributes for the SSL element.
Table A–114 ssl attributes
Attribute |
Default |
Description |
---|---|---|
s1as |
(optional) The nickname of the server certificate in the certificate database or the PKCS#11 token. In the certificate, the name format is tokenname:nickname. Including the tokenname: part of the name in this attribute is optional. |
|
false |
(optional) Determines whether SSL2 is enabled. |
|
none |
(optional) A space-separated list of the SSL2 ciphers used with the prefix + to enable or - to disable. For example, +rc4. Allowed values are rc4, rc4export, rc2, rc2export, idea, des, desede3. |
|
true |
(optional) Determines whether SSL3 is enabled. |
|
none |
(optional) A space-separated list of the SSL3 ciphers used, with the prefix + to enable or - to disable, for example +SSL_RSA_WITH_RC4_128_MD5. Allowed values are SSL_RSA_WITH_RC4_128_MD5, SSL_RSA_WITH_3DES_EDE_CBC_SHA, SSL_RSA_WITH_DES_CBC_SHA, SSL_RSA_EXPORT_WITH_RC4_40_MD5, SSL_RSA_WITH_NULL_MD5, SSL_RSA_WITH_RC4_128_SHA, and SSL_RSA_WITH_NULL_SHA. Values available in previous releases are supported for backward compatibility. |
|
true |
(optional) Determines whether TLS is enabled. |
|
true |
(optional) Determines whether TLS rollback is enabled. Enable TLS rollback for Microsoft Internet Explorer 5.0 and 5.5. |
Specifies the initial and minimum number of bean instances that are maintained in the pool. Default is 32. Applies to stateless session beans and message-driven beans.
bean-pool (sun-ejb-jar.xml)
none - contains data
Specifies session persistence (storage) properties.
session-manager (sun-web.xml)
The following table describes subelements for the store-properties element.
Table A–115 store-properties Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property, which has a name and a value. |
The following table describes properties for the store-properties element.
Table A–116 store-properties Properties
Property |
Default |
Description |
---|---|---|
domain-dir/generated/jsp/j2ee-apps/app-name/app-name_war |
Specifies the absolute or relative pathname of the directory into which individual session files are written. A relative path is relative to the temporary work directory for this web module. Applicable only if the persistence-type attribute of the parent session-manager element is file. |
|
session |
Specifies how much of the session state is stored. Allowed values are as follows:
Applicable only if the persistence-type attribute of the parent session-manager element is ha or replicated. |
If the persistenceScope store property is set to modified-attribute, a web module must follow these guidelines:
Call setAttribute() every time the session state is modified.
Make sure there are no cross-references between attributes. The object graph under each distinct attribute key is serialized and stored separately. If there are any object cross references between the objects under each separate key, they are not serialized and deserialized correctly.
Distribute the session state across multiple attributes, or at least between a read-only attribute and a modifiable attribute.
Specifies JAX-RPC property values that are set on a javax.xml.rpc.Stub object before it is returned to the web service client. The property names can be any properties supported by the JAX-RPC Stub implementation.
port-info (sun-web.xml, sun-ejb-jar.xml, sun-application-client.xml)
The following table describes subelements for the stub-property element.
Table A–117 stub-property subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the name of the entity. |
|
only one |
Specifies the value of the entity. |
The following table describes properties for the stub-property element.
Table A–118 stub-property properties
Property |
Default |
Description |
---|---|---|
true |
Determines whether the visibility of this endpoint as a Java Business Integration service is enabled or disabled. |
<service-ref> <service-ref-name>service/FooProxy</service-ref-name> <port-info> <service-endpoint-interface>a.FooPort</service-endpoint-interface> <wsdl-port> <namespaceURI>urn:Foo</namespaceURI> <localpart>FooPort</localpart> </wsdl-port> <stub-property> <name>javax.xml.rpc.service.endpoint.address</name> <value>http://localhost:8080/a/Foo</value> </stub-property> </port-info> </service-ref>
Defines the Enterprise Server specific configuration for an application. This is the root element; there can only be one sun-application element in a sun-application.xml file. See The sun-application.xml File.
none
The following table describes subelements for the sun-application element.
Table A–119 sun-application Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies the application’s web tier configuration. |
|
zero or one |
Determines whether EJB modules use pass-by-value or pass-by-reference semantics. |
|
zero or one |
Contains the unique ID for the application. |
|
zero or more |
Maps a role in the corresponding Java EE XML file to a user or group. |
|
zero or one |
Specifies an authentication realm. |
Defines the Enterprise Server specific configuration for an application client. This is the root element; there can only be one sun-application-client element in a sun-application-client.xml file. See The sun-application-client.xml file.
none
The following table describes subelements for the sun-application-client element.
Table A–120 sun-application-client subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Maps the absolute JNDI name to the ejb-ref in the corresponding Java EE XML file. |
|
zero or more |
Maps the absolute JNDI name to the resource-ref in the corresponding Java EE XML file. |
|
zero or more |
Maps the absolute JNDI name to the resource-env-ref in the corresponding Java EE XML file. |
|
zero or more |
Specifies runtime settings for a web service reference. |
|
zero or more |
Specifies the name of a logical message destination. |
|
zero or more |
Specifies the name of a physical message destination. |
|
zero or one |
Specifies changes to default Java Web Start parameters. |
Specifies beans mapped to a particular database schema.
A bean cannot be related to a bean that maps to a different database schema, even if the beans are deployed in the same EJB JAR file.
sun-cmp-mappings (sun-cmp-mappings.xml)
The following table describes subelements for the sun-cmp-mapping element.
Table A–121 sun-cmp-mapping Subelements
Element |
Required |
Description |
---|---|---|
only one |
Specifies the file that contains a description of the database schema. |
|
one or more |
Specifies the mapping of a bean to database columns. |
Defines the Enterprise Server specific CMP mapping configuration for an EJB JAR file. This is the root element; there can only be one sun-cmp-mappings element in a sun-cmp-mappings.xml file. See The sun-cmp-mappings.xml File.
none
The following table describes subelements for the sun-cmp-mappings element.
Table A–122 sun-cmp-mappings Subelements
Element |
Required |
Description |
---|---|---|
one or more |
Specifies beans mapped to a particular database schema. |
Defines the Enterprise Server specific configuration for an EJB JAR file. This is the root element; there can only be one sun-ejb-jar element in a sun-ejb-jar.xml file. See The sun-ejb-jar.xml File.
none
The following table describes subelements for the sun-ejb-jar element.
Table A–123 sun-ejb-jar Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Maps a role in the corresponding Java EE XML file to a user or group. |
|
only one |
Describes all the runtime properties for an EJB JAR file in the application. |
Defines Enterprise Server specific configuration for a web module. This is the root element; there can only be one sun-web-app element in a sun-web.xml file. See The sun-web.xml File.
none
The following table describes subelements for the sun-web-app element.
Table A–124 sun-web-app Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Contains the web context root for the web application. |
|
zero or more |
Maps roles to users or groups in the currently active realm. |
|
zero or more |
Specifies a principal name for a servlet, which is used for the run-as role defined in web.xml. |
|
zero or more |
Specifies a URL pattern for idempotent requests. |
|
zero or one |
Specifies session manager, session cookie, and other session-related information. |
|
zero or more |
Maps the absolute JNDI name to the ejb-ref in the corresponding Java EE XML file. |
|
zero or more |
Maps the absolute JNDI name to the resource-ref in the corresponding Java EE XML file. |
|
zero or more |
Maps the absolute JNDI name to the resource-env-ref in the corresponding Java EE XML file. |
|
zero or more |
Specifies runtime settings for a web service reference. |
|
zero or more |
Specifies the name of a physical message destination. |
|
zero or one |
Configures caching for web application components. |
|
zero or one |
Specifies class loader configuration information. |
|
zero or one |
Specifies JSP configuration information. |
|
zero or one |
Deprecated. Use the parameter-encoding subelement of sun-web-app instead. |
|
zero or one |
Determines the default request character encoding and how the web container decodes parameters from forms according to a hidden field value. |
|
zero or more |
Specifies a property, which has a name and a value. |
|
zero or more |
Specifies the name of a logical message destination. |
|
zero or more |
Specifies a name and optional publish location for a web service. |
The following table describes attributes for the sun-web-app element.
Table A–125 sun-web-app Attributes
Attribute |
Default |
Description |
---|---|---|
(blank) |
(optional) Not implemented. Do not use. |
|
none |
(optional) Specifies the HttpServlet message layer provider that the web container's servlet auth-constraint processing calls. |
The following table describes properties for the sun-web-app element.
Table A–126 sun-web-app Properties
Property |
Default |
Description |
---|---|---|
false |
If true, resources in this web application that are symbolic links are served. You can also define this property for a virtual server. Web applications on the virtual server that do not define this property use the virtual server's value. For details, see virtual-server in Sun GlassFish Enterprise Server 2.1 Administration Reference. Caution – Setting this property to true on Windows systems exposes JSP source code. |
|
none |
Specifies an alternate document root (docroot), where n is a positive integer that allows specification of more than one. Alternate docroots allow web applications to serve requests for certain resources from outside their own docroot, based on whether those requests match one (or more) of the URI patterns of the web application's alternate docroots. If a request matches an alternate docroot's URI pattern, it is mapped to the alternate docroot by appending the request URI (minus the web application's context root) to the alternate docroot's physical location (directory). If a request matches multiple URI patterns, the alternate docroot is determined according to the following precedence order:
For example, the following properties specify three alternate docroots. The URI pattern of the first alternate docroot uses an exact match, whereas the URI patterns of the second and third alternate docroots use extension and longest path prefix matches, respectively. <property name="alternatedocroot_1" value="from=/my.jpg dir=/srv/images/jpg"/> <property name="alternatedocroot_2" value="from=*.jpg dir=/srv/images/jpg"/> <property name="alternatedocroot_3" value="from=/jpg/* dir=/src/images"/> The value of each alternate docroot has two components: The first component, from, specifies the alternate docroot's URI pattern, and the second component, dir, specifies the alternate docroot's physical location (directory). Spaces are allowed in the dir component. You can set this property for all the web applications on a specific virtual server. For details, see virtual-server in Sun GlassFish Enterprise Server 2.1 Administration Reference. |
|
true |
If true, allows this web application to access the contexts of other web applications using the ServletContext.getContext()method. |
|
false |
If true, allows this web application to send a relative URL to the client using HttpServletResponse.sendRedirect(), and instructs the web container not to translate any relative URLs to fully qualified ones. |
|
false |
If true, sessions generated for this web application use the session ID specified in the request. |
|
true |
Set this property to false to ensure that for this web application file downloads using SSL work properly in Internet Explorer. You can set this property for all the web applications on a specific virtual server. For details, see virtual-server in Sun GlassFish Enterprise Server 2.1 Administration Reference. |
|
5 |
Specifies the maximum number of servlet instances allocated for each SingleThreadModel servlet in the web application. |
|
domain-dir/generated/j2ee-apps/app-name or domain-dir/generated/j2ee-modules/module-name |
Specifies a temporary directory for use by this web module. This value is used to construct the value of the javax.servlet.context.tempdir context attribute. Compiled JSP files are also placed in this directory. |
|
false |
If true, response headers are encoded using the response’s charset instead of the default (UTF-8). |