|
Java example source code file (package-info.java)
The package-info.java Java example source code/* * Copyright (c) 1997, 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 * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ /** * <h1>JAX-WS 2.0.1 Client Runtime * <P>This document describes the architecture of client side * JAX-WS 2.0.1 runtime. * * <h3>JAX-WS 2.0.1 Client Sequence Diagram * <img src='../../../../../jaxws/basic-client.seq.png'> * <h3>JAX-WS 2.0.1 Asynchronous Invocation Sequence Diagram * <img src='../../../../../jaxws/client-async.seq.png'> * <h3>JAX-WS 2.0.1 Dispatch Invocation Sequence Diagram * <img src='../../../../../jaxws/dispatch.seq.png'> * <H3>Message Flow * {@link com.sun.xml.internal.ws.client.WebService} provides client view of a Web service. * WebService.getPort returns an instance of {@link com.sun.xml.internal.ws.client.EndpointIFInvocationHandler} * with {@link com.sun.pept.ept.ContactInfoList} and {@link com.sun.pept.Delegate} * initialized. A method invocation on the port, obtained from WebService, invokes * {@link com.sun.xml.internal.ws.client.EndpointIFInvocationHandler#invoke}. This method * then creates a {@link com.sun.pept.ept.MessageInfo} and populates the data * (parameters specified by the user) and metadata such as RuntimeContext, RequestContext, * Message Exchange Pattern into this MessageInfo. This method then invokes * {@link com.sun.pept.Delegate#send} and returns the response. * <P> * The Delegate.send method iterates through the ContactInfoList and picks up the * correct {@link com.sun.pept.ept.ContactInfo} based upon the binding id of * {@link javax.xml.ws.BindingProvider} and sets it on the MessageInfo. After the * Delegate obtains a specific ContactInfo it uses that ContactInfo to obtain a * protocol-specific {@link com.sun.pept.protocol.MessageDispatcher}. There will be * two types of client-side MessageDispatchers for JAX-WS 2.0.1, * {@link com.sun.xml.internal.ws.protocol.soap.client.SOAPMessageDispatcher} and * {@link com.sun.xml.internal.ws.protocol.xml.client.XMLMessageDispatcher}. The Delegate * then invokes {@link com.sun.pept.protocol.MessageDispatcher#send}. The * MessageDispatcher.send method makes a decision about the synchronous and * asynchronous nature of the message exchange pattern and invokes separate methods * accordingly. * <p> * The MessageDispatcher uses ContactInfo to obtain * a {@link com.sun.xml.internal.ws.encoding.soap.client.SOAPXMLEncoder} which converts * the MessageInfo to {@link com.sun.xml.internal.ws.encoding.soap.internal.InternalMessage}. * There will be two types of client-side SOAPXMLEncoder for JAX-WS 2.0.1, * SOAPXMEncoder for SOAP 1.1 and {@link com.sun.xml.internal.ws.encoding.soap.client.SOAP12XMLEncoder} * for SOAP 1.2. The MessageDispatcher invokes configured handlers and use the * codec to convert the InternalMessage to a {@link javax.xml.soap.SOAPMessage}. * The metadata from the MessageInfo is classified into {@link javax.xml.soap.MimeHeaders} * of this SOAPMessage and context information for {@link com.sun.xml.internal.ws.api.server.WSConnection}. * The SOAPMessge is then written to the output stream of the WSConnection * obtained from MessageInfo. *<P> * The MessageDispatcher.receive method handles the response. The * SOAPMessageDispatcher extracts the SOAPMessage from the input stream of * WSConnection and performs the mustUnderstand processing followed by invocation * of any handlers. The MessageDispatcher uses ContactInfo to obtain a * {@link com.sun.xml.internal.ws.encoding.soap.client.SOAPXMLDecoder} which converts the SOAPMessage * to InternalMessage and then InternalMessage to MessageInfo. There will be two types of * client-side SOAPXMLDecoder for JAX-WS 2.0.1, SOAPXMLDencoder for SOAP 1.1 and * {@link com.sun.xml.internal.ws.encoding.soap.client.SOAP12XMLDecoder} for SOAP 1.2. The * response is returned back to the client code via Delegate. * * <H3>External Interactions * <H4>SAAJ API * <UL> * <LI> Other Java examples (source code examples)Here is a short list of links related to this Java package-info.java source code file: |
... this post is sponsored by my books ... | |
#1 New Release! |
FP Best Seller |
Copyright 1998-2021 Alvin Alexander, alvinalexander.com
All Rights Reserved.
A percentage of advertising revenue from
pages under the /java/jwarehouse
URI on this website is
paid back to open source projects.