Adding <h:form> causes java.lang.IllegalStateException: Cannot create a session after the response has been committed
This is a known problem and has been reported by yours truly as issue 2215. This will occur when the response buffer has overflowed (due to large content) and the response is been committed before the session is been created. This is result of bit overzealous attempts of Mojarra to postpone "unnecessary" session creation as much as possible (which is at its own a Good Thing though).
Until they get it fixed, there are several workarounds:
Create a
Filter
which doesHttpServletRequest#getSession()
beforeFilterChain#doFilter()
. Advantage: no need to change JSF configuration/code. Disadvantage: when you want to avoid unnecessary session creation yourself as well.Call
ExternalContext#getSession()
withtrue
in bean's (post)constructor orpreRenderView
listener. Advantage: actually, nothing. Disadvantage: too hacky.Add a context parameter with name of
com.sun.faces.writeStateAtFormEnd
and value offalse
toweb.xml
. Advantage: unnecessary session creation will be really avoided as opposed to #1 and #2. Disadvantage: response will now be fully buffered in memory until</h:form>
is reached. If your forms are not extremely large, the impact should however be minimal. It would however still fail if your<h:form>
starts relatively late in the view. This may be combined with #4.Add a context parameter with name of
javax.faces.FACELETS_BUFFER_SIZE
and a value of the Facelets response buffer size in bytes (e.g.65535
for 64KB) so that the entire HTML output or at least the<h:form>
(see #3) fits in the response buffer. Advantage/disadvantage, see #3.Add a context parameter with name of
javax.faces.STATE_SAVING_METHOD
and value ofclient
toweb.xml
. Advantage: session will not be created at all unless you have session scoped beans. It also immediately solves potentialViewExpiredException
cases. Disadvantage: increased network bandwidth usage. If you're using partial state saving, then the impact should however be minimal.
As to why the problem disappears when you remove <h:form>
, this is because no session needs to be created in order to store the view state.
Update: this has as per the duplicate issue 2277 been fixed since Mojarra 2.1.8. So, you can also just upgrade to at least that version.
With the new version 2.1.21 released yesterday of javax.faces this problem seems to have disappeared. Declare the new version:
<dependency>
<groupId>org.glassfish</groupId>
<artifactId>javax.faces</artifactId>
<version>2.1.21</version>
</dependency>
and replace the javax.faces.jar in the glassfish modules folder replacing the javax.faces.jar for the new version 2.1.21.