eclipse-ee4j / eclipse-ee4j/metro-wsit
TX docs need to be updated in WSITTutorial/readme.html
- Dominant language
- Java
- Stars
- 6
- Forks
- 21
- Avg merge
- 10h 2m
- Merged PRs (30d)
- 1
Description
TX testing tutorial for metro 1.1.1 release
wsittutorial/examples/wstx/basicWSTX/readme.html contains these steps shown
below, which should also be removed if they are not necessary, and they don't work:
3\. Use the NetBeans IDE to create a database connection.
a.
In the NetBeans Services tab, right-click Databases and select New
Connection. The New Database Connection dialog is displayed.
b.
Type jdbc:derby://localhost:1527/wstxSampleDB;create=true into the
Database URL field in the New Database Connection window.
c.
Type app in the User Name field.
d.
Type app in the Password field.
e.
Select the Remember password checkbox.
f.
Click OK.
i didn't have to do this step below, as this library was already accessible
without doing anything:
6
Add the Toplink Essentials Library to the SampleService-ejb project.
1.
In the Projects tab, right-click SampleService-ejb, select Properties,
then select the Libraries category. The Add Libraries dialog is displayed.
2.
Select the Toplink Essentials library from the Libraries list, then click
Add Library.
3.
Click OK.
i couldn't perform step 9\. d. below, since the checkbox was greyed out:
9\. Open the SampleServiceClient project and register it with the appropriate
instance (domain2) of the GlassFish server.
1.
Select File, then Open Project.
2.
Browse to the /wsittutorial/examples/wstx/basicWSTX/
directory and select the SampleServiceClient project.
3.
Select the Open as Main Project checkbox.
4.
Select the Open Required Projects checkbox.
i decided to forge ahead despite this step above "Use the NetBeans IDE to create
a database connection" failing, and the sample seemed to work, as
i see this in browser for url [http://localhost:2825/SampleClient/client](http://localhost:2825/SampleClient/client) :
WS-TX Simple Client
Calling WS-TX Simple Web Service implemented as Servlet
Committed Transaction:
Checked out 7 books and sent 3 publishedRequired message(s)
verified 3 message(s) sent, 7 books checked out.
Rollback Transaction: Sent 2 messages and returned checked out books.
Finished publishSupports invocation
Pass. verified rolled back messages not sent.
Passed. Verified that 7 books returned in rolled back transaction are still
checked out.
Calling WS-TX Simple Web Service implemented as CMT EJB
Finished publishedRequired. Sent 3 message(s)
verified 3 message(s) sent, 7 books checked out.
Rollback Transaction: Sent 2 messages and returned checked out books.
Finished publishSupports invocation
Pass. verified rolled back messages not sent.
Passed. Verified that 7 books returned in rolled back transaction are still
checked out.
this output doesn't match the image out what expected output should be displayed
on page 212 of [https://wsit-docs.dev.java.net/releases/1.1/WSITTutorial.pdf](https://wsit-docs.dev.java.net/releases/1.1/WSITTutorial.pdf)
seems that image needs to be updated to reflect the new sample expected output
for a "good" run, and we probably should do away with the step about step 4 on
page 206, since i wasn't able to successfully compleete this step, yet the
sample worked without completing this step.
as i previously mentioned, the image that is displayed in the .pdf showing
successful run results, should match the image that is displayed in the
readme.html (Figure 3\. basicWSTX Results)
#### Environment
Operating System: All
Platform: All
#### Affected Versions
[1.1.1]
Source: [https://github.com/javaee/metro-wsit/issues/804](https://github.com/javaee/metro-wsit/issues/804)
Author: glassfishrobot
Contributor guide
Research direction
Start with wsittutorial/examples/wstx/basicWSTX/readme.html and compare its setup steps and Figure 3 results with the WSITTutorial/readme.html content and the WSIT 1.1 tutorial PDF pages referenced in the issue. Verify the documented workflow and sample output, then update or remove the steps and synchronize the result images so the tutorial reflects a successful run.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100