Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated JAX-WS user guide. #380

Merged
merged 7 commits into from
Aug 10, 2020
Merged

Updated JAX-WS user guide. #380

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
47d38ce
Updated JAX-WS user guide.
Tomas-Kraus Jul 23, 2020
ed03b8d
Updated JAX-WS user guide: changes requested in PR
Tomas-Kraus Jul 31, 2020
df2f1f6
Updated JAX-WS user guide: changes requested in PR
Tomas-Kraus Jul 31, 2020
a4836fb
Updated JAX-WS user guide: changes requested in PR
Tomas-Kraus Jul 31, 2020
0607cdc
Updated JAX-WS user guide: changes requested in PR
Tomas-Kraus Jul 31, 2020
4908656
Fixed wrong e-mail.
Tomas-Kraus Jul 31, 2020
accb75d
Updated JAX-WS user guide: changes requested in PR
Tomas-Kraus Aug 10, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
89 changes: 44 additions & 45 deletions ...all/jaxws/docs/JAXWS2.3-ReleaseNotes.html → ...all/jaxws/docs/JAXWS3.0-ReleaseNotes.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@

-->

<title>Jakarta XML Web Services TCK, Version 2.3 Release Notes, September 2019</title>
<title>Jakarta XML Web Services TCK, Version 3.0 Release Notes, September 2019</title>
<style type="text/css">
<!--
body { background-color: #ffffdd; color: #000000}
Expand All @@ -39,52 +39,51 @@

<body>
<div align="Center">
<h1>Jakarta XML Web Services Technology Compatibility Kit, Version 2.3<br>
<h1>Jakarta XML Web Services Technology Compatibility Kit, Version 3.0<br>
<em class="emphasize">Release Notes, September 2019</em></h1>
</div>

<hr>
<h2><a name="kit_contents">Kit Contents</a></h2>

<p>The Jakarta XML Web Services, Version 2.3 Technology Compatibility Kit (TCK) includes the following items:</p>
<p>The Jakarta XML Web Services, Version 3.0 Technology Compatibility Kit (TCK) includes the following items:</p>
<li><p><strong>Jakarta XML Web Services TCK Signature, API, End-to-end, WS-I Conformance, Java-to-WSDL/WSDL-to-Java Mapping and Web Services Addressing Conformance tests:</strong></p>
<ul>
<li>A <strong>Signature test</strong> that checks that all of the public APIs are supported/defined as specified in the Jakarta XML Web Services Version 2.3 implementation that is being tested.</li>
<li>A <strong>Signature test</strong> that checks that all of the public APIs are supported/defined as specified in the Jakarta XML Web Services Version 3.0 implementation that is being tested.</li>
<li><strong>API tests</strong> to verify the functionality of all the public APIs under <code>jakarta.xml.ws</code>, <code>jakarta.xml.ws.handler</code>, <code>jakarta.xml.ws.handler.soap</code>, <code>jakarta.xml.ws.http</code>, <code>jakarta.xml.ws.spi</code>, <code>jakarta.xml.ws.spi.http</code>, <code>jakarta.xml.ws.soap</code>, and <code>jakarta.xml.ws.wsaddressing</code>.</li>
<li><strong>End-to-end tests</strong> that demonstrate marshalling/unmarshalling of all XML supported data types when going from WSDL-to-Java and all Jakarta XML Web Services supported Java data types when going from Java-to-WSDL as Jakarta XML Web Services SOAP Messages both through synchronous (request/response) and asynchronous (request/response) and (one-way) RPC invocations. All client programming model invocation methods (Stub-based, Dynamic Proxy, and Dispatch interface) are tested.</li>
<li> <strong>WS-I Conformance Tests</strong> that test and check for conformance to the WS-I Basic Profile 1.1, Attachment Profile 1.0, and Simple Soap Binding Profile 1.0 conformance specifications.</li>
<li><strong>Java-to-WSDL/WSDL-to-Java Mapping Tests</strong> that test and check for conformance to the Java-to-WSDL and WSDL-to-Java mappings.</li>
<li><strong>Web Services Addressing Conformance Tests</strong> that test and check for conformance to the Web Services Addressing 1.0 - Core, Web Services Addressing 1.0 - Metadata, and Web Services Addressing 1.0 - SOAP Binding conformance specifications.
<hr>

<h2><a name="platform">Platform Notes</a></h2>

<p>The Jakarta XML Web Services TCK tests have been built and tested with the the Compatible Implementation (CI) Eclipse GlassFish Server 5.1 running on the Java(tm) Standard Edition 8 (Java SE 8) platforms. If you are using a different Web server, you will need to make adjustments to the procedures outlined in this document.</p>

<p>The Jakarta XML Web Services TCK tests run on the following platforms:</p>

<ul>
Tomas-Kraus marked this conversation as resolved.
Show resolved Hide resolved
<li>Oracle Linux 7.1</li>
<li>Windows 10</li>
<li>CentOS 7</li>
</ul>

<p>In the instructions in this document, variables in angle brackets need to be expanded for each platform. For example, <code>&lt;TS_HOME&gt;</code> becomes <code>$TS_HOME</code> on Solaris/Linux and <code>%TS_HOME%</code> on Windows 10. In addition, the forward slashes (<code>/</code>) used in all of the examples need to be replaced with backslashes (<code>\</code>) for Windows XP.</p>
<hr>
<h2><a name="updates">Updates for the Jakarta XML Web Services TCK 2.3 Release</a></h2>
<h2><a name="updates">Updates for the Jakarta XML Web Services TCK 3.0 Release</a></h2>
<p>
Added support for Java SE 8 based signatures.<br>
Added tests for @Repeatable(value=WebServiceRefs.class) @WebServiceRef.
</p>
<hr>
<h2><a name="Notes">Notes for Jakarta XML Web Services TCK 2.3 Release</a></h2>

<h2><a name="Notes">Notes for Jakarta XML Web Services TCK 3.0 Release</a></h2>

<p>
There are a few Jakarta XML Web Services tests that reference schemas over the internet and this
caused build issues when attempting the rebuildable portion of Jakarta XML Web Services when test
machines had no access to the internet.
</p>

<p>
The following test references schema [ <code>http://www.w3.org/2006/03/addressing/ws-addr.xsd</code> ]
</p>
Expand All @@ -94,34 +93,34 @@ <h2><a name="Notes">Notes for Jakarta XML Web Services TCK 2.3 Release</a></h2>
<p>
The following test references schema [ <code>http://ws-i.org/profiles/basic/1.1/swaref.xsd</code> ]
</p>

<ul>
<li><code>src/com/sun/ts/tests/jaxws/wsi/w2j/document/literal/swareftest</code></li>
</ul>

<p>
If you attempt to build the jaxws tree for the VI as part of the rebuildable
technology rules and you do not have access to the internet than the build will
fail for these test cases. You need to use a Jakarta XML Web Services catalog to resolve the URI's
locally. A Jakarta XML Web Services catalog file exists under the following directory:
</p>

<ul>
<li><code>TS_HOME/src/com/sun/ts/tests/jaxws/common/xml/catalog/META-INF/jax-ws-catalog.xml</code></li>
</ul>
<p>
The wsimport ant task within <code>TS_HOME/src/com/sun/ts/tests/jaxws/common/xml/common.xml</code>
refers to this catalog file appropriately for both the CI and VI wsimport ant task tool wrappers.
</p>

<p>
We do not distribute these standards defined schema files as part of our test suite.
So the licensee will have to ensure to download and get a copy of the above schemas
however they decide to and place them in the TS_HOME/lib/schemas directory of the test
suite in order to build these tests with no internet access. The catalog file mentioned
above will resolve these URI's locally to these schema files under the TS_HOME/lib/schemas.
</p>

<hr>
<h2><a name="props"><code>jakarta.xml.ws.Endpoint</code> publishing API's</a></h2>
<p>
Expand All @@ -142,7 +141,7 @@ <h2><a name="props"><code>jakarta.xml.ws.Endpoint</code> publishing API's</a></h
exception. When this result occurs with this scenario, the result is considered
a PASS.
</p>

<p>
If your server does not support endpoint publishing (does not support the use of
<code>jakarta.xml.ws.Endpoint.publish()</code> methods), set the property value to
Expand All @@ -152,48 +151,48 @@ <h2><a name="props"><code>jakarta.xml.ws.Endpoint</code> publishing API's</a></h
publish the endpoints and an exception will be thrown. When this result occurs
with this scenario, the result is considered a PASS.
</p>

<p>
The <code>http.server.supports.endpoint.publish.2</code> property settings are used to specify
whether or not endpoint publishing is supported by the Jakarta EE 8 CI HTTP server.
The same settings and caveats as the <code>http.server.supports.endpoint.publish
</code> property apply to this property, based on whether or not the Jakarta EE 8 CI
supports endpoint publishing.
</p>

<hr>
<h2><a name="install_setup_run">Installing, Setting Up, and Running the Jakarta XML Web Services TCK</a></h2>
<p>Refer to the <cite>Jakarta XML Web Services TCK 2.3 User's Guide</cite>, available in the Jakarta XML Web Services TCK 2.3 documentation bundle, for complete instructions on installing, setting up, and running the Jakarta XML Web Services TCK.

<p>Refer to the <cite>Jakarta XML Web Services TCK 3.0 User's Guide</cite>, available in the Jakarta XML Web Services TCK 3.0 documentation bundle, for complete instructions on installing, setting up, and running the Jakarta XML Web Services TCK.
The online version of the JT Harness version 5.0 documentation is available <a href="https://wiki.openjdk.java.net/display/CodeTools/Documentation">here</a>.</p>

<hr>
<h2><a name="install_config_tomcat8">Quick Steps to Configure Apache Tomcat 8 for Jakarta XML Web Services TCK</a></h2>
<p>Follow the steps below to configure Apache Tomcat 8 for Jakarta XML Web Services TCK 2.3</p>

<p>Follow the steps below to configure Apache Tomcat 10 for Jakarta XML Web Services TCK 3.0</p>

<ul>
<li>Install Apache Tomcat 8.5.x to /apache-tomcat-8.5.x</li>
<li>Install Jakarta XML Web Services RI 2.3 to /jaxws-ri</li>
<li>Install Jakarta XML Web Services TCK 2.3 to /jaxwstck</li>
<li>Copy Jakarta XML Web Services RI 2.3 and Jakarta XML Web Services TCK 2.3 jars to appropriate Apache Tomcat 8.5.x directories
<li>mkdir -p /apache-tomcat-8.5.x/shared/lib /apache-tomcat-8.5.x/endorsed</li>
<li>Install Apache Tomcat 10.0.x to /apache-tomcat-10.0.x</li>
<li>Install Jakarta XML Web Services RI 3.0.0 to /jaxws-ri</li>
<li>Install Jakarta XML Web Services TCK 3.0 to /jaxwstck</li>
<li>Copy Jakarta XML Web Services RI 3.0.0 and Jakarta XML Web Services TCK 3.0 jars to appropriate Apache Tomcat 10.0.x directories
<li>mkdir -p /apache-tomcat-10.0.x/shared/lib /apache-tomcat-10.0.x/endorsed</li>
<ul>
For Java SE 8 do the following steps and use the ts.jte.tomcat.jdk18 file:
<ul>
<li>cp /jaxws-ri/lib/*.jar /apache-tomcat-8.5.x/shared/lib</li>
<li>cd /apache-tomcat-8.5.x/shared/lib; &nbsp; mv jaxws-api.jar jaxb-api.jar /apache-tomcat-8.5.x/endorsed</li>
<li>cp /jaxwstck/lib/jaxwstck.jar /jaxwstck/lib/tsharness.jar /apache-tomcat-8.5.x/shared/lib</li>
<li>cp /jaxws-ri/lib/*.jar /apache-tomcat-10.0.x/shared/lib</li>
<li>cd /apache-tomcat-10.0.x/shared/lib; &nbsp; mv jaxws-api.jar jaxb-api.jar /apache-tomcat-10.0.x/endorsed</li>
<li>cp /jaxwstck/lib/jaxwstck.jar /jaxwstck/lib/tsharness.jar /apache-tomcat-10.0.x/shared/lib</li>
<li>cd /jaxwstck/bin; &nbsp; mv ts.jte ts.jte.javaee8; &nbsp; cp ts.jte.tomcat.jdk18 ts.jte</li>
<li>Make sure endorsed.dirs, endorsed.dirs.ri properties in ts.jte file point to Apache Tomcat 8.5.x endorsed directory</li>
<li>Make sure endorsed.dirs, endorsed.dirs.ri properties in ts.jte file point to Apache Tomcat 10.0.x endorsed directory</li>
</ul>
</ul>
<li>Configure the rest of ts.jte as per Jakarta XML Web Services TCK 2.3 User's Guide (Example: jaxws.classes, webcontainer.home, etc)</li>
<li>Edit /apache-tomcat-8.5.x/conf/catalina.properties and set shared.loader property to:</li>
<li>Configure the rest of ts.jte as per Jakarta XML Web Services TCK 3.0 User's Guide (Example: jaxws.classes, webcontainer.home, etc)</li>
<li>Edit /apache-tomcat-10.0.x/conf/catalina.properties and set shared.loader property to:</li>
<ul>
<li>shared.loader=${catalina.home}/shared/lib/*.jar,${catalina.home}/endorsed/*.jar</li>
</ul>
<li>Configure the tomcat users in the /apache-tomcat-8.5.x/conf/tomcat-users.xml file as follows:</li>
<li>Configure the tomcat users in the /apache-tomcat-10.0.x/conf/tomcat-users.xml file as follows:</li>
<pre>
&lt;tomcat-users&gt;
&lt;role rolename="tomcat"/&gt;
Expand All @@ -208,12 +207,12 @@ <h2><a name="install_config_tomcat8">Quick Steps to Configure Apache Tomcat 8 fo
&lt;user username="role1" password="tomcat" roles="role1"/&gt;
&lt;/tomcat-users&gt;
</pre>
<li>Restart Apache Tomcat 8.5.x which is now ready for Jakarta XML Web Services TCK 2.3 testing</li>
<li>Restart Apache Tomcat 10.0.x which is now ready for Jakarta XML Web Services TCK 3.0 testing</li>
</ul>

<hr>
<p><cite><small>Copyright (c) 2011, 2020 Oracle and/or its affiliates. All rights reserved.</small></cite></p>
</li>
</ul>
</ul>
</body>
</html>
6 changes: 3 additions & 3 deletions .../assertions/JAXWS23JavadocAssertions.html → .../assertions/JAXWS30JavadocAssertions.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@
<body bgcolor="white">
<br>
<CENTER>
<h2><br>
Jakarta XML Web Services - 2.3<br>
JavaDoc Assertion Detail
<h2><br>
Jakarta XML Web Services - 3.0<br>
JavaDoc Assertion Detail
</h2>
</CENTER>
<TABLE width="900" border="1" frame="box" cellpadding="5">
Expand Down
Loading