Deploying a FUSE Services Framework Endpoint

Deployment steps

The following steps outline, at a high-level, what you must do to successfully configure and deploy a FUSE Services Framework endpoint to the Spring container:

Write a FUSE Services Framework configuration file for your application. See Configuring your application.
Build a WAR file that contains the configuration file, the WSDL file that defines your service, and the code that you generated from that WSDL file, including the implementation file, and any libraries that your application requires. See Building a WAR file.
Deploy the WAR file in one of the following ways:
- Copy the WAR file to the Spring container repository. See Deploying the WAR file to the Spring repository.
- Use the JMX console. See Managing the Container using the JMX Console.
- Use the Web service interface. See Managing the Container using the Web Service Interface.

Configuring your application

You must write an XML configuration file for your application. The Spring container requires this file to instantiate, configure, and assemble the beans in your application.

Example 5.1 shows the spring.xml configuration file used in the Spring container sample application. You can use any name for your configuration file, however, it must end with a .xml extension. This example file is taken from the InstallDir/samples/spring_container sample application. Most of the samples in the InstallDir/samples directory contain files namedspring.xml, which configure the samples for deployment to the Spring container.

Example 5.1. Configuration File—spring.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans 
    xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:jaxws="http://cxf.apache.org/jaxws"
    xsi:schemaLocation="
        http://cxf.apache.org/jaxws
        http://cxf.apache.org/schemas/jaxws.xsd
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd">
    <jaxws:endpoint id="SoapEndpoint" 
        implementor="#SOAPServiceImpl"
        address="http://localhost:9000/SoapContext/SoapPort"
        wsdlLocation="hello_world.wsdl"
        endpointName="e:SoapPort"
        serviceName="s:SOAPService"
        xmlns:e="http://apache.org/hello_world_soap_http"
        xmlns:s="http://apache.org/hello_world_soap_http"/>
    <bean id="SOAPServiceImpl" class="demo.hw.server.GreeterImpl"/> 
</beans>

The code shown in Example 5.1 can be explained as follows:

The Spring beans element is required at the beginning of every FUSE Services Framework configuration file. It is the only Spring element that you must be familiar with.

Configures a jaxws:endpoint element that defines a service and its corresponding endpoints.

	Important
	The location of the WSDL file specified in the `wsdlLocation` is relative to the WAR's `WEB_INF/wsdl` folder.

For more information on configuring a FUSE Services Framework jaxws:endpoint element, see Using the jaxws:endpoint Element.

Identifies the class that implements the service.