| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <!-- NewPage --> |
| <html lang="en"> |
| <head> |
| <!-- Generated by javadoc (1.8.0_101) on Mon Sep 19 17:00:15 EDT 2022 --> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <title>UDDIValueSetValidationPortType (UDDIv2 and v3 WS Stubs and Schema Bindings Generated from WSDL 3.3.11-SNAPSHOT API)</title> |
| <meta name="date" content="2022-09-19"> |
| <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style"> |
| <script type="text/javascript" src="../../../script.js"></script> |
| </head> |
| <body> |
| <script type="text/javascript"><!-- |
| try { |
| if (location.href.indexOf('is-external=true') == -1) { |
| parent.document.title="UDDIValueSetValidationPortType (UDDIv2 and v3 WS Stubs and Schema Bindings Generated from WSDL 3.3.11-SNAPSHOT API)"; |
| } |
| } |
| catch(err) { |
| } |
| //--> |
| var methods = {"i0":6}; |
| var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"]}; |
| var altColor = "altColor"; |
| var rowColor = "rowColor"; |
| var tableTab = "tableTab"; |
| var activeTableTab = "activeTableTab"; |
| </script> |
| <noscript> |
| <div>JavaScript is disabled on your browser.</div> |
| </noscript> |
| <!-- ========= START OF TOP NAVBAR ======= --> |
| <div class="topNav"><a name="navbar.top"> |
| <!-- --> |
| </a> |
| <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div> |
| <a name="navbar.top.firstrow"> |
| <!-- --> |
| </a> |
| <ul class="navList" title="Navigation"> |
| <li><a href="../../../overview-summary.html">Overview</a></li> |
| <li><a href="package-summary.html">Package</a></li> |
| <li class="navBarCell1Rev">Class</li> |
| <li><a href="class-use/UDDIValueSetValidationPortType.html">Use</a></li> |
| <li><a href="package-tree.html">Tree</a></li> |
| <li><a href="../../../deprecated-list.html">Deprecated</a></li> |
| <li><a href="../../../index-all.html">Index</a></li> |
| <li><a href="../../../help-doc.html">Help</a></li> |
| </ul> |
| </div> |
| <div class="subNav"> |
| <ul class="navList"> |
| <li><a href="../../../org/uddi/v3_service/UDDIValueSetCachingPortType.html" title="interface in org.uddi.v3_service"><span class="typeNameLink">Prev Class</span></a></li> |
| <li>Next Class</li> |
| </ul> |
| <ul class="navList"> |
| <li><a href="../../../index.html?org/uddi/v3_service/UDDIValueSetValidationPortType.html" target="_top">Frames</a></li> |
| <li><a href="UDDIValueSetValidationPortType.html" target="_top">No Frames</a></li> |
| </ul> |
| <ul class="navList" id="allclasses_navbar_top"> |
| <li><a href="../../../allclasses-noframe.html">All Classes</a></li> |
| </ul> |
| <div> |
| <script type="text/javascript"><!-- |
| allClassesLink = document.getElementById("allclasses_navbar_top"); |
| if(window==top) { |
| allClassesLink.style.display = "block"; |
| } |
| else { |
| allClassesLink.style.display = "none"; |
| } |
| //--> |
| </script> |
| </div> |
| <div> |
| <ul class="subNavList"> |
| <li>Summary: </li> |
| <li>Nested | </li> |
| <li>Field | </li> |
| <li>Constr | </li> |
| <li><a href="#method.summary">Method</a></li> |
| </ul> |
| <ul class="subNavList"> |
| <li>Detail: </li> |
| <li>Field | </li> |
| <li>Constr | </li> |
| <li><a href="#method.detail">Method</a></li> |
| </ul> |
| </div> |
| <a name="skip.navbar.top"> |
| <!-- --> |
| </a></div> |
| <!-- ========= END OF TOP NAVBAR ========= --> |
| <!-- ======== START OF CLASS DATA ======== --> |
| <div class="header"> |
| <div class="subTitle">org.uddi.v3_service</div> |
| <h2 title="Interface UDDIValueSetValidationPortType" class="title">Interface UDDIValueSetValidationPortType</h2> |
| </div> |
| <div class="contentContainer"> |
| <div class="description"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <dl> |
| <dt>All Superinterfaces:</dt> |
| <dd><a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/Remote.html?is-external=true" title="class or interface in java.rmi">Remote</a></dd> |
| </dl> |
| <hr> |
| <br> |
| <pre>public interface <span class="typeNameLabel">UDDIValueSetValidationPortType</span> |
| extends <a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/Remote.html?is-external=true" title="class or interface in java.rmi">Remote</a></pre> |
| <div class="block">This portType defines all of the UDDI value set validation operations. |
| |
| This class was generated by the JAX-WS RI. |
| JAX-WS RI 2.1.5-b03- |
| Generated source version: 2.1 |
| |
| <p class="MsoBodyText">Whenever a keyedReference is involved in a save operation |
| it may be checked to see that it is valid. Similarly, a keyedReferenceGroup |
| element that is involved in a save operation may also be checked to ensure that |
| it is valid. Checking is performed for tModels that are deemed to be |
| "checked", as determined by the policy of the UDDI registry.</p> |
| |
| <p class="MsoBodyText">UDDI provides the ability for third parties to register |
| value sets, and then control the validation process used by UDDI to perform |
| such checks. UDDI registries MAY support caching of these external value sets. |
| UDDI registries MAY also support external validation. Node and registry |
| policies determine the manner in which validation of references to external |
| value sets is performed. The APIs in this section can be used by UDDI |
| registries and nodes in their validation policies.</p> |
| |
| <p class="MsoBodyText">Third parties that want to provide an external checking |
| capability may be required by the UDDI registry to implement a Web service in |
| the same manner that UDDI does (e.g. using SOAP for message passing using |
| literal encoding) that exposes a single method named validate_values. The |
| interface for validate_values is described here.</p> |
| |
| <p class="MsoBodyText">In some cases a node may desire to eliminate or minimize |
| the number of calls to external validation Web services. It can do so by |
| caching valid values for those external value sets that allow caching of their |
| values. A node has two normative options for obtaining the set of valid |
| values. One is to periodically obtain the set of valid values from those value |
| set providers that implement a Web service that handles the get_allValidValues API. This API is described below. The other method of obtaining a cache of valid values is to |
| accumulate the valid values from successful calls to validate_values.</p> |
| |
| <h3><a name="_Toc85908142"></a><a name="_Toc53709336"></a><a name="_Toc45096421"></a><a name="_Toc45095964"></a><a name="_Toc42047341"></a><a name="_Toc535332281">5.6.1 |
| Value Set Programming Interfaces</a></h3> |
| |
| <p class="MsoBodyText">The Application Programming Interfaces in this section |
| represent capabilities that a UDDI registry MAY use to enable validation of |
| references to value sets. Registry policy determines which external value sets |
| are supported and how. See Section <a href="#_Ref9007633 ">9.4.19</a> <i>Value |
| Set Policies </i>and Section <a href="#_Ref9007695 ">9.6.5</a><i>Value Sets </i>for |
| more information on registry support of external value sets. These SOAP messages all behave synchronously.</p> |
| |
| <p class="MsoBodyText">The publicly accessible APIs that are used to support |
| external value set validation 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="#_validate_values"><b><span style="color:windowtext; |
| text-decoration:none">validate_values</span></b></a>: Used by nodes to allow |
| external providers of value set validation Web services to assess whether |
| keyedReferences or keyedReferenceGroups are valid. Returns a dispositionReport |
| structure.</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_allValidValues"><b><span style="color:windowtext; |
| text-decoration:none">get_allValidValues</span></b></a>: Used by nodes that |
| support caching of valid values from cacheable checked value sets to obtain the |
| set of valid values. Returns an empty message or a dispositionReport structure.</p> |
| |
| <p class="MsoBodyText">Registry policy may require value set providers that offer |
| one of these Web services to publish the bindingTemplate for the service and |
| the tModel for the value set in a particular way so that the proper Web service |
| can be discovered. See Section <a href="#_Ref9007695 ">9.6.5</a> <i>Value sets</i> |
| for more information<i>.</i> When a value set provider offers one of these Web |
| services, a tModel for the checked value set SHOULD be published in any |
| registry the provider wishes to offer it, and a bindingTemplate SHOULD be |
| published for the Web service(s) the value set provider offers for the checked |
| value set. The tModel SHOULD have categorizations from the uddi-org:types |
| category system to indicate the type of value set (<i>categorization</i>, <i>identifier</i>, |
| <i>relationship</i>, <i>categorizationGroup</i>), that it is checked (<i>checked</i>), |
| and, if the value set provider allows validation to occur against node caches |
| of valid values, the <i>cacheable</i> categorization should also be provided. </p> |
| |
| <p class="MsoBodyText">In order for a value set to be considered checked, the |
| tModel MUST first be categorized with the checked value from the uddi-org:types |
| category system. The decision to check such value sets is a registry and node |
| policy decision. </p> |
| |
| <p class="MsoBodyText">If a value set tModel is categorized as checked, then in |
| response to attempts to publish a keyedReference which uses the checked tModel, |
| nodes MUST either perform the required validation, or return E_unsupported.</p> |
| |
| <p class="MsoBodyText">The tModel should also have a categorization reference to |
| the bindingTemplate of the get_allValidValues or validate_values Web service |
| that the value set provider designates, using the uddi-org:validatedBy category |
| system. See Section <a href="#_Ref8977125 ">11.1.1</a> <i>UDDI Types Category |
| System </i>and Section <a href="# ">11.1.7</a> <i>Validated By Category System</i> |
| for more information.</p> |
| |
| <p class="MsoBodyText">The bindingTemplate for the get_allValidValues or the |
| validate_values Web service SHOULD reference in its tModelInstanceDetails the |
| appropriate value set API tModel (Section <a href="#_Ref8979902 ">11.2.7</a> <i>Value |
| Set Caching API tModel </i>or Section <a href="#_Ref8979938 ">11.2.8</a> <i>Value |
| Set Validation API tModel</i>) as well tModels for all of the value sets the |
| service applies to. </p></div> |
| </li> |
| </ul> |
| </div> |
| <div class="summary"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <!-- ========== METHOD SUMMARY =========== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="method.summary"> |
| <!-- --> |
| </a> |
| <h3>Method Summary</h3> |
| <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> |
| <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd"> </span></span></caption> |
| <tr> |
| <th class="colFirst" scope="col">Modifier and Type</th> |
| <th class="colLast" scope="col">Method and Description</th> |
| </tr> |
| <tr id="i0" class="altColor"> |
| <td class="colFirst"><code><a href="../../../org/uddi/api_v3/DispositionReport.html" title="class in org.uddi.api_v3">DispositionReport</a></code></td> |
| <td class="colLast"><code><span class="memberNameLink"><a href="../../../org/uddi/v3_service/UDDIValueSetValidationPortType.html#validateValues-org.uddi.vs_v3.ValidateValues-">validateValues</a></span>(<a href="../../../org/uddi/vs_v3/ValidateValues.html" title="class in org.uddi.vs_v3">ValidateValues</a> body)</code> |
| <div class="block"><p class="MsoBodyText">A UDDI node that supports external validation sends the |
| validate_values API to the appropriate external Web service, of which there is |
| exactly one, whenever a publisher saves data that uses a keyedReference or |
| keyedReferenceGroup whose use is regulated by the external party who controls |
| that Web service.</div> |
| </td> |
| </tr> |
| </table> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </div> |
| <div class="details"> |
| <ul class="blockList"> |
| <li class="blockList"> |
| <!-- ============ METHOD DETAIL ========== --> |
| <ul class="blockList"> |
| <li class="blockList"><a name="method.detail"> |
| <!-- --> |
| </a> |
| <h3>Method Detail</h3> |
| <a name="validateValues-org.uddi.vs_v3.ValidateValues-"> |
| <!-- --> |
| </a> |
| <ul class="blockListLast"> |
| <li class="blockList"> |
| <h4>validateValues</h4> |
| <pre><a href="../../../org/uddi/api_v3/DispositionReport.html" title="class in org.uddi.api_v3">DispositionReport</a> validateValues(<a href="../../../org/uddi/vs_v3/ValidateValues.html" title="class in org.uddi.vs_v3">ValidateValues</a> body) |
| throws <a href="../../../org/uddi/v3_service/DispositionReportFaultMessage.html" title="class in org.uddi.v3_service">DispositionReportFaultMessage</a>, |
| <a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/RemoteException.html?is-external=true" title="class or interface in java.rmi">RemoteException</a></pre> |
| <div class="block"><p class="MsoBodyText">A UDDI node that supports external validation sends the |
| validate_values API to the appropriate external Web service, of which there is |
| exactly one, whenever a publisher saves data that uses a keyedReference or |
| keyedReferenceGroup whose use is regulated by the external party who controls |
| that Web service. For purposes of discussion, the identifier, category, and |
| relationship type systems that the keyedReference elements refer to are called |
| checked value sets. The category group systems that the keyedReferenceGroup |
| elements refer to are similarly called checked category group systems. </p> |
| |
| <p class="MsoBodyText">The normal use for checked value sets is to verify that |
| specific values (checking the keyValue attribute of values supplied) exist |
| within the value set. For certain value sets the value set provider may |
| further restrict the use of a value based on a contextual evaluation of the |
| passed data. The provider may do enable this contextual checking by offering a |
| validation Web service.</p> |
| |
| <p class="MsoBodyText">Validation algorithms for checked category group systems |
| similarly verify that the contents of the keyedReferenceGroup elements form a |
| valid set according to the validation algorithm for the checked category group |
| system. Frequently such validation ensures that the value sets identified in |
| contained keyedReferences are allowed to participate in the category group |
| system.</p></div> |
| <dl> |
| <dt><span class="paramLabel">Parameters:</span></dt> |
| <dd><code>body</code> - The UDDI node that is calling validate_values MUST pass one or more businessEntity elements, one or more businessService elements, one or more bindingTemplate elements, one or more tModel elements, or one or more publisherAssertion elements as the sole argument to this Web service. The one or more elements passed represents the outermost UDDI data structure(s) being passed within a save_business, save_service, save_binding, save_tModel, add_publisherAssertion, or set_publisherAssertions API call. Multiple elements of the same type may be passed together if multiples are included in the same save invocation. |
| |
| The optional authInfo argument is an element that contains an authentication token. An authentication token is obtained using the get_authToken API call or through some other means external to this specification. Providers of validate_values Web services that serve multiple registries and providers that restrict who can use their service may require authInfo for this API. |
| |
| <p class="MsoBodyText">The called Web service for a checked value set performs |
| validation on all of the keyedReferences or keyedReferenceGroups that are |
| associated with the value sets the Web service is authorized to check. This |
| can involve merely checking that the <i>keyValue</i> values supplied are good for |
| the given value set (as signified by the embedded keyedReference tModelKey |
| values). Other types of validation as desired may be performed, including |
| context sensitive checks that utilize the information passed in the entity |
| being saved.</p> |
| |
| <p class="MsoBodyText">The entity being saved may contain multiple references to |
| values from the value set(s) that the validation Web service is authorized to |
| validate. When the entity being saved is a businessEntity, contained |
| businessService and bindingTemplate entities may themselves reference values |
| from the authorized value sets as well. All references to values that are |
| associated with the value set(s) that the validation Web service is authorized |
| to check MUST be validated without regard to their placement in the entity |
| being saved.</p> |
| |
| <p class="MsoBodyText">If the external value set and the node both support |
| caching of valid values, the node may not invoke validate_values if it already |
| knows that the referenced values are valid, through checking its cache.</p> |
| |
| <p class="MsoBodyText">A checked category group system is treated in the same manner |
| as a checked value set. The tModelKey associated with the keyedReferenceGroup |
| identifies the checked category group system. A node may be able to validate a |
| reference to a cacheable checked category group system without calling |
| validate_values if it can determine using its cache that the tModelKey |
| attributes from the keyedReference elements contained in the |
| keyedReferenceGroup are allowed for the category group system.</p></dd> |
| <dt><span class="returnLabel">Returns:</span></dt> |
| <dd>returns org.uddi.api_v3.DispositionReport |
| If all values referenced in the entity being saved are valid from the value set(s) or category group system(s) that the validation Web service is authorized to validate, the proper response is an empty message.</dd> |
| <dt><span class="throwsLabel">Throws:</span></dt> |
| <dd><code>DispositionReportFaultMessage,</code> - RemoteException |
| <p class="MsoBodyText">If any error is found, or the called Web service needs to |
| signal that the information being saved is not valid based on the validation |
| algorithm chosen by the external Web service provider, then the Web service |
| MUST raise a SOAP Fault as specified in Section <a href="#_Ref8979985 ">4.8</a> |
| <i>Success and Error Reporting.</i></p> |
| |
| <p class="MsoBodyText">When an error is signaled in this fashion, the UDDI node MUST |
| reject the pending change and return to the original caller the same SOAP fault data returned by the validation Web service. The error codes indicate one of the |
| following reasons, and the error text clearly indicates the keyedReference or |
| keyedReferenceGroup data that is being rejected and the reason it is being |
| rejected.</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>: One or more of the keyValues in the |
| keyedReference or keyedReferences in the keyedReferenceGroup supplied failed |
| validation. Only the first error encountered need be reported.</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>: The values may be valid, but are not |
| allowed contextually.</p></dd> |
| <dd><code><a href="../../../org/uddi/v3_service/DispositionReportFaultMessage.html" title="class in org.uddi.v3_service">DispositionReportFaultMessage</a></code></dd> |
| <dd><code><a href="https://docs.oracle.com/javase/6/docs/api/java/rmi/RemoteException.html?is-external=true" title="class or interface in java.rmi">RemoteException</a></code></dd> |
| </dl> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| </div> |
| </div> |
| <!-- ========= END OF CLASS DATA ========= --> |
| <!-- ======= START OF BOTTOM NAVBAR ====== --> |
| <div class="bottomNav"><a name="navbar.bottom"> |
| <!-- --> |
| </a> |
| <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> |
| <a name="navbar.bottom.firstrow"> |
| <!-- --> |
| </a> |
| <ul class="navList" title="Navigation"> |
| <li><a href="../../../overview-summary.html">Overview</a></li> |
| <li><a href="package-summary.html">Package</a></li> |
| <li class="navBarCell1Rev">Class</li> |
| <li><a href="class-use/UDDIValueSetValidationPortType.html">Use</a></li> |
| <li><a href="package-tree.html">Tree</a></li> |
| <li><a href="../../../deprecated-list.html">Deprecated</a></li> |
| <li><a href="../../../index-all.html">Index</a></li> |
| <li><a href="../../../help-doc.html">Help</a></li> |
| </ul> |
| </div> |
| <div class="subNav"> |
| <ul class="navList"> |
| <li><a href="../../../org/uddi/v3_service/UDDIValueSetCachingPortType.html" title="interface in org.uddi.v3_service"><span class="typeNameLink">Prev Class</span></a></li> |
| <li>Next Class</li> |
| </ul> |
| <ul class="navList"> |
| <li><a href="../../../index.html?org/uddi/v3_service/UDDIValueSetValidationPortType.html" target="_top">Frames</a></li> |
| <li><a href="UDDIValueSetValidationPortType.html" target="_top">No Frames</a></li> |
| </ul> |
| <ul class="navList" id="allclasses_navbar_bottom"> |
| <li><a href="../../../allclasses-noframe.html">All Classes</a></li> |
| </ul> |
| <div> |
| <script type="text/javascript"><!-- |
| allClassesLink = document.getElementById("allclasses_navbar_bottom"); |
| if(window==top) { |
| allClassesLink.style.display = "block"; |
| } |
| else { |
| allClassesLink.style.display = "none"; |
| } |
| //--> |
| </script> |
| </div> |
| <div> |
| <ul class="subNavList"> |
| <li>Summary: </li> |
| <li>Nested | </li> |
| <li>Field | </li> |
| <li>Constr | </li> |
| <li><a href="#method.summary">Method</a></li> |
| </ul> |
| <ul class="subNavList"> |
| <li>Detail: </li> |
| <li>Field | </li> |
| <li>Constr | </li> |
| <li><a href="#method.detail">Method</a></li> |
| </ul> |
| </div> |
| <a name="skip.navbar.bottom"> |
| <!-- --> |
| </a></div> |
| <!-- ======== END OF BOTTOM NAVBAR ======= --> |
| <p class="legalCopy"><small>Copyright © 2004–2022 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p> |
| </body> |
| </html> |
