Kapitel 10. Neue XDoclet Tags

Inhaltsverzeichnis

10.1. Class-Level-Tags
- 10.1.1. axis.service
- 10.1.2. axis.handler
- 10.1.3. axis.useHandler
- 10.1.4. axis.parameter
10.2. Method-Level-Tags
- 10.2.1. axis.method

Der Deployment-Descriptor von Axis beschreibt neben den verantwortlichen Klassennamen, eine Methodenliste, einen Request-Flow usw. (siehe Axis-Dokumentation). Um all diese Attribute zu unterstützen sind einige neue Tags erforderlich, die alle Axis-Attribute beschreiben. Hinzu kommt ein Template für XDoclet, welches die Tags verarbeitet.

10.1. Class-Level-Tags

10.1.1. axis.service

Deklariert die Klasse als WebService.

Attribute	Beschreibung	Default / Optional
name	Der Name des WebServices	- / verbindlich
scope	Der Gültigkeitsbereich des WebServices. Mögliche Werte: request, session, application. Request-Scope erzeugt für jeden Request eine neue Instanz der Java-Klasse, Application verwendet ein Singleton, das alle Requests bedient und Session erzeugt eine neue Instanz für jeden neuen Client, der Sessions unterstützt.	request / optional
urn	Der Name des WebServices unter dem er von aussen aufgerufen werden kann. Wenn nichts angegeben wird, dann wird der Name der Klasse verwendet	ClassName / optional
enable-remote-admin	Wenn true gesetzt, kann der Service remote administriert werden. Voraussetzung ist allerdings die globale Aktivierung des RemoteAdmin-Features in Axis.	false / optional
include-all	Wenn true gesetzt werden alle öffentlichen Methoden der Klasse als WebService exportiert.	false / optional

10.1.2. axis.handler

Deklariert die Klasse als Request-Handler. Sie muss von org.apache.axis.handlers.BasicHandler abgeleitet sein.

Attribute	Beschreibung	Default / Optional
name	Der Name des Handlers	- / verbindlich

10.1.3. axis.useHandler

Deklariert einen Handler, den die WebService-Klasse benutzten soll. XDoclet fügt damit im Deployment-Descriptor ein Request-Flow Element ein, welches den/die Handler einbindet.

Attribute	Beschreibung	Default / Optional
name	Der Namen des zu benutzenden Handlers	- / verbindlich

10.1.4. axis.parameter

Deklariert einen Parameter, den die Handlerklasse erfragen kann.

Attribute	Beschreibung	Default / Optional
name	Der Name des Parameters	- / verbindlich
value	Der Wert des Parameters	- / verbindlich

WebServices mit Java, Axis, XDoclet und Eclipse