Javadoc Task

WSDL4RegTask

Description

Registers SOAP Web Services in UDDI registries.

This task allows to perform multiple operations on a UDDI registry:

Create / Update / Delete a business entity.
Create / Update / Delete a taxonomy within a business entity
Create a SOAP web service within a business entity (delete and update will be added later)

This task makes use as much as possible of Apache librairies (ant, commons) as well as the latest SUN Web Service Pack (JAX-* packages).

In order to use this task, the JAXR related jars must be in the classpath.

The task definition looks like:

<taskdef name="wsdl4reg" classname="org.apache.wsdl4reg.ant.WSDL4RegTask"/>

Parameters

Attribute	Description	Required
verbose	Turns verbosity on. Defaults to "false"	No

Parameters specified as nested elements

authentication (required)

The required authentication element contains all the user credentials in order to connect to a UDDI registry.

Parameters

Attribute	Description	Required
login	user's login	Yes
password	user's password	Yes

registry (required)

The required registry element contains 2 UDDI URLs used by WSDL4Reg in order to perform operations on the registry.

Parameters

Attribute	Description	Required
queryManager	Allow clients to search for data using the JAXR information model	Yes
lifeCycleManager	Allow clients to submit data to a registry, modify it and remove it	Yes

business (required)

The required business element specifies information about an organization and its taxonomy.
This element might contain one taxonomy (NAICS, .....)

Parameters

Attribute	Sub Element	Sub Attribute	Description	Required
name			The name of the organization	Yes
description			The description of the organization	No
command			operation to perform on the registry ("create", "update" or "delete"). Defaults to "create". NB: If the business exists and the command is "create", nothing happens.	No
	taxonomy		The taxonomy to attach to the business. NB: One taxonomy can be added at one time using WSDL4Reg. In order to add multiple taxonomies, the task must be called multiple times.	No
		name	Name of the taxonomy	Yes
		value	Value of the taxonomy	Yes
		description	Description of the taxonomy	No
		command	operation to perform on the registry ("create", "update" or "delete"). Defaults to "create". NB: If the taxonomy exists and the command is "create", nothing happens.	No


<business
	name="wsdl4reg"
	description="sourceforge project">
	<taxonomy
		name="ntis-gov:naics"
		value="51121"
		description="Software Publishers"/>
</business>

wsdl (optional)

The optional wsdl element is used to register (update and unregister later) a set of possible SOAP web services located in a WSDL document.

Parameters

Attribute	Description	Required
location	URL to a valid WSDL document	Yes
command	operation to perform on the registry ("create", "update" or "delete"). Defaults to "create".	No

Example

  	<target name="testDeleteBiz">
		<echo>Executing testDeleteBiz</echo>
		<wsdl4reg verbose="yes">
			<authentication 
				login="wsdl4reg" 
				password="password"/>
			<registry
				queryManager="http://www-3.ibm.com/services/uddi/v2beta/inquiryapi"
				lifeCycleManager="https://www-3.ibm.com/services/uddi/v2beta/protect/publishapi"/>
			<business
				name="wsdl4reg"
				command="delete"/>
		</wsdl4reg>
	</target>
	
	<target name="testCreateBiz" depends="testDeleteBiz">
		<echo>Executing testCreateBiz</echo>
		<wsdl4reg verbose="yes">
			<authentication 
				login="wsdl4reg" 
				password="password"/>
			<registry
				queryManager="http://www-3.ibm.com/services/uddi/v2beta/inquiryapi"
				lifeCycleManager="https://www-3.ibm.com/services/uddi/v2beta/protect/publishapi"/>
			<business
				name="wsdl4reg"
				description="sourceforge project">
				<taxonomy
					name="ntis-gov:naics"
					value="51121"
					description="Software Publishers"/>
			</business>
		</wsdl4reg>
	</target>
	
	<target name="addGoogleService" depends="testCreateBiz">
		<echo>Executing addService</echo>
		<wsdl4reg verbose="yes">
			<authentication 
				login="wsdl4reg" 
				password="password"/>
			<registry
				queryManager="http://www-3.ibm.com/services/uddi/v2beta/inquiryapi"
				lifeCycleManager="https://www-3.ibm.com/services/uddi/v2beta/protect/publishapi"/>
			<business name="wsdl4reg"/>
			<wsdl location="http://wsdl4reg.sourceforge.net/wsdls/GoogleSearch.wsdl"/>
		</wsdl4reg>
	</target>