< prev index next >

src/java.xml.ws/share/classes/javax/xml/ws/LogicalMessage.java

Print this page

        

*** 1,7 **** /* ! * Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this --- 1,7 ---- /* ! * Copyright (c) 2005, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this
*** 26,56 **** package javax.xml.ws; import javax.xml.transform.Source; import javax.xml.bind.JAXBContext; ! /** The <code>LogicalMessage</code> interface represents a * protocol agnostic XML message and contains methods that * provide access to the payload of the message. * * @since 1.6, JAX-WS 2.0 **/ public interface LogicalMessage { /** Gets the message payload as an XML source, may be called * multiple times on the same LogicalMessage instance, always ! * returns a new <code>Source</code> that may be used to retrieve the entire * message payload. * ! * <p>If the returned <code>Source</code> is an instance of ! * <code>DOMSource</code>, then * modifications to the encapsulated DOM tree change the message * payload in-place, there is no need to susequently call ! * <code>setPayload</code>. Other types of <code>Source</code> provide only * read access to the message payload. * ! * @return The contained message payload; returns <code>null</code> if no * payload is present in this message. **/ public Source getPayload(); /** Sets the message payload --- 26,56 ---- package javax.xml.ws; import javax.xml.transform.Source; import javax.xml.bind.JAXBContext; ! /** The {@code LogicalMessage} interface represents a * protocol agnostic XML message and contains methods that * provide access to the payload of the message. * * @since 1.6, JAX-WS 2.0 **/ public interface LogicalMessage { /** Gets the message payload as an XML source, may be called * multiple times on the same LogicalMessage instance, always ! * returns a new {@code Source} that may be used to retrieve the entire * message payload. * ! * <p>If the returned {@code Source} is an instance of ! * {@code DOMSource}, then * modifications to the encapsulated DOM tree change the message * payload in-place, there is no need to susequently call ! * {@code setPayload}. Other types of {@code Source} provide only * read access to the message payload. * ! * @return The contained message payload; returns {@code null} if no * payload is present in this message. **/ public Source getPayload(); /** Sets the message payload
*** 63,77 **** **/ public void setPayload(Source payload); /** Gets the message payload as a JAXB object. Note that there is no * connection between the returned object and the message payload, ! * changes to the payload require calling <code>setPayload</code>. * * @param context The JAXBContext that should be used to unmarshall * the message payload ! * @return The contained message payload; returns <code>null</code> if no * payload is present in this message * @throws WebServiceException If an error occurs when using a supplied * JAXBContext to unmarshall the payload. The cause of * the WebServiceException is the original JAXBException. **/ --- 63,77 ---- **/ public void setPayload(Source payload); /** Gets the message payload as a JAXB object. Note that there is no * connection between the returned object and the message payload, ! * changes to the payload require calling {@code setPayload}. * * @param context The JAXBContext that should be used to unmarshall * the message payload ! * @return The contained message payload; returns {@code null} if no * payload is present in this message * @throws WebServiceException If an error occurs when using a supplied * JAXBContext to unmarshall the payload. The cause of * the WebServiceException is the original JAXBException. **/
< prev index next >