| <!DOCTYPE html> |
| <!-- |
| | Generated by Apache Maven Doxia at 2015-07-03 |
| | Rendered using Apache Maven Fluido Skin 1.3.0 |
| --> |
| <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
| <head> |
| <meta charset="UTF-8" /> |
| <meta name="viewport" content="width=device-width, initial-scale=1.0" /> |
| <meta name="Date-Revision-yyyymmdd" content="20150703" /> |
| <meta http-equiv="Content-Language" content="en" /> |
| <title>wsdd-maven-plugin – Introduction</title> |
| <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" /> |
| <link rel="stylesheet" href="./css/site.css" /> |
| <link rel="stylesheet" href="./css/print.css" media="print" /> |
| |
| |
| <script type="text/javascript" src="./js/apache-maven-fluido-1.3.0.min.js"></script> |
| |
| |
| </head> |
| <body class="topBarDisabled"> |
| |
| |
| |
| |
| <div class="container-fluid"> |
| <div id="banner"> |
| <div class="pull-left"> |
| <div id="bannerLeft"> |
| <h2>wsdd-maven-plugin</h2> |
| </div> |
| </div> |
| <div class="pull-right"> <a href="../.." id="bannerRight"> |
| <img src="../../images/axis-small.png" alt="Apache Axis"/> |
| </a> |
| </div> |
| <div class="clear"><hr/></div> |
| </div> |
| |
| <div id="breadcrumbs"> |
| <ul class="breadcrumb"> |
| |
| |
| <li class=""> |
| <a href="http://www.apache.org/" class="externalLink" title="Apache"> |
| Apache</a> |
| </li> |
| <li class="divider ">/</li> |
| <li class=""> |
| <a href="../../../../" title="Axis"> |
| Axis</a> |
| </li> |
| <li class="divider ">/</li> |
| <li class=""> |
| <a href="../../../" title="Axis 1.x"> |
| Axis 1.x</a> |
| </li> |
| <li class="divider ">/</li> |
| <li class=""> |
| <a href="../../" title="Java"> |
| Java</a> |
| </li> |
| <li class="divider ">/</li> |
| <li class=""> |
| <a href="../" title="Maven plugins"> |
| Maven plugins</a> |
| </li> |
| <li class="divider ">/</li> |
| <li class=""> |
| <a href="./" title="wsdd-maven-plugin"> |
| wsdd-maven-plugin</a> |
| </li> |
| <li class="divider ">/</li> |
| <li class="">Introduction</li> |
| |
| |
| |
| <li id="publishDate" class="pull-right">Last Published: 2015-07-03</li> <li class="divider pull-right">|</li> |
| <li id="projectVersion" class="pull-right">Version: 1.4.1-SNAPSHOT</li> |
| |
| </ul> |
| </div> |
| |
| |
| <div class="row-fluid"> |
| <div id="leftColumn" class="span3"> |
| <div class="well sidebar-nav"> |
| |
| |
| <ul class="nav nav-list"> |
| <li class="nav-header">Overview</li> |
| |
| <li class="active"> |
| |
| <a href="#"><i class="none"></i>Introduction</a> |
| </li> |
| |
| <li> |
| |
| <a href="plugin-info.html" title="Goals"> |
| <i class="none"></i> |
| Goals</a> |
| </li> |
| <li class="nav-header">Apache</li> |
| |
| <li> |
| |
| <a href="http://www.apache.org/licenses/LICENSE-2.0.html" class="externalLink" title="License"> |
| <i class="none"></i> |
| License</a> |
| </li> |
| |
| <li> |
| |
| <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship"> |
| <i class="none"></i> |
| Sponsorship</a> |
| </li> |
| |
| <li> |
| |
| <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"> |
| <i class="none"></i> |
| Thanks</a> |
| </li> |
| |
| <li> |
| |
| <a href="http://www.apache.org/security/" class="externalLink" title="Security"> |
| <i class="none"></i> |
| Security</a> |
| </li> |
| </ul> |
| |
| |
| <form id="search-form" action="http://www.google.com/search" method="get" > |
| |
| <input value="ws.apache.org/axis/java" name="sitesearch" type="hidden"/> |
| <input class="search-query" name="q" id="query" type="text" /> |
| </form> |
| <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=search-form"></script> |
| |
| <hr class="divider" /> |
| |
| <div id="poweredBy"> |
| <div class="clear"></div> |
| <div class="clear"></div> |
| <div class="clear"></div> |
| <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> |
| <img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> |
| </a> |
| </div> |
| </div> |
| </div> |
| |
| |
| <div id="bodyColumn" class="span9" > |
| |
| <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License. You may obtain a copy of the License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section"> |
| <h2><a name="wsdd-maven-plugin"></a>wsdd-maven-plugin</h2> |
| <p>Historically, the recommended way to deploy Axis services was based on the following procedure:</p> |
| <ol style="list-style-type: decimal"> |
| <li>Deploy the Axis WAR to a servlet container or application server.</li> |
| <li>Add the Web service code to the <tt>WEB-INF/classes</tt> or <tt>WEB-INF/lib</tt> folder in the (exploded) Axis WAR.</li> |
| <li>Create a WSDD file (or use the WSDD file generated by wsdl2java) and deploy it using the admin client. This will add the definitions contained in the submitted WSDD file to the <tt>server-config.wsdd</tt> file.</li></ol> |
| <p>This procedure is described in more details in the <a href="../../install.html">Installation Guide</a>.</p> |
| <p>However, nowadays the preferred approach - especially for enterprise projects - is to have a build process that packages the Web service(s) together with the Axis libraries into a WAR that is then deployed to the application server. This requires that the <tt>server-config.wsdd</tt> file is constructed before the WAR is built. With Axis 1.4, developers would typically maintain that file by hand, either by editing it directly (and copying the contents of WSDD files created by wsdl2java) or by using e.g. the Axis 1.4 tooling in Eclipse. The file is then added to the project files under source control so that it is available during the build.</p> |
| <p>This approach is suboptimal because in most cases the <tt>server-config.wsdd</tt> file contains content generated by wsdl2java. That content should not be under source control. Instead, the <tt>server-config.wsdd</tt> file should be assembled automatically during the build process, based on the output of wsdl2java.</p> |
| <p>This is exactly what the wsdd-maven-plugin does: it takes a set of WSDD files and merges them into a single output WSDD. The input WSDD files are typically generated by <a href="../wsdl2java/index.html">wsdl2java-maven-plugin</a>, but the set may also contain manually created WSDD files, e.g. to configure custom handlers or to override configuration properties.</p></div> |
| </div> |
| </div> |
| </div> |
| |
| <hr/> |
| |
| <footer> |
| <div class="container-fluid"> |
| <div class="row span12">Copyright © 2000-2015 |
| <a href="http://www.apache.org/">The Apache Software Foundation</a>. |
| All Rights Reserved. |
| |
| </div> |
| |
| |
| |
| </div> |
| </footer> |
| </body> |
| </html> |
