docs/org.eclipse.wst.wsdl.ui.doc.user/tasks/tcrtwsdl.html - webservices/webtools.webservices - Git at Google

 <?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html lang="en-us" xml:lang="en-us">
 <head>
 <meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
 <meta name="copyright" content="Copyright (c) 2000, 2007 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
 <meta name="DC.rights.owner" content="(C) Copyright 2000, 2007" />
 <meta content="public" name="security" />
 <meta content="index,follow" name="Robots" />
 <meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
 <meta content="task" name="DC.Type" />
 <meta name="DC.Title" content="Creating a new WSDL file" />
 <meta name="abstract" content="You can create a new, empty WSDL file, then edit it using the WSDL editor." />
 <meta name="description" content="You can create a new, empty WSDL file, then edit it using the WSDL editor." />
 <meta content="WSDL, creating, Web services, creating WSDL" name="DC.subject" />
 <meta content="WSDL, creating, Web services, creating WSDL" name="keywords" />
 <meta scheme="URI" name="DC.Relation" content="../../org.eclipse.jst.ws.doc.user/concepts/cwsdl.html" />
 <meta scheme="URI" name="DC.Relation" content="../concepts/cwsdled.html" />
 <meta scheme="URI" name="DC.Relation" content="timpwsdl.html" />
 <meta scheme="URI" name="DC.Relation" content="tedtwsdl.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="tcrtwsdl" name="DC.Identifier" />
 <meta content="en-us" name="DC.Language" />
 <link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
 <title>Creating a new WSDL file</title>
 </head>
 <body id="tcrtwsdl"><a name="tcrtwsdl"><!-- --></a>


 <h1 class="topictitle1">Creating a new WSDL file</h1>


 <div><p>You can create a new, empty WSDL file, then edit it using the WSDL
 editor.</p>

 <div class="section"><p>To create a WSDL file, follow these steps:</p>
 </div>

 <ol>
 <li class="stepexpand"><span>Create a project to contain the WSDL document.</span> It does
 not matter what kind of project you create.</li>

 <li class="stepexpand"><span>In the workbench, click  <strong>File &gt; New &gt; Other &gt; Web Services &gt;
 WSDL</strong>.</span> Click <strong>Next</strong>.</li>

 <li class="stepexpand"><span>Select the project or folder that will contain the WSDL file.</span>
  In the  <strong>File name</strong> field, type the name of the WSDL file, for
 example  <tt class="sysout">MyWSDLFile.wsdl</tt>. The name of your XML
 file must end in  <tt class="sysout">.wsdl</tt></li>

 <li class="stepexpand"><span>Click  <strong>Next.</strong></span></li>

 <li class="stepexpand"><span>Enter the  following information: </span>
 <ol type="a">
 <li class="substepexpand"><span><strong>Target namespace</strong> is the namespace for the WSDL file or
 accept the default (<samp class="codeph">http://www.example.org/<em>MyWSDLFile</em>/</samp>).</span>
  The target namespace is used for the names of messages and the port
 type, binding and service defined in the WSDL file. The value must take the
 form of a valid URI (for example, <samp class="codeph">http://www.mycompany.com/myservice/</samp>)
 </li>

 <li class="substepexpand"><span>The  <strong>Prefix</strong> is the prefix associated with the target
 namespace.</span></li>

 <li class="substepexpand"><span>Select <span class="uicontrol">Create WSDL Skeleton</span> if you want
 the wizard to create the skeleton of the WSDL file.</span>  This will
 generate the WSDL elements required for your service, including bindings,
 ports and messages. You can then modify these to meet the requirements of
 your Web service.</li>

 <li class="substepexpand"><span>If you have chosen to create a WSDL skeleton, select the binding
 options you want to use in the WSDL document. The options are SOAP and HTTP.
 Use the SOAP protocol when you want to exchange structured and typed information.
 Use the HTTP protocol when you want your application client to just request
 or update information.</span>  If you select SOAP you can
 then select the encoding style you want to use.<ul>
 <li><strong>Document literal</strong>. Document style messages, literal encoding. Use
 this style of binding when you want to send SOAP messages that can be validated
 by an XML validator.  All the data types in the SOAP message body are defined
 in a schema, so the WSDL parts must point to schema elements. </li>

 <li><strong>RPC literal</strong>. RPC style messages, literal encoding. Use this style
 of binding when you want to specify the operation method names in your SOAP
 messages so a server can dispatch the specified methods.  Data types must
 be defined, so the WSDL parts must point to XSD types.</li>

 <li><strong>RPC encoded</strong>. RPC style messages and SOAP encoding. Use this style
 of binding when you want to encode data graphs in your SOAP messages so a
 server can deserialize the object data.  Data types must be defined, so the
 WSDL parts must point to XSD types.</li>

 </ul>
  If you select HTTP you can select whether to create an HTTP getter or
 setter.<ul>
 <li><strong>HTTP GET</strong>. A GET request fetches data from a Web server based on
 an URL value and a set of HTTP headers. Use this method when you want to retrieve
 information specified in the request. </li>

 <li><strong>HTTP POST</strong>. A POST request sends additional data to the server,
 specified after the URL and the headers. Use this method when you want to
 send data enclosed in the body of the request.</li>

 </ul>
 </li>

 </ol>

 </li>

 <li class="stepexpand"><span>Click  <strong>Finish</strong>.</span> The WSDL file opens in the WSDL
 editor.</li>

 </ol>

 <div class="section"><p>If you created a WSDL file with a skeleton using SOAP bindings,
 it should look similar to the following:</p>
 <p><br /><img src="../images/soapskel.gif" alt="Image of a WSDL skeleton using SOAP bindings" /><br /></p>
 <p>If you created
 a WSDL file with a skeleton using HTTP bindings, it should look similar to
 the following:</p>
 <p><br /><img src="../images/httpskel.gif" alt="Image of a WSDL skeleton using HTTP bindings" /><br /></p>
 </div>

 </div>

 <div>
 <div class="linklist"><strong>Related concepts</strong><br />

 <div><a href="../../org.eclipse.jst.ws.doc.user/concepts/cwsdl.html">WSDL</a></div>
 <div><a href="../concepts/cwsdled.html" title="The WSDL editor allows you to easily and graphically create, modify, view, and validate WSDL files.">Editing WSDL files with the WSDL Editor</a></div></div>

 <div class="linklist"><strong>Related tasks</strong><br />

 <div><a href="timpwsdl.html" title="You can import WSDL files into the workbench and open them in the WSDL editor. Opening them in the WSDL editor provides you with an opportunity to have a structured viewing of the WSDL file.">Importing a WSDL file</a></div>
 <div><a href="tedtwsdl.html" title="Once you have created a WSDL file, you can edit it in the WSDL editor. You can also import WSDL files you have created into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div>
 </div>

 </body>
 </html>
	<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	<html lang="en-us" xml:lang="en-us">
	<head>
	<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
	<meta name="copyright" content="Copyright (c) 2000, 2007 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: IBM Corporation - initial API and implementation" />
	<meta name="DC.rights.owner" content="(C) Copyright 2000, 2007" />
	<meta content="public" name="security" />
	<meta content="index,follow" name="Robots" />
	<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
	<meta content="task" name="DC.Type" />
	<meta name="DC.Title" content="Creating a new WSDL file" />
	<meta name="abstract" content="You can create a new, empty WSDL file, then edit it using the WSDL editor." />
	<meta name="description" content="You can create a new, empty WSDL file, then edit it using the WSDL editor." />
	<meta content="WSDL, creating, Web services, creating WSDL" name="DC.subject" />
	<meta content="WSDL, creating, Web services, creating WSDL" name="keywords" />
	<meta scheme="URI" name="DC.Relation" content="../../org.eclipse.jst.ws.doc.user/concepts/cwsdl.html" />
	<meta scheme="URI" name="DC.Relation" content="../concepts/cwsdled.html" />
	<meta scheme="URI" name="DC.Relation" content="timpwsdl.html" />
	<meta scheme="URI" name="DC.Relation" content="tedtwsdl.html" />
	<meta content="XHTML" name="DC.Format" />
	<meta content="tcrtwsdl" name="DC.Identifier" />
	<meta content="en-us" name="DC.Language" />
	<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
	<title>Creating a new WSDL file</title>
	</head>
	<body id="tcrtwsdl"><a name="tcrtwsdl"><!-- --></a>


	<h1 class="topictitle1">Creating a new WSDL file</h1>



	<div><p>You can create a new, empty WSDL file, then edit it using the WSDL
	editor.</p>

	<div class="section"><p>To create a WSDL file, follow these steps:</p>
	</div>

	<ol>
	<li class="stepexpand"><span>Create a project to contain the WSDL document.</span> It does
	not matter what kind of project you create.</li>

	<li class="stepexpand"><span>In the workbench, click <strong>File > New > Other > Web Services >
	WSDL</strong>.</span> Click <strong>Next</strong>.</li>

	<li class="stepexpand"><span>Select the project or folder that will contain the WSDL file.</span>
	In the <strong>File name</strong> field, type the name of the WSDL file, for
	example <tt class="sysout">MyWSDLFile.wsdl</tt>. The name of your XML
	file must end in <tt class="sysout">.wsdl</tt></li>

	<li class="stepexpand"><span>Click <strong>Next.</strong></span></li>

	<li class="stepexpand"><span>Enter the following information: </span>
	<ol type="a">
	<li class="substepexpand"><span><strong>Target namespace</strong> is the namespace for the WSDL file or
	accept the default (<samp class="codeph">http://www.example.org/<em>MyWSDLFile</em>/</samp>).</span>
	The target namespace is used for the names of messages and the port
	type, binding and service defined in the WSDL file. The value must take the
	form of a valid URI (for example, <samp class="codeph">http://www.mycompany.com/myservice/</samp>)
	</li>

	<li class="substepexpand"><span>The <strong>Prefix</strong> is the prefix associated with the target
	namespace.</span></li>

	<li class="substepexpand"><span>Select <span class="uicontrol">Create WSDL Skeleton</span> if you want
	the wizard to create the skeleton of the WSDL file.</span> This will
	generate the WSDL elements required for your service, including bindings,
	ports and messages. You can then modify these to meet the requirements of
	your Web service.</li>

	<li class="substepexpand"><span>If you have chosen to create a WSDL skeleton, select the binding
	options you want to use in the WSDL document. The options are SOAP and HTTP.
	Use the SOAP protocol when you want to exchange structured and typed information.
	Use the HTTP protocol when you want your application client to just request
	or update information.</span> If you select SOAP you can
	then select the encoding style you want to use.<ul>
	<li><strong>Document literal</strong>. Document style messages, literal encoding. Use
	this style of binding when you want to send SOAP messages that can be validated
	by an XML validator. All the data types in the SOAP message body are defined
	in a schema, so the WSDL parts must point to schema elements. </li>

	<li><strong>RPC literal</strong>. RPC style messages, literal encoding. Use this style
	of binding when you want to specify the operation method names in your SOAP
	messages so a server can dispatch the specified methods. Data types must
	be defined, so the WSDL parts must point to XSD types.</li>

	<li><strong>RPC encoded</strong>. RPC style messages and SOAP encoding. Use this style
	of binding when you want to encode data graphs in your SOAP messages so a
	server can deserialize the object data. Data types must be defined, so the
	WSDL parts must point to XSD types.</li>

	</ul>
	If you select HTTP you can select whether to create an HTTP getter or
	setter.<ul>
	<li><strong>HTTP GET</strong>. A GET request fetches data from a Web server based on
	an URL value and a set of HTTP headers. Use this method when you want to retrieve
	information specified in the request. </li>

	<li><strong>HTTP POST</strong>. A POST request sends additional data to the server,
	specified after the URL and the headers. Use this method when you want to
	send data enclosed in the body of the request.</li>

	</ul>
	</li>

	</ol>

	</li>

	<li class="stepexpand"><span>Click <strong>Finish</strong>.</span> The WSDL file opens in the WSDL
	editor.</li>

	</ol>

	<div class="section"><p>If you created a WSDL file with a skeleton using SOAP bindings,
	it should look similar to the following:</p>
	<p><br /><img src="../images/soapskel.gif" alt="Image of a WSDL skeleton using SOAP bindings" /><br /></p>
	<p>If you created
	a WSDL file with a skeleton using HTTP bindings, it should look similar to
	the following:</p>
	<p><br /><img src="../images/httpskel.gif" alt="Image of a WSDL skeleton using HTTP bindings" /><br /></p>
	</div>

	</div>

	<div>
	<div class="linklist"><strong>Related concepts</strong><br />

	<div><a href="../../org.eclipse.jst.ws.doc.user/concepts/cwsdl.html">WSDL</a></div>
	<div><a href="../concepts/cwsdled.html" title="The WSDL editor allows you to easily and graphically create, modify, view, and validate WSDL files.">Editing WSDL files with the WSDL Editor</a></div></div>

	<div class="linklist"><strong>Related tasks</strong><br />

	<div><a href="timpwsdl.html" title="You can import WSDL files into the workbench and open them in the WSDL editor. Opening them in the WSDL editor provides you with an opportunity to have a structured viewing of the WSDL file.">Importing a WSDL file</a></div>
	<div><a href="tedtwsdl.html" title="Once you have created a WSDL file, you can edit it in the WSDL editor. You can also import WSDL files you have created into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div>
	</div>

	</body>
	</html>