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

- Previous: L
- Next: N

# M

## manager-properties

Specifies session manager properties.

### Superelements

session-manager (`sun-web.xml`)

### Subelements

The following table describes subelements for the `manager-properties` element.

Table A–61 `manager-properties` Subelements

Element | Required | Description
--- | --- | ---
property (with attributes) | zero or more | Specifies a property, which has a name and a value.

### Properties

The following table describes properties for the `manager-properties` element.

Table A–62 `manager-properties` Properties

Property | Default | Description
--- | --- | ---
`reapIntervalSeconds` | `60` | Specifies the number of seconds between checks for expired sessions. This is also the interval at which sessions are passivated if `maxSessions` is exceeded. To prevent data inconsistency, set this value lower than the frequency at which session data changes. For example, this value should be as low as possible (`1` second) for a hit counter servlet on a frequently accessed web site, or the last few hits might be lost each time the server is restarted. Applicable only if the `persistence-type` attribute of the parent session-manager element is `file`.
`maxSessions` | `-1` | Specifies the maximum number of sessions that are permitted in the cache, or `-1` for no limit. After this, an attempt to create a new session causes an `IllegalStateException` to be thrown. The session manager passivates sessions to the persistent store when this maximum is reached. Applicable only if the `persistence-type` attribute of the parent session-manager element is `file`.
`sessionFilename` | none; state is not preserved across restarts | Specifies the absolute or relative path to the directory in which the session state is preserved between application restarts, if preserving the state is possible. A relative path is relative to the temporary directory for this web application. Applicable only if the `persistence-type` attribute of the parent session-manager element is `memory`.

## mapping-properties

This element is not implemented.

### Superelements

cmp (`sun-ejb-jar.xml`)

## max-cache-size

Specifies the maximum number of beans allowable in cache. A value of zero indicates an unbounded cache. In reality, there is no hard limit. The max-cache-size limit is just a hint to the cache implementation. Default is 512.

Applies to stateful session beans and entity beans.

### Superelements

bean-cache (`sun-ejb-jar.xml`)

### Subelements

none - contains data

## max-pool-size

Specifies the maximum number of bean instances in the pool. Values are from 0 (1 for message-driven bean) to MAX_INTEGER. A value of 0 means the pool is unbounded. Default is 64.

Applies to all beans.

### Superelements

bean-pool (`sun-ejb-jar.xml`)

### Subelements

none - contains data

## max-wait-time-in-millis

This element is deprecated. Do not use.

### Superelements

bean-pool (`sun-ejb-jar.xml`)

## mdb-connection-factory

Specifies the connection factory associated with a message-driven bean. Queue or Topic type must be consistent with the Java Message Service Destination type associated with the message-driven bean class.

### Superelements

ejb (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `mdb-connection-factory` element.

Table A–63 `mdb-connection-factory` Subelements

Element | Required | Description
--- | --- | ---
jndi-name | only one | Specifies the absolute `jndi-name`.
default-resource-principal | zero or one | Specifies the default sign-on (name/password) to the resource manager.

## mdb-resource-adapter

Specifies runtime configuration information for a message-driven bean.

### Superelements

ejb (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `mdb-resource-adapter` element.

Table A–64 `mdb-resource-adapter` subelements

Element | Required | Description
--- | --- | ---
resource-adapter-mid | zero or one | Specifies a resource adapter module ID.
activation-config | one or more | Specifies an activation configuration.

## message

Specifies the methods or operations to which message security requirements apply.

### Superelements

message-security (`sun-web.xml`, `sun-ejb-jar.xml`, `sun-application-client.xml`)

### Subelements

The following table describes subelements for the `message` element.

Table A–65 `message` Subelements

Element | Required | Description
--- | --- | ---
java-method | zero or one | Specifies the methods or operations to which message security requirements apply.
operation-name | zero or one | Specifies the WSDL name of an operation of a web service.

## message-destination

Specifies the name of a logical `message-destination` defined within an application. The `message-destination-name` matches the corresponding `message-destination-name` in the corresponding J2EE deployment descriptor file.

### Superelements

sun-web-app (`sun-web.xml`), enterprise-beans (`sun-ejb-jar.xml`), sun-application-client (`sun-application-client.xml`)

### Subelements

The following table describes subelements for the `message-destination` element.

Table A–66 `message-destination` subelements

Element | Required | Description
--- | --- | ---
message-destination-name | only one | Specifies the name of a logical message destination defined within the corresponding J2EE deployment descriptor file.
jndi-name | only one | Specifies the `jndi-name` of the associated entity.

## message-destination-name

Specifies the name of a logical message destination defined within the corresponding J2EE deployment descriptor file.

### Superelements

message-destination (`sun-web.xml`, `sun-ejb-jar.xml`, `sun-application-client.xml`)

### Subelements

none - contains data

## message-security

Specifies message security requirements.

- If the grandparent element is webservice-endpoint, these requirements pertain to request and response messages of the endpoint.

- If the grandparent element is port-info, these requirements pertain to the port of the referenced service.

### Superelements

message-security-binding (`sun-web.xml`, `sun-ejb-jar.xml`, `sun-application-client.xml`)

### Subelements

The following table describes subelements for the `message-security` element.

Table A–67 `message-security` Subelements

Element | Required | Description
--- | --- | ---
message | one or more | Specifies the methods or operations to which message security requirements apply.
request-protection | zero or one | Defines the authentication policy requirements of the application’s request processing.
response-protection | zero or one | Defines the authentication policy requirements of the application’s response processing.

### message-security-binding

Specifies a custom authentication provider binding for a parent webservice-endpoint or port-info element in one or both of these ways:

- By binding to a specific provider

- By specifying the message security requirements enforced by the provider

### Superelements

webservice-endpoint, port-info (`sun-web.xml`, `sun-ejb-jar.xml`, `sun-application-client.xml`)

### Subelements

The following table describes subelements for the `message-security-binding` element.

Table A–68 `message-security-binding` Subelements

Element | Required | Description
--- | --- | ---
message-security | zero or more | Specifies message security requirements.

### Attributes

The following table describes attributes for the `message-security-binding` element.

Table A–69 `message-security-binding` Attributes

Attribute | Default | Description
--- | --- | ---
`auth-layer` | none | Specifies the message layer at which authentication is performed. The value must be `SOAP`.
`provider-id` | none | (optional) Specifies the authentication provider used to satisfy application-specific message security requirements. If this attribute is not specified, a default provider is used, if it is defined for the message layer. if no default provider is defined, authentication requirements defined in the `message-security-binding` are not enforced.

## message-security-config

Specifies configurations for message security providers.

### Superelements

client-container (`sun-acc.xml`)

### Subelements

The following table describes subelements for the `message-security-config` element.

Table A–70 `message-security-config` Subelements

Element | Required | Description
--- | --- | ---
provider-config | one or more | Specifies a configuration for one message security provider.

### Attributes

The following table describes attributes for the `message-security-config` element.

Table A–71 `message-security-config` Attributes

Attribute | Default | Description
--- | --- | ---
`auth-layer` | none | Specifies the message layer at which authentication is performed. The value must be `SOAP`.
`default-provider` | none | (optional) Specifies the server provider that is invoked for any application not bound to a specific server provider.
`default-client-provider` | none | (optional) Specifies the client provider that is invoked for any application not bound to a specific client provider.

## method

Specifies a bean method.

### Superelements

flush-at-end-of-method (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `method` element.

Table A–72 `method` Subelements

Element | Required | Description
--- | --- | ---
description | zero or one | Specifies an optional text description.
ejb-name | zero or one | Matches the `ejb-name` in the corresponding `ejb-jar.xml` file.
method-name | only one | Specifies a method name.
method-intf | zero or one | Specifies the method interface to distinguish between methods with the same name in different interfaces.
method-params | zero or one | Specifies fully qualified Java type names of method parameters.

## method-intf

Specifies the method interface to distinguish between methods with the same name in different interfaces. Allowed values are `Home`, `Remote`, `LocalHome`, and `Local`.

### Superelements

method (`sun-ejb-jar.xml`)

### Subelements

none - contains data

## method-name

Specifies a method name or `*` (an asterisk) for all methods. If a method is overloaded, specifies all methods with the same name.

### Superelements

java-method (`sun-web.xml`, `sun-ejb-jar.xml`, `sun-application-client.xml`); finder, query-method , method (`sun-ejb-jar.xml`)

### Subelements

none - contains data

### Examples

`<method-name>findTeammates</method-name>`

`<method-name>*</method-name>`

## method-param

Specifies the fully qualified Java type name of a method parameter.

### Superelements

method-params (`sun-web.xml`, `sun-ejb-jar.xml`, `sun-application-client.xml`)

### Subelements

none - contains data

## method-params

Specifies fully qualified Java type names of method parameters.

### Superelements

java-method (`sun-web.xml`, `sun-ejb-jar.xml`, `sun-application-client.xml`); query-method, method (`sun-ejb-jar.xml`)

### Subelements

The following table describes subelements for the `method-params` element.

Table A–73 `method-params` Subelements

Element | Required | Description
--- | --- | ---
method-param | zero or more | Specifies the fully qualified Java type name of a method parameter.

- Previous: L
- Next: N

- © 2010, Oracle Corporation and/or its affiliates