org.apache.ws.scout.registry.RegistryV3Impl.java Source code

Java tutorial

Introduction

Here is the source code for org.apache.ws.scout.registry.RegistryV3Impl.java

Source

/*
 * Copyright 2001-2004 The Apache Software Foundation.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *      http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.ws.scout.registry;

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.StringReader;
import java.net.URI;
import java.net.URISyntaxException;
import java.security.AccessController;
import java.security.PrivilegedAction;
import java.util.Arrays;
import java.util.List;
import java.util.Properties;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBElement;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Marshaller;
import javax.xml.bind.Unmarshaller;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.registry.InvalidRequestException;
import javax.xml.transform.stream.StreamSource;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.ws.scout.transport.LocalTransport;
import org.apache.ws.scout.transport.Transport;
import org.apache.ws.scout.transport.TransportException;
import org.apache.ws.scout.util.XMLUtils;
import org.uddi.api_v3.AssertionStatusReport;
import org.uddi.api_v3.AuthToken;
import org.uddi.api_v3.BindingDetail;
import org.uddi.api_v3.BindingTemplate;
import org.uddi.api_v3.BusinessDetail;
import org.uddi.api_v3.BusinessEntity;
import org.uddi.api_v3.BusinessList;
import org.uddi.api_v3.BusinessService;
import org.uddi.api_v3.CategoryBag;
import org.uddi.api_v3.CompletionStatus;
import org.uddi.api_v3.DeleteBinding;
import org.uddi.api_v3.DeleteBusiness;
import org.uddi.api_v3.DeletePublisherAssertions;
import org.uddi.api_v3.DeleteService;
import org.uddi.api_v3.DeleteTModel;
import org.uddi.api_v3.DiscoveryURLs;
import org.uddi.api_v3.DispositionReport;
import org.uddi.api_v3.FindBinding;
import org.uddi.api_v3.FindBusiness;
import org.uddi.api_v3.FindQualifiers;
import org.uddi.api_v3.FindService;
import org.uddi.api_v3.FindTModel;
import org.uddi.api_v3.GetAssertionStatusReport;
import org.uddi.api_v3.GetAuthToken;
import org.uddi.api_v3.GetBusinessDetail;
import org.uddi.api_v3.GetPublisherAssertions;
import org.uddi.api_v3.GetRegisteredInfo;
import org.uddi.api_v3.GetServiceDetail;
import org.uddi.api_v3.GetTModelDetail;
import org.uddi.api_v3.IdentifierBag;
import org.uddi.api_v3.InfoSelection;
import org.uddi.api_v3.Name;
import org.uddi.api_v3.ObjectFactory;
import org.uddi.api_v3.PublisherAssertion;
import org.uddi.api_v3.PublisherAssertions;
import org.uddi.api_v3.PublisherAssertionsResponse;
import org.uddi.api_v3.RegisteredInfo;
import org.uddi.api_v3.SaveBinding;
import org.uddi.api_v3.SaveBusiness;
import org.uddi.api_v3.SaveService;
import org.uddi.api_v3.SaveTModel;
import org.uddi.api_v3.ServiceDetail;
import org.uddi.api_v3.ServiceList;
import org.uddi.api_v3.SetPublisherAssertions;
import org.uddi.api_v3.TModel;
import org.uddi.api_v3.TModelBag;
import org.uddi.api_v3.TModelDetail;
import org.uddi.api_v3.TModelList;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;
import org.xml.sax.SAXException;

/**
 * RegistryImpl is the implementation of IRegistry.
 * 
 * <p>The execute() function signature has been changed slightly from the jUDDI
 * version, since the URL can no longer be decided dynamically (in an easy
 * enough manner) as we don't use jUDDI data types anymore.</p>
 * 
 * <i>The function code is borrowed from jUDDI, with appropriate modifications so
 * that xmlbeans data types are used intead of jUDDI data types.</i>
 * 
 */

public class RegistryV3Impl implements IRegistryV3 {

    public static final String DEFAULT_INQUIRY_ENDPOINT = "org.apache.juddi.v3.client.transport.wrapper.UDDIInquiryService#inquire";;
    public static final String DEFAULT_PUBLISH_ENDPOINT = "org.apache.juddi.v3.client.transport.wrapper.UDDIPublicationService#publish";
    public static final String DEFAULT_SECURITY_ENDPOINT = "org.apache.juddi.v3.client.transport.wrapper.UDDISecurityService#secure";
    public static final String DEFAULT_ADMIN_ENDPOINT = "http://localhost/juddiv3/";
    public static final String DEFAULT_TRANSPORT_CLASS = "org.apache.ws.scout.transport.LocalTransport";
    public static final String DEFAULT_SECURITY_PROVIDER = "com.sun.net.ssl.internal.ssl.Provider";
    public static final String DEFAULT_PROTOCOL_HANDLER = "com.sun.net.ssl.internal.www.protocol";
    public static final String DEFAULT_UDDI_VERSION = "3.0";
    public static final String DEFAULT_UDDI_NAMESPACE = "urn:uddi-org:api_v3";

    private URI adminURI;
    private URI inquiryURI;
    private URI publishURI;
    private URI securityURI;

    private Transport transport;

    private String securityProvider;
    private String protocolHandler;
    private String uddiVersion;
    private String uddiNamespace;

    private String nodeName;
    private String managerName;

    private ObjectFactory objectFactory = new ObjectFactory();

    private Marshaller marshaller = null;
    private Unmarshaller unmarshaller = null;

    private static Log log = LogFactory.getLog(RegistryV3Impl.class);

    /**
     * Creates a new instance of RegistryImpl.
     * @throws InvalidRequestException 
     */
    public RegistryV3Impl(Properties props, String nodeName, String managerName) throws InvalidRequestException {
        super();

        this.init(props, nodeName, managerName);
    }

    /**
     * @throws InvalidRequestException 
     * 
     */
    private void init(Properties props, String nodeName, String managerName) throws InvalidRequestException {
        this.nodeName = nodeName;
        this.managerName = managerName;
        // We need to have a non-null Properties
        // instance so initialization takes place.
        if (props == null)
            props = new Properties();

        // Override defaults with specific specific values
        try {
            // note that since we are using the juddi-client, these settings are fixed!
            // the URL settings will be passed down to the juddi-client config. 
            // (see the parameters in the "META-INF/jaxr-uddi.xml)
            setInquiryURI(new URI(DEFAULT_INQUIRY_ENDPOINT));
            setPublishURI(new URI(DEFAULT_PUBLISH_ENDPOINT));
            setSecurityURI(new URI(DEFAULT_SECURITY_ENDPOINT));
            setTransport(getTransport(DEFAULT_TRANSPORT_CLASS));
            // the following parameters are still configurable however
            setAdminURI(new URI(
                    props.getProperty(ConnectionFactoryImpl.ADMIN_ENDPOINT_PROPERTY, DEFAULT_ADMIN_ENDPOINT)));
            setSecurityProvider(
                    props.getProperty(ConnectionFactoryImpl.SECURITY_PROVIDER_PROPERTY, DEFAULT_SECURITY_PROVIDER));
            setProtocolHandler(
                    props.getProperty(ConnectionFactoryImpl.PROTOCOL_HANDLER_PROPERTY, DEFAULT_PROTOCOL_HANDLER));
            setUddiVersion(props.getProperty(ConnectionFactoryImpl.UDDI_VERSION_PROPERTY, DEFAULT_UDDI_VERSION));
            setUddiNamespace(
                    props.getProperty(ConnectionFactoryImpl.UDDI_NAMESPACE_PROPERTY, DEFAULT_UDDI_NAMESPACE));

            JAXBContext context = JAXBContextUtil.getContext(JAXBContextUtil.UDDI_V3_VERSION);
            unmarshaller = context.createUnmarshaller();
            marshaller = context.createMarshaller();

        } catch (URISyntaxException muex) {
            throw new InvalidRequestException(muex.getMessage(), muex);
        } catch (JAXBException e) {
            throw new RuntimeException(e);
        }
    }

    /**
     * 
     * @param uddiRequest
     * @return String
     * @throws RegistryV3Exception
     */
    public String execute(String uddiRequest, String urltype) throws TransportException {
        URI endPointURL = null;
        if (urltype.equalsIgnoreCase("INQUIRY"))
            endPointURL = this.getInquiryURI();
        else
            endPointURL = this.getPublishURI();

        // A SOAP request is made and a SOAP response
        // is returned.

        return transport.send(uddiRequest, endPointURL);
    }

    /**
     * 
     */
    public JAXBElement<?> execute(JAXBElement<?> uddiRequest, URI endPointURI) throws RegistryV3Exception {

        ByteArrayOutputStream baos = new ByteArrayOutputStream();

        Document doc;
        try {
            DocumentBuilderFactory docBuilderFactory = DocumentBuilderFactory.newInstance();
            docBuilderFactory.setNamespaceAware(true);
            DocumentBuilder docBuilder = docBuilderFactory.newDocumentBuilder();
            this.marshaller.marshal(uddiRequest, baos);
            doc = docBuilder.parse(new ByteArrayInputStream(baos.toByteArray()));
        } catch (SAXException saxe) {
            throw (new RegistryV3Exception(saxe));
        } catch (ParserConfigurationException pce) {
            throw (new RegistryV3Exception(pce));
        } catch (IOException ioe) {
            throw (new RegistryV3Exception(ioe));
        } catch (JAXBException ioe) {
            throw (new RegistryV3Exception(ioe));
        }
        Element request = doc.getDocumentElement();

        request.setAttribute("xmlns", this.getUddiNamespace());
        if (!"3.0".equals(this.getUddiVersion())) {
            request.setAttribute("generic", this.getUddiVersion());
        }
        //request.setAttributeNS("http://www.w3.org/2000/xmlns/","xmlns", this.getUddiNamespace());
        // A SOAP request is made and a SOAP response
        // is returned.
        if (log.isDebugEnabled()) {
            String xmlIn = XMLUtils.convertNodeToXMLString(request);
            log.debug("Request send to UDDI Registry: " + xmlIn);
        }

        Element response;
        try {
            response = transport.send(request, endPointURI);
        } catch (TransportException te) {
            throw new RegistryV3Exception(te);
        }
        /* if (response.hasAttributes()) {
           NamedNodeMap am = response.getAttributes();
           ArrayList<String> al = new ArrayList<String>();
           for (int i = 0; i < am.getLength(); i++) {
         Node n = am.item(i);
         String attribute = n.getNodeName();
         if (attribute!= null && attribute.startsWith("xmlns")) {
            al.add(attribute);
         }
           }
           for (String attr : al) {
         response.removeAttribute(attr);
           }
        }*/
        JAXBElement<?> uddiResponse = null;
        if (response != null) {
            if (response.getNamespaceURI() == null) {
                response.setAttributeNS("http://www.w3.org/2000/xmlns/", "xmlns", this.getUddiNamespace());
            }

            // If we are getting responses from a UDDI v3, remove the xmlns

            // First, let's make sure that a response
            // (any response) is found in the SOAP Body.

            String responseName = response.getLocalName();
            if (responseName == null) {
                throw new RegistryV3Exception("Unsupported response " + "from registry. A value was not present.");
            }

            // Let's now try to determine which UDDI response
            // we received and unmarshal it appropriately or
            // throw a RegistryV3Exception if it's unknown.
            // Well, we have now determined that something was
            // returned and it is "a something" that we know
            // about so let's unmarshal it into a RegistryObject
            // Next, let's make sure we didn't recieve a SOAP
            // Fault. If it is a SOAP Fault then throw it
            // immediately.

            try {
                String xml = XMLUtils.convertNodeToXMLString(response);
                log.debug("Response is: " + xml);

                StringReader reader = new StringReader(xml);
                uddiResponse = (JAXBElement<?>) unmarshaller.unmarshal(new StreamSource(reader));
                //It is probably faster not to go to a String, but JAXB has issues with this
                //uddiResponse = (JAXBElement<?>) unmarshaller.unmarshal(response);

            } catch (JAXBException xmle) {
                throw (new RegistryV3Exception(xmle));
            }

            if (responseName.toLowerCase().equals("fault")) {
                NodeList nodeList = null;

                // Child Elements
                String fCode = null;
                nodeList = response.getElementsByTagName("faultcode");
                if (nodeList.getLength() > 0)
                    fCode = nodeList.item(0).getNodeValue();

                String fString = null;
                nodeList = response.getElementsByTagName("faultstring");
                if (nodeList.getLength() > 0)
                    fString = nodeList.item(0).getNodeValue();

                String fActor = null;
                nodeList = response.getElementsByTagName("faultactor");
                if (nodeList.getLength() > 0)
                    fActor = nodeList.item(0).getNodeValue();

                DispositionReport dispRpt = null;

                nodeList = response.getElementsByTagName("detail");
                if (nodeList.getLength() > 0) {
                    nodeList = ((Element) nodeList.item(0)).getElementsByTagName("dispositionReport");
                    if (nodeList.getLength() > 0) {
                        JAXBElement<DispositionReport> dispRptObj = null;
                        try {
                            dispRptObj = (JAXBElement<DispositionReport>) unmarshaller
                                    .unmarshal((Element) nodeList.item(0));
                        } catch (JAXBException xmle) {
                            throw (new RegistryV3Exception(xmle));
                        }
                        dispRpt = dispRptObj.getValue();
                    }
                }

                RegistryV3Exception e = new RegistryV3Exception(fCode, fString, fActor, dispRpt);

                // Create RegistryV3Exception instance and return
                throw e;
            }
        }

        return uddiResponse;
    }

    /**
     * @return Returns the adminURL.
     */
    public URI getAdminURI() {
        return this.adminURI;
    }

    /**
     * @param url
     *            The adminURL to set.
     */
    public void setAdminURI(URI url) {
        this.adminURI = url;
    }

    /**
     * @return Returns the inquiryURL.
     */
    public URI getInquiryURI() {
        return this.inquiryURI;
    }

    /**
     * @param inquiryURI
     *            The inquiryURI to set.
     */
    public void setInquiryURI(URI inquiryURI) {
        this.inquiryURI = inquiryURI;
    }

    /**
     * @return Returns the protocolHandler.
     */
    public String getProtocolHandler() {
        return this.protocolHandler;
    }

    /**
     * @param protocolHandler
     *            The protocolHandler to set.
     */
    public void setProtocolHandler(String protocolHandler) {
        this.protocolHandler = protocolHandler;
    }

    /**
     * @return Returns the publishURL.
     */
    public URI getPublishURI() {
        return this.publishURI;
    }

    /**
     * @return Returns the publishURL.
     */
    public URI getSecurityURI() {
        return this.securityURI;
    }

    /**
     * @param publishURI
     *            The publishURI to set.
     */
    public void setPublishURI(URI publishURI) {
        this.publishURI = publishURI;
    }

    /**
     * @param publishURI
     *            The publishURI to set.
     */
    public void setSecurityURI(URI securityURI) {
        this.securityURI = securityURI;
    }

    /**
     * @return Returns the securityProvider.
     */
    public String getSecurityProvider() {
        return this.securityProvider;
    }

    /**
     * @param securityProvider
     *            The securityProvider to set.
     */
    public void setSecurityProvider(String securityProvider) {
        this.securityProvider = securityProvider;
    }

    /**
     * @return Returns the transport.
     */
    public Transport getTransport() {
        return transport;
    }

    /**
     * @param transport
     *            The transport to set.
     */
    public void setTransport(Transport transport) {
        this.transport = transport;
    }

    /**
     * @return Returns the uddiNS.
     */
    public String getUddiNamespace() {
        return this.uddiNamespace;
    }

    /**
     * @param uddiNS
     *            The uddiNS to set.
     */
    public void setUddiNamespace(String uddiNS) {
        this.uddiNamespace = uddiNS;
    }

    /**
     * @return Returns the uddiVersion.
     */
    public String getUddiVersion() {
        return this.uddiVersion;
    }

    /**
     * @param uddiVersion
     *            The uddiVersion to set.
     */
    public void setUddiVersion(String uddiVersion) {
        this.uddiVersion = uddiVersion;
    }

    /**
     * "Used to remove an existing bindingTemplate from the bindingTemplates
     * collection that is part of a specified businessService structure."
     * 
     * @exception RegistryV3Exception;
     */
    public DispositionReport deleteBinding(String authInfo, String[] bindingKeyArray) throws RegistryV3Exception {
        DeleteBinding request = this.objectFactory.createDeleteBinding();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (bindingKeyArray != null) {
            request.getBindingKey().addAll(Arrays.asList(bindingKeyArray));
        }

        DispositionReport dr = new DispositionReport();
        JAXBElement<?> o = execute(this.objectFactory.createDeleteBinding(request), this.getPublishURI());
        if (o != null) {
            dr = (DispositionReport) o.getValue();
        }

        return dr;
    }

    /**
     * "Used to delete registered businessEntity information from the registry."
     * 
     * @exception RegistryV3Exception;
     */
    public DispositionReport deleteBusiness(String authInfo, String[] businessKeyArray) throws RegistryV3Exception {
        DeleteBusiness request = this.objectFactory.createDeleteBusiness();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (businessKeyArray != null) {
            request.getBusinessKey().addAll(Arrays.asList(businessKeyArray));
        }

        DispositionReport dr = new DispositionReport();
        JAXBElement<?> o = execute(this.objectFactory.createDeleteBusiness(request), this.getPublishURI());
        if (o != null) {
            dr = (DispositionReport) o.getValue();
        }

        return dr;
    }

    /**
     * @exception RegistryV3Exception;
     */
    public DispositionReport deletePublisherAssertions(String authInfo, PublisherAssertion[] assertionArray)
            throws RegistryV3Exception {
        DeletePublisherAssertions request = this.objectFactory.createDeletePublisherAssertions();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (assertionArray != null) {
            request.getPublisherAssertion().addAll(Arrays.asList(assertionArray));
        }

        DispositionReport dr = new DispositionReport();
        JAXBElement<?> o = execute(this.objectFactory.createDeletePublisherAssertions(request),
                this.getPublishURI());
        if (o != null) {
            dr = (DispositionReport) o.getValue();
        }

        return dr;
    }

    /**
     * "Used to delete an existing businessService from the businessServices
     * collection that is part of a specified businessEntity."
     * 
     * @exception RegistryV3Exception;
     */
    public DispositionReport deleteService(String authInfo, String[] serviceKeyArray) throws RegistryV3Exception {
        DeleteService request = this.objectFactory.createDeleteService();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (serviceKeyArray != null) {
            request.getServiceKey().addAll(Arrays.asList(serviceKeyArray));
        }

        DispositionReport dr = new DispositionReport();
        JAXBElement<?> o = execute(this.objectFactory.createDeleteService(request), this.getPublishURI());
        if (o != null) {
            dr = (DispositionReport) o.getValue();
        }

        return dr;
    }

    /**
     * "Used to delete registered information about a tModel. If there are any
     * references to a tModel when this call is made, the tModel will be marked
     * deleted instead of being physically removed."
     * 
     * @exception RegistryV3Exception;
     */
    public DispositionReport deleteTModel(String authInfo, String[] tModelKeyArray) throws RegistryV3Exception {
        DeleteTModel request = this.objectFactory.createDeleteTModel();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (tModelKeyArray != null) {
            request.getTModelKey().addAll(Arrays.asList(tModelKeyArray));
        }

        DispositionReport dr = new DispositionReport();
        JAXBElement<?> o = execute(this.objectFactory.createDeleteTModel(request), this.getPublishURI());
        if (o != null) {
            dr = (DispositionReport) o.getValue();
        }

        return dr;
    }

    /**
     * Used to locate information about one or more businesses. Returns a
     * businessList message that matches the conditions specified.
     * 
     * @exception RegistryV3Exception;
     */
    public BusinessList findBusiness(Name[] nameArray, DiscoveryURLs discoveryURLs, IdentifierBag identifierBag,
            CategoryBag categoryBag, TModelBag tModelBag, FindQualifiers findQualifiers, int maxRows)
            throws RegistryV3Exception {
        FindBusiness request = this.objectFactory.createFindBusiness();

        if (nameArray != null) {
            request.getName().addAll(Arrays.asList(nameArray));
        }

        if (discoveryURLs != null) {
            request.setDiscoveryURLs(discoveryURLs);
        }

        if (identifierBag != null) {
            request.setIdentifierBag(identifierBag);
        }

        if (categoryBag != null) {
            request.setCategoryBag(categoryBag);
        }

        if (tModelBag != null) {
            request.setTModelBag(tModelBag);
        }

        if (findQualifiers != null) {
            request.setFindQualifiers(findQualifiers);
        }

        request.setMaxRows(maxRows);

        BusinessList bl = null;
        JAXBElement<?> o = execute(this.objectFactory.createFindBusiness(request), this.getInquiryURI());
        if (o != null)
            bl = (BusinessList) o.getValue();

        return bl;
    }

    /**
     * "Used to locate specific bindings within a registered businessService.
     * Returns a bindingDetail message."
     * 
     * @exception RegistryV3Exception
     */
    public BindingDetail findBinding(String serviceKey, CategoryBag categoryBag, TModelBag tModelBag,
            FindQualifiers findQualifiers, int maxRows) throws RegistryV3Exception {
        // FIXME: Juddi's methods also set category bag (per uddi spec v3).
        // However, we are sticking to v2 for now, so categorybag doesn't
        // exist under FindBinding. It is fine for now, since the incoming
        // parameter value is always null anyways -- but this may change
        // in the future.

        FindBinding request = this.objectFactory.createFindBinding();

        if (serviceKey != null) {
            request.setServiceKey(serviceKey);
        }

        if (categoryBag != null) {
            request.setCategoryBag(categoryBag);
        }

        if (tModelBag != null) {
            request.setTModelBag(tModelBag);
        }

        if (findQualifiers != null) {
            request.setFindQualifiers(findQualifiers);
        }
        request.setMaxRows(maxRows);

        BindingDetail bd = null;
        JAXBElement<?> o = execute(this.objectFactory.createFindBinding(request), this.getInquiryURI());
        if (o != null)
            bd = (BindingDetail) o.getValue();

        return bd;
    }

    /**
     * "Used to locate specific services within a registered businessEntity.
     * Return a serviceList message." From the XML spec (API, p18) it appears
     * that the name, categoryBag, and tModelBag arguments are mutually
     * exclusive.
     * 
     * @exception RegistryV3Exception;
     */
    public ServiceList findService(String businessKey, Name[] nameArray, CategoryBag categoryBag,
            TModelBag tModelBag, FindQualifiers findQualifiers, int maxRows) throws RegistryV3Exception {
        FindService request = this.objectFactory.createFindService();

        if (businessKey != null) {
            request.setBusinessKey(businessKey);
        }

        if (nameArray != null) {
            request.getName().addAll(Arrays.asList(nameArray));
        }

        if (categoryBag != null) {
            request.setCategoryBag(categoryBag);
        }

        if (tModelBag != null) {
            request.setTModelBag(tModelBag);
        }

        if (findQualifiers != null) {
            request.setFindQualifiers(findQualifiers);
        }

        request.setMaxRows(maxRows);

        ServiceList sl = null;
        JAXBElement<?> o = execute(this.objectFactory.createFindService(request), this.getInquiryURI());
        if (o != null)
            sl = (ServiceList) o.getValue();

        return sl;
    }

    /**
     * "Used to locate one or more tModel information structures. Returns a
     * tModelList structure."
     * 
     * @exception RegistryV3Exception;
     */
    public TModelList findTModel(String name, CategoryBag categoryBag, IdentifierBag identifierBag,
            FindQualifiers findQualifiers, int maxRows) throws RegistryV3Exception {
        FindTModel request = this.objectFactory.createFindTModel();

        Name jaxbName = this.objectFactory.createName();

        if (name != null) {
            jaxbName.setValue(name);
        }

        request.setName(jaxbName);

        if (categoryBag != null) {
            request.setCategoryBag(categoryBag);
        }

        if (identifierBag != null) {
            request.setIdentifierBag(identifierBag);
        }

        if (findQualifiers != null) {
            request.setFindQualifiers(findQualifiers);
        }

        request.setMaxRows(maxRows);

        TModelList tml = null;
        JAXBElement<?> o = execute(this.objectFactory.createFindTModel(request), this.getInquiryURI());
        if (o != null)
            tml = (TModelList) o.getValue();

        return tml;
    }

    /**
     * @exception RegistryV3Exception;
     */
    public AssertionStatusReport getAssertionStatusReport(String authInfo, String completionStatus)
            throws RegistryV3Exception {
        GetAssertionStatusReport request = this.objectFactory.createGetAssertionStatusReport();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (completionStatus != null) {
            CompletionStatus cs = CompletionStatus.fromValue(completionStatus);
            request.setCompletionStatus(cs);
        }

        AssertionStatusReport asr = new AssertionStatusReport();
        JAXBElement<?> o = execute(this.objectFactory.createGetAssertionStatusReport(request),
                this.getPublishURI());
        asr = (AssertionStatusReport) o.getValue();

        return asr;
    }

    /**
     * "Used to request an authentication token from an Operator Site.
     * Authentication tokens are required to use all other APIs defined in the
     * publishers API. This server serves as the program's equivalent of a login
     * request."
     * 
     * @exception RegistryV3Exception;
     */
    public AuthToken getAuthToken(String userID, String cred) throws RegistryV3Exception {
        GetAuthToken request = this.objectFactory.createGetAuthToken();

        if (userID != null) {
            request.setUserID(userID);
        }

        if (cred != null) {
            request.setCred(cred);
        }

        URI getAuthTokenURI = null;
        if ("3.0".equals(uddiVersion)) {
            getAuthTokenURI = this.getSecurityURI();
        } else {
            getAuthTokenURI = this.getPublishURI();
        }

        AuthToken at = null;
        JAXBElement<?> o = execute(this.objectFactory.createGetAuthToken(request), getAuthTokenURI);
        if (o != null)
            at = (AuthToken) o.getValue();

        return at;
    }

    /**
     * Used to get the full businessEntity information for a particular business
     * entity. Returns a businessDetail message.
     * 
     * @exception RegistryV3Exception;
     */
    public BusinessDetail getBusinessDetail(String businessKey) throws RegistryV3Exception {
        String[] keys = new String[1];
        keys[0] = businessKey;

        return getBusinessDetail(keys);
    }

    /**
     * "Used to get the full businessEntity information for one or more
     * businesses. Returns a businessDetail message."
     * 
     * @exception RegistryV3Exception;
     */
    public BusinessDetail getBusinessDetail(String[] businessKeyArray) throws RegistryV3Exception {
        GetBusinessDetail request = this.objectFactory.createGetBusinessDetail();

        if (businessKeyArray != null) {
            request.getBusinessKey().addAll(Arrays.asList(businessKeyArray));
        }

        BusinessDetail bd = null;
        JAXBElement<?> o = execute(this.objectFactory.createGetBusinessDetail(request), this.getInquiryURI());
        bd = (BusinessDetail) o.getValue();
        return bd;
    }

    /**
     * @exception RegistryV3Exception;
     */
    public PublisherAssertions getPublisherAssertions(String authInfo) throws RegistryV3Exception {
        GetPublisherAssertions request = this.objectFactory.createGetPublisherAssertions();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        PublisherAssertions pa = new PublisherAssertions();
        JAXBElement<?> o = execute(this.objectFactory.createGetPublisherAssertions(request), this.getPublishURI());
        if (o != null) {
            PublisherAssertionsResponse par = (PublisherAssertionsResponse) o.getValue();
            List<PublisherAssertion> assertions = par.getPublisherAssertion();
            for (int i = 0; i < assertions.size(); i++) {
                pa.getPublisherAssertion().add((PublisherAssertion) assertions.get(i));
            }
        }

        return pa;
    }

    /**
     * @exception RegistryV3Exception;
     */
    public RegisteredInfo getRegisteredInfo(String authInfo) throws RegistryV3Exception {
        GetRegisteredInfo request = this.objectFactory.createGetRegisteredInfo();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        request.setInfoSelection(InfoSelection.ALL);

        RegisteredInfo ri = null;
        JAXBElement<?> o = execute(this.objectFactory.createGetRegisteredInfo(request), this.getPublishURI());
        if (o != null)
            ri = (RegisteredInfo) o.getValue();

        return ri;
    }

    /**
     * "Used to get full details for a particular registered businessService.
     * Returns a serviceDetail message."
     * 
     * @exception RegistryV3Exception;
     */
    public ServiceDetail getServiceDetail(String serviceKey) throws RegistryV3Exception {
        String[] keys = new String[1];
        keys[0] = serviceKey;

        return getServiceDetail(keys);
    }

    /**
     * "Used to get full details for a given set of registered businessService
     * data. Returns a serviceDetail message."
     * 
     * @exception RegistryV3Exception;
     */
    public ServiceDetail getServiceDetail(String[] serviceKeyArray) throws RegistryV3Exception {
        GetServiceDetail request = this.objectFactory.createGetServiceDetail();

        if (serviceKeyArray != null) {
            request.getServiceKey().addAll(Arrays.asList(serviceKeyArray));
        }

        ServiceDetail sd = null;
        JAXBElement<?> o = execute(this.objectFactory.createGetServiceDetail(request), this.getInquiryURI());
        if (o != null)
            sd = (ServiceDetail) o.getValue();

        return sd;
    }

    /**
     * "Used to get full details for a particular registered TModel. Returns a
     * tModelDetail message."
     * 
     * @exception RegistryV3Exception;
     */
    public TModelDetail getTModelDetail(String tModelKey) throws RegistryV3Exception {
        String[] keys = new String[1];
        keys[0] = tModelKey;

        return getTModelDetail(keys);
    }

    /**
     * "Used to get full details for a given set of registered tModel data.
     * Returns a tModelDetail message."
     * 
     * @exception RegistryV3Exception;
     */
    public TModelDetail getTModelDetail(String[] tModelKeyArray) throws RegistryV3Exception {
        GetTModelDetail request = this.objectFactory.createGetTModelDetail();

        if (tModelKeyArray != null) {
            request.getTModelKey().addAll(Arrays.asList(tModelKeyArray));
        }

        TModelDetail tmd = null;
        JAXBElement<?> o = execute(this.objectFactory.createGetTModelDetail(request), this.getInquiryURI());
        if (o != null)
            tmd = (TModelDetail) o.getValue();

        return tmd;
    }

    /**
     * @exception RegistryV3Exception;
     */
    public PublisherAssertions setPublisherAssertions(String authInfo, PublisherAssertion[] assertionArray)
            throws RegistryV3Exception {
        SetPublisherAssertions request = this.objectFactory.createSetPublisherAssertions();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (assertionArray != null) {
            request.getPublisherAssertion().addAll(Arrays.asList(assertionArray));
        }

        PublisherAssertions pa = null;
        JAXBElement<?> o = execute(this.objectFactory.createSetPublisherAssertions(request), this.getPublishURI());
        if (o != null)
            pa = (PublisherAssertions) o.getValue();

        return pa;
    }

    /**
     * "Used to register new bindingTemplate information or update existing
     * bindingTemplate information. Use this to control information about
     * technical capabilities exposed by a registered business."
     * 
     * @exception RegistryV3Exception;
     */
    public BindingDetail saveBinding(String authInfo, BindingTemplate[] bindingArray) throws RegistryV3Exception {
        SaveBinding request = this.objectFactory.createSaveBinding();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (bindingArray != null) {
            request.getBindingTemplate().addAll(Arrays.asList(bindingArray));
        }

        BindingDetail bd = null;
        JAXBElement<?> o = execute(this.objectFactory.createSaveBinding(request), this.getPublishURI());
        if (o != null)
            bd = (BindingDetail) o.getValue();

        return bd;
    }

    /**
     * "Used to register new businessEntity information or update existing
     * businessEntity information. Use this to control the overall information
     * about the entire business. Of the save_x APIs this one has the broadest
     * effect."
     * 
     * @exception RegistryV3Exception;
     */
    public BusinessDetail saveBusiness(String authInfo, BusinessEntity[] businessArray) throws RegistryV3Exception {
        SaveBusiness request = this.objectFactory.createSaveBusiness();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (businessArray != null) {
            for (int i = 0; i < businessArray.length; i++) {
                BusinessEntity be = businessArray[i];
                if (be.getBusinessServices().getBusinessService().size() == 0) {
                    be.setBusinessServices(null);
                }
            }

            request.getBusinessEntity().addAll(Arrays.asList(businessArray));
        }

        BusinessDetail bd = null;
        JAXBElement<?> o = execute(this.objectFactory.createSaveBusiness(request), this.getPublishURI());
        if (o != null)
            bd = (BusinessDetail) o.getValue();

        return bd;
    }

    /**
     * "Used to register or update complete information about a businessService
     * exposed by a specified businessEntity."
     * 
     * @exception RegistryV3Exception;
     */
    public ServiceDetail saveService(String authInfo, BusinessService[] serviceArray) throws RegistryV3Exception {
        SaveService request = this.objectFactory.createSaveService();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (serviceArray != null) {
            request.getBusinessService().addAll(Arrays.asList(serviceArray));
        }

        ServiceDetail sd = null;
        JAXBElement<?> o = execute(this.objectFactory.createSaveService(request), this.getPublishURI());
        if (o != null)
            sd = (ServiceDetail) o.getValue();

        return sd;
    }

    /**
     * "Used to register or update complete information about a tModel."
     * 
     * @exception RegistryV3Exception;
     */
    public TModelDetail saveTModel(String authInfo, TModel[] tModelArray) throws RegistryV3Exception {
        SaveTModel request = this.objectFactory.createSaveTModel();

        if (authInfo != null) {
            request.setAuthInfo(authInfo);
        }

        if (tModelArray != null) {
            request.getTModel().addAll(Arrays.asList(tModelArray));
        }

        TModelDetail tmd = null;
        JAXBElement<?> o = execute(this.objectFactory.createSaveTModel(request), this.getPublishURI());
        if (o != null)
            tmd = (TModelDetail) o.getValue();
        return tmd;
    }

    /**
     * Returns an implementation of Transport based on the className passed in.
     * If a null value is passed then the default Transport implementation
     * "org.apache.ws.scout.transport.AxisTransport" is created and returned.
     * 
     * @return Transport
     */
    public Transport getTransport(String className) {
        Transport transport = null;
        Class transportClass = null;

        // If a Transport class name isn't supplied use
        // the default Transport implementation.
        if (className == null)
            className = DEFAULT_TRANSPORT_CLASS;

        try {
            // instruct class loader to load the TransportFactory
            transportClass = getClassForName(className);
        } catch (ClassNotFoundException cnfex) {
            throw new RuntimeException(cnfex);
        }

        try {
            // try to instantiate the TransportFactory
            if (LocalTransport.class.getName().equals(className) && managerName != null) {
                transport = (Transport) transportClass.getConstructor(new Class[] { String.class, String.class })
                        .newInstance(nodeName, managerName);
            } else {
                transport = (Transport) transportClass.newInstance();
            }
        } catch (Exception ex) {
            throw new RuntimeException(ex);
        }

        return transport;
    }

    /**
     * 
     * @param name
     * @return The class object for the name given
     * @throws ClassNotFoundException
     * @throws NoClassDefFoundError
     */
    public static Class getClassForName(String name) throws ClassNotFoundException, NoClassDefFoundError {
        Class clazz = null;

        try {
            // log.info("Using the Context ClassLoader");
            ClassLoader ccl = AccessController.doPrivileged(new PrivilegedAction<ClassLoader>() {
                public ClassLoader run() {
                    return Thread.currentThread().getContextClassLoader();
                }
            });

            clazz = Class.forName(name, true, ccl);
        } catch (Exception e) {
            log.debug("Failed to load the class " + name + " with context class loader " + e);
        }

        if (null == clazz) {
            ClassLoader scl = AccessController.doPrivileged(new PrivilegedAction<ClassLoader>() {
                public ClassLoader run() {
                    return ClassLoader.getSystemClassLoader();
                }
            });

            try {
                clazz = Class.forName(name, true, scl);
            } catch (Exception e) {
                throw new RuntimeException(e);
            }
        }

        return clazz;
    }
}