com.sun.xml.ws.rx.rm.runtime.RmRuntimeVersion 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.rx.rm.runtime;
import com.sun.xml.ws.rx.RxRuntimeException;
import com.sun.xml.ws.rx.util.JaxbContextRepository;
import com.sun.xml.bind.api.JAXBRIContext;
import com.sun.xml.ws.api.addressing.AddressingVersion;
import com.sun.xml.ws.rx.rm.api.RmProtocolVersion;
import javax.xml.bind.Unmarshaller;
/**
* This enumeration contains all currently supported WS-ReliableMessaging versions.
* The used reliable messaging version affects the WS-ReliableMessaging Policy assertions displayed
* int the web service's WSDL, XML namespace of RM protocol element being created
* as well as RM protocol message processing logic.
*
* @author Marek Potociar
*
* @see #WSRM200502
* @see #WSRM200702
*/
public enum RmRuntimeVersion {
/**
*
* This value represents the outdated and obsolete WS-ReliableMessaging v1.0 protocol.
*
*
* You may want to choose this version for your WS endpoints to ensure maximum
* backward compatibility with clients running on older systems, such as
* Metro 1.0 or .NET 3.0
*
*
* @see RmVersion
*/
WSRM200502(
RmProtocolVersion.WSRM200502,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.AcceptType.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.AckRequestedElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.CreateSequenceElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.CreateSequenceResponseElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.Expires.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.Identifier.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.OfferType.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.SequenceAcknowledgementElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.SequenceElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.SequenceFaultElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200502.TerminateSequenceElement.class),
/**
*
* This value represents the version of WS-ReliableMessaging protocol standardized
* by OASIS organization. This is currently the most up-to-date version.
*
*
* You should primarily use this version for your WS endpoints. It is compatible with
* clients running on Metro 1.3 or .NET 3.5 and later.
*
*
* @see RmVersion
*/
WSRM200702(
RmProtocolVersion.WSRM200702,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.AcceptType.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.AckRequestedElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.Address.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.CloseSequenceElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.CloseSequenceResponseElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.CreateSequenceElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.CreateSequenceResponseElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.DetailType.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.Expires.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.Identifier.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.IncompleteSequenceBehaviorType.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.OfferType.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.SequenceAcknowledgementElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.SequenceElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.SequenceFaultElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.TerminateSequenceElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.TerminateSequenceResponseElement.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.UsesSequenceSSL.class,
com.sun.xml.ws.rx.rm.protocol.wsrm200702.UsesSequenceSTR.class);
public static RmRuntimeVersion forProtocolVersion(RmProtocolVersion protocolVersion) {
for (RmRuntimeVersion version : values()) {
if (version.protocolVersion == protocolVersion) {
return version;
}
}
assert false : "Unsupported WS-ReliableMessaging protocol version definition detected"; // we should never get here
return null;
}
/**
* Provides a default reliable messaging version value.
*
* @return a default reliable messaging version value. Currently returns {@link #WSRM200702}.
*
* @see RmVersion
*/
public static RmRuntimeVersion getDefault() {
return forProtocolVersion(RmProtocolVersion.getDefault());
}
/**
* General constants
*/
public final RmProtocolVersion protocolVersion;
/**
* Private fields
*/
private final JaxbContextRepository jaxbContextRepository;
private RmRuntimeVersion(RmProtocolVersion protocolVersion, Class... rmProtocolClasses) {
this.protocolVersion = protocolVersion;
this.jaxbContextRepository = new JaxbContextRepository(rmProtocolClasses);
}
/**
* Creates JAXB {@link Unmarshaller} that is able to unmarshall protocol elements for given WS-RM version.
*
* As JAXB unmarshallers are not thread-safe, this method should be used to create a new {@link Unmarshaller}
* instance whenever there is a chance that the same instance might be invoked concurrently from multiple
* threads. On th other hand, it is prudent to cache or pool {@link Unmarshaller} instances if possible as
* constructing a new {@link Unmarshaller} instance is rather expensive.
*
* For additional information see this blog entry.
*
* @return created JAXB unmarshaller
*
* @exception RxRuntimeException in case the creation of unmarshaller failed
*/
public Unmarshaller createUnmarshaller(AddressingVersion av) throws RxRuntimeException {
return jaxbContextRepository.getUnmarshaller(av);
}
/**
* Returns JAXB context that is intitialized based on a given addressing version.
*
* @param av addressing version used to initialize JAXB context
*
* @return JAXB context that is intitialized based on a given addressing version.
*/
public JAXBRIContext getJaxbContext(AddressingVersion av) {
return jaxbContextRepository.getJaxbContext(av);
}
@Override
public String toString() {
return "RmRuntimeVersion{" + "protocolVersion=" + protocolVersion + '}';
}
}