WildFly Full 21 Model Reference

The configuration of the ejb3 subsystem.

Children (10)

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
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 EJB3 subsystem.

async The EJB3 Asynchronous Invocation Service
identity Identity definition for security identity propagation
iiop The IIOP service
remote The EJB3 Remote Service
timer-service The EJB timer service

strict-max-bean-instance-pool A bean instance pool with a strict upper limit
thread-pool An EJB thread pool

Provided capabilities(3)

Name	Dynamic	Other provider points
org.wildfly.ejb3.clustered.singleton	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

client-interceptors Client interceptor definitions.

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

default-clustered-sfsb-cache Name of the default stateful bean cache, which will be applicable to all clustered stateful EJBs, 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

default-distinct-name The default distinct name that is applied to every EJB deployed on this server

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

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

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

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

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

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

default-missing-method-permissions-deny-access If this is set to true then methods on an EJB 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

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

default-security-domain The default security domain that will be used for EJBs 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

default-sfsb-cache Name of the default stateful bean cache, which will be applicable to all stateful EJBs, 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

default-sfsb-passivation-disabled-cache Name of the default stateful bean cache, which will be applicable to all stateful EJBs which have passivation disabled. Each deployment or EJB 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

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

default-slsb-instance-pool Name of the default stateless bean instance pool, which will be applicable to all stateless EJBs, 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

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

default-stateful-bean-session-timeout The default session timeout for stateful beans. Modification to this attribute takes effect immediately for subsequent deployments; for EJBs 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

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 EJB 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

enable-graceful-txn-shutdown Enabling txn graceful shutdown will make the server wait for active EJB-related transactions to complete before suspending. For that reason, if the server is running on a cluster, the suspending cluster node may receive ejb requests until all active transactions are complete. To avoid this behavior, omit this tag.

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

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

in-vm-remote-interface-invocation-pass-by-value If set to false, the parameters to invocations on remote interface of an EJB, 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

log-system-exceptions If this is true then all EJB system (not application) exceptions will be logged. The EJB spec mandates this behaviour, however it is not recommended as it will often result in exceptions being logged twice (once by the EJB 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

server-interceptors Server interceptor definitions.

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

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

Operations (2)

add Adds the ejb3 subsystem.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
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
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 EJBs, unless overridden at the deployment or bean level
default-distinct-name	STRING	false	true		The default distinct name that is applied to every EJB deployed on this server
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-missing-method-permissions-deny-access	BOOLEAN	false	true	false	If this is set to true then methods on an EJB with a security domain specified or with other methods with security metadata will have an implicit @DenyAll unless other security metadata is present
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-security-domain	STRING	false	true		The default security domain that will be used for EJBs if the bean doesn't explicitly specify one
default-sfsb-cache	STRING	false	true		Name of the default stateful bean cache, which will be applicable to all stateful EJBs, unless overridden at the deployment or bean level
default-sfsb-passivation-disabled-cache	STRING	false	true		Name of the default stateful bean cache, which will be applicable to all stateful EJBs which have passivation disabled. Each deployment or EJB can optionally override this cache name.
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 EJBs, 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 EJBs already deployed, redeploying is needed to use the new value.
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 EJB-related transactions to complete before suspending. For that reason, if the server is running on a cluster, the suspending cluster node may receive ejb requests until all active transactions are complete. To avoid this behavior, omit this tag.
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 remote interface of an EJB, will be passed by reference. Else, the parameters will be passed by value.
log-system-exceptions	BOOLEAN	false	true	true	If this is true then all EJB system (not application) exceptions will be logged. The EJB spec mandates this behaviour, however it is not recommended as it will often result in exceptions being logged twice (once by the EJB and once by the calling code)
server-interceptors	LIST	false	false		Server interceptor definitions.
statistics-enabled	BOOLEAN	false	true	false	If set to true, enable the collection of invocation statistics.

remove Removes the ejb3 subsystem.