You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@juddi.apache.org by al...@apache.org on 2013/05/04 01:23:28 UTC
svn commit: r1479003 [3/5] - in /juddi/branches/juddi-3.2.x:
juddi-client/src/main/java/org/apache/juddi/v3/client/
uddi-ws/src/main/java/org/uddi/v3_service/
Modified: juddi/branches/juddi-3.2.x/uddi-ws/src/main/java/org/uddi/v3_service/UDDIPublicationPortType.java
URL: http://svn.apache.org/viewvc/juddi/branches/juddi-3.2.x/uddi-ws/src/main/java/org/uddi/v3_service/UDDIPublicationPortType.java?rev=1479003&r1=1479002&r2=1479003&view=diff
==============================================================================
--- juddi/branches/juddi-3.2.x/uddi-ws/src/main/java/org/uddi/v3_service/UDDIPublicationPortType.java (original)
+++ juddi/branches/juddi-3.2.x/uddi-ws/src/main/java/org/uddi/v3_service/UDDIPublicationPortType.java Fri May 3 23:23:27 2013
@@ -52,7 +52,632 @@ import org.uddi.api_v3.TModelDetail;
* This portType defines all of the UDDI publication operations.
*
* This class was generated by the JAX-WS RI. JAX-WS RI 2.1.5-b03- Generated
- * source version: 2.1
+ * source version: 2.1 <h2 style="margin-left:0in;text-indent:0in"><a
+ * name="_Toc527816081">Publication </a>API Set</h2>
+ *
+ * <p class="MsoBodyText">The API calls in this section are used to publish and
+ * update information contained in a UDDI registry. According to the
+ * policy of the UDDI registry, a publisher selects a UDDI node where it will
+ * publish the information. </p>
+ *
+ * <p class="MsoBodyText">API calls in this section MUST all be implemented as
+ * synchronous and "atomic" from the point of view of the caller. That is, each
+ * call MUST either succeed completely or fail completely. Partial results MUST
+ * NOT be returned.</p>
+ *
+ * <h3><a name="_Toc528997551"></a><a name="_Toc525464311"></a><a
+ * name="_Ref247612"></a><a name="_Toc85908096"></a><a
+ * name="_Toc53709291"></a><a name="_Toc45096377"></a><a
+ * name="_Toc45095920"></a><a name="_Toc42047297"></a><a
+ * name="_Ref12253009">5.2.1 Publishing entities with node assigned
+ * keys</a></h3>
+ *
+ * <p class="MsoBodyText">When a publisher does not provide keys for new
+ * entities, the UDDI node will assign keys in accordance with registry policy.
+ * Node-assigned keys MUST use keys that conform to the grammar in Section <a
+ * href="#_Ref8978849 ">4.4</a> <i>About uddiKeys</i>.</p>
+ *
+ * <h3><a name="_Toc85908097"></a><a name="_Toc53709292"></a><a
+ * name="_Toc45096378"></a><a name="_Toc45095921"></a><a
+ * name="_Toc42047298"></a><a name="_Ref8978630">5.2.2 Publishing entities with
+ * publisher-assigned keys</a></h3>
+ *
+ * <p class="MsoBodyText">The registry keying policy MAY allow an entityâs key
+ * to be proposed by the publisher. If the publisher does not propose a key for
+ * an entity, the registry MUST assign one. </p>
+ *
+ * <p class="MsoBodyText">Since entity keys MUST be unique in a registry without
+ * regard to the type of entity and since registries MUST define to impose
+ * policies concerning which publishers may publish which keys,
+ * publisher-assigned keys are subject to rules that UDDI registries enforce.
+ * Behavior that ensures uniqueness across entity types (businessEntity,
+ * businessService, bindingTemplate, tModel and subscription) is REQUIRED for
+ * all registries. In this section we discuss the behavior of registries that
+ * use the recommended "uddi:" key structure. This behavior provides uniqueness
+ * and promotes interoperability among registries, while allowing various
+ * registry-specific policies to be built. Practical guidance for the use of
+ * this facility may be found in Section <a
+ * href="../../../../../hately/My%20Documents/uddi/v3specification/UDDI%20V3%20Specification.htm#_Ref9007543#_Ref9007543">9.4.2</a>
+ * <i>General Keying Policy</i> and Section <a
+ * href="../../../../../hately/My%20Documents/uddi/v3specification/UDDI%20V3%20Specification.htm#_Ref9007521#_Ref9007521">9.4.3</a>
+ * <i>Policy Abstractions for the UDDI keying scheme</i>.</p>
+ *
+ * <h4 style="margin-left:0in;text-indent:0in"><a name="_Ref9009437">5.2.2.1 Key
+ * generator keys and their partitions</a></h4>
+ *
+ * <p class="MsoBodyText">To ensure that publisher-generated keys do not
+ * conflict with one another, registries assign the authority to generate keys
+ * to publishers in the following manner:</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in">1.<span
+ * style="font:7.0pt "Times New
+ * Roman""> </span>The conceptual space
+ * of uddiKeys is divided into non-overlapping, hierarchically arranged
+ * partitions, each of which can be associated with a publisher.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in">2.<span
+ * style="font:7.0pt "Times New
+ * Roman""> </span>Only the publisher
+ * associated with a particular partition is given the authority to assign keys
+ * within the partition.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in">3.<span
+ * style="font:7.0pt "Times New
+ * Roman""> </span>The publisher with
+ * authority for a given partition may designate any publisher it chooses for
+ * any partition directly below the partition it manages, provided it has not
+ * already designated a publisher to that partition.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in">4.<span
+ * style="font:7.0pt "Times New
+ * Roman""> </span>The publisher with
+ * authority for a partition may transfer its authority to another
+ * publisher.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in">5.<span
+ * style="font:7.0pt "Times New
+ * Roman""> </span>Initially, the
+ * registry itself has authority for the root partition of the hierarchy.</p>
+ *
+ * <p class="MsoBodyText">The specific mechanisms that enforce these rules are
+ * explained below.</p>
+ *
+ * <p class="MsoBodyText">Each node of a registry is a generator of keys.
+ * This is required to enable the node to generate keys not provided by
+ * publishers. In addition, the policies of a registry MAY allow individual
+ * publishers to obtain the authority to be generators of keys for specific
+ * partitions within the space of uddiKeys. Publishers obtain this authority by
+ * owning a particular tModel called a key generator tModel. The key
+ * generator tModel contains a key generator key, and it specifies the partition
+ * for which the publisher may assign keys. </p>
+ *
+ * <p class="MsoBodyText"><span style="layout-grid-mode:line">The subset of
+ * derivedKeys called <i>key generator keys</i> consists of all the keys of the
+ * form:</span></p>
+ *
+ * <p class="MsoNormal" style="margin-left:1.0in">keyGeneratorKey
+ * =
+ * uddiKey <span
+ * style="layout-grid-mode:line">":keygenerator"</span></p>
+ *
+ * <p class="MsoBodyText">As described in Section 4.4.1, a derivedKey is one
+ * that is formed from another key by appending a non-empty, colon-prefixed
+ * string to another uddiKey. A derivedKey is said to be "based on" this
+ * uddiKey. With this in mind, the complete partition of a given keyGeneratorKey
+ * is the set of keys consisting of:</p>
+ *
+ * <p class="MsoBodyText"> </p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in">1.<span
+ * style="font:7.0pt "Times New
+ * Roman""> </span>The set of
+ * derivedKeys based on the same uddiKey that the keyGeneratorKey is based
+ * upon.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in">2.<span
+ * style="font:7.0pt "Times New
+ * Roman""> </span>The set of
+ * keyGeneratorKeys based on a key that is in the partition.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in">3.<span
+ * style="font:7.0pt "Times New
+ * Roman""> </span>The domainKey, if
+ * the keyGeneratorKey is based upon that domainKey.</p>
+ *
+ * <p class="MsoBodyText"> </p>
+ *
+ * <p class="MsoBodyText">Note that the partition's keyGeneratorKey itself is
+ * exluded from the partition.</p>
+ *
+ * <p class="MsoBodyText">A rootKeyGeneratorKey is a keyGeneratorKey that is not
+ * based on a derivedKey. That is:</p>
+ *
+ * <p class="MsoNormal" style="margin-left:1.0in">rootKeyGeneratorKey
+ * = (uuidKey /
+ * domainKey) ":keygenerator"</p>
+ *
+ * <p class="MsoNormal" style="margin-left:1.0in"> </p>
+ *
+ * <h5 style="margin-left:0in;text-indent:0in">5.2.2.1.1 Examples</h5>
+ *
+ * <p class="MsoBodyText">Based on the rules above, it is possible to construct
+ * the keyGeneratorKey for any key by manipulating the string representation of
+ * the key. To illustrate, suppose the key is x, then the following pseudo-code
+ * will determine the keyGeneratoryKey:</p>
+ *
+ * <p class="codeSample">If x is a keyGeneratorKey, and y is that key minus the
+ * ":keygenerator" suffix,</p>
+ *
+ * <p class="codeSample">then if y is a domainKey</p>
+ *
+ * <p class="codeSample"> then x is a top-level keyGenerator, and
+ * has no keyGeneratorKey (1.a)</p>
+ *
+ * <p class="codeSample"> else y is a derivedKey, based on z, </p>
+ *
+ * <p class="codeSample"> and xâs
+ * keyGeneratorKey is z:keyGenerator (1.b)</p>
+ *
+ * <p class="codeSample">else</p>
+ *
+ * <p class="codeSample" style="margin-left:1.0in">If x is a domainKey </p>
+ *
+ * <p class="codeSample" style="margin-left:1.0in">then xâs keyGeneratorkey is
+ * x:keyGenerator (2)<br> else x is based on a key y, and xâs keyGenerator is
+ * y:keyGenerator (3)</p>
+ *
+ * <p class="MsoBodyText"> </p>
+ *
+ * <p class="MsoBodyText">Using this pseudo-code illustration, the following
+ * table provides examples of legal URIâs and their associated key generators
+ * for each of the four cases noted:</p>
+ *
+ * <table class="specTable"
+ * style="width:452.0pt;margin-left:.5in;border-collapse:collapse;border:none"
+ * border="1" cellpadding="0" cellspacing="0" width="603"> <tbody><tr> <td
+ * style="width:164.0pt;border:solid black 1.0pt; background:#FFFFCA;padding:0in
+ * 5.4pt 0in 5.4pt" valign="top" width="219"> <p
+ * class="MsoNormal"><b>Key</b></p> </td> <td style="width:2.25in;border:solid
+ * black 1.0pt; border-left:none;background:#FFFFCA;padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="216"> <p class="MsoNormal"><b>keyGeneratorKey</b></p>
+ * </td> <td style="width:1.75in;border:solid black 1.0pt;
+ * border-left:none;background:#FFFFCA;padding:0in 5.4pt 0in 5.4pt" valign="top"
+ * width="168"> <p class="MsoNormal"><b>Case in pseudo-code</b></p> </td> </tr>
+ * <tr> <td style="width:164.0pt;border:solid black 1.0pt;
+ * border-top:none;padding:0in 5.4pt 0in 5.4pt" valign="top" width="219"> <p
+ * class="MsoNormal">uddi:tempuri.com</p> </td> <td
+ * style="width:2.25in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="216"> <p
+ * class="MsoNormal">uddi:tempuri.com:keygenerator</p> </td> <td
+ * style="width:1.75in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="168"> <p class="MsoNormal">2</p> </td> </tr> <tr> <td
+ * style="width:164.0pt;border:solid black 1.0pt; border-top:none;padding:0in
+ * 5.4pt 0in 5.4pt" valign="top" width="219"> <p
+ * class="MsoNormal">uddi:tempuri.com:keygenerator</p> </td> <td
+ * style="width:2.25in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="216"> <p class="MsoNormal"><none></p> </td> <td
+ * style="width:1.75in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="168"> <p class="MsoNormal">1.a</p> </td> </tr> <tr> <td
+ * style="width:164.0pt;border:solid black 1.0pt; border-top:none;padding:0in
+ * 5.4pt 0in 5.4pt" valign="top" width="219"> <p class="MsoNormal"><span
+ * lang="IT">uddi:tempuri.com:xxx:keygenerator</span></p> </td> <td
+ * style="width:2.25in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="216"> <p
+ * class="MsoNormal">uddi:tempuri.com:keygenerator</p> </td> <td
+ * style="width:1.75in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="168"> <p class="MsoNormal">1.b</p> </td> </tr> <tr> <td
+ * style="width:164.0pt;border:solid black 1.0pt; border-top:none;padding:0in
+ * 5.4pt 0in 5.4pt" valign="top" width="219"> <p
+ * class="MsoNormal">uddi:tempuri.com:xxx</p> </td> <td
+ * style="width:2.25in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="216"> <p
+ * class="MsoNormal">uddi:tempuri.com:keygenerator</p> </td> <td
+ * style="width:1.75in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="168"> <p class="MsoNormal">3</p> </td> </tr> <tr> <td
+ * style="width:164.0pt;border:solid black 1.0pt; border-top:none;padding:0in
+ * 5.4pt 0in 5.4pt" valign="top" width="219"> <p
+ * class="MsoNormal">uddi:tempuri.com:xxx:yyy</p> </td> <td
+ * style="width:2.25in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="216"> <p class="MsoNormal"><span
+ * lang="IT">uddi:tempuri.com:xxx:keygenerator</span></p> </td> <td
+ * style="width:1.75in;border-top:none;border-left: none;border-bottom:solid
+ * black 1.0pt;border-right:solid black 1.0pt; padding:0in 5.4pt 0in 5.4pt"
+ * valign="top" width="168"> <p class="MsoNormal">3</p> </td> </tr>
+ * </tbody></table>
+ *
+ * <p class="MsoBodyText"> </p>
+ *
+ * <p class="MsoBodyText">The following keys do NOT belong to the partition of
+ * the key generator key "uddi:tempuri.com:keygenerator".</p>
+ *
+ * <table class="MsoNormalTable"
+ * style="width:405.0pt;margin-left:77.4pt;border-collapse:collapse" border="0"
+ * cellpadding="0" cellspacing="0" width="540"> <tbody><tr> <td
+ * style="width:171.0pt;padding:0in 5.4pt 0in 5.4pt" valign="top" width="228">
+ * <p class="MsoNormal"> "uddi:tempuri.com:keygenerator"</p> </td> <td
+ * style="width:3.25in;padding:0in 5.4pt 0in 5.4pt" valign="top" width="312"> <p
+ * class="MsoNormal">The keyGeneratorKey does not belong to the partition it
+ * designates.</p> <p class="MsoNormal"> </p> </td> </tr> <tr> <td
+ * style="width:171.0pt;padding:0in 5.4pt 0in 5.4pt" valign="top" width="228">
+ * <p class="MsoNormal">"uddi:tempuri.com:xxx:yyy"</p> </td> <td
+ * style="width:3.25in;padding:0in 5.4pt 0in 5.4pt" valign="top" width="312"> <p
+ * class="MsoNormal">This key belongs to the partition of the keyGeneratorKey
+ * "uddi:tempuri.com:xxx:keygenerator", not this one.</p> </td> </tr> <tr> <td
+ * style="width:171.0pt;padding:0in 5.4pt 0in 5.4pt" valign="top" width="228">
+ * <p class="MsoNormal"><span
+ * lang="IT">"uddi:tempuri.com:keygenerator:zzz"</span></p> </td> <td
+ * style="width:3.25in;padding:0in 5.4pt 0in 5.4pt" valign="top" width="312"> <p
+ * class="MsoNormal">This key does not belong in any partition â it is an
+ * invalid key.</p> </td> </tr> </tbody></table>
+ *
+ * <p class="MsoNormal"><a name="_Ref529862482"></a><a
+ * name="_Hlt531586136"></a> </p>
+ *
+ * <h4 style="margin-left:0in;text-indent:0in"><a name="_Ref8978954">5.2.2.2
+ * Behavior of publishers</a></h4>
+ *
+ * <p class="MsoBodyText">To successfully publish a new entity with a proposed
+ * key, the publisher needs to own the key generator tModel for the partition in
+ * which the key lies. Typically, a publisher gets ownership by publishing the
+ * tModel in question, but publishers can also get ownership in other ways, for
+ * example by having another publisher transfer ownership.</p>
+ *
+ * <p class="MsoBodyText">Once a publisher owns a key generator tModel that
+ * publisher MAY publish new entities<a href="#_ftn20" name="_ftnref20"
+ * title=""><span class="MsoFootnoteReference"><span
+ * class="MsoFootnoteReference"><span
+ * style="font-size:10.0pt;letter-spacing:-.25pt">[20]</span></span></span></a>
+ * and assign them keys within the key generator tModelâs partition. New keys
+ * can only be generated from keyGenerator tModels that are not hidden.
+ * Publishers are responsible for managing the uniqueness of the keys in the
+ * partition they own. If a publisher fails to do so, and generates an already
+ * used key, a publish operation could inadvertently replace an entity
+ * previously published by that publisher.</p>
+ *
+ * <p class="MsoBodyText">If a publisher owns key generator tModels with the
+ * same key in multiple registries â for example one in the publisherâs private
+ * test registry and one in the UDDI Business Registry â that publisher MAY
+ * publish the entities with identical keys in those registries. This enables
+ * many interesting capabilities. For example, publishers may choose to develop
+ * their UDDI entities by publishing them into test registries and then, at
+ * appropriate times, "promote" them to the UDDI Business Registry.</p>
+ *
+ * <h4 style="margin-left:0in;text-indent:0in"><a name="_Ref4335985">5.2.2.3
+ * Behavior of UDDI nodes</a></h4>
+ *
+ * <p class="MsoBodyText">To ensure that publisher-assigned keys work correctly
+ * all UDDI implementations behave as follows.</p>
+ *
+ * <h5 style="margin-left:0in;text-indent:0in">5.2.2.3.1 "New" and "existing"
+ * entities defined</h5>
+ *
+ * <p class="MsoBodyText">During a publish operation, the entity or entities
+ * being published are either "new" or "existing". An existing entity is one
+ * that has a key that matches the key of an entity already in the registry. A
+ * new entity is one that does not. If a new entity has a key, this key is the
+ * key proposed for that entity by its publisher.</p>
+ *
+ * <h5 style="margin-left:0in;text-indent:0in">5.2.2.3.2 Behavior with respect
+ * to entities for which no key is proposed.</h5>
+ *
+ * <p class="MsoBodyText">A UDDI node MUST generate and assign a key to each
+ * entity for which the publisher proposes no key. It may generate uuidKeys for
+ * use as the keys of new entities for which no key is proposed or it may
+ * generate keys in the partition of a key generator tModel it owns. </p>
+ *
+ * <p class="MsoBodyText">A registry whose nodes assign uddiKeys to new entities
+ * is called a root registry. The UDDI Business Registry is a root registry. A
+ * registry whose nodes gain ownership of their key generator tModels by
+ * publishing them in the UDDI Business Registry are affiliates of the UDDI
+ * Business Registry. See Section <a href="#_Ref11678674 ">1.5.5</a>
+ * <i>Affiliations of Registries</i>.</p>
+ *
+ * <h5 style="margin-left:0in;text-indent:0in">5.2.2.3.3 Behavior with respect
+ * to uuidKeys</h5>
+ *
+ * <p class="MsoBodyText">A UDDI node SHOULD accept a uuidKey as the key for a
+ * new entity during a publish operation if the publisher is a trusted publisher
+ * of such keys, according to the policies of the registry. UDDI nodes MUST NOT
+ * allow other publishers to generate uuidKeys.</p>
+ *
+ * <h5 style="margin-left:0in;text-indent:0in">5.2.2.3.4 Behavior with respect
+ * to key generator keys</h5>
+ *
+ * <p class="MsoBodyText">A UDDI node MUST NOT publish any non-tModel entity
+ * whose proposed key is a key generator key. A tModel whose proposed key
+ * is a key generator key MUST include a category bag with a keyed reference
+ * with the tModelKey set to "uddi:uddi.org:categorization:types" and the
+ * keyValue set to "keyGenerator".</p>
+ *
+ * <h5 style="margin-left:0in;text-indent:0in">5.2.2.3.5 Behavior with respect
+ * to root key generator keys</h5>
+ *
+ * <p class="MsoBodyText">During a publish operation a UDDI node SHOULD accept a
+ * root key generator key as the key for a new tModel if it is proposed by a
+ * publisher authorized to publish the key, according to the policies of the
+ * registry. The policy MUST prevent more than one publisher from publishing
+ * tModels with the same root key generator key. </p>
+ *
+ * <p class="MsoBodyText">An appropriate policy for root and for affiliated
+ * registries is given in Chapter <a href="#_Ref8981882 ">9</a>
+ * <i>Policy</i>.</p>
+ *
+ * <h5 style="margin-left:0in;text-indent:0in">5.2.2.3.6 Behavior with respect
+ * to other proposed keys</h5>
+ *
+ * <p class="MsoBodyText">A UDDI node SHOULD accept keys proposed for new
+ * entities during publishing operations if they meet both of the following
+ * criteria.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol;layout-grid-mode:line">·<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span></span><span style="layout-grid-mode:line">The proposed key lies in
+ * the partition of the key of an existing key generator tModel and the key
+ * generator tModel is not hidden.</span></p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span>The same publisher who is proposing the new key owns the key
+ * generator tModel referred to in the previous bullet.<span
+ * class="MsoFootnoteReference"> </span><a href="#_ftn21" name="_ftnref21"
+ * title=""><span
+ * style="font-size:10.0pt;font-family:Arial;letter-spacing:-.25pt">[21]</span></a></p>
+ *
+ * <h4 style="margin-left:0in;text-indent:0in">5.2.2.4 Affiliations of
+ * registries</h4>
+ *
+ * <p class="MsoBodyText">A set of registries may cooperate in managing a single
+ * multi-registry key space by designating one of the registries in the group to
+ * be the "root registry" and assigning it to be the authority for the root
+ * partition. Other registries in the set are said to be affiliate
+ * registries. See Section <a href="#_Ref11678674 ">1.5.5</a>
+ * <i>Affiliations of Registries</i> for more information</p>
+ *
+ * <p class="MsoBodyText">The UDDI Business Registry is a root registry. Its
+ * policies and procedures are designed to make it simple for any UDDI registry
+ * to be affiliated with it.</p>
+ *
+ * <p class="MsoBodyText">Designating new authorities is done by publishing key
+ * generator tModels in the root registry, in one or more of the registries
+ * affiliated with the root registry or both. The owner of a key generator
+ * tModel is the naming authority for the partition the tModel represents. </p>
+ *
+ * <h3><a name="_Toc85908098"></a><a name="_Toc53709293"></a><a
+ * name="_Toc45096379"></a><a name="_Toc45095922"></a><a
+ * name="_Toc42047299"></a><a name="_Ref8978999">5.2.3 Special considerations
+ * for validated value sets</a></h3>
+ *
+ * <p class="MsoBodyText">Several of the APIs defined in this section allow
+ * publishers to save category and identifier information in support of searches
+ * that use category and identifier system references. The save_business,
+ * save_service, save_binding and save_tModel APIs allow designation of these
+ * value set references. Categorization is specified using the element
+ * named categoryBag, which contains namespace-qualified references to
+ * categories and descriptions. categoryBags can also contain groups of
+ * these references to categories and descriptions. Identifiers are
+ * specified using the identifierBag element, which contains namespace-qualified
+ * references to identifiers and descriptions.</p>
+ *
+ * <p class="MsoBodyText">Similarly, the add_publisherAssertions and
+ * set_publisherAssertions APIs allow publisherAssertion elements to be
+ * saved. These publisherAssertion elements contain a characterization of
+ * the relationship being established using a keyedReference element that refers
+ * to a relationship type system.</p>
+ *
+ * <p class="MsoBodyText">Identifier, category and relationship type systems
+ * taken together are referred to as "value sets." UDDI allows value sets
+ * to be checked or unchecked. References to checked value sets that are
+ * registered in UDDI can be checked internally by the UDDI nodes where
+ * publishing takes place, or externally by a provider of a validation Web
+ * service. The UDDI node can also choose to not support some or all
+ * checked value sets.</p>
+ *
+ * <p class="MsoBodyText">When a UDDI node encounters a reference to a checked
+ * value set in a keyedReference it will either ensure the reference is
+ * validated or fail the save. Such references to supported checked value
+ * sets are verified for validity according to the validation algorithm defined
+ * for the value set and described by its tModel. When all checks succeed,
+ * the save is permitted. An E_unvalidatable error indicates the checked
+ * value set is supported but its validation algorithm is not available.
+ * An E_unsupported indicates the checked value set is not supported by the
+ * node. E_invalidValue or E_valueNotAllowed indicate one or more
+ * references failed validation. When the checked value set is not
+ * supported, the value setâs validation algorithm is unavailable, or any of the
+ * references fail validation, the save operation MUST fail. </p>
+ *
+ * <p class="MsoBodyText">When the UDDI node supports a checked value set it may
+ * check the references itself, or consult a validation Web service. For
+ * cached checked value sets, the UDDI node verifies that referenced keyValues
+ * are in the set of valid values for the value set. The selection of an
+ * algorithm for verifying a checked value set is a matter of registry policy as
+ * detailed in Chapter <a href="#_Ref8980043 ">9</a> <i>Policy</i>.</p>
+ *
+ * <p class="MsoBodyText">A category group system is portrayed by a
+ * keyedRefererenceGroup element. Each keyedReferenceGroup has a tModelKey
+ * that references the category group system, and a set of contained
+ * keyedReference elements that make up the actual group of categories.
+ * Similar to references to checked value sets, validation is carried out for a
+ * keyedReferenceGroup if the referenced category group system is checked.
+ * Such validation entails verification that the keyedReferenceGroup is valid
+ * according to the validation algorithm described by the tModel for the
+ * category group system. Validation for a keyedReferenceGroup that
+ * references a cached checked category group system involves verification that
+ * the tModels referenced by the contained keyedReference elements are valid for
+ * the category group system. The set of valid values for such a cacheable
+ * checked category group system is defined by the tModelKeys for the set of
+ * tModels that can participate in the group.</p>
+ *
+ * <p class="MsoBodyText">No validation is performed on references to unchecked
+ * value sets</p>
+ *
+ * <h3><a name="_Toc85908099"></a><a name="_Toc53709294"></a><a
+ * name="_Toc45096380"></a><a name="_Toc45095923"></a><a
+ * name="_Toc42047300"></a><a name="_Ref535223605"></a><a
+ * name="_Toc528997553"></a><a name="_Toc525464313"></a><a
+ * name="_Hlt536851811"></a>5.2.4 Special considerations for the xml:lang
+ * attribute</h3>
+ *
+ * <p class="MsoBodyText">During save_xx API calls, the name, description,
+ * address, and personName UDDI elements MAY be adorned with the xml:lang
+ * attribute to indicate the language in which their content is expressed. (See
+ * Chapter <a href="#_Ref8981895 ">3</a> <i>UDDI Registry Data
+ * Structures</i>.) When an optional xml:lang attribute is omitted from an
+ * element, no xml:lang attribute will be saved for that element.</p>
+ *
+ * <p class="MsoBodyText">Name elements in UDDI core data structures are
+ * frequently the main targets for sorts during UDDI inquiries. When a
+ * UDDI data structure has multiple names, sorting occurs on the first
+ * name. Care should be taken to list the primary name first when the
+ * entity is saved to ensure the proper placement of the entity in a sorted
+ * result set.</p>
+ *
+ * <p class="MsoBodyText">Values which can be passed in the language supplied in
+ * a save_xx API call MUST obey the recommended rules and syntax governing the
+ * xml:lang data type as defined in Section <a href="#_Ref8977786 ">3.3.2.3</a>
+ * <i>name</i>.</p>
+ *
+ * <h3><a name="_Toc528997554"></a><a name="_Toc525464316"></a><a
+ * name="_Toc85908100"></a><a name="_Toc53709295"></a><a
+ * name="_Toc45096381"></a><a name="_Toc45095924"></a><a
+ * name="_Toc42047301">5.2.5 Publisher </a>API summary</h3>
+ *
+ * <p class="MsoBodyText">The publishing API calls are:</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_add_publisherAssertions"><b><span
+ * style="color:windowtext;
+ * text-decoration:none">add_publisherAssertions</span></b></a>: Used to add
+ * relationship assertions to the existing set of assertions. See Appendix
+ * A <i>Relationships and Publisher Assertions</i>.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_delete_binding"><b><span style="color:windowtext;
+ * text-decoration:none">delete_binding</span></b></a>: Used to remove an
+ * existing bindingTemplate from the registry.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_save_business"><b><span style="color:windowtext;
+ * text-decoration:none">delete_business</span></b></a>: Used to delete existing
+ * businessEntity information from the registry.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_delete_publisherAssertions"><b><span style="color:
+ * windowtext;text-decoration:none">delete_publisherAssertions</span></b></a>:
+ * Used to delete specific publisher assertions from the assertion collection
+ * controlled by a particular publisher. Deleting assertions from the
+ * assertion collection affects the visibility of business relationships.
+ * Deleting an assertion causes any relationships based on that assertion to
+ * become incomplete.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_delete_service"><b><span style="color:windowtext;
+ * text-decoration:none">delete_service</span></b></a>: Used to delete an
+ * existing businessService from the registry.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_delete_tModel"><b><span style="color:windowtext;
+ * text-decoration:none">delete_tModel</span></b></a>: Used to hide existing
+ * information about a tModel. Any tModel hidden in this way is still
+ * usable for reference purposes and accessible via the get_tModelDetail API,
+ * but is hidden from find_tModel result sets. There is no specified way
+ * to delete a tModel.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_get_assertionStatusReport"><b><span
+ * style="color:windowtext;
+ * text-decoration:none">get_assertionStatusReport</span></b></a>: Used to get a
+ * status report containing publisher assertions and status information.
+ * This report is useful to help an administrator manage publisher assertions.
+ * Returns an assertionStatusReport that includes the status of all assertions
+ * made involving any businessEntity controlled by the requesting publisher.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_get_publisherAssertions"><b><span
+ * style="color:windowtext;
+ * text-decoration:none">get_publisherAssertions</span></b></a>: Used to get a
+ * list of publisher assertions that are controlled by an individual
+ * publisher. Returns a publisherAssertions structure containing all
+ * publisher assertions associated with a specific publisher.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_get_registeredInfo"><b><span
+ * style="color:windowtext;
+ * text-decoration:none">get_registeredInfo</span></b></a>: Used to request an
+ * abbreviated list of businesses and tModels currently managed by a given
+ * publisher.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_save_binding"><b><span style="color:windowtext;
+ * text-decoration:none">save_binding</span></b></a>: Used to register new
+ * bindingTemplate information or to update existing bindingTemplate
+ * information. Use this to control information about technical
+ * capabilities exposed by a registered business.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_save_business"><b><span style="color:windowtext;
+ * text-decoration:none">save_business</span></b></a>: Used to register new
+ * businessEntity information or update existing businessEntity
+ * information. Use this to control the full set of information about the
+ * entire business, including its businessService and bindingTemplate
+ * structures. This API has the broadest effect of all of the save_xx
+ * APIs.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_save_service"><b><span style="color:windowtext;
+ * text-decoration:none">save_service</span></b></a>: Used to register or
+ * update complete information about a businessService.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_save_tModel"><b><span style="color:windowtext;
+ * text-decoration:none">save_tModel</span></b></a>: Used to register or
+ * update information about a tModel.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><a href="#_set_publisherAssertions"><b><span
+ * style="color:windowtext;
+ * text-decoration:none">set_publisherAssertions</span></b></a>: Used to save
+ * the complete set of publisher assertions for an individual publisher.
+ * Replaces any existing assertions, and causes any old assertions that are not
+ * reasserted to be removed from the registry.</p>
*
*/
@WebService(name = "UDDI_Publication_PortType", targetNamespace = "urn:uddi-org:v3_service")
@@ -71,9 +696,113 @@ import org.uddi.api_v3.TModelDetail;
public interface UDDIPublicationPortType extends Remote {
/**
+ * The add_publisherAssertions API call causes one or more
+ * publisherAssertions to be added to an individual publisherâs assertion
+ * collection. See Appendix A Relationships and Publisher Assertions
+ * describing relationships and the API get_publisherAssertions for more
+ * information on this collection. <p class="MsoBodyText">The publisher must
+ * own the businessEntity referenced in the fromKey, the toKey, or
+ * both. If both of the businessKey values passed within an assertion
+ * are owned by the publisher, then the assertion is automatically complete
+ * and the relationship described in the assertion is visible via the
+ * find_relatedBusinesses API. To form a relationship when the
+ * publisher only owns one of the two keys passed, the assertion MUST be
+ * matched exactly by an assertion made by the publisher who owns the other
+ * business referenced. Assertions exactly match if and only if they: </p>
+ *
+ * <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in">1.<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span>refer to the same businessEntity in their fromKeys; </p>
+ *
+ * <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in">2.<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span>refer to the same businessEntity in their toKeys; </p>
*
- * @param body
+ * <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in">3.<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span>refer to the same tModel in their tModelKeys; </p>
+ *
+ * <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in">4.<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span>have identical keyNames; and </p>
+ *
+ * <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in">5.<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span>have identical keyValues.</p>
+ *
+ * <p class="MsoBodyText">When a publisherAssertion being added references a
+ * checked relationship system using the tModelKey in the contained
+ * keyedReference, the reference MUST be checked for validity prior to
+ * completion of the add, or the node must return E_unsupported, indicating
+ * it does not support the referenced checked relationship system.
+ * Validation of a relationship system reference entails verification that
+ * the reference is valid according to the validation algorithm defined for
+ * the relationship system and described by its tModel. For cached
+ * checked relationship systems, the validation algorithm verifies that
+ * referenced keyValues are in the set of valid values for the relationship
+ * system.</p>
+ *
+ * <p class="MsoBodyText">For registries supporting the subscription APIs at
+ * any node, it is necessary to track a modified date for publisherAssertion
+ * elements so that nodes have the necessary information for responding to
+ * subscription requests involving find_relatedBusinesses and
+ * get_assertionStatusReport filters.</p>
+ *
+ * @param body <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>authInfo</i></b>: This optional argument is an
+ * element that contains an authentication token. Authentication
+ * tokens are obtained using the get_authToken API call or through some
+ * other method external to this specification. Registries that serve
+ * multiple publishers and registries that restrict who can publish in them
+ * typically require authInfo for this call.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>publisherAssertion</i></b>: This required repeating
+ * element holds the relationship assertions that are being added.
+ * Relationship assertions consist of a reference to two businessEntity key
+ * values as designated by the fromKey and toKey elements, as well as a
+ * REQUIRED expression of directional relationship within the contained
+ * keyedReference element. See Appendix A <i>Relationships and
+ * PublisherAssertions</i> on managing relationships. The fromKey, the
+ * toKey, and all three parts of the keyedReference â the tModelKey, the
+ * keyName, and the keyValue MUST be specified or the call will fail with
+ * the error E_fatalError. Empty (zero length) keyNames and keyValues are
+ * permitted.</p> Upon successful completion, an empty message is returned.
+ * See section 4.8 Success and Error Reporting.
* @throws DispositionReportFaultMessage, RemoteException
+ *
+ * <p class="MsoBodyText">If an error occurs in processing this API call, a
+ * dispositionReport structure MUST be returned to the caller in a SOAP
+ * Fault. See Section <a href="#_Ref8978558 ">4.8</a> <i>Success and Error
+ * Reporting. </i>In addition to the errors common to all APIs, the
+ * following error information is relevant here:</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_invalidKeyPassed</b>: signifies that one of the
+ * <i>uddiKey</i> values passed did not match with any known businessKey or
+ * tModelKey values. The key and element or attribute that caused the
+ * problem SHOULD be clearly indicated in the error text.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_userMismatch</b>: signifies that neither of the
+ * businessKey values passed in the embedded fromKey and toKey elements is
+ * owned by the publisher associated with the authentication token.
+ * The error text SHOULD clearly indicate which assertion caused the
+ * error.</p>
*/
@WebMethod(operationName = "add_publisherAssertions", action = "add_publisherAssertions")
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
@@ -82,9 +811,55 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * The delete_binding API call causes one or more instances of
+ * bindingTemplate data to be deleted from the UDDI registry.
*
- * @param body
- * @throws DispositionReportFaultMessage, RemoteException
+ * @param body <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>authInfo</i></b>: This optional argument is an
+ * element that contains an authentication token. Authentication
+ * tokens are obtained using the get_authToken API call or through some
+ * other method external to this specification. Registries that serve
+ * multiple publishers and registries that restrict who can publish in them
+ * typically require authInfo for this call.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>bindingKey</i></b>: One or more required
+ * <i>uddiKey</i> values that represent specific instances of known
+ * bindingTemplate data.</p>
+ *
+* Upon successful completion, an empty message is returned. See section 4.8
+ * Success and Error Reporting.
+ * @throws DispositionReportFaultMessage, RemoteException <p
+ * class="MsoBodyText">If an error occurs in processing this API call, a
+ * dispositionReport structure MUST be returned to the caller in a SOAP
+ * Fault. See Section <a href="#_Ref8978558 ">4.8</a> <i>Success and
+ * Error Reporting. </i>In addition to the errors common to all APIs,
+ * the following error information is relevant here:</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_invalidKeyPassed</b>: Signifies that one of the
+ * <i>uddiKey</i> values passed did not match with any known bindingKey
+ * values or multiple instances of the same bindingKey values were
+ * passed. No partial results are returned â if any bindingKey values
+ * passed are not valid, this error is returned. The key that caused
+ * the problem SHOULD clearly be indicated in the error text.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_userMismatch</b>: Signifies that one or more of the
+ * bindingKey values passed refers to a bindingTemplate that is not owned by
+ * the individual publisher associated with the authentication token.</p>
+ *
+ * <b><span
+ * style="font-size:13.0pt;font-family:Arial;color:navy"></span></b>
*/
@WebMethod(operationName = "delete_binding", action = "delete_binding")
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
@@ -93,9 +868,72 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * The delete_business API call is used to remove one or more business
+ * registrations and all elements that correspond to the natural content of
+ * the corresponding businessEntity elements from a UDDI registry.
*
- * @param body
- * @throws DispositionReportFaultMessage, RemoteException
+ * @param body · authInfo: This optional argument is an element that
+ * contains an authentication token. Authentication tokens are obtained
+ * using the get_authToken API call or through some other means external to
+ * this specification. Registries that serve multiple publishers and
+ * registries that restrict who can publish in them typically require
+ * authInfo for this call.
+ *
+ * · businessKey: One or more required uddiKey values that represent
+ * specific instances of known businessEntity data. <p
+ * class="MsoBodyText">The UDDI registry MUST permanently remove all of the
+ * <i>natural contents</i><a href="#_ftn22" name="_ftnref22" title=""><span
+ * class="MsoFootnoteReference"><span class="MsoFootnoteReference"><span
+ * style="font-size:10.0pt;letter-spacing:-.25pt">[22]</span></span></span></a>
+ * of the passed businessEntity elements, including any currently nested
+ * businessService and bindingTemplate data, from the UDDI registry.</p>
+ *
+ * <p class="MsoBodyText">If there are service projections<a href="#_ftn23"
+ * name="_ftnref23" title=""><span class="MsoFootnoteReference"><span
+ * class="MsoFootnoteReference"><span
+ * style="font-size:10.0pt;letter-spacing:-.25pt">[23]</span></span></span></a>
+ * that reference businessService elements deleted in this way, they are
+ * left untouched. Such "broken" service projections appear in their
+ * businessEntity as businessService elements containing the businessKey and
+ * serviceKey attributes as their only content. For this reason, it is a
+ * best practice to coordinate references to businessService data published
+ * under another businessEntity with the party who manages that data.
+ * </p>
+ *
+ * <p class="MsoBodyText">All publisher assertions that reference the
+ * businessKey of the businessEntity being deleted in either the fromKey or
+ * toKey of the publisherAssertion MUST be automatically deleted. A
+ * deleted business MUST not be returned in the find_relatedBusinesses
+ * API.</p>
+ *
+ * <p class="MsoBodyText">Any transferToken referring to the business entity
+ * being deleted becomes invalid and can no longer be used to transfer any
+ * entities.</p> Upon successful completion, an empty message is returned.
+ * See section 4.8 Success and Error Reporting.
+ * @throws DispositionReportFaultMessage, RemoteException <p
+ * class="MsoBodyText">If an error occurs in processing this API call, a
+ * dispositionReport element MUST be returned to the caller within a SOAP
+ * Fault. See Section <a href="#_Ref8978558 ">4.8</a> <i>Success and
+ * Error Reporting. </i>In addition to the errors common to all APIs,
+ * the following error information is relevant here:</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_invalidKeyPassed</b>: Signifies that one of the
+ * <i>uddiKey</i> values passed did not match with any known businessKey
+ * values or multiple instances of the same businessKey values were passed.
+ * The key that caused the error SHOULD be clearly indicated in the error
+ * text.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_userMismatch</b>: Signifies that one or more of the
+ * businessKey values passed refers to data that is not owned by the
+ * individual publisher who is represented by the authentication token.</p>
+ *
+ * <p class="MsoNormal"> </p>
*/
@WebMethod(operationName = "delete_business", action = "delete_business")
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
@@ -104,9 +942,59 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * The delete_publisherAssertions API call causes one or more
+ * publisherAssertion elements to be removed from a publisherâs assertion
+ * collection. See Appendix A Relationships and Publisher Assertions and the
+ * API get_publisherAssertions for more information on this collection.
*
- * @param body
- * @throws DispositionReportFaultMessage, RemoteException
+ * @param body <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>authInfo</i></b>: This optional argument is an
+ * element that contains an authentication token. Authentication
+ * tokens are obtained using the get_authToken API call or through some
+ * other means external to this specification. Registries that serve
+ * multiple publishers and registries that restrict who can publish in them
+ * typically require authInfo for this call.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>publisherAssertion</i></b>: One or more required
+ * publisher assertion structures exactly matching an existing assertion in
+ * the publisherâs assertion collection.</p> <p class="MsoBodyText">The UDDI
+ * registry scans the assertion collection associated with the publisher,
+ * and removes any assertions that exactly match all parts of each
+ * publisherAssertion passed. Any assertions described that cannot be
+ * located result in an error. The removal of assertions in this API
+ * causes the corresponding relationships to no longer be visible via the
+ * find_relatedBusinesses API.</p>
+ *
+ * <p class="MsoBodyText">For registries supporting the subscription APIs at
+ * any node, it is necessary to track a modified date for publisherAssertion
+ * elements so that nodes have the necessary information for responding to
+ * subscription requests involving find_relatedBusinesses and
+ * get_assertionStatusReport filters.</p> Upon successful completion, an
+ * empty message is returned. See section 4.8 Success and Error Reporting.
+ * @throws DispositionReportFaultMessage, RemoteException <p
+ * class="MsoBodyText">If an error occurs in processing this API call, a
+ * dispositionReport structure MUST be returned to the caller in a SOAP
+ * Fault. See Section <a href="#_Ref8978558 ">4.8</a> <i>Success and
+ * Error Reporting. </i>In addition to the errors common to all APIs,
+ * the following error information is relevant here:</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_assertionNotFound</b>: Signifies that one of the
+ * assertion structures passed does not have any corresponding match in the
+ * publisherâs assertion collection or multiple instances of the same
+ * publisherAssertions elements were passed. The assertion that caused
+ * the problem SHOULD be clearly indicated in the error text. </p>
+ *
+ * <b><span
+ * style="font-size:13.0pt;font-family:Arial;color:navy"></span></b>
*/
@WebMethod(operationName = "delete_publisherAssertions", action = "delete_publisherAssertions")
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
@@ -115,9 +1003,53 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * The delete_service API call is used to remove one or more businessService
+ * elements from the UDDI registry and from its containing businessEntity
+ * parent.
*
- * @param body
- * @throws DispositionReportFaultMessage, RemoteException
+ * @param body <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>authInfo</i></b>: This optional argument is an
+ * element that contains an authentication token. Authentication
+ * tokens are obtained using the get_authToken API call or through some
+ * other means external to this specification. Registries that serve
+ * multiple publishers and registries that restrict who can publish in them
+ * typically require authInfo for this call.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>serviceKey</i></b>: One or more required
+ * <i>uddiKey</i> values that represent specific instances of known
+ * businessService data.</p> <p class="MsoBodyText">All contained
+ * bindingTemplate data MUST also be removed from the registry as a result
+ * of this call.</p>
+ *
+ * <p class="MsoBodyText">If a business service being deleted is the target
+ * of a business service projection associated with another businessEntity,
+ * the referencing businessService elements are left untouched. Such
+ * "broken" service projections appear in their businessEntity and
+ * businessService elements containing the businessKey and serviceKey
+ * attributes as their only content. For this reason, it is
+ * recommended that references to businessService data published under
+ * another businessEntity be coordinated with the party that manages that
+ * data. </p>
+ * @throws DispositionReportFaultMessage, RemoteException If an error occurs
+ * in processing this API call, a dispositionReport structure MUST be
+ * returned to the caller in a SOAP Fault. See Section 4.8 Success and Error
+ * Reporting. In addition to the errors common to all APIs, the following
+ * error information is relevant here:
+ *
+ * · E_invalidKeyPassed: Signifies that one of the uddiKey values passed did
+ * not match with any known serviceKey values or multiple instances of the
+ * same serviceKey values were passed. The key causing the error SHOULD be
+ * clearly indicated in the error text.
+ *
+ * · E_userMismatch: Signifies that one or more of the serviceKey values
+ * passed refers to data that is not owned by the individual publisher who
+ * is represented by the authentication token.
*/
@WebMethod(operationName = "delete_service", action = "delete_service")
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
@@ -126,9 +1058,60 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * The delete_tModel API call is used to logically delete one or more tModel
+ * structures. Logical deletion hides the deleted tModels from find_tModel
+ * result sets but does not physically delete them. New references to
+ * deleted (hidden) tModels can be established by publishers that know their
+ * keys. Deleting an already deleted tModel has no effect.
*
- * @param body
- * @throws DispositionReportFaultMessage, RemoteException
+ * @param body <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>authInfo</i></b>: This optional argument is an
+ * element that contains an authentication token. Authentication
+ * tokens are obtained using the get_authToken API call or through some
+ * other means external to this specification. Registries that serve
+ * multiple publishers and registries that restrict who can publish in them
+ * typically require authInfo for this call.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>tModelKey</i></b>: One or more required
+ * <i>uddiKey</i> values that represent specific instances of known tModel
+ * data.</p> <p class="MsoBodyText">If a tModel is hidden in this way it
+ * MUST not be physically deleted as a result of this call. Any tModels
+ * hidden in this way are still accessible, via the get_registeredInfo and
+ * get_tModelDetail APIs, but are omitted from any results returned by calls
+ * to find_tModel. All other inquiry APIs may include references to
+ * tModelKeys of deleted tModelKeys, and UDDI data structures that reference
+ * these tModels are found and retrieved. </p>
+ *
+ * <p class="MsoBodyText">The purpose of the delete_tModel behavior is to
+ * ensure that the details associated with a hidden tModel are still
+ * available to anyone currently using the tModel. A hidden tModel can
+ * be restored and made visible to search results by invoking the
+ * save_tModel API at a later time, passing the original data and the
+ * tModelKey value of the hidden tModel.</p>
+ *
+ * <p class="MsoBodyText">It is not an error to transfer a hidden tModel
+ * (i.e. deleted attribute set to TRUE).</p> Upon successful completion, an
+ * empty message is returned. See section 4.8 Success and Error Reporting.
+ * @throws DispositionReportFaultMessage, RemoteException If an error occurs
+ * in processing this API call, a dispositionReport element MUST be returned
+ * to the caller within a SOAP Fault. See Section 4.8 Success and Error
+ * Reporting. In addition to the errors common to all APIs, the following
+ * error information is relevant here:
+ *
+ * · E_invalidKeyPassed: Signifies that one of the uddiKey values passed did
+ * not match with any known tModelKey values or multiple instances of the
+ * same tModelKey values were passed. The invalid key references SHOULD be
+ * clearly indicated in the error text.
+ *
+ * · E_userMismatch: Signifies that one or more of the tModelKey values
+ * passed refers to data that is not owned by the individual publisher who
+ * is represented by the authentication token.
*/
@WebMethod(operationName = "delete_tModel", action = "delete_tModel")
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
@@ -137,11 +1120,149 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * The get_assertionStatusReport API call provides administrative support
+ * for determining the status of current and outstanding publisher
+ * assertions that involve any of the business registrations managed by the
+ * individual publisher. Using this API, a publisher can see the status of
+ * assertions that they have made, as well as see assertions that others
+ * have made that involve businessEntity structures controlled by the
+ * requesting publisher. See Appendix A Relationships and Publisher
+ * Assertions for more information.
*
* @param completionStatus
- * @param authInfo
- * @return returns java.util.List<org.uddi.api_v3.AssertionStatusItem>
- * @throws DispositionReportFaultMessage, RemoteException
+ * @param authInfo <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>authInfo</i></b>: This optional argument is an
+ * element that contains an authentication token. Authentication
+ * tokens are obtained using the get_authToken API call or through some
+ * other means external to this specification. Registries that serve
+ * multiple publishers and registries that restrict who can publish in them
+ * typically require authInfo for this call.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>completionStatus</i></b>: This optional argument lets
+ * the publisher restrict the result set to only those relationships that
+ * have the specified status value. Assertion status is a calculated
+ * result based on the sum total of assertions made by the individuals that
+ * control specific business registrations. When no completionStatus
+ * element is provided, all assertions involving the businesses that the
+ * publisher owns are retrieved, without regard to the completeness of the
+ * relationship. completionStatus MUST contain one of the following
+ * values</p>
+ *
+ * <p class="MsoNormal" style="margin-left:1.5in;text-indent:-.25in"><span
+ * style="font-family:"Courier New"">o<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span></span><b>status:complete</b>: Passing this value causes only the
+ * publisher assertions that are complete to be returned. Each
+ * businessEntity listed in assertions that are complete has a visible
+ * relationship that directly reflects the data in a complete assertion (as
+ * described in the find_relatedBusinesses API).</p>
+ *
+ * <p class="MsoNormal" style="margin-left:1.5in;text-indent:-.25in"><span
+ * style="font-family:"Courier New"">o<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span></span><b>status:toKey_incomplete</b>: Passing this value causes
+ * only those publisher assertions where the party who controls the
+ * businessEntity referenced by the toKey value in an assertion, has not
+ * made a matching assertion, to be listed.</p>
+ *
+ * <p class="MsoNormal" style="margin-left:1.5in;text-indent:-.25in"><span
+ * style="font-family:"Courier New"">o<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span></span><b>status:fromKey_incomplete</b>: Passing this value causes
+ * only those publisher assertions where the party who controls the
+ * businessEntity referenced by the fromKey value in an assertion, has not
+ * made a matching assertion, to be listed.</p>
+ *
+ * <p class="MsoNormal" style="margin-left:1.5in;text-indent:-.25in"><span
+ * style="font-family:"Courier New"">o<span style="font:7.0pt
+ * "Times New Roman"">
+ * </span></span><b>status:both_incomplete</b>. This status value, however,
+ * is only applicable to the context of UDDI subscription and SHOULD not be
+ * present as part of a response to a get_assertionStatusReport request.</p>
+ *
+ * <span
+ * style="font-size:10.0pt;font-family:Arial;letter-spacing:-.25pt"></span>
+ * @return returns java.util.List<org.uddi.api_v3.AssertionStatusItem> Upon
+ * successful completion, an assertionStatusReport structure is returned
+ * containing zero or more assertionStatusItem structures. Elements will be
+ * sorted by last date change in ascending order.
+ *
+ * The assertionStatusReport has the form: <img
+ * src="http://uddi.org/pubs/uddi-v3.0.2-20041019_files/image067.gif"> <p
+ * class="MsoBodyText">The assertionStatusReport reports all complete and
+ * incomplete assertions and serves an administrative use for determining if
+ * there are any outstanding, incomplete assertions pertaining to
+ * relationships involving businesses with which the publisher is
+ * associated.</p>
+ *
+ * <p class="MsoBodyText">Since the publisher who was authenticated by the
+ * get_assertionStatusReport API may own several businesses, the
+ * assertionStatusReport structure shows the assertions made for all
+ * businesses owned by the publisher.</p>
+ *
+ * <p class="MsoBodyText">The assertion status report is composed of a set
+ * of assertionStatusItem elements that describe the assertions in which the
+ * publisherâs businesses participate. The assertionStatusItem element
+ * has the form:</p>
+ *
+ * <p class="MsoBodyText"><img
+ * src="http://uddi.org/pubs/uddi-v3.0.2-20041019_files/image068.gif"
+ * border="0" height="170" width="393"></p>
+ *
+ * <p class="MsoBodyText"> </p>
+ *
+ * <p class="MsoBodyText">The assertionStatusItem structure has the
+ * following attribute:</p>
+ *
+ * <table class="MsoNormalTable"
+ * style="margin-left:48.75pt;border-collapse:collapse;border:none"
+ * border="1" cellpadding="0" cellspacing="0"> <tbody><tr> <td
+ * style="border:solid black 1.0pt;background:#FFFFCA;padding: 0in 5.4pt 0in
+ * 5.4pt" valign="top"> <p class="MsoNormal"><b>Name </b></p> </td>
+ * <td style="border:solid black 1.0pt;border-left:none;background:
+ * #FFFFCA;padding:0in 5.4pt 0in 5.4pt" valign="top"> <p
+ * class="MsoNormal"><b>Use </b></p> </td> </tr> <tr> <td
+ * style="border:solid black 1.0pt;border-top:none;padding:0in 5.4pt 0in
+ * 5.4pt" valign="top"> <p class="MsoNormal">completionStatus </p>
+ * </td> <td style="border-top:none;border-left:none;border-bottom:solid
+ * black 1.0pt; border-right:solid black 1.0pt;padding:0in 5.4pt 0in 5.4pt"
+ * valign="top"> <p class="MsoNormal">required</p> </td> </tr>
+ * </tbody></table>
+ *
+ * <p class="MsoNormal"> </p>
+ *
+ * <p class="MsoBodyText">While the elements fromKey, toKey and
+ * keyedReference together identify the assertion on whose status a report
+ * is being provided, the keysOwned element designates those businessKeys
+ * the publisher manages. The keysOwned element has the form:</p>
+ *
+ * <p class="MsoBodyText"><img
+ * src="http://uddi.org/pubs/uddi-v3.0.2-20041019_files/image069.gif"
+ * border="0" height="137" width="372"></p>
+ *
+ * <p class="MsoBodyText">An assertion is part of a reciprocal relationship
+ * only if the completionStatus attribute has a value "status:complete". If
+ * completionStatus has a value "status:toKey_incomplete" or
+ * "status:fromKey_incomplete", the party who controls the businessEntity
+ * referenced by the toKey or the fromKey has not yet made a matching
+ * assertion.</p>
+ * @throws DispositionReportFaultMessage, RemoteException If an error occurs
+ * in processing this API call, a dispositionReport element MUST be returned
+ * to the caller within a SOAP Fault. See Section 4.8 Success and Error
+ * Reporting. In addition to the errors common to all APIs, the following
+ * error information is relevant here:
+ *
+ * · E_invalidCompletionStatus: Signifies that the completionStatus value
+ * passed is unrecognized. The completion status that caused the problem
+ * SHOULD be clearly indicated in the error text.
+ *
+ *
*/
@WebMethod(operationName = "get_assertionStatusReport", action = "get_assertionStatusReport")
@WebResult(name = "assertionStatusItem", targetNamespace = "urn:uddi-org:api_v3")
@@ -153,10 +1274,30 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * The get_publisherAssertions API call is used to obtain the full set of
+ * publisher assertions that is associated with an individual publisher. It
+ * complements the get_registeredInfo API which returns information about
+ * businesses, services, bindings, and tModels managed by a publisher.
*
- * @param authInfo
- * @return returns java.util.List<org.uddi.api_v3.PublisherAssertion>
- * @throws DispositionReportFaultMessage, RemoteException
+ * @param authInfo · authInfo: This optional argument is an element that
+ * contains an authentication token. Authentication tokens are obtained
+ * using the get_authToken API call or through some other means external to
+ * this specification. Registries that serve multiple publishers and
+ * registries that restrict who can publish in them typically require
+ * authInfo for this call.
+ * @return returns java.util.List<org.uddi.api_v3.PublisherAssertion> This
+ * API call returns a publisherAssertions structure that contains a
+ * publisherAssertion element for each publisher assertion registered by the
+ * publisher. When the registry distinguishes between publishers, this
+ * information is associated with the authentication information. Only
+ * assertions made by the publisher are returned. Elements will be sorted by
+ * last date change in ascending order. See get_assertionStatusReport and
+ * Appendix A Relationships and Publisher Assertions for more details.
+ *
+ * The publisherAssertions structure has the form: <img
+ * src="http://uddi.org/pubs/uddi-v3.0.2-20041019_files/image071.gif">
+ * @throws DispositionReportFaultMessage, RemoteException None, other than
+ * those common to all UDDI APIs. See Section 12.1 Common Error Codes.
*/
@WebMethod(operationName = "get_publisherAssertions", action = "get_publisherAssertions")
@WebResult(name = "publisherAssertion", targetNamespace = "urn:uddi-org:api_v3")
@@ -167,7 +1308,7 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
- * he get_registeredInfo API call is used to get an abbreviated list of all
+ * The get_registeredInfo API call is used to get an abbreviated list of all
* businessEntity and tModel data that are controlled by a publisher. When
* the registry distinguishes between publishers, this is the individual
* associated with the credentials passed in the authInfo element. This
@@ -210,10 +1351,162 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * The save_binding API call is used to save or update a complete
+ * bindingTemplate element. It can be used to add or update one or more
+ * bindingTemplate elements as well as the container/contained relationship
+ * that each bindingTemplate has with one or more existing businessService
+ * elements. Each bindingTemplate MAY be signed and MAY have
+ * publisher-assigned keys.
*
- * @param body
- * @return returns org.uddi.api_v3.BindingDetail
- * @throws DispositionReportFaultMessage, RemoteException
+ * @param body <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>authInfo</i></b>: This optional argument is an
+ * element that contains an authentication token. Authentication
+ * tokens are obtained using the get_authToken API call or through some
+ * other means external to this specification. Registries that serve
+ * multiple publishers and registries that restrict who can publish in them
+ * typically require authInfo for this call.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>bindingTemplate</i></b>: Required repeating element
+ * containing one or more complete bindingTemplate structures. To save a new
+ * bindingTemplate, a bindingTemplate element is passed with either an empty
+ * bindingKey attribute value, or with a publisher-assigned bindingKey. See
+ * Section <a href="#_Ref8978954 ">5.2.2.2</a> <i>Behavior of
+ * Publishers</i>. </p> <p class="MsoBodyText"><span lang="EN-AU">Each new
+ * bindingTemplate passed MUST contain a serviceKey value that corresponds
+ * to a registered businessService controlled by the same publisher. An
+ * existing binding template MAY contain a serviceKey value that corresponds
+ * to a registered businessService controlled by the same
+ * publisher</span>. The net effect of this call is to determine the
+ * containing parent businessService for each bindingTemplate affected by
+ * this call. If the same bindingTemplate (determined by matching bindingKey
+ * value) is listed more than once, any relationship to the containing
+ * businessService is determined by processing order, which is determined by
+ * the position of the bindingTemplate data in first to last order.</p>
+ *
+ * <p class="MsoBodyText">If the bindingKey within a bindingTemplate element
+ * is missing or is passed with an empty value, this is a signal that the
+ * bindingTemplate is being inserted for the first time. When this
+ * occurs, the node MUST automatically generate a new key for the
+ * bindingTemplate that is without an associated key. New bindingTemplate
+ * structures can also be added with publisher-assigned keys. See Section <a
+ * href="#_Ref8978954 ">5.2.2.2</a> <i>Behavior of Publishers</i>.</p>
+ *
+ * <p class="MsoBodyText">Using this API call it is possible to move an
+ * existing bindingTemplate from one businessService to another by simply
+ * specifying a different parent businessService relationship along with the
+ * complete bindingTemplate. Changing a parent relationship in this
+ * way causes two businessService structures to be affected. The net
+ * result of such a move is that the bindingTemplate still resides within
+ * one, and only one businessService based on the value of the serviceKey
+ * passed. An attempt to move a bindingTemplate in this manner by a party
+ * who is not the publisher of the businessService that is specified by the
+ * serviceKey MUST be rejected with an error E_userMismatch.</p>
+ *
+ * <p class="MsoBodyText">When a bindingTemplate is saved with a categoryBag
+ * content that is associated with a checked value set or category group
+ * system tModel, the references MUST be checked for validity prior to
+ * completion of the save, or the node must return E_unsupported, indicating
+ * it does not support the referenced checked value set or category group
+ * system. See Section <a href="#_Ref8978999 ">5.2.3</a> <i>Special
+ * considerations for validated value sets</i> and Appendix F <i>Using
+ * Categorization</i> for additional details.</p>
+ * @return returns org.uddi.api_v3.BindingDetail This API returns a
+ * bindingDetail structure containing the results of the call that reflects
+ * the newly registered information for the effected bindingTemplate
+ * elements. If more than one bindingTemplate is saved in a single
+ * save_binding call, the resulting bindingDetail MUST return results in the
+ * same order that they appeared in the save_binding call. If the same
+ * bindingTemplate (determined by matching bindingKey) is listed more than
+ * once in the save_binding call, it MAY be listed once in the result for
+ * each appearance in the save_binding call. If the same bindingTemplate
+ * appears more than once in the response, the last occurrence of the
+ * bindingTemplate in the results represents the state stored in the
+ * registry. Any bindingKeys that were assigned as a result of processing
+ * the save_binding call are included in the bindingTemplate data.
+ *
+ * The bindingDetail structure has the form: <img
+ * src="http://uddi.org/pubs/uddi-v3.0.2-20041019_files/image075.gif">
+ * @throws DispositionReportFaultMessage, RemoteException <p
+ * class="MsoBodyText">If an error occurs in processing this API call, a
+ * dispositionReport element MUST be returned to the caller in a SOAP
+ * Fault. See Section <a href="#_Ref8978558 ">4.8</a> <i>Success and
+ * Error Reporting. </i>In addition to the errors common to all APIs,
+ * the following error information is relevant here:</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_accountLimitExceeded</b>: Signifies that user account
+ * limits have been exceeded. </p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_invalidKeyPassed</b>: Signifies that the request
+ * cannot be satisfied because one or more <i>uddiKey</i> values specified
+ * are not valid key values for the entities being published. tModelKey,
+ * serviceKey, or bindingKey values that either do not exist, or exist with
+ * a different entity type, or are not authorized to be proposed by the
+ * publisher are considered to be invalid values. The key causing the error
+ * SHOULD be clearly indicated in the error text. This error code will also
+ * be returned in the event that the serviceKey is not provided and the
+ * bindingKey is either absent or has a value not registered in the
+ * registry. In this case, the error text SHOULD clearly indicate the use of
+ * an incomplete bindingTemplate.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_invalidValue</b>: A value that was passed in a
+ * keyValue attribute did not pass validation. This applies to checked
+ * value sets that are referenced using keyedReferences. The error text
+ * SHOULD clearly indicate the key and value combination that failed
+ * validation.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><span
+ * style="layout-grid-mode:line">E_keyUnavailable</span></b><span
+ * style="layout-grid-mode:line">: Indicates that the proposed key has
+ * already been assigned to some other publisher or is not within the
+ * partition defined by a key generator tModel that the publisher
+ * owns.</span></p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_requestTimeout</b>: Signifies that the request could
+ * not be carried out because a needed validate_values service did not
+ * respond in a reasonable amount of time. Details identifying the failing
+ * Web service SHOULD be included in the dispositionReport element.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_userMismatch</b>: Signifies that one or more of the
+ * <i>uddiKey </i>values passed refers to data that is not owned by the
+ * individual publisher who is represented by the authentication token.</p>
+ *
+ * <p class="MsoBodyText" style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b>E_valueNotAllowed</b>: Restrictions have been placed by
+ * the value set provider on the types of information that should be
+ * included at that location within a specific value set. A validate_values
+ * Web service chosen by the UDDI node has rejected this businessEntity for
+ * at least one specified keyedReference. The error text SHOULD
+ * clearly indicate the keyedReference that was not successfully
+ * validated.</p>
+ *
+ * <span
+ * style="font-size:10.0pt;font-family:Arial;letter-spacing:-.25pt"></span>
*/
@WebMethod(operationName = "save_binding", action = "save_binding")
@WebResult(name = "bindingDetail", targetNamespace = "urn:uddi-org:api_v3", partName = "body")
@@ -223,10 +1516,258 @@ public interface UDDIPublicationPortType
throws DispositionReportFaultMessage, RemoteException;
/**
+ * <p class="MsoBodyText">The save_business API call is used to save or
+ * update information about a complete businessEntity structure. This
+ * API has the broadest scope of all of the save_xx API calls, and can be
+ * used to make sweeping changes to the published information for one or
+ * more businessEntity elements controlled by an individual.</p>
*
- * @param body
- * @return returns org.uddi.api_v3.BusinessDetail
- * @throws DispositionReportFaultMessage, RemoteException
+ * <p class="MsoBodyText">This API call can be used to establish a reference
+ * relationship to businessService structures that are managed as the
+ * contents of another businessEntity. In this way, a businessService
+ * that is a natural part of one businessEntity can appear as a <i>projected
+ * service</i> of another businessEntity. The content of a
+ * businessService projected in this way (by way of a reference established
+ * by this API) are not managed as a part of the referencing entity.</p>
+ *
+ * <p class="MsoBodyText">businessEntity structures MAY be signed and MAY
+ * have publisher-assigned keys.</p>
+ *
+ * @param body <p class="MsoBodyText"
+ * style="margin-left:1.0in;text-indent:-.25in"><span
+ * style="font-family:Symbol">·<span style="font:7.0pt "Times New
+ * Roman"">
+ * </span></span><b><i>authInfo</i></b>: This optional argument is an
[... 844 lines stripped ...]
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@juddi.apache.org
For additional commands, e-mail: commits-help@juddi.apache.org