publisherassertion.java

可以实现UDDI

/*
 * The source code contained herein is licensed under the IBM Public License
 * Version 1.0, which has been approved by the Open Source Initiative.
 * Copyright (C) 2001, Hewlett-Packard Company
 * All Rights Reserved.
 *
 */

package org.uddi4j.datatype.assertion;

import org.uddi4j.UDDIElement;
import org.uddi4j.UDDIException;
import org.uddi4j.util.FromKey;
import org.uddi4j.util.KeyedReference;
import org.uddi4j.util.ToKey;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;

/**
 * <p>
 * Represents the publisherAssertion element within the UDDI version 2.0 schema.
 * This class contains the following types of methods:
 * 
 * <ul>
 *   <li>Constructor passing the required fields.
 *   <li>Constructor that will instantiate the object from an appropriate XML
 *       DOM element.
 *   <li>Get/set methods for each attribute that this element can contain.
 *   <li>For sets of attributes, a get/setVector method is provided.
 *   <li>SaveToXML method. Serializes this class within a passed in element.
 * </ul>
 * 
 * Typically this class is used to construct parameters for, or interpret
 * responses from, methods in the UDDIProxy class.
 *
 * <p><b>Element description:</b>
 * 
 * <p>UDDI version 2.0 introduces an assertion feature based on "publisher
 * assertions".  Publisher assertions are the basis for a mechanism to
 * that allows more than one registered businessEntity element to be
 * linked in a manner that conveys a specific type of relationship.
 * This is why the feature is sometimes called the relationship feature.
 * Publisher assertions are used to establish visible relationships between
 * registered data and a set of assertions. This relationship can be seen by
 * a general inquiry message (named "find_relatedBusinesses").
 *
 *
 * @author Mahesh C S ([e-mail])
 */
public class PublisherAssertion extends UDDIElement {

   public static final String UDDI_TAG = "publisherAssertion";

   protected Element base = null;

   FromKey fromKey = null;
   ToKey toKey = null;
   KeyedReference keyedReference = null;


   /**
    * Default constructor.
    * Avoid using the default constructor for validation. It does not validate
    * required fields. Instead, use the required fields constructor to perform
    * validation.
    */
   public PublisherAssertion() {
   }

   /**
    * Construct the object with required fields.
    *
    * @param fromKey    String
    * @param toKey  String
    * @param keyRef  KeyedReference
    */
   public PublisherAssertion(String fromKey, String toKey ,
                             KeyedReference keyRef) {
        this.fromKey = new FromKey(fromKey);
        this.toKey = new ToKey(toKey);
        this.keyedReference = keyRef;
   }

   /**
    * Construct the object from a DOM tree. Used by
    * UDDIProxy to construct an object from a received UDDI
    * message.
    *
    * @param base   Element with the name appropriate for this class.
    * @exception UDDIException Thrown if DOM tree contains a SOAP fault
    *  or a disposition report indicating a UDDI error.
    */
   public PublisherAssertion(Element base) throws UDDIException {
       // Check if it is a fault. Throws an exception if it is.
       super(base);
       NodeList nl = null;
       nl = getChildElementsByTagName(base, FromKey.UDDI_TAG);
       if (nl.getLength() > 0) {
          fromKey = new FromKey((Element)nl.item(0));
       }
       nl = getChildElementsByTagName(base, ToKey.UDDI_TAG);
       if (nl.getLength() > 0) {
          toKey = new ToKey((Element)nl.item(0));
       }
       nl = getChildElementsByTagName(base, KeyedReference.UDDI_TAG);
       if (nl.getLength() > 0) {
          keyedReference = new KeyedReference((Element)nl.item(0));
       }
   }

   public String getFromKeyString() {
       return fromKey.getText();
   }

   public void setFromKeyString(String s) {
       fromKey = new FromKey();
       fromKey.setText(s);
   }

   public String getToKeyString() {
       return toKey.getText();
   }

   public void setToKeyString(String s) {
       toKey = new ToKey();
       toKey.setText(s);
   }

   public FromKey getFromKey() {
       return fromKey;
   }

   public void  setFromKey(FromKey key) {
       fromKey = key;
   }

   public ToKey getToKey() {
       return toKey;
   }

   public void  setToKey(ToKey key) {
       toKey = key;
   }

   public KeyedReference getKeyedReference() {
       return keyedReference;
   }

   public void setKeyedReference(KeyedReference r ) {
       keyedReference = r;
   }

   /**
    * Save an object to the DOM tree. Used to serialize an object
    * to a DOM tree, usually to send a UDDI message.
    *
    * <BR>Used by UDDIProxy.
    *
    * @param parent Object will serialize as a child element under the
    *               passed in parent element.
    */
   public void saveToXML(Element parent) {
       base = parent.getOwnerDocument().createElementNS(UDDIElement.XMLNS, UDDIElement.XMLNS_PREFIX + UDDI_TAG);
       
       if (fromKey!=null) {
          fromKey.saveToXML(base);
       }
       if (toKey!=null) {
          toKey.saveToXML(base);
       }
       if (keyedReference!=null) {
          keyedReference.saveToXML(base);
       }

       parent.appendChild(base);
   }
}