Bug 779826 (SOA-2187)

Summary: Router "split" methods are deprecated, but still shown normal in docs
Product: [JBoss] JBoss Enterprise SOA Platform 5 Reporter: Dana Mison <dmison>
Component: DocumentationAssignee: David Le Sage <dlesage>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: 5.0.2   
Target Milestone: ---   
Target Release: 5.1.0 GA   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-2187
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-09-22 15:58:23 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 Dana Mison 2010-07-29 02:18:36 UTC 
Affects: Documentation (Ref Guide, User Guide, etc.)
Help Desk Ticket Reference: https://access.redhat.com/issue-tracker/?module=issues&action=view&tid=1128293&gid=1354
project_key: SOA

The SOA-P docs show that there is a "split" method that should be used  on StaticRouter [1], ContentBasedRouter [2], and StaticWiretap [3]. 

However, that method appears to now be deprecated [4] since MessageMulticaster is automatically adding aggregation details if the message is routed to more than one recipient.  Please see "sendToSubset()" method of MessageMulticaster [5].

We should probably update the Aggregator documentation [6] to explain how the out of the box router actions are automatically "splitting" the message and adding aggregation details if routed to multiple recipients.

[1]  http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/5.0.1/html/Programmers_Guide/chap-SOA_ESB_Programmers_Guide-Out-of-the-box_Actions.html#section-StaticRouter
[2]  http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/5.0.1/html/Programmers_Guide/chap-SOA_ESB_Programmers_Guide-Out-of-the-box_Actions.html#section-ContentBasedRouter
[3]  http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/5.0.1/html/Programmers_Guide/chap-SOA_ESB_Programmers_Guide-Out-of-the-box_Actions.html#section-StaticWireTap
[4]  http://anonsvn.jboss.org/repos/labs/labs/jbossesb/trunk/product/rosetta/src/org/jboss/soa/esb/actions/StaticRouter.java
[5]  http://anonsvn.jboss.org/repos/labs/labs/jbossesb/trunk/product/rosetta/src/org/jboss/soa/esb/client/MessageMulticaster.java
[6]  http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/5.0.1/html/Programmers_Guide/chap-SOA_ESB_Programmers_Guide-Out-of-the-box_Actions.html#section-Aggregator
Comment 1 Dana Mison 2010-07-29 02:19:38 UTC 
Help Desk Ticket Reference: Added: https://access.redhat.com/issue-tracker/?module=issues&action=view&tid=1128293&gid=1354
Comment 2 Dana Mison 2010-07-29 02:24:49 UTC 
Link: Added: This issue depends JBESB-3398
Comment 3 Dana Mison 2010-07-29 02:26:41 UTC 
also need to know the oldest version of JBossESB this applies to, so it can documented which versions of SOA this affects.
Comment 4 Dana Mison 2010-07-29 02:28:49 UTC 
Can I get you to hunt this one down & see that it gets included upstream as well if appropriate ?
Comment 6 Laura Bailey 2010-12-17 00:34:27 UTC 
Writer: Added: dlesage
Comment 7 Laura Bailey 2010-12-17 00:38:33 UTC 
Release Notes Docs Status: Added: Not Yet Documented
Comment 9 David Le Sage 2011-02-11 05:21:46 UTC 
Release Notes Docs Status: Removed: Not Yet Documented Added: Not Required