Skip to content

Commit 9cffb0d

Browse files
AXIS2-6102 Remove WSDL 2.0 references from user-facing docs
Follow-up to WSDL 2.0 code removal. Scrubs WSDL 2.0 mentions from published site docs, samples README, and codegen tool reference so documentation matches the 2.0.1 release. - src/site/xdoc/index.xml: drop MEP Support bullet (described MEPs in WSDL 2.0 terms); WSDL support bullet now lists 1.1 only - src/site/xdoc/refLib.xml: remove WSDL 2.0 spec link - src/site/xdoc/docs/migration.xml: rewrite "WSDL 2.0 support" section as "WSDL support" (1.1) - src/site/xdoc/docs/rest-ws.xml: rewrite intro (was framed as "WSDL 2.0 HTTP Binding defines REST"); drop IRI-style link - src/site/xdoc/docs/userguide-samples.xml: remove external FlickrClient entry (WSDL 2.0 code-gen demo from WSO2 nightly) - src/site/xdoc/tools/CodegenToolReference.xml: remove wsdlVersion option row (no longer applicable without WSDL 2.0) - modules/samples/dynamicclient/README.txt: remove WSDL20DynamicClient mvn command - .gitignore: ignore wtf.txt (untracked maven build log artifact)
1 parent c016d8f commit 9cffb0d

8 files changed

Lines changed: 10 additions & 41 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,3 +8,4 @@ target
88
/modules/tool/axis2-eclipse-service-plugin/META-INF
99
/modules/tool/axis2-eclipse-service-plugin/lib
1010
axis2-json-api*.log
11+
wtf.txt

modules/samples/dynamicclient/README.txt

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,4 +15,3 @@ Running the Clients
1515
* Run each clients using a IDE or use following Maven commands.
1616

1717
mvn exec:java -Dexec.mainClass="org.apache.axis2.examples.client.WSDL11DynamicClient" -Dexec.classpathScope=compile
18-
mvn exec:java -Dexec.mainClass="org.apache.axis2.examples.client.WSDL20DynamicClient" -Dexec.classpathScope=compile

src/site/xdoc/docs/migration.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,9 +60,9 @@ and listeners for SOAP over various protocols such as HTTP, SMTP,
6060
etc.), have been abstracted away from the Axis2 engine. Having a
6161
transport-independent Axis engine allows far more flexibility in
6262
transport options.</p>
63-
<p><strong>WSDL 2.0 support</strong> - Axis2 supports both WSDL
64-
versions 1.1 and 2.0, which are used by Axis2's code generation
65-
tools to create web service skeletons and client stubs.</p>
63+
<p><strong>WSDL support</strong> - Axis2 supports WSDL 1.1, which is
64+
used by Axis2's code generation tools to create web service
65+
skeletons and client stubs.</p>
6666
<p><strong>Component-oriented architecture</strong> - Axis2
6767
components consist of handlers and modules in .mar and .aar
6868
archives. These easily reusable components allow extended

src/site/xdoc/docs/rest-ws.xml

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -43,21 +43,17 @@ GET.</p>
4343

4444
<h2>Introduction</h2>
4545

46-
<p>WSDL 2.0 HTTP Binding defines a way to implement REST (Representational
47-
State Transfer) with Web services. Axis2 implements the most defined HTTP
48-
binding specification. REST Web services are a reduced subset of the usual
49-
Web service stack.</p>
46+
<p>REST (Representational State Transfer) Web services are a reduced
47+
subset of the usual Web service stack. Axis2 supports exposing services
48+
over HTTP GET and POST without requiring a SOAP envelope.</p>
5049

5150
<p>The Axis2 REST implementation assumes the following properties:</p>
5251
<ol>
5352
<li>REST Web services are Synchronous and Request Response in nature.</li>
5453
<li>When REST Web services are accessed via GET, the service and the
5554
operations are identified based on the URL. The parameters are assumed as
5655
parameters of the Web service. In this case, the GET based REST Web
57-
services support only simple types as arguments and it should adhere to
58-
the <a
59-
href="http://www.w3.org/TR/2006/CR-wsdl20-adjuncts-20060327/#_operation_iri_style">IRI
60-
style</a>.</li>
56+
services support only simple types as arguments.</li>
6157
<li>POST based Web services do not need a SOAP Envelope or a SOAP Body.
6258
REST Web Services do not have Headers and the payload is sent
6359
directly.</li>

src/site/xdoc/docs/userguide-samples.xml

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -194,18 +194,6 @@ generated code with Castor.</p>
194194
outputs the Apache Axis2 version.</p>
195195
<p><strong>yahoorestearch</strong>: A complete example of the use
196196
of a REST service rather than a SOAP service.</p>
197-
<h3>External:</h3>
198-
<p><strong>FlickrClient</strong> : Demonstrates code generation
199-
capabilities for WSDL 2.0. The FlickrService.wsdl describes
200-
services offered by flickr in terms of WSDL 2.0. It also
201-
demonstrates how a restful service can be described using the
202-
HTTPBinding of wsdl 2.0.</p>
203-
<p>Extract the <a href=
204-
"http://dist.wso2.org/products/wsas/java/nightly-build/">WSO2 WSAS
205-
for Java nightly build distribution</a> and you will find the
206-
sample at WSAS_HOME/samples/FlickrClient or checkout sample from
207-
SVN:
208-
http://wso2.org/repos/wso2/trunk/wsas/java/modules/samples/FlickrClient</p>
209197
<p><strong>See Next Section</strong> - <a href=
210198
"userguide-forfurtherstudy.html">For Further Study</a></p>
211199
</body>

src/site/xdoc/index.xml

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -111,12 +111,6 @@ and asynchronous Web services invocation using non-blocking clients
111111
and transports.</p>
112112
</li>
113113
<li>
114-
<p style="margin-bottom: 0in"><strong>MEP Support</strong> - Axis2
115-
now comes handy with the flexibility to support Message Exchange
116-
Patterns (MEPs) with in-built support for basic MEPs defined in
117-
WSDL 2.0.</p>
118-
</li>
119-
<li>
120114
<p style="margin-bottom: 0in"><strong>Flexibility</strong> - The
121115
Axis2 architecture gives the developer complete freedom to insert
122116
extensions into the engine for custom header processing, system
@@ -143,8 +137,7 @@ the core of the engine is completely transport-independent.</p>
143137
<li>
144138
<p style="margin-bottom: 0in"><strong>WSDL support</strong> - Axis2
145139
supports the Web Service Description Language, version <a href=
146-
"http://www.w3.org/TR/wsdl">1.1</a> and <a href=
147-
"http://www.w3.org/TR/wsdl20/">2.0</a>, which allows you to easily
140+
"http://www.w3.org/TR/wsdl">1.1</a>, which allows you to easily
148141
build stubs to access remote services, and also to automatically
149142
export machine-readable descriptions of your deployed services from
150143
Axis2.</p>

src/site/xdoc/refLib.xml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,7 @@ Extensions: Digital Signature Specification</a></b><br />
4949
Adding security to SOAP.</p>
5050
<p><b>Other Specifications</b></p>
5151
<p>Web Services Description Language (WSDL) <a href=
52-
"http://www.w3c.org/TR/wsdl.html">1.1</a> <a href=
53-
"http://www.w3.org/TR/wsdl20/">2.0</a></p>
52+
"http://www.w3c.org/TR/wsdl.html">1.1</a></p>
5453
<p>WS - Addressing <a href=
5554
"http://www.w3.org/Submission/ws-addressing/">submission</a>
5655
<a href="http://www.w3.org/TR/2005/WD-ws-addr-core-20050331/">1.0

src/site/xdoc/tools/CodegenToolReference.xml

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -405,13 +405,6 @@ side skeleton.</td>
405405
the command line tool.</td>
406406
</tr>
407407
<tr>
408-
<td>wsdlVersion</td>
409-
<td>Sets the version of the wsdl that is being used during
410-
codegeneration. This deafults to 1.1 and one can set this to 2,
411-
when trying to work with a WSDL 2.0 document. Maps to the -wv
412-
option of the command line tool.</td>
413-
</tr>
414-
<tr>
415408
<td>externalMapping</td>
416409
<td>Location of the external mapping file to be used. Maps to the
417410
-em option of the command line tool.</td>

0 commit comments

Comments
 (0)