Chapter 10. New XDoclet tags

Table of Contents

Beside the actual class name, the deployment descriptor of Axis describes a method list, a request flow etc. (see Axis documentation). To support all these attributes some new tags are necessary describing all these Axis attributes. Here the introduced template for XDoclet comes into play to process the tags.

10.1. Class level tags

10.1.1. axis.service

Declares a class as web service.

Attribute

Description

Default / Optional

name

The name of the web service

- / mandatory

scope

The scope of the web service. Possible values: request, session, application. The request scope creates a new instance of the java class for each request, application uses a singleton, which serves all requests and sessions and creates a new instance for each new client that supports sessions.

request / optional

urn

The web service name to be called. If no name is given, the class name will be used.

ClassName / optional

enable-remote-admin

If set to true, the service can be administered remotely provided that the remote admin feature is globally enabled in Axis.

false / optional

include-all

If set to true, all public methods will be exported as web service methods.

false / optional

10.1.2. axis.handler

Declares the class as request handler. The class must extend org.apache.axis.handlers.BasicHandler.

Attribute

Description

Default / Optional

name

The name of the handler

- / mandatory

10.1.3. axis.useHandler

Defines the handler which should be used by the web service. XDoclet then inserts a request flow element in the deployment descriptor, which links the handler to this web service.

Attribute

Description

Default / Optional

name

The name of the handler to use

- / mandatory

10.1.4. axis.parameter

Declares a parameter the handler class can request.

Attribute

Beschreibung

Default / Optional

name

Name of the parameter

- / mandatory

value

Value of the parameter

- / mandatory