<h3>  
Atmosphere EE6
</h3>

<h4>
Ant
</h4>
<p>
For purposes of this blog we use ver 1.01 of Atmosphere EE6 and PrimeFaces 3.4.1.&nbsp;&nbsp;  Start by downloading the library here:
</p>
<p>
<a href="http://search.maven.org/#browse|-1161903243" target="_blank" class="news_link" title="Atmosphere 1.01">
http://search.maven.org/#browse|-1161903243
</a
</p>

<p>
You will need following jar files:
</p>

<div style="margin-left:60px">
<p>
atmosphere-annotations-1.0.1.jar<br/>
atmosphere-compat-jbossweb-1.0.1.jar<br/>
atmosphere-compat-tomcat-1.0.1.jar<br/>
atmosphere-compat-tomcat7-1.0.1.jar<br/>
atmosphere-runtime-1.0.1.jar<br/>
</p>
</div>

<p>
This version of Atmosphere needs SLF4J for logging.&nbsp;&nbsp;  Also for purposes of this blog, we used ver 1.7.1 of SLF4J.&nbsp;&nbsp;  It can be downloaded here:
</p>
<p>
<a href="http://www.slf4j.org/download.html" target="_blank" title="SLF4J" class="news_link">
http://www.slf4j.org/download.html
</a>
</p>

<p>
You will need only the following SLF4J jars:
</p>
<div style="margin-left:60px">
<p>
slf4j-api-1.7.1.jar<br/>
slf4j-simple-1.7.1.jar
</p>
</div>

<p>
Add the preceeding jar files mentioned to your project together with your PrimeFaces and other libraries required by your project.
</p>

<h4>
Maven
</h4>
<p>
For Maven projects add the following in the pom.xml of your project.&nbsp;&nbsp;Don't forget to also include the entries for  PrimeFaces and other libraries required by your project.
</p>
<p>
<pre class="brush: xml">
        &lt;dependency>
            &lt;groupId>org.atmosphere&lt;/groupId>
            &lt;artifactId>atmosphere-runtime&lt;/artifactId>
            &lt;version>1.0.1&lt;/version>
        &lt;/dependency> 
        
        &lt;dependency>
            &lt;groupId>org.slf4j&lt;/groupId>
            &lt;artifactId>slf4j-api&lt;/artifactId>
            &lt;version>1.7.1&lt;/version>
        &lt;/dependency>

        &lt;dependency>
            &lt;groupId>org.slf4j&lt;/groupId>
            &lt;artifactId>slf4j-simple&lt;/artifactId>
            &lt;version>1.7.1&lt;/version>
        &lt;/dependency>

</pre>
</p>

<h3>
PrimeFaces Project
</h3>

<p>
The web descriptor file (web.xml) of your project should define the PrimeFaces PushServlet.&nbsp;&nbsp;This servlet extends <i>org.atmosphere.cpr.AtmosphereServlet</i>. &nbsp;&nbsp; The entry to register PushServet should look like below.
</p>

<p>
<pre class="brush: xml">

    &lt;servlet>
        &lt;servlet-name>Push Servlet&lt;/servlet-name>
        &lt;servlet-class>org.primefaces.push.PushServlet&lt;/servlet-class>
        &lt;load-on-startup>1&lt;/load-on-startup>
        &lt;init-param>
            &lt;param-name>org.atmosphere.cpr.broadcasterCacheClass&lt;/param-name>
            &lt;param-value>org.atmosphere.cache.HeaderBroadcasterCache&lt;/param-value>
        &lt;/init-param>
        &lt;init-param>
            &lt;param-name>org.atmosphere.cpr.broadcasterClass&lt;/param-name>
            &lt;param-value>org.atmosphere.cpr.DefaultBroadcaster&lt;/param-value>
        &lt;/init-param>
        &lt;init-param>
            &lt;param-name>org.atmosphere.cpr.broadcastFilterClasses&lt;/param-name>
            &lt;param-value>org.atmosphere.client.TrackMessageSizeFilter&lt;/param-value>
        &lt;/init-param>
        &lt;init-param>
            &lt;param-name>org.atmosphere.cpr.sessionSupport&lt;/param-name>
            &lt;param-value>true&lt;/param-value>
        &lt;/init-param>
    &lt;/servlet>
    &lt;servlet-mapping>
        &lt;servlet-name>Push Servlet&lt;/servlet-name>
        &lt;url-pattern>/primepush/*&lt;/url-pattern>
    &lt;/servlet-mapping>
</pre>
</p>

<p>
Please note that the configuration above uses WebSocket (default).  If you are using a Tomcat version earlier than 7.0.27, you may want to turn off the use of WebSocket by adding    <i>org.atmosphere.useWebSocket</i>  with a value of  <i>false</i>.  
</p>

<p>
Please consult your Atmosphere documentation for more options.  You can also find more configuration options from the following page:
</p>
<p>
<a href="https://github.com/Atmosphere/atmosphere/wiki/Configuring-Atmosphere-using-the-web.xml-or-atmosphere.xml" class="news_link" target="_blank" title="Atmosphere">
https://github.com/Atmosphere/atmosphere/wiki/Configuring-Atmosphere-using-the-web.xml-or-atmosphere.xml
</a>
</p>


<p>
And finally the code.&nbsp;&nbsp;To make this demonstration simple and clear,&nbsp; we use the counter sample from PrimeFaces demo site.
</p>

<p>
<pre class="brush: xml;highlight:15">


&lt;html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:p="http://primefaces.org/ui"
      xmlns:h="http://java.sun.com/jsf/html">
    &lt;h:head>
        &lt;title>Facelet Title</title>
    &lt;/h:head>
    &lt;h:body>
        &lt;h:form id="form">  
            &lt;h:outputText id="out" value="#{pushBean.count}" 
		styleClass="ui-widget display" />  
            &lt;br />  
            &lt;p:commandButton value="Click" actionListener="#{pushBean.increment}" />  
        &lt;/h:form>  

        &lt;p:socket onMessage="handleMessage" channel="/counter" />  

         &lt;script type="text/javascript">
                function handleMessage(data) {
                    $('.display').html(data);
                }          
        &lt;/script>
    &lt;/h:body>
&lt;/html>

</pre>
</p>

<p>
The &lt;p:socket /&gt; component makes things happen.  The <i>channel</i> attribute of this component is the server-browser communication channel.  When messages are received from the server end of the channel, the value of <i>onMessage</i>, a JavaScript code,  is executed. 
</p>

<p>
<pre class="brush: java; highlight: [7,25]">
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
import org.primefaces.push.PushContext;
import org.primefaces.push.PushContextFactory;

@ManagedBean
@SessionScoped
public class PushBean implements java.io.Serializable {

    public PushBean() {
    }
    private int count;

    public int getCount() {
        return count;
    }

    public void setCount(int count) {
        this.count = count;
    }

    public synchronized void increment() {
        count++;
        PushContext pushContext = PushContextFactory.getDefault().getPushContext();
        pushContext.push("/counter", String.valueOf(count));
    }
}
</pre>
</p>

<p>
Communication is initiated by the server, this is accomplished by <i>PushContext.push(channel,data)</i> shown above.  Push broadcasts data to all waiting clients.  
</p>

<h3>
Tomcat 7
</h3>
<p>
Atmosphere over Tomcat version 7.0.27 and later works regardless of the  IO connector (BIO, NIO or APR) being used.
</p>

<p>
That's it.  Good luck.
</p>

Using Primefaces PrimePush with Tomcat 7