org.apache.juddi.validation.vsv

Class Uddiuddiorgidentifierisreplacedby

java.lang.Object

org.apache.juddi.validation.vsv.Uddiuddiorgidentifierisreplacedby

All Implemented Interfaces:

ValueSetValidator

Direct Known Subclasses:

Uuide59ae32077a511d5b8980004ac49cc1e

public class Uddiuddiorgidentifierisreplacedby
extends Object
implements ValueSetValidator

UDDI provides a mechanism that may be used by publishers to tag their businessEntities and tModels with information that identifies them according to any number of identification systems. This tModel represents an identifier system that may be used to identify the tModel or businessEntity that logically replaces the tModel or businessEntity in which it is used. This version of the isReplacedBy identifier system replaces the prior version of this identifier system by providing a means for referring to replacement entities that have version 3 format keys. It is often desirable to gracefully retire a tModel in favor of a replacement. For example, when a Web service definition is replaced by an incompatible version, the publisher of the specification may wish to leave the tModel for the existing definition in place so that existing uses will not be disturbed, while at the same time making it clear that there is a replacement available. The UDDI isReplacedBy identifier system, coupled with the behavior of UDDI with respect to obsolete tModels, fills this need by allowing the obsolete tModel to point to its replacement. See Section 5.2.11 delete_tModel. The isReplacedBy identifier system exists in prior versions of UDDI. keyedReferences that refer to this original isReplacedBy identifier system contain entity keys in the version 1 and 2 formats (as UUIDs with the uuid or no scheme prefix). When accessed using a prior version API in a multi-version registry, the older isReplacedBy identifier system yields valid references to businessEntity or tModel keys that are in the format of the prior version, and thus remain valid. When viewed using the version 3 UDDI API these same references to the earlier isReplacedBy identifier system contain invalid version 3 format keys. A new version of this identifier system is required to be able to reference the set of values defined by version 3 format keys.

The keyValues in keyedReferences that refer to this tModel must be tModelKeys or businessKeys. Such a keyValue specifies the entity that is the replacement for the entity in which the keyedReference appears. The above and further validation requirements are as follows:

a. In the case where a reference is made from an obsolete business entity the following validation rules apply:

1. reference to a new business entity; this is a valid operation

2. reference to self; this is invalid

3. reference to a service, binding or tModel; this is an invalid operation given that the entity being pointed to must be a business

4. reference to another publisher’s business; this is a valid operation; no ownership check is made

5. reference to another publisher’s service, binding or tModel; this is an invalid operation because of a.3 above

6. reference to invalid keys; this is an invalid operation; a key must be valid.

b. In the case where a reference is made from an obsolete tModel the following validation rules apply:

1. reference to a new tModel; this is a valid operation

2. reference to self; this is invalid

3. reference to a service, binding or business; this is an invalid operation given that the entity being pointed to must be a tModel

4. reference to another publisher’s tModel; this is a valid operation; no ownership check is made

5. reference to another publisher’s service, binding or business; this is an invalid operation because of b.3 above

6. reference to invalid keys; this is an invalid operation; a key must be valid.

7. reference to a hidden tModel; this is a valid operation

c. Adding isReplacedBy to a service’s or binding’s category bag: this is a semantically wrong operation and will be rejected.

When returning an error encountered in the above, E_invalidValue will be returned to indicate that a value that was passed in a keyValue attribute did not pass validation.

While this validation is intended at save time, references to replacing business entities may become invalid if (A) the business is deleted and (B) in V3 the business is deleted and then the key is re-used for a different entity. As such, in a replicating registry, nodes processing changeRecords related to business entities or tModels that refer to (now) invalid or missing business or tModels entity keys respectively, MUST NOT raise replication errors.

Author:

Alex O'Ree

Constructor Summary

Constructors

Constructor and Description
Uddiuddiorgidentifierisreplacedby()

Method Summary

Modifier and Type	Method and Description
String	getMyKey()
List<String>	getValidValues()
void	validateTmodelInstanceDetails(List<TModelInstanceInfo> tModelInstanceInfo, String xpath)
void	validateValuesBindingTemplate(List<BindingTemplate> items, String xpath)
void	validateValuesBusinessEntity(List<BusinessEntity> items)
void	validateValuesBusinessService(List<BusinessService> items, String xpath)
void	validateValuesPublisherAssertion(List<PublisherAssertion> items)
void	validateValuesTModel(List<TModel> items)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Uddiuddiorgidentifierisreplacedby

public Uddiuddiorgidentifierisreplacedby()

Method Detail

getMyKey

public String getMyKey()

validateValuesBindingTemplate

public void validateValuesBindingTemplate(List<BindingTemplate> items,
                                          String xpath)
                                   throws DispositionReportFaultMessage

Specified by:

validateValuesBindingTemplate in interface ValueSetValidator

Throws:

DispositionReportFaultMessage

validateValuesBusinessEntity

public void validateValuesBusinessEntity(List<BusinessEntity> items)
                                  throws DispositionReportFaultMessage

Specified by:

validateValuesBusinessEntity in interface ValueSetValidator

Throws:

DispositionReportFaultMessage

validateValuesBusinessService

public void validateValuesBusinessService(List<BusinessService> items,
                                          String xpath)
                                   throws DispositionReportFaultMessage

Specified by:

validateValuesBusinessService in interface ValueSetValidator

Throws:

DispositionReportFaultMessage

validateValuesPublisherAssertion

public void validateValuesPublisherAssertion(List<PublisherAssertion> items)
                                      throws DispositionReportFaultMessage

Specified by:

validateValuesPublisherAssertion in interface ValueSetValidator

Throws:

DispositionReportFaultMessage

validateTmodelInstanceDetails

public void validateTmodelInstanceDetails(List<TModelInstanceInfo> tModelInstanceInfo,
                                          String xpath)
                                   throws DispositionReportFaultMessage

Specified by:

validateTmodelInstanceDetails in interface ValueSetValidator

Throws:

DispositionReportFaultMessage

validateValuesTModel

public void validateValuesTModel(List<TModel> items)
                          throws DispositionReportFaultMessage

Specified by:

validateValuesTModel in interface ValueSetValidator

Throws:

DispositionReportFaultMessage

getValidValues

public List<String> getValidValues()

Specified by:

getValidValues in interface ValueSetValidator