Library Link To Toggle Frames Print Feedback

Introduction

Overview

You can deploy and run a Celtix Web service endpoint from any Web server capable of acting as a servlet container. Celtix provides a standard servlet, the CXF servlet, which acts as an adapter for the Web service endpoints.

Sample application

This document uses, as an example, the Celtix servlet container sample application that is included in the following directory of your Celtix installation:

CeltixInstallDir/samples/service_creation/hello_world

For information on how to run this sample application, see the README.txt in that directory. For more detailed information, see the Celtix Getting Started Guide.

Graphical Overview

Figure 2.1, “Exposing a Celtix Web Service Endpoint from a Servlet Container” shows the main components of the servlet container sample application and illustrates how you can expose a Celtix Web service endpoint from a servlet container:

Figure 2.1. Exposing a Celtix Web Service Endpoint from a Servlet Container

Exposing a Celtix Web Service Endpoint from a Servlet Container

Web server

The Web server shown in Figure 2.1, “Exposing a Celtix Web Service Endpoint from a Servlet Container” can be any Web server capable of acting as a servlet container. When a Web server is used as a container, all hosted services are accessed through the same IP port. For example, if you use Tomcat, the default IP port is 8080.

Deployed WAR file

Services are deployed to the Web server in a Web Archive (WAR) file, as shown in Figure 2.1, “Exposing a Celtix Web Service Endpoint from a Servlet Container” . The deployed WAR file contains the compiled code for the service being deployed, a copy of the WSDL file that defines the service, the WSDL stub code, and configuration files.

CXF servlet

The CXF servlet shown in Figure 2.1, “Exposing a Celtix Web Service Endpoint from a Servlet Container” is a standard servlet provided by Celtix. It acts as an adapter for Web service endpoints and is part of the Celtix ASE runtime. It is implemented by the org.apache.cxf.jaxws.servlet.CXFServlet class.

cxf-servlet.xml file

The cxf-servlet.xml file configures the endpoints that plug into the CXF servlet. See for more detail.

web.xml file

The web.xml file is a standard deployment descriptor file that tells the application server to load the org.apache.cxf.jaxws.servlet.CXFServlet class.