user manual

ManualsBrandsBorland Software ManualsHome Theater ServerHome Theater Server 6

101

102

103

104

105

106

107

108

109

110

Chapter 9: Borland Enterprise Server Web Services 93

Web Service Deployment Descriptors

■

“Java:RPC provider” on page 89

■

“Java:EJB provider” on page 89

■

“Java:VISIBROKER provider” on page 90

■

“Java:MDB provider” on page 92

Web Service Deployment Descriptors

Web services are deployed as part of a WAR. A single WAR can contain

multiple web services. You can also deploy multiple WARs with each

containing many web services.

The difference between a normal WAR and a WAR containing web services is

the presence of an extra descriptor named server-config.wsdd in the WEB-INF

directory. The server-config.wsdd file provides configuration information (the

name of the web service, the provider, any corresponding Java classes and

allowed methods).

There is one WSDD file per WAR and it contains information about all

available web services within that WAR.

The typical component structure of a WAR containing web services has the

following elements:

■

WEB-INF/web.xml

■

WEB-INF/server-config.wsdd

■

WEB-INF/classes/<classes corresponding to your web services are located

here>

■

WEB-INF/lib/<classes corresponding to your web services are located here in

the packed JAR form>

The WEB-INF/lib also contains some standard JARs that are necessary for the

Axis Runtime engine.

To publish your Java classes as a web service, use the WSDD format to

define the items that you want to deploy to the Partition. For example, an entry

corresponding to a service named "BankService" can be:

<parameter name="allowedMethods" value="create_account query_account"/

</service>

In this case, the com.fidelity.Bank Java class links to web service BankService.

The class com.fidelity.Bank can have a number of public methods, but only the

methods create_account and query_account are available through the web

service.

NOTE For more information on the web services deployment descriptor (WSDD),

refer to the Axis User Guide located in <install_dir>/doc/axis/user-guide.html,

or go to the 3rd Party Documentation, Axis Documentation section.