[CONF] Apache CXF 2.0 Documentation: Server, Service, and Client FactoryBeans (page edited)

Sun, 25 Mar 2007 11:02:21 -0800

Page Edited : CXF20DOC : Server, Service, and Client FactoryBeans

Server, Service, and Client FactoryBeans has been edited by Dan Diephouse (Mar 25, 2007).

(View changes)

Content:

Overview

CXF has four primary classes which help in the representation of services:

Class Function
Service The Service contains the service model, which is an abstract representation of the Service and it's operations. It also contains information such as the databinding being used, the Invoker, the Executor, service properties, interceptors, and more.
Endpoint The Endpoint represents an endpoint which can receive messages. Its primary function is to hold Interceptors which are specific to that endpoint (for instance, SOAP interceptors) and provide listeners for faults that occur. Both the Client and Server use the Endpoint class.
Client The Client is a client implementation which manages message flows on the client side.
Server The Server represents a Server endpoint inside CXF. It provides hooks to start/stop the server and access the Endpoint.

CXF also includes several factories to assist in the creation of clients and servers:

Class Function Implementations
AbstractServiceFactoryBean This class is responsible for creating the service model from either a WSDL or a class file. It also sets up basic properties such as the databinding or basic interceptors. It is most often hidden behind a Client/ServerFactoryBean. ReflectionServiceFactoryBean, JaxWsServiceFactoryBean
ServerFactoryBean Creates a Server side endpoint. ServerFactoryBean, JaxWsServerFactoryBean
ClientFactoryBean Creates a Client endpoint. ClientFactoryBean, JaxWsClientFactoryBean
ClientProxyFactoryBean Creates a Java proxy around a Client ClientProxyFactoryBean, JaxWsProxyFactoryBean

For more information on how to use these beans, please see the Simple Frontend page or the javadocs.

ServiceFactoryBeans and AbstractServiceConfiguration

The primary service factory bean inside CXF is the ReflectionServiceFactoryBean. It provides a way to map a class to a service. If you are interested in controlling how this mapping occurs, you can extend provide your own Service configuration. Most configuration of services happens through these. For instance, in the JAX-WS frontend, the JaxWsServiceConfiguration controls how the service is mapped by inspecting the JAX-WS annotations.

To add your own service configuration:

MyServiceConfiguration config = new AbstractServiceConfiguration() {
... // your implementation
};
ReflectionServiceFactoryBean serviceFactory = new ReflectionServiceFactoryBean();
serviceFactory.getServiceConfigurations().add(0, config);

ServerFactoryBean svrFactory = new ServerFactoryBean();
svrFactory.setServiceFactory(serviceFactory);
...
Server svr = svrFactory.create();

Powered by Atlassian Confluence (Version: 2.2.9 Build:#527 Sep 07, 2006) - Bug/feature request

Unsubscribe or edit your notifications preferences

Reply via email to