14.4.4. Configuring Netty Servlet

Configuring a servlet engine for the Netty Servlet transport

1. Deploy the servlet. A web application using the servlet might have a web.xml file similar to the following:

   <?xml version="1.0" encoding="UTF-8"?>
   <web-app xmlns="http://java.sun.com/xml/ns/j2ee" 
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
     version="2.4">
     <servlet>
       <servlet-name>HornetQServlet</servlet-name>
       <servlet-class>org.jboss.netty.channel.socket.http.HttpTunnelingServlet</servlet-class>
       <init-param>
         <param-name>endpoint</param-name>
         <param-value>local:org.hornetq</param-value>
       </init-param>
       <load-on-startup>1</load-on-startup>
     </servlet>
   
     <servlet-mapping>
       <servlet-name>HornetQServlet</servlet-name>
       <url-pattern>/HornetQServlet</url-pattern>
     </servlet-mapping>
   </web-app>

2. Add the netty-invm acceptor to the server-side configuration in <JBOSS_HOME>/jboss-as/server/<PROFILE>/deploy/hornetq/hornetq-configuration.xml:

   <acceptors>
     <acceptor name="netty-invm">
       <factory-class>
         org.hornetq.core.remoting.impl.netty.NettyAcceptorFactory
       </factory-class>
       <param key="use-invm" value="true"/>
       <param key="host" value="org.hornetq"/>
     </acceptor>
   </acceptors>

3. Define a connector for the client in <JBOSS_HOME>/jboss-as/server/<PROFILE>/deploy/hornetq/hornetq-configuration.xml:

   <connectors>
     <connector name="netty-servlet">
       <factory-class>
         org.hornetq.core.remoting.impl.netty.NettyConnectorFactory
       </factory-class>
       <param key="host" value="localhost"/>
       <param key="port" value="8080"/>
       <param key="use-servlet" value="true"/>
       <param key="servlet-path" value="/messaging/HornetQServlet"/>
     </connector>
   </connectors>