[jbossseam-issues] [JBoss JIRA] Created: (JBSEAM-3569) Clarify docs on depends= for facesContext

[Samuel Mendenhall (JIRA)]

Clarify docs on depends= for facesContext
-----------------------------------------

                 Key: JBSEAM-3569
                 URL: https://jira.jboss.org/jira/browse/JBSEAM-3569
             Project: Seam
          Issue Type: Task
          Components: Documentation Issues
    Affects Versions: 2.1.0.CR1, 2.0.3.CR1
            Reporter: Samuel Mendenhall
            Priority: Minor


The following example results in a null FacesContext:

@Startup(depends = "org.jboss.seam.faces.facesContext")
@Scope(ScopeType.APPLICATION)
@Name("SomeBean")
public class SomeBean {

	@Logger
	private Log log;

	@Create
	public void init() {
		FacesContext facesContext = FacesContext.getCurrentInstance();
		log.info("FacesContext: " + facesContext);
	}
}

The docs are misleading in the sense that it promotes the idea that depends = "org.jboss.seam.faces.facesContext" means this bean will have access to the facesContext if it depends on it.  This is not true as there isn't a guarantee at this point that the underlying JSF implementation is started.


This may affect more than just the depends on facesContext, it would be nice to have a general guideline detailed on what and what can not be relied on.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: https://jira.jboss.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira