Bug 1015116

Summary: [Doc Bug Fix] Document how to assign Bean Pools for stateless session beans and message driven beans
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: Jan Martiska <jmartisk>
Component: DocumentationAssignee: Andrea Hoffer <ahoffer>
Status: CLOSED CURRENTRELEASE QA Contact: Jan Martiska <jmartisk>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.2.0CC: dmichael, smumford
Target Milestone: post-GAKeywords: FutureFeature, Triaged
Target Release: EAP 6.4.2   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Build Name: 14875, Development Guide-6.2-1 Build Date: 02-10-2013 13:20:00 Topic ID: 5236-336541 [Latest]
Last Closed: 2015-10-20 13:00:31 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Jan Martiska 2013-10-03 13:23:37 UTC
Title: Stateless Session Beans

Describe the issue:
JBoss-specific extensions to the EJB 3.1 specification should be documented. There is for example the possibility to assign a stateless EJB to a particular bean pool. 

Suggestions for improvement:
Add instructions how to assign a bean pool to a stateless EJB, that is using the @org.jboss.ejb3.annotation.Pool annotation, like this:

@Stateless
@Pool("myAwesomePool")
public class HelloBean implements HelloBeanRemote {

    public HelloBean() {
    }

    @Override
    public String hello(String name) {
        return "Hello, " + name;
    }

}

Also please mention that the @Pool annotation is part of the JBoss EJB3 external API and must be added as a dependency, with Maven you can do it this way:

<dependency>
  <groupId>org.jboss.ejb3</groupId>
  <artifactId>jboss-ejb3-ext-api</artifactId>
  <version>2.1.0</version>
</dependency>

Bean pools are discussed in the Admin guide (http://documentation-devel.engineering.redhat.com/docs/en-US/JBoss_Enterprise_Application_Platform/6.2/html/Administration_and_Configuration_Guide/sect-Configuring_Bean_Pools.html) so it would also be useful to add a link to it.

Comment 1 Jan Martiska 2013-10-03 13:27:03 UTC
I almost forgot, exactly the same goes for message driven beans, except the annotation will just be applied to a message driven bean declaration. No other difference.

Comment 6 Jan Martiska 2015-08-03 08:36:42 UTC
Verified in Admin guide 6.4-en-US-6.4.0-35, thanks!