dev@javaserverfaces.java.net

Spec/JavaDoc "Bug" on UIComponentBase.setParent()

From: Matthias Wessendorf <matzew_at_apache.org>
Date: Wed, 21 Oct 2009 20:45:29 -0700

Hi,

while working on Trinidad 2 I checked JavaDoc (hosted at java.sun.com)
and MyFaces impl for UIComponentBase for setParent().

The JavaDoc says:

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

MyFaces basically queues two events:
-PostAddToViewEvent
-PreRemoveFromViewEvent

Generally I think the JavaDoc should be polished to better reflect the
total algorithm...

Also, I found it funny that the spec doesn't mention the
PostAddToViewEvent class at all.
Is that an oversight ?

Greetings,
Matthias

http://svn.apache.org/repos/asf/myfaces/core/trunk/api/src/main/java/javax/faces/component/UIComponentBase.java

-- 
Matthias Wessendorf
blog: http://matthiaswessendorf.wordpress.com/
sessions: http://www.slideshare.net/mwessendorf
twitter: http://twitter.com/mwessendorf