1 /*
   2  * Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 /**
  27  * <h1>JAX-WS 2.1 Tools</h1>
  28  * This document describes the tools included with JAX-WS 2.0.1.
  29  *
  30  * <h2>ANT Tasks</h2>
  31    <d1>
  32  *  <dt>{@link com.sun.tools.internal.ws.ant.AnnotationProcessingTask AnnotationProcessing}
  33  *  <dd>An ANT task to invoke <a href="http://download.oracle.com/javase/6/docs/api/javax/annotation/processing/package-summary.html">Annotation Processing</a>.
  34 
  35  *  <dt>{@link com.sun.tools.internal.ws.ant.WsGen2 WsGen}
  36  *  <dd>
  37  *    An ANT task to invoke {@link com.sun.tools.internal.ws.WsGen WsGen}
  38 
  39  *  <dt>{@link com.sun.tools.internal.ws.ant.WsImport2 WsImport}
  40  *  <dd>
  41  *    An ANT task to invoke {@link com.sun.tools.internal.ws.WsImport WsImport}
  42  *
  43  *  </d1>
  44  * <h2>Command-line Tools</h2>
  45    <d1>
  46  *  <dt><a href="http://download.oracle.com/javase/6/docs/api/javax/annotation/processing/package-summary.html">AP</a>
  47  <dd>A Java SE tool and framework for processing annotations. Annotation processing will invoke a JAX-WS AnnotationProcossor for
  48  *   processing Java source  files with javax.jws.* annotations and making them web services.
  49  *   Annotation processing will compile the Java source files and generate any additional classes needed to make an javax.jws.WebService
  50  *   annotated class a Web service.
  51  *
  52  *  <dt>{@link com.sun.tools.internal.ws.WsGen WsGen}
  53  *  <dd>Tool to process a compiled javax.jws.WebService annotated class and to generate the necessary classes to make
  54  *  it a Web service.
  55 
  56  *  <dt>{@link com.sun.tools.internal.ws.ant.WsImport2 WsImport}
  57  *  <dd>
  58  *    Tool to import a WSDL and to generate an SEI (a javax.jws.WebService) interface that can be either implemented
  59  *    on the server to build a web service, or can be used on the client to invoke the web service.
  60  *  </d1>
  61  * <h2>Implementation Classes</h2>
  62  *  <d1>
  63  *    <dt>{@link com.sun.tools.internal.ws.processor.model.Model Model}
  64  *    <dd>The model is used to represent the entire Web Service.  The JAX-WS ProcessorActions can process
  65  *    this Model to generate Java artifacts such as the service interface.
  66  *
  67  *
  68  *    <dt>{@link com.sun.tools.internal.ws.processor.modeler.Modeler Modeler}
  69  *    <dd>A Modeler is used to create a Model of a Web Service from a particular Web
  70  *    Web Service description such as a WSDL
  71  *    file.
  72  *
  73  *    <dt>{@link com.sun.tools.internal.ws.processor.modeler.wsdl.WSDLModeler WSDLModeler}
  74  *    <dd>The WSDLModeler processes a WSDL to create a Model.
  75  *
  76  *    <dt>{@link com.sun.tools.internal.ws.processor.modeler.annotation.WebServiceAp WebServiceAp}
  77  *    <dd>WebServiceAp is a AnnotationProcessor for processing javax.jws.* and
  78  *    javax.xml.ws.* annotations. This class is used either by the WsGen (CompileTool) tool or
  79  *    idirectly via the {@link com.sun.istack.internal.ws.WSAP WSAP} when invoked by Annotation Processing.
  80  *   </d1>
  81  *
  82  **/
  83 package com.sun.tools.internal.ws;