Skip to content

Commit 3943495

Browse files
Added about_tck.adoc and updated REAME.adoc
1 parent 19b1879 commit 3943495

File tree

2 files changed

+65
-0
lines changed

2 files changed

+65
-0
lines changed

README.adoc

+28
Original file line numberDiff line numberDiff line change
@@ -177,6 +177,34 @@ to delete the "#java" part and then it will work.
177177

178178
./runtests --web tomee-plume com/sun/ts/tests/ejb30/lite/stateful/concurrency/accesstimeout/annotated/Client#beanClassLevel_from_ejbembed
179179

180+
## TEST DEBUG
181+
182+
The following are the flags the scrip `runtests` accept for debuggin purposes:
183+
184+
185+
-d,--debug Enable Server and TCK appclient debug options (5005 and 5003)
186+
-de,--debug-embedded Enable TCK embedded ejb debug options (port 5001)
187+
-dh,--debug-harness Enable TCK harness debug options (port 5002)
188+
-da,--debug-appclient Enable TCK appclient debug options (port 5003)
189+
-dj,--debug-javatest Enable TCK javatest debug options (port 5004)
190+
-ds,--debug-server Enable Server debug options (port 5005)
191+
--connector deploy connectors for connector tests
192+
193+
You can attach to the ports via your IDE remote debugger options.
194+
Example:
195+
196+
./runtests --web tomee-plume -c -d com.sun.ts.tests.ejb30.lite.stateful.concurrency.accesstimeout.annotated.Client#beanClassLevel_from_ejbembed
197+
198+
Depending on the IDE, you will need to attempt twice to connect to the exposed port.
199+
200+
## WHAT TO TEST
201+
202+
The test that needs to be tested are the one having the following `keywords`:
203+
204+
javaee_web_profile, ejb_web_profile, jacc_web_profile, jaspic_web_profile, javamail_web_profile, jaxr_web_profile, xa_web_profile, jaxrpc_web_profile, jaxws_web_profile
205+
206+
For more information about TCK structure and tests attributes check the link:about_tck{outfilesuffix}[about_tck] documentation.
207+
180208
## WHAT NEXT
181209

182210
Getting from zero to passing is a long road. Failures and the

about_tck.adoc

+37
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# About JakartaEE TCK
2+
3+
## CTS
4+
5+
The JakartaEE Test Compatibility Kit (TCK) is conformed by a Compatibility Test Suite (CTS).
6+
7+
CTS is a set of tools and tests used to verify that a licensee's implementation of Java EE 8 technology conforms to the applicable specification.
8+
9+
Java EE 8 CTS includes version 5.0 of the JT harness.
10+
11+
## Tests organization
12+
13+
The JakartaEE TCK is conformed by a total of 47,219 tests that can be divided in two subset: one set for Web Profile and other for Full Profile.
14+
15+
Each test has a set of attributes like id, keyword, testName, test_directory and classname among others.
16+
The `keyword` attribute can be used to differentiate the test that belong to a Web and/or Full Profile, and if they are optional base on the type of profile.
17+
18+
The following are the `keywords` related with Web Profile:
19+
20+
javaee_web_profile, ejb_web_profile, jacc_web_profile, jaspic_web_profile, javamail_web_profile, jaxr_web_profile, xa_web_profile, jaxrpc_web_profile, jaxws_web_profile
21+
22+
## JT Harness UI
23+
This is a useful UI tool that comes in handy when one needs to know if a specific test is or not part of a specific profile.
24+
25+
## start JT Harness UI
26+
From the `$TCK_HOME` execute:
27+
28+
cd bin
29+
ant gui
30+
31+
The UI shows all the TCK test and you can navigate to an specific test and view the Test Description tab that contains the test attributes described above.
32+
33+
34+
35+
36+
37+

0 commit comments

Comments
 (0)