Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

Ce contenu n'est pas disponible dans la langue sélectionnée.

Appendix A. Reference Material

A.1. EJB Java Naming and Directory Interface Reference
Copier lien

The Java Naming and Directory Interface lookup name for a session bean uses the following syntax: 

ejb:<appName>/<moduleName>/<distinctName>/<beanName>!<viewClassName>?stateful
Copy to Clipboard Toggle word wrap
  • <appName>: If the session bean’s JAR file has been deployed within an enterprise archive (EAR) then the appName is the name of the respective EAR. By default, the name of an EAR is its file name without the .ear suffix. The application name can be overridden in its application.xml file. If the session bean is not deployed in an EAR, then leave the appName blank.
  • <moduleName>: The moduleName is the name of the JAR file in which the session bean is deployed. The default name of the JAR file is its file name without the .jar suffix. The module name can be overridden in the JAR’s ejb-jar.xml file.
  • <distinctName>: JBoss EAP allows each deployment to specify an optional distinct name. If the deployment does not have a distinct name, then leave the distinctName blank.
  • <beanName>: The beanName is the simple class name of the session bean to be invoked.
  • <viewClassName>: The viewClassName is the fully qualified class name of the remote interface. This includes the package name of the interface.
  • ?stateful: The ?stateful suffix is required when the Java Naming and Directory Interface name refers to a stateful session bean. It is not included for other bean types.

For example, if we deployed hello.jar having a stateful bean org.jboss.example.HelloBean that exposed a remote interface org.jboss.example.Hello, then the Java Naming and Directory Interface lookup name would be: 

ejb:/hello/HelloBean!org.jboss.example.Hello?stateful"
Copy to Clipboard Toggle word wrap

A.2. EJB Reference Resolution
Copier lien

This section covers how JBoss EAP implements @EJB and @Resource. Please note that XML always overrides annotations but the same rules apply.

Rules for the @EJB annotation
  • The @EJB annotation also has a mappedName() attribute. The specification leaves this as vendor specific metadata, but JBoss EAP recognizes mappedName() as the global Java Naming and Directory Interface name of the EJB you are referencing. If you have specified a mappedName(), then all other attributes are ignored and this global Java Naming and Directory Interface name is used for binding.

  • If you specify @EJB with no attributes defined: 

    @EJB
ProcessPayment myEjbref;
    Copy to Clipboard Toggle word wrap

    Then the following rules apply:

    • The EJB JAR of the referencing bean is searched for an EJB with the interface used in the @EJB injection. If there are more than one EJB that publishes same business interface, then an exception is thrown. If there is only one bean with that interface then that one is used.
    • Search the EAR for EJB that publish that interface. If there are duplicates, then an exception is thrown. Otherwise the matching bean is returned.
    • Search globally in JBoss EAP runtime for an EJB of that interface. Again, if duplicates are found, an exception is thrown.
  • @EJB.beanName() corresponds to <ejb-link>. If the beanName() is defined, then use the same algorithm as @EJB with no attributes defined except use the beanName() as a key in the search. An exception to this rule is if you use the ejb-link # syntax: it allows you to put a relative path to a JAR in the EAR where the EJB you are referencing is located. Refer to the EJB 3.2 specification for more details.

A.3. Project Dependencies for Remote EJB Clients
Copier lien

Maven projects that include the invocation of session beans from remote clients require the following dependencies from the JBoss EAP Maven repository. There are two ways to declare EJB client dependencies, as described in the sub-sections below.

Note

The artifactId versions are subject to change. See the JBoss EAP Maven Repository for the latest versions.

Maven Dependencies for Remote EJB Clients

The jboss-eap-jakartaee8 Bill of Materials (BOM) packages the correct version of many of the artifacts commonly required by a JBoss EAP application. The BOM dependency is specified in the <dependencyManagement> section of the pom.xml with the scope of import.

Example: POM File <dependencyManagement> Section

<dependencyManagement>
   <dependencies>
      <dependency>
      <groupId>org.jboss.bom</groupId>
        <artifactId>jboss-eap-jakartaee8</artifactId>
        <version>7.3.0.GA</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
   </dependencies>
</dependencyManagement>
Copy to Clipboard Toggle word wrap

The remaining dependencies are specified in the <dependencies> section of the pom.xml file.

Example: POM File <dependencies> Section

<dependencies>
    <!-- Include the Enterprise Java Bean client JARs -->
    <dependency>
        <groupId>org.jboss.eap</groupId>
        <artifactId>wildfly-ejb-client-bom</artifactId>
        <type>pom</type>
    </dependency>

    <!-- Include any additional dependencies required by the application
        ...
    -->

</dependencies>
Copy to Clipboard Toggle word wrap

The ejb-remote quickstart that ships with JBoss EAP provides a complete working example of remote EJB client application. See the client/pom.xml file located in root directory of that quickstart for a complete example of dependency configuration for remote session bean invocation.

Single artifactID for jboss-ejb-client Dependencies

You can use the wildfly-ejb-client-bom artifactID and add the jboss-ejb-client library to include all the required dependencies for EJB clients: 

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.jboss.eap</groupId>
            <artifactId>wildfly-ejb-client-bom</artifactId>
            <version>EJB_CLIENT_BOM_VERSION</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>org.jboss</groupId>
        <artifactId>jboss-ejb-client</artifactId>
    </dependency>
</dependencies>
Copy to Clipboard Toggle word wrap

You must use the EJB_CLIENT_BOM_VERSION that is available in the JBoss EAP Maven repository.

A.4. jboss-ejb3.xml Deployment Descriptor Reference
Copier lien

jboss-ejb3.xml is a custom deployment descriptor that can be used in either EJB JAR or WAR archives. In an EJB JAR archive it must be located in the META-INF/ directory. In a WAR archive it must be located in the WEB-INF/ directory.

The format is similar to ejb-jar.xml, using some of the same namespaces and providing some other additional namespaces. The contents of jboss-ejb3.xml are merged with the contents of ejb-jar.xml, with the jboss-ejb3.xml items taking precedence.

This document only covers the additional non-standard namespaces used by jboss-ejb3.xml. See http://java.sun.com/xml/ns/javaee/ for documentation on the standard namespaces.

The root namespace is http://www.jboss.com/xml/ns/javaee.

Assembly descriptor namespaces
The following namespaces can all be used in the <assembly-descriptor> element. They can be used to apply their configuration to a single bean, or to all beans in the deployment by using a wildcard (*) as the ejb-name.
The security namespace (urn:security)
xmlns:s="urn:security"
Copy to Clipboard Toggle word wrap

This allows you to set the security-domain and the run-as-principal for an EJB. 

<s:security>
  <ejb-name>*</ejb-name>
  <s:security-domain>myDomain</s:security-domain>
  <s:run-as-principal>myPrincipal</s:run-as-principal>
</s:security>
Copy to Clipboard Toggle word wrap
The resource adapter namespace: urn:resource-adapter-binding
xmlns:r="urn:resource-adapter-binding"
Copy to Clipboard Toggle word wrap

This allows you to set the resource adapter for a Message-Driven Bean. 

<r:resource-adapter-binding>
  <ejb-name>*</ejb-name>
  <r:resource-adapter-name>myResourceAdapter</r:resource-adapter-name>
</r:resource-adapter-binding>
Copy to Clipboard Toggle word wrap
The IIOP namespace: urn:iiop
xmlns:u="urn:iiop"
Copy to Clipboard Toggle word wrap

The IIOP namespace is where IIOP settings are configured.

The pool namespace: urn:ejb-pool:1.0
xmlns:p="urn:ejb-pool:1.0"
Copy to Clipboard Toggle word wrap

This allows you to select the pool that is used by the included stateless session beans or Message-Driven Beans. Pools are defined in the server configuration. 

<p:pool>
   <ejb-name>*</ejb-name>
   <p:bean-instance-pool-ref>my-pool</p:bean-instance-pool-ref>
</p:pool>
Copy to Clipboard Toggle word wrap
The cache namespace: urn:ejb-cache:1.0
xmlns:c="urn:ejb-cache:1.0"
Copy to Clipboard Toggle word wrap

This allows you to select the cache that is used by the included stateful session beans. Caches are defined in the server configuration. 

<c:cache>
   <ejb-name>*</ejb-name>
   <c:cache-ref>my-cache</c:cache-ref>
</c:cache>
Copy to Clipboard Toggle word wrap 
<?xml version="1.1" encoding="UTF-8"?>
<jboss:ejb-jar xmlns:jboss="http://www.jboss.com/xml/ns/javaee"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.jboss.com/xml/ns/javaee http://www.jboss.org/j2ee/schema/jboss-ejb3-2_0.xsd"
    version="3.1"
    impl-version="2.0">
  <enterprise-beans>
     <message-driven>
        <ejb-name>ReplyingMDB</ejb-name>
        <ejb-class>org.jboss.as.test.integration.ejb.mdb.messagedestination.ReplyingMDB</ejb-class>
        <activation-config>
           <activation-config-property>
              <activation-config-property-name>destination</activation-config-property-name>
              <activation-config-property-value>java:jboss/mdbtest/messageDestinationQueue
              </activation-config-property-value>
           </activation-config-property>
        </activation-config>
     </message-driven>
  </enterprise-beans>
 </jboss:ejb-jar>
Copy to Clipboard Toggle word wrap
Note

There are known issues with the jboss-ejb3-spec-2_0.xsd file that may result in schema validation errors. You can ignore these errors. For more information, see https://bugzilla.redhat.com/show_bug.cgi?id=1192591.

A.5. Configure an EJB Thread Pool
Copier lien

You can create an EJB thread pool using the management console or the management CLI.

Procedure

  1. Log in to the management console.
  2. Navigate to Configuration Subsystems EJB and click View.
  3. Select Container Thread Pool.
  4. Click Add and specify the Name and Max Threads values.
  5. Click Save.

A.5.2. Configure an EJB Thread Pool Using the Management CLI
Copier lien

Procedure

  1. Use the add operation with the following syntax: 

    /subsystem=ejb3/thread-pool=THREAD_POOL_NAME:add(max-threads=MAX_SIZE)
    Copy to Clipboard Toggle word wrap
    1. Replace THREAD_POOL_NAME with the required name for the thread pool.
    2. Replace MAX_SIZE with the maximum size of the thread pool.

  2. Use the read-resource operation to confirm the creation of the thread pool: 

    /subsystem=ejb3/thread-pool=THREAD_POOL_NAME:read-resource
    Copy to Clipboard Toggle word wrap

    1. To reconfigure all the services in the ejb3 subsystem to use a new thread pool, use the following commands: 

      /subsystem=ejb3/thread-pool=bigger:add(max-threads=100, core-threads=10)
/subsystem=ejb3/service=async:write-attribute(name=thread-pool-name, value="bigger")
/subsystem=ejb3/service=remote:write-attribute(name=thread-pool-name, value="bigger")
/subsystem=ejb3/service=timer-service:write-attribute(name=thread-pool-name, value="bigger")
reload
      Copy to Clipboard Toggle word wrap

      XML Configuration Sample:

      <subsystem xmlns="urn:jboss:domain:ejb3:5.0">
    ...
    <async thread-pool-name="bigger"/>
    ...
    <timer-service thread-pool-name="bigger" default-data-store="default-file-store">
    ...
    <remote connector-ref="http-remoting-connector" thread-pool-name="bigger"/>
    ...
    <thread-pools>
        <thread-pool name="default">
            <max-threads count="10"/>
            <core-threads count="5"/>
            <keepalive-time time="100" unit="milliseconds"/>
        </thread-pool>
        <thread-pool name="bigger">
            <max-threads count="100"/>
            <core-threads count="5"/>
        </thread-pool>
    </thread-pools>
    ...
      Copy to Clipboard Toggle word wrap

A.5.3. EJB Thread Pool Attributes
Copier lien

EJB thread pools can be configured using attributes to run more efficiently for specific configuration needs.

  • The max-threads attribute determines the total or maximum number of threads that the executor supports. 
/subsystem=ejb3/thread-pool=default:write-attribute(name=max-threads, value=9)
{"outcome" => "success"}
Copy to Clipboard Toggle word wrap
  • The core-threads attribute determines the number of threads that are kept in the executor’s pool. This includes idle threads. If the core-threads attribute is not specified, it will default to the value of max-threads. 
/subsystem=ejb3/thread-pool=default:write-attribute(name=core-threads, value=3)
{"outcome" => "success"}
Copy to Clipboard Toggle word wrap
  • The keepalive-time attribute determines the amount of time that a non-core thread will be allowed to remain idle. After this time, the non-core thread is removed. 
/subsystem=ejb3/thread-pool=default:write-attribute(name=keepalive-time, value={time=5, unit=MINUTES})
{"outcome"=> "success"}
Copy to Clipboard Toggle word wrap
  • To change the time without changing the units of time for the keepalive-time attribute, use the following command: 
/subsystem=ejb3/thread-pool=default:write-attribute(name=keepalive-time.time, value=10)
{"outcome"=> "success"}
Copy to Clipboard Toggle word wrap





Revised on 2022-02-01 13:02:13 UTC

Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat