⁠Chapter 23. Web Services

23.1. Configuration and Packaging
23.2. Conversational Web Services
23.2.1. A Recommended Strategy
23.3. An example web service
23.4. RESTful HTTP web services with RESTEasy
23.4.1. RESTEasy configuration and request serving
23.4.2. Resources and providers as Seam components
23.4.3. Securing resources
23.4.4. Mapping exceptions to HTTP responses
23.4.5. Exposing entities via RESTful API
Seam integrates with JBossWS (JWS) to allow standard Java EE web services to take full advantage of Seam's contextual framework, including conversational web service support. This chapter guides you through web service configuration for a Seam environment.

⁠23.1. Configuration and Packaging

To allow Seam to intercept web service requests so that the necessary Seam contexts can be created for the request, a special SOAP handler must be configured; org.jboss.seam.webservice.SOAPRequestHandler is a SOAPHandler implementation that does the work of managing Seam's lifecycle during the scope of a web service request.
A special configuration file, soap-handlers.xml should be placed into the META-INF directory of the jar file that contains the web service classes. This file contains the following SOAP handler configuration: 
<?xml version="1.0" encoding="UTF-8"?>
<handler-chains xmlns="http://java.sun.com/xml/ns/javaee">
 <handler-chain>
  <handler>
   <handler-name>SOAP Request Handler</handler-name>
   <handler-class>org.jboss.seam.webservice.SOAPRequestHandler</handler-class>
  </handler>
 </handler-chain>
</handler-chains>