com.sun.xml.ws.api.model.wsdl.WSDLModel Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of webservices-rt Show documentation
Show all versions of webservices-rt Show documentation
This module contains the Metro runtime code.
/*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
*
* Copyright (c) 1997-2017 Oracle and/or its affiliates. All rights reserved.
*
* The contents of this file are subject to the terms of either the GNU
* General Public License Version 2 only ("GPL") or the Common Development
* and Distribution License("CDDL") (collectively, the "License"). You
* may not use this file except in compliance with the License. You can
* obtain a copy of the License at
* https://oss.oracle.com/licenses/CDDL+GPL-1.1
* or LICENSE.txt. See the License for the specific
* language governing permissions and limitations under the License.
*
* When distributing the software, include this License Header Notice in each
* file and include the License file at LICENSE.txt.
*
* GPL Classpath Exception:
* Oracle designates this particular file as subject to the "Classpath"
* exception as provided by Oracle in the GPL Version 2 section of the License
* file that accompanied this code.
*
* Modifications:
* If applicable, add the following below the License Header, with the fields
* enclosed by brackets [] replaced by your own identifying information:
* "Portions Copyright [year] [name of copyright owner]"
*
* Contributor(s):
* If you wish your version of this file to be governed by only the CDDL or
* only the GPL Version 2, indicate your decision by adding "[Contributor]
* elects to include this software in this distribution under the [CDDL or GPL
* Version 2] license." If you don't indicate a single choice of license, a
* recipient has the option to distribute your version of this file under
* either the CDDL, the GPL Version 2 or to extend the choice of license to
* its licensees as provided above. However, if you add GPL Version 2 code
* and therefore, elected the GPL Version 2 license, then the option applies
* only if the new code is made subject to such option by the copyright
* holder.
*/
package com.sun.xml.ws.api.model.wsdl;
import com.sun.istack.NotNull;
import com.sun.xml.ws.api.server.Container;
import com.sun.xml.ws.api.wsdl.parser.WSDLParserExtension;
import com.sun.xml.ws.api.wsdl.parser.XMLEntityResolver;
import com.sun.xml.ws.api.policy.PolicyResolver;
import com.sun.xml.ws.api.policy.PolicyResolverFactory;
import com.sun.xml.ws.wsdl.parser.RuntimeWSDLParser;
import com.sun.xml.ws.policy.PolicyMap;
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();
/**
* Returns the first service QName from insertion order
*/
public QName getFirstServiceName();
/**
* Returns the message with the given QName
* @param name Message name
* @return Message
*/
public WSDLMessage getMessage(QName name);
/**
* Gives a {@link Map} of wsdl:message qualified name and {@link com.sun.xml.ws.api.model.wsdl.WSDLMesage}
*
* @return an empty Map if the wsdl document has no wsdl:message
*/
@NotNull Map getMessages();
/**
* Gives the PolicyMap associated with the WSDLModel
*
* @return PolicyMap
*
* @deprecated
* Do not use this method as the PolicyMap API is not final yet and might change in next few months.
*/
public PolicyMap getPolicyMap();
/**
* 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 parse(wsdlEntityParser, resolver, isClientSide, Container.NONE, extensions);
}
/**
* 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 container - container in which the parser is run
* @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, @NotNull Container container, WSDLParserExtension... extensions) throws IOException, XMLStreamException, SAXException {
return parse(wsdlEntityParser, resolver, isClientSide, container, PolicyResolverFactory.create(),extensions);
}
/**
* 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 container - container in which the parser is run
* @param policyResolver - PolicyResolver for resolving effective Policy
* @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, @NotNull Container container, PolicyResolver policyResolver, WSDLParserExtension... extensions) throws IOException, XMLStreamException, SAXException {
return RuntimeWSDLParser.parse(wsdlEntityParser, resolver, isClientSide, container, policyResolver, extensions);
}
}
}