PostAddToViewEvent delivery specification needs clarification

[eclipse-faces-bot]

UIComponent.getChildren() says the following about PostAddToViewEvent delivery:

"After the child component has been added to the view, if the following condition is not met:

FacesContext.isPostback() returns true and FacesContext.getCurrentPhaseId() returns
PhaseId.RESTORE_VIEW

Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class, java.lang.Object) must be
called, passing PostAddToViewEvent.class as the first argument and the newly added component as the
second argument."

However:

1. We do actually deliver PostAddToViewEvents during restore view when partial state saving is
enabled.
2. We don't actually want to deliver PostAddToViewEvents during render response when Facelets
temporarily removes/re-adds existing components from the tree.
3. These requirements are not specified in UIComponent.setParent(), which also discusses
PostAddToViewEvent delivery:

"This method will cause an PostAddToViewEvent to be published and if parent.isInView() returns true an
PostAddToViewEvent will be published as well."

The getChildren()/setParent() documentation should either be consistent, or we should remove the doc
from one of these locations.

Environment

Operating System: All
Platform: Macintosh

Affected Versions

[2.0]

[eclipse-faces-bot]

@glassfishrobot Commented
Reported by aschwart

[eclipse-faces-bot]

@glassfishrobot Commented
@edburns said:
p2

[eclipse-faces-bot]

@glassfishrobot Commented
@edburns said:
take ownership.

[eclipse-faces-bot]

@glassfishrobot Commented
@edburns said:
Fix checked in.

[eclipse-faces-bot]

@glassfishrobot Commented
rogerk said:
changelog

[eclipse-faces-bot]

@glassfishrobot Commented
Marked as fixed on Tuesday, June 22nd 2010, 4:13:46 am

[eclipse-faces-bot]

@glassfishrobot Commented
@manfredriem said:
Closing resolved issue out

[eclipse-faces-bot]

@glassfishrobot Commented
This issue was imported from java.net JIRA JAVASERVERFACES_SPEC_PUBLIC-805

[eclipse-faces-bot]

• Issue Imported From: PostAddToViewEvent delivery specification needs clarification javaee/javaserverfaces-spec#805
• Original Issue Raised By:@glassfishrobot
• Original Issue Assigned To: @edburns
• Original Issue Closed By:@glassfishrobot