従来、管理者が GUI を使って手動で、サービス (BusinessService) とエンドポイント (BindingTemplates) を UDDI Registry に登録していました。残念ながら、こうすると、Registry 内のデータが静的、つまり時間が経つと陳腐化してしまいます。

jUDDI Registry をより動的にするには、デプロイするたびに各エンドポイントを登録すると理にかなうはずです。UDDI アノテーションは、これを行うためだけに設計されています。アプリケーションサーバーにデプロイされる際にサービスを登録します。

アノテーションには UDDIService と UDDIServiceBinding の 2 種類があります。エンドポイントを登録するには、上記の両方を使用する必要があります。

サービスをアンデプロイすると、エンドポイントは UDDI Registry から削除されますが、サービス情報は残ります (エンドポイントがなくてもサービスがあるため、後に確認するよう指示を出すことができるため、Registry にサービスレベルの情報を残すのは理にかなっています)。

UDDIService アノテーションを使用して、Registry 内にすでにあるビジネスにサービスを登録します。アノテーションは、Java クラスのクラスレベルに追加してください。

UDDIServiceBinding アノテーションを使用して、UDDI Registry に BindingTemplate を登録します (このアノテーションのみでの使用はできません。UDDIService アノテーション内で使用する必要があります)。

サービスを定義するクラスにアノテーションを使用することができます。ここでは、WebService に追加されています (POJO に JAX-WS 'WebService' アノテーションがついています)。

package org.apache.juddi.samples;

import javax.jws.WebService;
import org.apache.juddi.v3.annotations.UDDIService;
import org.apache.juddi.v3.annotations.UDDIServiceBinding;

@UDDIService(
		businessKey="uddi:myBusinessKey",
		serviceKey="uddi:myServiceKey", 
		description = "Hello World test service")
@UDDIServiceBinding(
		bindingKey="uddi:myServiceBindingKey",
	    description="WSDL endpoint for the helloWorld Service. This service is used for "
				  + "testing the jUDDI annotation functionality",
	    accessPointType="wsdlDeployment",
	    accessPoint="http://localhost:8080/juddiv3-samples/services/helloworld?wsdl")
@WebService(
		endpointInterface = "org.apache.juddi.samples.HelloWorld",
        serviceName = "HelloWorld")

public class HelloWorldImpl implements HelloWorld {
    public String sayHi(String text) {
        System.out.println("sayHi called");
        return "Hello " + text;
    }
}

この WebService をデプロイすると、juddi-client コードは、UDDI アノテーションに対してこのクラスをスキャンし、登録プロセスを担当します。

clerk のセクションでは、org.apache.juddi.samples.HelloWorldImpl サービスクラスに参照する必要があります。

            <clerk name="BobCratchit" node="default" publisher="sales" password="sales"> 
                 <class>org.apache.juddi.samples.HelloWorldImpl</class>  
            </clerk>

このコードは、ボブが default という名前のノードの接続設定を使用しており、sales publisher (このパスワードは sales) を使用する予定であると記述しています。

CategoryBag 属性を使用して、tModels を参照します。以下に CategoryBag の例を示しています。

        <categoryBag>
           <keyedReference tModelKey="uddi:uddi.org:categorization:types" 
            keyName="uddi-org:types:wsdl" keyValue="wsdlDeployment" /> 
           <keyedReference tModelKey="uddi:uddi.org:categorization:types" 
            keyName="uddi-org:types:wsdl2" keyValue="wsdlDeployment2" />
        </categoryBag>

以下のように追加できます。

categoryBag="keyedReference=keyName=uddi-org:types:wsdl;keyValue=wsdlDeployment;" +
                     "tModelKey=uddi:uddi.org:categorization:types," +  
                     "keyedReference=keyName=uddi-org:types:wsdl2;keyValue=wsdlDeployment2;" +
                     "tModelKey=uddi:uddi.org:categorization:types2",