xml.wsdlui/javahelp/org/netbeans/modules/xml/wsdlui/docs/wsdl_editor_creating.html
author Milutin Kristofic <mkristofic@netbeans.org>
Tue, 31 Jan 2017 14:20:36 +0100
changeset 1584 ddcac47bfed1
parent 1241 f7c3471c4a3f
permissions -rw-r--r--
Added Missing license terms
abadea@61
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
abadea@61
     2
<!--
mkristofic@1584
     3
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
mkristofic@1584
     4
mkristofic@1584
     5
Copyright 2009-2017 Oracle and/or its affiliates. All rights reserved.
mkristofic@1584
     6
mkristofic@1584
     7
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
mkristofic@1584
     8
Other names may be trademarks of their respective owners.
mkristofic@1584
     9
mkristofic@1584
    10
The contents of this file are subject to the terms of either the GNU
mkristofic@1584
    11
General Public License Version 2 only ("GPL") or the Common
mkristofic@1584
    12
Development and Distribution License("CDDL") (collectively, the
mkristofic@1584
    13
"License"). You may not use this file except in compliance with the
mkristofic@1584
    14
License. You can obtain a copy of the License at
mkristofic@1584
    15
http://www.netbeans.org/cddl-gplv2.html
mkristofic@1584
    16
or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
mkristofic@1584
    17
specific language governing permissions and limitations under the
mkristofic@1584
    18
License.  When distributing the software, include this License Header
mkristofic@1584
    19
Notice in each file and include the License file at
mkristofic@1584
    20
nbbuild/licenses/CDDL-GPL-2-CP.  Oracle designates this
mkristofic@1584
    21
particular file as subject to the "Classpath" exception as provided
mkristofic@1584
    22
by Oracle in the GPL Version 2 section of the License file that
mkristofic@1584
    23
accompanied this code. If applicable, add the following below the
mkristofic@1584
    24
License Header, with the fields enclosed by brackets [] replaced by
mkristofic@1584
    25
your own identifying information:
mkristofic@1584
    26
"Portions Copyrighted [year] [name of copyright owner]"
mkristofic@1584
    27
mkristofic@1584
    28
Contributor(s):
mkristofic@1584
    29
mkristofic@1584
    30
The Original Software is NetBeans. The Initial Developer of the Original
mkristofic@1584
    31
Software is Sun Microsystems, Inc. Portions Copyright 2009-2010 Sun
mkristofic@1584
    32
Microsystems, Inc. All Rights Reserved.
mkristofic@1584
    33
mkristofic@1584
    34
If you wish your version of this file to be governed by only the CDDL
mkristofic@1584
    35
or only the GPL Version 2, indicate your decision by adding
mkristofic@1584
    36
"[Contributor] elects to include this software in this distribution
mkristofic@1584
    37
under the [CDDL or GPL Version 2] license." If you do not indicate a
mkristofic@1584
    38
single choice of license, a recipient has the option to distribute
mkristofic@1584
    39
your version of this file under either the CDDL, the GPL Version 2 or
mkristofic@1584
    40
to extend the choice of license to its licensees as provided above.
mkristofic@1584
    41
However, if you add GPL Version 2 code and therefore, elected the GPL
mkristofic@1584
    42
Version 2 license, then the option applies only if the new code is
mkristofic@1584
    43
made subject to such option by the copyright holder.
abadea@61
    44
-->
samaresh@118
    45
abadea@61
    46
<html>
samaresh@118
    47
abadea@61
    48
<head>
psmejkal@1108
    49
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
samaresh@118
    50
<title>Creating a WSDL File From Scratch</title>
abadea@61
    51
<link rel="stylesheet" href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css" type="text/css">
abadea@61
    52
</head>
samaresh@118
    53
abadea@61
    54
<body>
samaresh@118
    55
samaresh@118
    56
<h2>Creating a WSDL File From Scratch</h2>
abadea@61
    57
<p><small><a href="#seealso">See Also</a></small></p>
samaresh@118
    58
samaresh@118
    59
<p>When you create a WSDL file from scratch, the wizard contains three pages that you can fill out.</p>
samaresh@118
    60
abadea@61
    61
<ul>
jstein@319
    62
<li><b>Name and Location.</b> Prompts you to enter basic information about the WSDL file.</li>
jstein@319
    63
<li><b>Abstract Configuration.</b> Prompts you to define the port type, operation, and messages.</li>
jstein@319
    64
<li><b>Concrete Configuration.</b> Prompts you to define the binding, service, and port.</li>
abadea@61
    65
</ul>
samaresh@118
    66
samaresh@118
    67
<p>You do <i>not</i> need to complete all three pages. 
samaresh@118
    68
You can fill out the Name and Location page and then click Finish. 
samaresh@118
    69
Or you can fill out the Name and Location page and the Abstract Configuration page and then click Finish.</p>
samaresh@118
    70
samaresh@118
    71
<!--
samaresh@118
    72
<p>If you want to use the Partner view, it makes sense to fill out the Name and Location page only.</p>
samaresh@118
    73
-->
samaresh@118
    74
samaresh@118
    75
samaresh@118
    76
abadea@61
    77
<p><b>To create a WSDL file from scratch:</b></p>
samaresh@118
    78
abadea@61
    79
<ol>
samaresh@118
    80
skini@649
    81
  <li>In the Projects window, right-click the project and choose New &gt; WSDL Document.<br>
jstein@319
    82
      The Name and Location wizard page appears.</li>
samaresh@118
    83
jstein@319
    84
  <li>Configure the <a href="CSH/new_wsdl_wizard_name_location.html">name and location</a>:</li>
samaresh@118
    85
abadea@61
    86
  <ol type="a">
jstein@319
    87
    <li>Enter a name for the WSDL file. 
jstein@319
    88
        The name must comply with the rules for the <a href="wsdl_editor_ncname.html"><tt>NCName</tt></a> data type. 
jstein@319
    89
        You cannot enter a name that already exists in the project. 
jstein@319
    90
        Be sure to enter a descriptive name, such as <tt>AirlineReservationService</tt> or <tt>HotelReservationService</tt>.</li>
abadea@61
    91
    <li>(Optional) Change the default folder by clicking Browse and selecting the new folder.</li>
jstein@319
    92
    <li>Enter the target namespace of the WSDL file. The target namespace will appear in the root element.</li>
abadea@61
    93
    <li>Specify any XML Schema files that you want to import.</li>
abadea@61
    94
  </ol>
samaresh@118
    95
jstein@319
    96
  <li>If you want to configure the abstract and concrete information from the wizard, then click Next. 
jstein@319
    97
      Otherwise, click Finish and skip the remaining steps.</li>
jstein@319
    98
jstein@319
    99
  <li>Configure the <a href="CSH/new_wsdl_wizard_define_abstract.html">abstract information</a>:</li>
samaresh@118
   100
abadea@61
   101
  <ol type="a">
samaresh@151
   102
    <li>Enter a name for the port type.</li>
samaresh@151
   103
    <li>Enter a name for the operation.</li>
jstein@319
   104
    <li>Select the category of operation: request-response or one way.</li>
jstein@258
   105
    <li>Define the message that the operation receives as input.</li>
jstein@258
   106
    <li>If the operation is a request-response operation, then define the message that the operation sends as output.</li>
jstein@258
   107
    <li>(Optional) If the operation is a request-response operation, then you can optionally define a message that the operation sends as a fault.</li>
abadea@61
   108
  </ol>
samaresh@118
   109
jstein@319
   110
  <li>If you want to configure the concrete information from the wizard, then click Next. 
jstein@319
   111
      Otherwise, click Finish and skip the remaining step.</li>
jstein@319
   112
jstein@319
   113
  <li>Configure the <a href="CSH/new_wsdl_wizard_define_concrete.html">concrete information</a>:</li>
samaresh@118
   114
abadea@61
   115
  <ol type="a">
samaresh@151
   116
    <li>Enter a name for the binding.</li>
jstein@258
   117
    <li>Select the type of binding.</li>
jstein@258
   118
    <li>Select the binding subtype. The choices vary depending on the binding type.</li>
samaresh@151
   119
    <li>Enter a name for the service.</li>
samaresh@151
   120
    <li>Enter a name for the port.</li>
abadea@61
   121
    <li>Click Finish.</li>
abadea@61
   122
  </ol>
samaresh@118
   123
abadea@61
   124
  The WSDL file is created. The WSDL Editor appears in WSDL view.
samaresh@118
   125
abadea@61
   126
</ol>
samaresh@118
   127
abadea@61
   128
<ul class="note">
jstein@258
   129
  <li>If you created a SOAP binding, then the port's <tt>soap:address</tt> node includes a Location property.
samaresh@118
   130
    The Location property specifies the address of the port. 
samaresh@118
   131
    The wizard generates a dummy value for the Location property. 
samaresh@118
   132
    The Location property must be unique; that is, the value must not conflict with any other WSDL files 
samaresh@118
   133
    that are deployed to the same application server.</li>
abadea@61
   134
</ul>
samaresh@118
   135
abadea@61
   136
<dl>
abadea@61
   137
<dt><a name="seealso">See Also</a></dt>
samaresh@118
   138
<dd><a href="wsdl_editor.html" title="About the WSDL Editor">About the WSDL Editor</a></dd>
samaresh@151
   139
<dd><a href="wsdl_editor_creating_existing.html" title="Creating a WSDL File Based On an Existing WSDL File">Creating a WSDL File Based On an Existing WSDL File</a></dd>
abadea@61
   140
</dl>
abadea@61
   141
<hr>
abadea@61
   142
<small>  
abadea@61
   143
<a href="credits.html">Legal Notices</a></small>
abadea@61
   144
<table border="0" cellpadding="150">
abadea@61
   145
<tr><td>&nbsp;</td></tr>
abadea@61
   146
<tr><td>&nbsp;</td></tr>
abadea@61
   147
<tr><td>&nbsp;</td></tr>
abadea@61
   148
</table>
abadea@61
   149
</body>
abadea@61
   150
</html>