WildFly 34 Model Reference

The configuration of the ejb3 subsystem.

Children (12)

application-security-domain A mapping from a security domain referenced in a deployed application
cache A SFSB cache
cluster-passivation-store A clustered passivation store
distributable-cache A SFSB cache which is distributable
file-passivation-store A file system based passivation store
mdb-delivery-group Delivery group to manage delivery for mdbs
passivation-store A passivation store
remoting-profile A remoting profile
service Centrally configurable services that are part of the Enterprise Beans 3 subsystem.

async The Enterprise Beans 3 Asynchronous Invocation Service
identity Identity definition for security identity propagation
iiop The IIOP service
remote The Enterprise Beans 3 Remote Service
timer-service The Jakarta Enterprise Beans timer service

simple-cache A SFSB cache which is non-distributable
strict-max-bean-instance-pool A bean instance pool with a strict upper limit
thread-pool A Jakarta Enterprise Beans thread pool

Provided capabilities(5)

Name	Dynamic	Other provider points
org.wildfly.ejb3.clustered.singleton	false	none
org.wildfly.ejb.stateful.default-cache	false	none
org.wildfly.ejb.stateful.passation-disabled-cache	false	none
org.wildfly.ejb3	false	none
org.wildfly.ejb3.remote.client-configurator	false	none

Attributes (23)

allow-ejb-name-regex If this is true then regular expressions can be used in interceptor bindings to allow interceptors to be mapped to all beans that match the regular expression

Attribute	Value
Default Value	false
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

client-interceptors Client interceptor definitions.

Attribute	Value
Type	LIST
Nillable	true
Expressions Allowed	false
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-clustered-sfsb-cache Name of the default stateful bean cache, which will be applicable to all clustered stateful Jakarta Enterprise Beans, unless overridden at the deployment or bean level

Deprecated Since 2.0.0

Not supported on current version servers; only allowed in managed domain profiles for use on servers running earlier versions.

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-only
Stability	default

default-distinct-name The default distinct name that is applied to every Jakarta Enterprise Beans deployed on this server

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-entity-bean-instance-pool Name of the default entity bean instance pool, which will be applicable to all entity beans, unless overridden at the deployment or bean level

Deprecated Since 10.0.0

Not supported on current version servers; only allowed in managed domain profiles for use on servers running earlier versions.

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-entity-bean-optimistic-locking If set to true entity beans will use optimistic locking by default

Deprecated Since 10.0.0

Not supported on current version servers; only allowed in managed domain profiles for use on servers running earlier versions.

Attribute	Value
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-mdb-instance-pool Name of the default MDB instance pool, which will be applicable to all MDBs, unless overridden at the deployment or bean level

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-missing-method-permissions-deny-access If this is set to true then methods on Jakarta Enterprise Beans with a security domain specified or with other methods with security metadata will have an implicit @DenyAll unless other security metadata is present

Attribute	Value
Default Value	false
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-resource-adapter-name Name of the default resource adapter name that will be used by MDBs, unless overridden at the deployment or bean level

Attribute	Value
Default Value	activemq-ra
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-security-domain The default security domain that will be used for Jakarta Enterprise Beans if the bean doesn't explicitly specify one

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-sfsb-cache Name of the default stateful bean cache, which will be applicable to all stateful Jakarta Enterprise Beans, unless overridden at the deployment or bean level

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-sfsb-passivation-disabled-cache Name of the default stateful bean cache, which will be applicable to all stateful Jakarta Enterprise Beans that have passivation disabled. Each deployment or Jakarta Enterprise Beans can optionally override this cache name.

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-singleton-bean-access-timeout The default access timeout for singleton beans

Attribute	Value
Default Value	5000
Type	LONG
Nillable	true
Expressions Allowed	true
Min	1
Max	2,147,483,647
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-slsb-instance-pool Name of the default stateless bean instance pool, which will be applicable to all stateless Jakarta Enterprise Beans, unless overridden at the deployment or bean level

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-stateful-bean-access-timeout The default access timeout for stateful beans

Attribute	Value
Default Value	5000
Type	LONG
Nillable	true
Expressions Allowed	true
Min	1
Max	2,147,483,647
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

default-stateful-bean-session-timeout The default session timeout for stateful beans. Modification to this attribute takes effect immediately for subsequent deployments; for Jakarta Enterprise Beans already deployed, redeploying is needed to use the new value.

Attribute	Value
Type	LONG
Nillable	true
Expressions Allowed	true
Min	-1
Max	2,147,483,647
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

disable-default-ejb-permissions This deprecated attribute has no effect and will be removed in a future release; it may never be set to a "false" value

Deprecated Since 3.0.0

Adding default permissions to Jakarta Enterprise Beans deployments is no longer supported and this configuration attribute will be removed in a future release

Attribute	Value
Default Value	true
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

enable-graceful-txn-shutdown Enabling txn graceful shutdown will make the server wait for active remote Jakarta Enterprise Beans-related transactions to complete before suspending. For that reason, if the server is running on a cluster, the suspending cluster node may receive Jakarta Enterprise Beans requests until all active remote transactions are complete. To avoid this behavior, omit this tag. This attribute has no effect on local Jakarta Enterprise Beans-related transactions.

Attribute	Value
Default Value	false
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

enable-statistics If set to true, enable the collection of invocation statistics. Deprecated in favour of "statistics-enabled"

Deprecated Since 5.0.0

If set to true, enable the collection of invocation statistics. Deprecated in favour of "statistics-enabled"

Attribute	Value
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

in-vm-remote-interface-invocation-pass-by-value If set to false, the parameters to invocations on the remote interface of a Jakarta Enterprise Beans, will be passed by reference. Else, the parameters will be passed by value.

Attribute	Value
Default Value	true
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

log-system-exceptions If this is true then all Jakarta Enterprise Beans system (not application) exceptions will be logged. The Jakarta Enterprise Beans spec mandates this behaviour, however, it is not recommended as it will often result in exceptions being logged twice (once by the Jakarta Enterprise Beans and once by the calling code)

Attribute	Value
Default Value	true
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

server-interceptors Server interceptor definitions.

Attribute	Value
Type	LIST
Nillable	true
Expressions Allowed	false
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

statistics-enabled If set to true, enable the collection of invocation statistics.

Attribute	Value
Default Value	false
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Stability	default

Operations (2)

add Adds the ejb3 subsystem.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
default-entity-bean-instance-pool	STRING	false	true		Name of the default entity bean instance pool, which will be applicable to all entity beans, unless overridden at the deployment or bean level
default-entity-bean-optimistic-locking	BOOLEAN	false	true		If set to true entity beans will use optimistic locking by default
default-mdb-instance-pool	STRING	false	true		Name of the default MDB instance pool, which will be applicable to all MDBs, unless overridden at the deployment or bean level
default-resource-adapter-name	STRING	false	true	activemq-ra	Name of the default resource adapter name that will be used by MDBs, unless overridden at the deployment or bean level
default-sfsb-cache	STRING	false	true		Name of the default stateful bean cache, which will be applicable to all stateful Jakarta Enterprise Beans, unless overridden at the deployment or bean level
default-singleton-bean-access-timeout	LONG	false	true	5000	The default access timeout for singleton beans
default-slsb-instance-pool	STRING	false	true		Name of the default stateless bean instance pool, which will be applicable to all stateless Jakarta Enterprise Beans, unless overridden at the deployment or bean level
default-stateful-bean-access-timeout	LONG	false	true	5000	The default access timeout for stateful beans
default-stateful-bean-session-timeout	LONG	false	true		The default session timeout for stateful beans. Modification to this attribute takes effect immediately for subsequent deployments; for Jakarta Enterprise Beans already deployed, redeploying is needed to use the new value.
statistics-enabled	BOOLEAN	false	true	false	If set to true, enable the collection of invocation statistics.
enable-statistics	BOOLEAN	false	true		If set to true, enable the collection of invocation statistics. Deprecated in favour of "statistics-enabled"
in-vm-remote-interface-invocation-pass-by-value	BOOLEAN	false	true	true	If set to false, the parameters to invocations on the remote interface of a Jakarta Enterprise Beans, will be passed by reference. Else, the parameters will be passed by value.
default-distinct-name	STRING	false	true		The default distinct name that is applied to every Jakarta Enterprise Beans deployed on this server
default-security-domain	STRING	false	true		The default security domain that will be used for Jakarta Enterprise Beans if the bean doesn't explicitly specify one
default-missing-method-permissions-deny-access	BOOLEAN	false	true	false	If this is set to true then methods on Jakarta Enterprise Beans with a security domain specified or with other methods with security metadata will have an implicit @DenyAll unless other security metadata is present
default-sfsb-passivation-disabled-cache	STRING	false	true		Name of the default stateful bean cache, which will be applicable to all stateful Jakarta Enterprise Beans that have passivation disabled. Each deployment or Jakarta Enterprise Beans can optionally override this cache name.
disable-default-ejb-permissions	BOOLEAN	false	true	true	This deprecated attribute has no effect and will be removed in a future release; it may never be set to a "false" value
enable-graceful-txn-shutdown	BOOLEAN	false	true	false	Enabling txn graceful shutdown will make the server wait for active remote Jakarta Enterprise Beans-related transactions to complete before suspending. For that reason, if the server is running on a cluster, the suspending cluster node may receive Jakarta Enterprise Beans requests until all active remote transactions are complete. To avoid this behavior, omit this tag. This attribute has no effect on local Jakarta Enterprise Beans-related transactions.
log-system-exceptions	BOOLEAN	false	true	true	If this is true then all Jakarta Enterprise Beans system (not application) exceptions will be logged. The Jakarta Enterprise Beans spec mandates this behaviour, however, it is not recommended as it will often result in exceptions being logged twice (once by the Jakarta Enterprise Beans and once by the calling code)
allow-ejb-name-regex	BOOLEAN	false	true	false	If this is true then regular expressions can be used in interceptor bindings to allow interceptors to be mapped to all beans that match the regular expression
server-interceptors	LIST	false	false		Server interceptor definitions.
client-interceptors	LIST	false	false		Client interceptor definitions.
default-clustered-sfsb-cache	STRING	false	true		Name of the default stateful bean cache, which will be applicable to all clustered stateful Jakarta Enterprise Beans, unless overridden at the deployment or bean level

remove Removes the ejb3 subsystem.