[jira] [Created] (PLUTO-700) Spec: Clarify Section 20.2.3 titled "Render State Scope"

[Neil Griffin (JIRA)]

Neil Griffin created PLUTO-700:
----------------------------------

             Summary: Spec: Clarify Section 20.2.3 titled "Render State Scope"
                 Key: PLUTO-700
                 URL: https://issues.apache.org/jira/browse/PLUTO-700
             Project: Pluto
          Issue Type: Bug
          Components: spec
    Affects Versions: 3.0.0
            Reporter: Neil Griffin
            Assignee: Scott Nicklous


Section 20.2.3 of the Portlet 3.0 Specification titled "Render State Scope" 
states:
{quote}The render state scope is a passivating scope that associates managed 
beans with the render state.{quote}

While it is true that beans annotated with {{@RenderStateScoped}} need to be 
"passivating" (meaning they need to be able to save/restore their state), such 
beans are required to implement javax.portlet.annotations.PortletSerializable 
rather than java.io.Serializable.

The Portlet 3.0 API {{@RenderStateScoped}} annotation declares the following 
qualifiers:
{code:java|title=RenderStateScoped.java}
@Retention(RUNTIME) 
@Target({TYPE})
@NormalScope()
@Inherited
public @interface RenderStateScoped {
    String paramName() default "";
}
{code}

Note that the annotation defines {{@NormalScope()}} and not 
{{@NormalScope(passivating = true)}}.

Because of this, it is necessary to clarify the sentence in the spec. For 
example:

{quote}The render state scope is a non-passivating scope that associates 
managed beans with the render state. Although beans annotated with 
@RenderStateScoped are non-passivating from a CDI perspective, all such beans 
must be able to save and restore their state.{quote}




--
This message was sent by Atlassian JIRA
(v7.6.3#76005)