Configure with Spring for the simple front end server

You can configure the CXF simple front end server endpoint by using the <simple:server> tag in spring.

<beans xmlns="http://www.springframework.org/schema/beans"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:simple="http://cxf.apache.org/simple"
      xmlns:soap="http://cxf.apache.org/bindings/soap"
      xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://cxf.apache.org/bindings/soap http://cxf.apache.org/schemas/configuration/soap.xsd
http://cxf.apache.org/simple http://cxf.apache.org/schemas/simple.xsd">

  <simple:server id="pojoservice" serviceClass="demo.hw.server.HelloWorld" address="/hello_world">
  	<simple:serviceBean>
  		<bean class="demo.hw.server.HelloWorldImpl" />
  	</simple:serviceBean>
  </simple:server>
</beans>

The simple:server element supports many additional attributes:

Name

Value

endpointName

The endpoint name this service is implementing, it maps to the wsdl:port@name. In the format of "ns:ENDPOINT_NAME" where ns is a namespace prefix valid at this scope.

serviceName

The service name this service is implementing, it maps to the wsdl:service@name. In the format of "ns:SERVICE_NAME" where ns is a namespace prefix valid at this scope.

wsdlLocation

The location of the WSDL. Can be on the classpath, file system, or be hosted remotely.

bindingId

The binding uri for the service model to use

transportId

The transport uri which is used for looking up the transport factory in CXF

address

The service publish address

bus

The bus name that will be used in the jaxws endpoint.

serviceBean

The implementor of jaxws endpoint. You can specify the implementor class name here, or just the ref bean name in the format of "#REF_BEAN_NAME"

serviceClass

The implementor class name, it is really useful when you specify the implementor with the ref bean which is wrapped by using Spring AOP

start

Whether the service endpoint should be published now, or whether it will be published at a later point, the default value is true

It also supports many child elements:

Name

Value

simple:executor

A Java executor which will be used for the service. This can be supplied using the Spring <bean class="MyExecutor"/> syntax.

simple:inInterceptors

The incoming interceptors for this endpoint. A list of <bean>s or <ref>s.

simple:inFaultInterceptors

The incoming fault interceptors for this endpoint. A list of <bean>s or <ref>s.

simple:outInterceptors

The outgoing interceptors for this endpoint. A list of <bean>s or <ref>s.

simple:outFaultInterceptors

The outgoing fault interceptors for this endpoint. A list of <bean>s or <ref>s.

simple:properties

A properties map which should be supplied to the JAX-WS endpoint. See below.

simple:dataBinding

You can specify the which DataBinding will be use in the endpoint , This can be supplied using the Spring <bean class="MyDataBinding"/> syntax.

simple:binding

You can specify the BindingFactory for this endpoint to use. This can be supplied using the Spring <bean class="MyBindingFactory"/> syntax.

simple:features

The features that hold the interceptors for this endpoint. A list of <bean>s or <ref>s

simple:invoker

The invoker which will be supplied to this endpoint. This can be supplied using the Spring <bean class="MyInvoker"/> syntax.

simple:schemaLocations

The schema locations for endpoint to use. A list of <schemaLocation>s

simple:serviceFactory

The service factory for this endpoint to use. This can be supplied using the Spring <bean class="MyServiceFactory"/> syntax

simple:serviceBean

The service implementation instance to be used. This can be supplied using the Spring <bean class="MyServiceBean"/> syntax

Here is a more advanced example which shows how to provide interceptors and properties:

<beans xmlns="http://www.springframework.org/schema/beans"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:simple="http://cxf.apache.org/simple"
      xmlns:soap="http://cxf.apache.org/bindings/soap"
      xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://cxf.apache.org/bindings/soap http://cxf.apache.org/schemas/configuration/soap.xsd
http://cxf.apache.org/simple http://cxf.apache.org/schemas/simple.xsd">

  <simple:server id="inlineInvoker" 
    serviceClass="org.apache.cxf.service.factory.HelloServiceImpl"
    address="http://localhost:8080/simpleWithAddress">
    <simple:invoker>
      <bean class="org.apache.cxf.service.invoker.BeanInvoker">
        <constructor-arg>
          <bean class="org.apache.cxf.service.factory.HelloServiceImpl"/>
        </constructor-arg>
      </bean>
    </simple:invoker>    
  </simple:server>
  
  <simple:server id="inlineSoapBinding" 
    serviceClass="org.apache.cxf.service.factory.HelloService"
    serviceBean="#greeter"
    address="http://localhost:8080/test"   
    serviceName="t:HelloService"
    xmlns:t="http://apache.org/hello_world_soap_http"
    endpointName="t:HelloPort">
    <simple:binding>
      <soap:soapBinding mtomEnabled="true" version="1.2"/>
    </simple:binding>
  </simple:server>
</beans>

Configure with Spring for the simple front end client

You could use the <simple:client> element to configure the simple front end client, you can use the spring's getBean API to get the client instance from the application context.

<beans xmlns="http://www.springframework.org/schema/beans"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:simple="http://cxf.apache.org/simple"
      xmlns:soap="http://cxf.apache.org/bindings/soap"
      xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://cxf.apache.org/bindings/soap http://cxf.apache.org/schemas/configuration/soap.xsd
http://cxf.apache.org/simple http://cxf.apache.org/schemas/simple.xsd">

  <simple:client id="client" 
    serviceClass="org.apache.cxf.service.factory.HelloService"
    address="http://localhost:9000/foo2"
    serviceName="s:XMLService"
    xmlns:s="http://apache.org/hello_world_soap_http"
    endpointName="s:XMLPort"    
    bindingId="http://cxf.apache.org/bindings/xformat"/>
</beans>

The simple:client element supports many additional attributes:

Name

Value

endpointName

The endpoint name this service is implementing, it maps to the wsdl:port@name. In the format of "ns:ENDPOINT_NAME" where ns is a namespace prefix valid at this scope.

serviceName

The service name this service is implementing, it maps to the wsdl:service@name. In the format of "ns:SERVICE_NAME" where ns is a namespace prefix valid at this scope.

wsdlLocation

The location of the WSDL. Can be on the classpath, file system, or be hosted remotely.

bindingId

The binding uri for the service model to use

address

The service publish address

bus

The bus name that will be used in the jaxws endpoint.

serviceClass

The implementor class name.

username

The user name which is used in the transport layer

password

The password that is used in the transport layer

It also supports many child elements:

Name

Value

simple:inInterceptors

The incoming interceptors for this endpoint. A list of <bean>s or <ref>s.

simple:inFaultInterceptors

The incoming fault interceptors for this endpoint. A list of <bean>s or <ref>s.

simple:outInterceptors

The outgoing interceptors for this endpoint. A list of <bean>s or <ref>s.

simple:outFaultInterceptors

The outgoing fault interceptors for this endpoint. A list of <bean>s or <ref>s.

simple:properties

A properties map which should be supplied to the JAX-WS endpoint. See below.

simple:dataBinding

You can specify the which DataBinding will be use in the endpoint , This can be supplied using the Spring <bean class="MyDataBinding"/> syntax.

simple:binding

You can specify the BindingFactory for this endpoint to use. This can be supplied using the Spring <bean class="MyBindingFactory"/> syntax.

simple:features

The features that hold the interceptors for this endpoint. A list of <bean>s or <ref>s

simple:conduitSelector

The conduit selector which is strategy for retreival of a conduit to mediate an outbound message to be injected into the client.

Here is a more advanced example which shows how to provide interceptors and properties:

<beans xmlns="http://www.springframework.org/schema/beans"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:simple="http://cxf.apache.org/simple"
      xmlns:soap="http://cxf.apache.org/bindings/soap"
      xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://cxf.apache.org/bindings/soap http://cxf.apache.org/schemas/configuration/soap.xsd
http://cxf.apache.org/simple http://cxf.apache.org/schemas/simple.xsd">

  <bean id="saajIn" class="org.apache.cxf.binding.soap.saaj.SAAJInInterceptor"/>
  <bean id="saajOut" class="org.apache.cxf.binding.soap.saaj.SAAJOutInterceptor"/>
  
  <simple:client id="client1" 
    serviceClass="org.apache.cxf.service.factory.HelloService"
    address="http://localhost:9000/foo"
    serviceName="s:SOAPService"
    xmlns:s="http://apache.org/hello_world_soap_http">
    <simple:binding>
      <soap:soapBinding mtomEnabled="true" version="1.2"/>
    </simple:binding>
    <simple:inInterceptors>
	  <bean class="org.apache.cxf.interceptor.LoggingInInterceptor"/>
	  <ref bean="saajIn"/>
	</simple:inInterceptors>
	<simple:outInterceptors>
	  <bean class="org.apache.cxf.interceptor.LoggingOutInterceptor"/>
	  <ref bean="saajOut"/>
	</simple:outInterceptors>
    <simple:conduitSelector>
      <bean class="org.apache.cxf.endpoint.NullConduitSelector"/>
    </simple:conduitSelector>
  </simple:client>
</beans>
  • No labels