com.sun.faces.push

Class WebsocketFacesListener

java.lang.Object

com.sun.faces.push.WebsocketFacesListener

All Implemented Interfaces:

EventListener, javax.faces.event.FacesListener, javax.faces.event.SystemEventListener

public class WebsocketFacesListener
extends Object
implements javax.faces.event.SystemEventListener

This JSF listener for UIViewRoot ensures that the necessary JavaScript code to open or close the WebSocket is properly rendered depending on rendered and connected attributes.

Since:

2.3

Author:

Bauke Scholtz

See Also:

Push

Constructor Summary

Constructors

Constructor and Description
WebsocketFacesListener()

Method Summary

Modifier and Type	Method and Description
boolean	isListenerForSource(Object source) Only listens on UIViewRoot.
static boolean	isNew(javax.faces.context.FacesContext context, javax.faces.component.UIWebsocket websocket)
void	processEvent(javax.faces.event.SystemEvent event) If the websocket has just switched its rendered or connected attribute, then render either the open() script or the close() script.
static void	subscribeIfNecessary(javax.faces.context.FacesContext context)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WebsocketFacesListener

public WebsocketFacesListener()

Method Detail

subscribeIfNecessary

public static void subscribeIfNecessary(javax.faces.context.FacesContext context)

isNew

public static boolean isNew(javax.faces.context.FacesContext context,
                            javax.faces.component.UIWebsocket websocket)

isListenerForSource

public boolean isListenerForSource(Object source)

Only listens on UIViewRoot.

Specified by:

isListenerForSource in interface javax.faces.event.SystemEventListener

Parameters:

source - the source that is inquiring about the appropriateness of sending an event to this listener instance.

Returns:

the value as specified above

processEvent

public void processEvent(javax.faces.event.SystemEvent event)
                  throws javax.faces.event.AbortProcessingException

If the websocket has just switched its rendered or connected attribute, then render either the open() script or the close() script. During an ajax request with partial rendering, it's added as <eval> by partial response writer, else it's just added as a script component with target="body".

Specified by:

processEvent in interface javax.faces.event.SystemEventListener

Parameters:

event - the SystemEvent instance that is being processed.

Throws:

javax.faces.event.AbortProcessingException - if lifecycle processing should cease for this request.