com.sun.xml.ws.api.model.wsdl.WSDLModel Maven / Gradle / Ivy
/*
* The contents of this file are subject to the terms
* of the Common Development and Distribution License
* (the License). You may not use this file except in
* compliance with the License.
*
* You can obtain a copy of the license at
* https://glassfish.dev.java.net/public/CDDLv1.0.html.
* See the License for the specific language governing
* permissions and limitations under the License.
*
* When distributing Covered Code, include this CDDL
* Header Notice in each file and include the License file
* at https://glassfish.dev.java.net/public/CDDLv1.0.html.
* If applicable, add the following below the CDDL Header,
* with the fields enclosed by brackets [] replaced by
* you own identifying information:
* "Portions Copyrighted [year] [name of copyright owner]"
*
* Copyright 2006 Sun Microsystems Inc. All Rights Reserved
*/
package com.sun.xml.ws.api.model.wsdl;
import com.sun.istack.NotNull;
import com.sun.xml.ws.api.wsdl.parser.WSDLParserExtension;
import com.sun.xml.ws.api.wsdl.parser.XMLEntityResolver;
import com.sun.xml.ws.wsdl.parser.RuntimeWSDLParser;
import org.xml.sax.SAXException;
import javax.xml.namespace.QName;
import javax.xml.stream.XMLStreamException;
import java.io.IOException;
import java.util.Map;
/**
* Provides abstraction of wsdl:definitions.
*
* @author Vivek Pandey
*/
public interface WSDLModel extends WSDLExtensible {
/**
* Gets {@link WSDLPortType} that models wsdl:portType
*
* @param name non-null quaified name of wsdl:message, where the localName is the value of wsdl:portType@name and
* the namespaceURI is the value of wsdl:definitions@targetNamespace
* @return A {@link com.sun.xml.ws.api.model.wsdl.WSDLPortType} or null if no wsdl:portType found.
*/
WSDLPortType getPortType(@NotNull QName name);
/**
* Gets {@link WSDLBoundPortType} that models wsdl:binding
*
* @param name non-null quaified name of wsdl:binding, where the localName is the value of wsdl:binding@name and
* the namespaceURI is the value of wsdl:definitions@targetNamespace
* @return A {@link WSDLBoundPortType} or null if no wsdl:binding found
*/
WSDLBoundPortType getBinding(@NotNull QName name);
/**
* Give a {@link WSDLBoundPortType} for the given wsdl:service and wsdl:port names.
*
* @param serviceName service QName
* @param portName port QName
* @return A {@link WSDLBoundPortType}. null if the Binding for the given wsd:service and wsdl:port name are not
* found.
*/
WSDLBoundPortType getBinding(@NotNull QName serviceName, @NotNull QName portName);
/**
* Gets {@link WSDLService} that models wsdl:service
*
* @param name non-null quaified name of wsdl:service, where the localName is the value of wsdl:service@name and
* the namespaceURI is the value of wsdl:definitions@targetNamespace
* @return A {@link WSDLService} or null if no wsdl:service found
*/
WSDLService getService(@NotNull QName name);
/**
* Gives a {@link Map} of wsdl:portType {@link QName} and {@link WSDLPortType}
*
* @return an empty Map if the wsdl document has no wsdl:portType
*/
@NotNull Map getPortTypes();
/**
* Gives a {@link Map} of wsdl:binding {@link QName} and {@link WSDLBoundPortType}
*
* @return an empty Map if the wsdl document has no wsdl:binding
*/
@NotNull Map getBindings();
/**
* Gives a {@link Map} of wsdl:service qualified name and {@link com.sun.xml.ws.api.model.wsdl.WSDLService}
*
* @return an empty Map if the wsdl document has no wsdl:service
*/
@NotNull Map getServices();
/**
* Main purpose of this class is to parsing of a WSDL and get the {@link WSDLModel} from it.
*/
public class WSDLParser{
/**
* Parses WSDL from the given wsdlLoc and gives a {@link WSDLModel} built from it.
*
* @param wsdlEntityParser Works like an entityResolver to resolve WSDLs
* @param resolver {@link XMLEntityResolver}, works at XML infoset level
* @param isClientSide true - its invoked on the client, false means its invoked on the server
* @param extensions var args of {@link com.sun.xml.ws.api.wsdl.parser.WSDLParserExtension}s
* @return A {@link WSDLModel} built from the given wsdlLocation}
* @throws java.io.IOException
* @throws javax.xml.stream.XMLStreamException
* @throws org.xml.sax.SAXException
*/
public static @NotNull WSDLModel parse(XMLEntityResolver.Parser wsdlEntityParser, XMLEntityResolver resolver, boolean isClientSide, WSDLParserExtension... extensions) throws IOException, XMLStreamException, SAXException {
return RuntimeWSDLParser.parse(wsdlEntityParser, resolver, isClientSide, extensions);
}
}
}