From 8a2510ac9c5c3b850e960ed5086c977aefca4240 Mon Sep 17 00:00:00 2001 From: Scott M Stark Date: Mon, 20 Jan 2025 22:40:18 -0500 Subject: [PATCH] Get guides builing using asciidoc --- ...standalone-TCKs-from-platform-TCK.asciidoc | 26 - release/artifact-install.pom | 469 ---------- release/pom.xml | 184 ---- release/src/main/assembly/assembly.xml | 105 --- release/tools/build-utils.xml | 566 ------------ release/tools/build.xml | 861 ------------------ release/tools/caj.xml | 147 --- release/tools/common.xml | 147 --- release/tools/connector.xml | 246 ----- release/tools/cts-internal-default.xml | 68 -- release/tools/el.xml | 151 --- release/tools/jacc.xml | 218 ----- release/tools/jakartaee-tech-common.xml | 130 --- release/tools/jakartaee.xml | 258 ------ release/tools/jaxws.xml | 210 ----- release/tools/jaxwsnose.xml | 126 --- release/tools/jdbc.xml | 83 -- release/tools/jms.xml | 193 ---- release/tools/jpa.xml | 204 ----- release/tools/jsp.xml | 214 ----- release/tools/jstl.xml | 204 ----- release/tools/jta.xml | 176 ---- release/tools/jte.props.sanitize | 40 - release/tools/saaj.xml | 182 ---- release/tools/servlet.xml | 240 ----- release/tools/websocket.xml | 241 ----- .../docs/userguide/pom.xml | 24 - .../docs/userguide/src/assembly/dist.xml | 17 +- .../docs/userguide/src/assembly/pdfs.xml | 40 + .../docs/userguide/src/main/asciidoc}/README | 0 .../src/main/asciidoc/attributes.conf | 35 + .../userguide/src/main/asciidoc/book.adoc | 22 + .../userguide/src/main/asciidoc/config.adoc | 29 + .../userguide/src/main/asciidoc/config.inc | 159 ++++ .../src/main/asciidoc}/debug-tips.inc | 0 .../userguide/src/main/asciidoc/debug.adoc | 70 ++ .../userguide/src/main/asciidoc}/defns.inc | 0 .../docs/userguide/src/main/asciidoc/faq.adoc | 46 + .../src/main/asciidoc/install-server-vi.inc | 0 .../src/main/asciidoc/install-server.inc | 0 .../userguide/src/main/asciidoc/install.adoc | 71 ++ .../userguide/src/main/asciidoc/intro.adoc | 283 ++++++ .../userguide/src/main/asciidoc/intro.inc | 20 + .../userguide/src/main/asciidoc/packages.inc | 7 + .../userguide/src/main/asciidoc/platforms.inc | 4 + .../userguide/src/main/asciidoc/preface.adoc | 134 +++ .../userguide/src/main/asciidoc}/rebuild.adoc | 8 - .../userguide/src/main/asciidoc/rebuild.inc | 7 + .../src/main/asciidoc/req-software.inc | 10 + .../userguide/src/main/asciidoc/rules.adoc | 369 ++++++++ .../userguide/src/main/asciidoc/rules.inc | 19 + .../src/main/asciidoc/tck-packages.inc | 6 + .../userguide/src/main/asciidoc}/title.adoc | 9 - .../userguide/src/main/asciidoc}/title.inc | 0 .../src/main/asciidoc/using-examples.inc | 50 + .../userguide/src/main/asciidoc/using.adoc | 136 +++ .../userguide/src/main/asciidoc/using.inc | 0 .../docs/userguide/src/assembly/dist.xml | 41 + user_guides/apply_template.sh | 84 -- user_guides/build_tckugs.sh | 61 -- user_guides/connector/src/assembly/dist.xml | 41 + user_guides/jms/src/assembly/dist.xml | 41 + ...ee_logo_schooner_color_stacked_default.png | Bin 46992 -> 0 bytes .../main/resources/theme/jakartaee-theme.yml | 134 --- user_guides/jsp/src/assembly/dist.xml | 41 + user_guides/jstl/src/assembly/dist.xml | 41 + user_guides/jta/src/assembly/dist.xml | 41 + .../pdf-assembly/src/assembly/dist.xml | 41 + .../pdf-assembly/src/assembly/pdfs.xml | 40 + user_guides/platform/pom.xml | 7 + user_guides/platform/src/assembly/dist.xml | 41 + .../platform/src/main/assembly/assembly.xml | 21 - user_guides/websocket/pom.xml | 14 - user_guides/websocket/src/assembly/dist.xml | 41 + .../websocket/src/main/asciidoc/README | 77 ++ .../content => asciidoc}/attributes.conf | 0 .../websocket/src/main/asciidoc/book.adoc | 22 + .../{jbake/content => asciidoc}/config.adoc | 8 - .../{jbake/content => asciidoc}/config.inc | 0 .../src/main/asciidoc/debug-tips.inc | 0 .../{jbake/content => asciidoc}/debug.adoc | 8 - .../websocket/src/main/asciidoc/defns.inc | 46 + .../main/{jbake/content => asciidoc}/faq.adoc | 8 - .../install-server-vi.inc | 0 .../content => asciidoc}/install-server.inc | 0 .../{jbake/content => asciidoc}/install.adoc | 8 - .../{jbake/content => asciidoc}/intro.adoc | 8 - .../websocket/src/main/asciidoc/intro.inc | 0 .../{jbake/content => asciidoc}/packages.inc | 0 .../{jbake/content => asciidoc}/platforms.inc | 0 .../{jbake/content => asciidoc}/preface.adoc | 8 - .../websocket/src/main/asciidoc/rebuild.adoc | 12 + .../{jbake/content => asciidoc}/rebuild.inc | 0 .../content => asciidoc}/req-software.inc | 0 .../{jbake/content => asciidoc}/rules.adoc | 8 - .../{jbake/content => asciidoc}/rules.inc | 0 .../content => asciidoc}/tck-packages.inc | 0 .../websocket/src/main/asciidoc/title.adoc | 33 + .../websocket/src/main/asciidoc/title.inc | 11 + .../content => asciidoc}/using-examples.inc | 0 .../{jbake/content => asciidoc}/using.adoc | 8 - .../websocket/src/main/asciidoc/using.inc | 0 .../websocket/src/main/jbake/assets/README.md | 4 - .../src/main/jbake/assets/_config.yml | 14 - 104 files changed, 2143 insertions(+), 6134 deletions(-) delete mode 100644 notes/Standard-Rules-while-separating-standalone-TCKs-from-platform-TCK.asciidoc delete mode 100644 release/artifact-install.pom delete mode 100644 release/pom.xml delete mode 100644 release/src/main/assembly/assembly.xml delete mode 100644 release/tools/build-utils.xml delete mode 100644 release/tools/build.xml delete mode 100644 release/tools/caj.xml delete mode 100644 release/tools/common.xml delete mode 100644 release/tools/connector.xml delete mode 100644 release/tools/cts-internal-default.xml delete mode 100644 release/tools/el.xml delete mode 100644 release/tools/jacc.xml delete mode 100644 release/tools/jakartaee-tech-common.xml delete mode 100644 release/tools/jakartaee.xml delete mode 100644 release/tools/jaxws.xml delete mode 100644 release/tools/jaxwsnose.xml delete mode 100644 release/tools/jdbc.xml delete mode 100644 release/tools/jms.xml delete mode 100644 release/tools/jpa.xml delete mode 100644 release/tools/jsp.xml delete mode 100644 release/tools/jstl.xml delete mode 100644 release/tools/jta.xml delete mode 100644 release/tools/jte.props.sanitize delete mode 100644 release/tools/saaj.xml delete mode 100644 release/tools/servlet.xml delete mode 100644 release/tools/websocket.xml rename user_guides/pdf-assembly/src/main/assembly/resources.xml => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/assembly/dist.xml (70%) create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/assembly/pdfs.xml rename {user_guides/websocket/src/main/jbake/content => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc}/README (100%) create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/attributes.conf create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/book.adoc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/config.adoc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/config.inc rename {user_guides/websocket/src/main/jbake/content => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc}/debug-tips.inc (100%) create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/debug.adoc rename {user_guides/websocket/src/main/jbake/content => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc}/defns.inc (100%) create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/faq.adoc rename user_guides/websocket/src/main/jbake/content/intro.inc => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install-server-vi.inc (100%) rename user_guides/websocket/src/main/jbake/content/using.inc => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install-server.inc (100%) create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install.adoc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/intro.adoc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/intro.inc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/packages.inc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/platforms.inc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/preface.adoc rename {user_guides/websocket/src/main/jbake/content => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc}/rebuild.adoc (58%) create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rebuild.inc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/req-software.inc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rules.adoc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rules.inc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/tck-packages.inc rename {user_guides/websocket/src/main/jbake/content => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc}/title.adoc (73%) rename {user_guides/websocket/src/main/jbake/content => tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc}/title.inc (100%) create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using-examples.inc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using.adoc create mode 100644 tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using.inc create mode 100644 tcks/apis/websocket/docs/userguide/src/assembly/dist.xml delete mode 100755 user_guides/apply_template.sh delete mode 100644 user_guides/build_tckugs.sh create mode 100644 user_guides/connector/src/assembly/dist.xml create mode 100644 user_guides/jms/src/assembly/dist.xml delete mode 100644 user_guides/jms/src/main/resources/theme/jakarta_ee_logo_schooner_color_stacked_default.png delete mode 100644 user_guides/jms/src/main/resources/theme/jakartaee-theme.yml create mode 100644 user_guides/jsp/src/assembly/dist.xml create mode 100644 user_guides/jstl/src/assembly/dist.xml create mode 100644 user_guides/jta/src/assembly/dist.xml create mode 100644 user_guides/pdf-assembly/src/assembly/dist.xml create mode 100644 user_guides/pdf-assembly/src/assembly/pdfs.xml create mode 100644 user_guides/platform/src/assembly/dist.xml delete mode 100644 user_guides/platform/src/main/assembly/assembly.xml create mode 100644 user_guides/websocket/src/assembly/dist.xml create mode 100644 user_guides/websocket/src/main/asciidoc/README rename user_guides/websocket/src/main/{jbake/content => asciidoc}/attributes.conf (100%) create mode 100644 user_guides/websocket/src/main/asciidoc/book.adoc rename user_guides/websocket/src/main/{jbake/content => asciidoc}/config.adoc (98%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/config.inc (100%) create mode 100644 user_guides/websocket/src/main/asciidoc/debug-tips.inc rename user_guides/websocket/src/main/{jbake/content => asciidoc}/debug.adoc (97%) create mode 100644 user_guides/websocket/src/main/asciidoc/defns.inc rename user_guides/websocket/src/main/{jbake/content => asciidoc}/faq.adoc (91%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/install-server-vi.inc (100%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/install-server.inc (100%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/install.adoc (96%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/intro.adoc (99%) create mode 100644 user_guides/websocket/src/main/asciidoc/intro.inc rename user_guides/websocket/src/main/{jbake/content => asciidoc}/packages.inc (100%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/platforms.inc (100%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/preface.adoc (97%) create mode 100644 user_guides/websocket/src/main/asciidoc/rebuild.adoc rename user_guides/websocket/src/main/{jbake/content => asciidoc}/rebuild.inc (100%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/req-software.inc (100%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/rules.adoc (99%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/rules.inc (100%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/tck-packages.inc (100%) create mode 100644 user_guides/websocket/src/main/asciidoc/title.adoc create mode 100644 user_guides/websocket/src/main/asciidoc/title.inc rename user_guides/websocket/src/main/{jbake/content => asciidoc}/using-examples.inc (100%) rename user_guides/websocket/src/main/{jbake/content => asciidoc}/using.adoc (98%) create mode 100644 user_guides/websocket/src/main/asciidoc/using.inc delete mode 100644 user_guides/websocket/src/main/jbake/assets/README.md delete mode 100644 user_guides/websocket/src/main/jbake/assets/_config.yml diff --git a/notes/Standard-Rules-while-separating-standalone-TCKs-from-platform-TCK.asciidoc b/notes/Standard-Rules-while-separating-standalone-TCKs-from-platform-TCK.asciidoc deleted file mode 100644 index 14ce4e5403..0000000000 --- a/notes/Standard-Rules-while-separating-standalone-TCKs-from-platform-TCK.asciidoc +++ /dev/null @@ -1,26 +0,0 @@ -The wiki attempts to create some general rules and common steps that can be referred while separating standalone TCKs out from the platform TCK repository and to convert them into JUnit/maven based tests. This is not a comprehensive document and might require further evaluation of each items before refactoring standalone TCKs. - -1. It is required to understand whether server like environment or container based testing is needed for the standalone TCK and whether archives need to be deployed to the container based on the current java tests. Arquillian is currently the accepted way for creating and deploying archives that uses shrinkwrap api. -* Jakarta REST TCK uses arquillian(creates serlvet container) for testing: The initial POC PR that was used for Jakarta REST TCK migration https://github.com/jakartaee/rest/pull/1002 , wiki https://github.com/alwin-joseph/rest/wiki/REST-TCK-separation-from-JakartaEE-TCK-repo describes the migration effort. -* If no containers are required for testing, the JSONB TCK example can be followed. PR https://github.com/eclipse-ee4j/jsonb-api/pull/276/. - -2. The tests in platform repository runs in different vehicles based on the property file `install//other/vehicle.properties` for . -The standalone tests should adhere to the specification requirements on running in these vehicles while migrating the tests. -For instance the JAXRS tck was run run in servlet vehicle ; the arquillian uses servlet container hence the migration of tests did not require additional changes to run them in servlet vehicles. - -3. `install//bin/build.xml` is the main ant file specific to each technology for building the from jakartaee-tck repository. The java source files in list all.test.dir can be considered as the list of files with the tests. Each test method would have `@testName` tag in the comments, for JUnit these methods will need `@org.junit.jupiter.api.Test` tag correspondingly. - -4. Need to implement the list of tests run for javaee full platform , webprofile, standalone and other profile runs as specified in -`src/com/sun/ts/lib/harness/keyword.properties` . Currently "KEYWORDS" parameter is used to specify the right list of tests to be run using ant. In JUnit `org.junit.jupiter.api.Tag` can be used to implement the special keywords to create test groups. The `install//bin/ts.jtx` has the list of tests disabled, the same can be implemented using `@org.junit.jupiter.api.Disabled` Tag. - -5. `release/tools/.xml` will have the list of files that is included in the legacy final tck bundle. -Choose those java/class files and the other helper files from here for the migrated tests so those will be included in the bundle post migration. - -6. jakartaee-tck/lib/ has the jars used for build/run of the tcks. The same can be mentioned as dependency in maven project after migration instead of using jars from repository. The current legacy standalone TCK bundle will have the jars that is required for the tck to be run. -For eg : in Jakarta REST -common-httpclient was used to build and run the jaxrs tck hence used it as maven dependency in Jakarta REST TCK build pom file https://github.com/jakartaee/rest/blob/6f453f85ed8aa5b1ae4b8261b9039d28cd974b04/jaxrs-tck/pom.xml#L190 and sample tck run pom file https://github.com/jakartaee/rest/blob/master/jersey-tck/pom.xml - -7. userguides are present at jakartaee-tck/user_guides/ : The current users guides in jakartaee-tck project are maven projects. They can be moved directly to a new repo/maven-project. It would be required to edit the userguide contents for change in details related to migration of the tck. - -8. Create tck runners for implementations: Once the standalone TCK is created as an archive bundle, it is recommended to execute it against at least one implementation. The https://github.com/eclipse-ee4j/jakartaee-tck/tree/master/glassfish-runner has some of the tck runners against glassfish server. - diff --git a/release/artifact-install.pom b/release/artifact-install.pom deleted file mode 100644 index 963871ce5a..0000000000 --- a/release/artifact-install.pom +++ /dev/null @@ -1,469 +0,0 @@ - - - - - 4.0.0 - - jakarta.tck - cdi-tck-artifacts - pom - - ${project.version} - Jakarta EE TCK Artifacts - - - - - - maven-install-plugin - 3.1.3 - - - install-appclient - package - - install-file - - - jakarta.tck - appclient - ${project.version} - jar - appclient-${project.version}.jar - true - - - - install-assembly - package - - install-file - - - jakarta.tck - assembly - ${project.version} - jar - assembly-${project.version}.jar - true - - - - install-common - package - - install-file - - - jakarta.tck - common - ${project.version} - jar - common-${project.version}.jar - true - - - - install-connector - package - - install-file - - - jakarta.tck - connector - ${project.version} - jar - connector-${project.version}.jar - true - - - - install-ejb30 - package - - install-file - - - jakarta.tck - ejb30 - ${project.version} - jar - ejb30-${project.version}.jar - true - - - - install-ejb32 - package - - install-file - - - jakarta.tck - ejb32 - ${project.version} - jar - ejb32-${project.version}.jar - true - - - - install-el-tck - package - - install-file - - - jakarta.tck - el-platform-tck - ${project.version} - jar - el-platform-tck-${project.version}.jar - true - - - - install-integration - package - - install-file - - - jakarta.tck - integration - ${project.version} - jar - integration-${project.version}.jar - true - - - - install-javaee - package - - install-file - - - jakarta.tck - javaee - ${project.version} - jar - javaee-${project.version}.jar - true - - - - install-javamail - package - - install-file - - - jakarta.tck - javamail - ${project.version} - jar - javamail-${project.version}.jar - true - - - - install-jaxrs - package - - install-file - - - jakarta.tck - jaxrs - ${project.version} - jar - jaxrs-${project.version}.jar - true - - - - install-jdbc - package - - install-file - - - jakarta.tck - jdbc - ${project.version} - jar - jdbc-${project.version}.jar - true - - - - install-jms - package - - install-file - - - jakarta.tck - jms - ${project.version} - jar - jms-${project.version}.jar - true - - - - install-jms-tck - package - - install-file - - - jakarta.tck - jms-tck - ${project.version} - jar - jms-tck-${project.version}.jar - true - - - - install-jpa - package - - install-file - - - jakarta.tck - jpa - ${project.version} - jar - jpa-${project.version}.jar - true - - - - install-jpa-tck - package - - install-file - - - jakarta.tck - jpa-tck - ${project.version} - jar - jpa-tck-${project.version}.jar - true - - - - install-jsonb - package - - install-file - - - jakarta.tck - jsonb - ${project.version} - jar - jsonb-${project.version}.jar - true - - - - install-jsonp - package - - install-file - - - jakarta.tck - jsonp - ${project.version} - jar - jsonp-${project.version}.jar - true - - - - install-jsp - package - - install-file - - - jakarta.tck - jsp - ${project.version} - jar - jsp-${project.version}.jar - true - - - - install-jstl - package - - install-file - - - jakarta.tck - jstl - ${project.version} - jar - jstl-${project.version}.jar - true - - - - install-jta - package - - install-file - - - jakarta.tck - jta - ${project.version} - jar - jta-${project.version}.jar - true - - - - install-libutil - package - - install-file - - - jakarta.tck - libutil - ${project.version} - jar - libutil-${project.version}.jar - true - - - - install-runtime - package - - install-file - - - jakarta.tck - runtime - ${project.version} - jar - runtime-${project.version}.jar - true - - - - install-samples - package - - install-file - - - jakarta.tck - samples - ${project.version} - jar - samples-${project.version}.jar - true - - - - install-servlet - package - - install-file - - - jakarta.tck - servlet - ${project.version} - jar - servlet-${project.version}.jar - true - - - - install-signaturetest - package - - install-file - - - jakarta.tck - signaturetest - ${project.version} - jar - signaturetest-${project.version}.jar - true - - - - install-tsharness - package - - install-file - - - jakarta.tck - tsharness - ${project.version} - jar - tsharness-${project.version}.jar - true - - - - install-websocket - package - - install-file - - - jakarta.tck - websocket - ${project.version} - jar - websocket-${project.version}.jar - true - - - - install-xa - package - - install-file - - - jakarta.tck - xa - ${project.version} - jar - xa-${project.version}.jar - true - - - - - - - diff --git a/release/pom.xml b/release/pom.xml deleted file mode 100644 index f7e1f2b971..0000000000 --- a/release/pom.xml +++ /dev/null @@ -1,184 +0,0 @@ - - - - 4.0.0 - - - jakarta.tck - project - 11.0.0-SNAPSHOT - - - release - pom - Jakarta TCK Release - - - - ${project.groupId} - appclient - ${project.version} - - - ${project.groupId} - assembly-tck - ${project.version} - - - ${project.groupId} - common - ${project.version} - - - ${project.groupId} - connector - ${project.version} - - - ${project.groupId} - ejb30 - ${project.version} - - - ${project.groupId} - ejb32 - ${project.version} - - - ${project.groupId} - el-platform-tck - ${project.version} - - - ${project.groupId} - integration - ${project.version} - - - ${project.groupId} - javaee-tck - ${project.version} - - - ${project.groupId} - javamail - ${project.version} - - - ${project.groupId} - jdbc - ${project.version} - - - ${project.groupId} - jms-tck - ${project.version} - - - ${project.groupId} - persistence-platform-tck-tests - ${project.version} - - - ${project.groupId} - jsonb-platform-tck - ${project.version} - - - ${project.groupId} - jsonb-platform-tck - ${project.version} - - - ${project.groupId} - pages-platform-tck - ${project.version} - - - ${project.groupId} - jakarta-tags-tck - ${project.version} - - - ${project.groupId} - jta - ${project.version} - - - ${project.groupId} - libutil - ${project.version} - - - ${project.groupId} - runtime - ${project.version} - - - ${project.groupId} - signaturetest - ${project.version} - - - ${project.groupId} - tsharness - ${project.version} - - - ${project.groupId} - websocket-tck-platform-tests - 2.2.0 - - - ${project.groupId} - xa - ${project.version} - - - jakarta.platform - jakarta.jakartaee-tck-user-guide - ${project.version} - zip - - - - - - - maven-assembly-plugin - - - distribution - - single - - package - - - src/main/assembly/assembly.xml - - platform-tck-${project.version} - - - - - - - diff --git a/release/src/main/assembly/assembly.xml b/release/src/main/assembly/assembly.xml deleted file mode 100644 index 6921e00614..0000000000 --- a/release/src/main/assembly/assembly.xml +++ /dev/null @@ -1,105 +0,0 @@ - - - dist - platform-tck-${project.version} - - zip - - - - - - ../LICENSE_EFTL.md - LICENSE.md - - - artifact-install.pom - artifacts - pom.xml - true - - - - - - ${project.basedir} - / - - README.adoc - - - - ${project.basedir}/../install/jakartaee/bin - bin - - certificates/** - *.config - *.dat - *.policy - ts.jte - - - - - - - - ${project.groupId}:appclient - ${project.groupId}:assembly - ${project.groupId}:common - ${project.groupId}:connector - ${project.groupId}:ejb30 - ${project.groupId}:ejb32 - ${project.groupId}:el-platform-tck - ${project.groupId}:integration - ${project.groupId}:javaee - ${project.groupId}:javamail - ${project.groupId}:jaxrs - ${project.groupId}:jdbc - ${project.groupId}:jms-tck - ${project.groupId}:persistence-platform-tck-tests - ${project.groupId}:jsonb - ${project.groupId}:jsonp - ${project.groupId}:jsp - ${project.groupId}:jstl - ${project.groupId}:jta - ${project.groupId}:libutil - ${project.groupId}:runtime - ${project.groupId}:samples - ${project.groupId}:servlet - ${project.groupId}:signaturetest - ${project.groupId}:tsharness - ${project.groupId}:websocket-tck-platform-tests - ${project.groupId}:xa - - true - artifacts - true - - - - jakarta.enterprise:cdi-tck-dist-libs - - false - /lib - false - true - - - - jakarta.platform:jakarta.jakartaee-tck-user-guide:zip - - true - - - META-INF/ - - - doc - true - - - - diff --git a/release/tools/build-utils.xml b/release/tools/build-utils.xml deleted file mode 100644 index b083349106..0000000000 --- a/release/tools/build-utils.xml +++ /dev/null @@ -1,566 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Proprietary APIs have been detected. Users are strongly discouraged from using -proprietary APIs. If you can remove them, please do so. - - The following proprietary APIs were found in the build log: - =========================================================== - ${proprietary.errors} - - - - - - - - - -The CTS-Build job which ran previous to this job had failures. - -Please see the CTS-Build log output for compilation errors. - - The logs are located under the hudson job's /job/Trunk.Build/ dir - -FAILED DIRECTORIES BELOW -======================== -${failed.dirs} - - - - - - - - - - - - - - - - - - - - -The runclient target that runs the smoke tests, failed to run properly. Please see log for details. - - -SmokeLog: -========= -${smoke.log.contents} - - - - - - - - - - - - - - - - -List of failed smoke tests (See smoke log, included below, for more details): - -${failed.tests} - -Server logs are located here: ${javaee.home.ri}/domains/domain1/logs - - -SmokeLog: -========= -${smoke.log.contents} - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - deleteing ${release.tools.current.dir}/.. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Checking availability of URL "${url.to.check}" ... - - - - Success, "${url.to.check}" is available. - - - Failure, "${url.to.check}" is NOT available. - - - - - - - - - - - - Ping SUCCESS, ${ping.host} is reachable. - - - Ping FAILED, ${ping.host} is NOT reachable. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/build.xml b/release/tools/build.xml deleted file mode 100644 index 265c6a0f9a..0000000000 --- a/release/tools/build.xml +++ /dev/null @@ -1,861 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/caj.xml b/release/tools/caj.xml deleted file mode 100644 index ce228796dc..0000000000 --- a/release/tools/caj.xml +++ /dev/null @@ -1,147 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/common.xml b/release/tools/common.xml deleted file mode 100644 index 2cd0a77915..0000000000 --- a/release/tools/common.xml +++ /dev/null @@ -1,147 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/connector.xml b/release/tools/connector.xml deleted file mode 100644 index fbdb49afe5..0000000000 --- a/release/tools/connector.xml +++ /dev/null @@ -1,246 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/cts-internal-default.xml b/release/tools/cts-internal-default.xml deleted file mode 100644 index 056c7be7ff..0000000000 --- a/release/tools/cts-internal-default.xml +++ /dev/null @@ -1,68 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/el.xml b/release/tools/el.xml deleted file mode 100644 index 730314e106..0000000000 --- a/release/tools/el.xml +++ /dev/null @@ -1,151 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jacc.xml b/release/tools/jacc.xml deleted file mode 100644 index 3a1cf3b65b..0000000000 --- a/release/tools/jacc.xml +++ /dev/null @@ -1,218 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jakartaee-tech-common.xml b/release/tools/jakartaee-tech-common.xml deleted file mode 100644 index 3280882f78..0000000000 --- a/release/tools/jakartaee-tech-common.xml +++ /dev/null @@ -1,130 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jakartaee.xml b/release/tools/jakartaee.xml deleted file mode 100644 index 15b1064a21..0000000000 --- a/release/tools/jakartaee.xml +++ /dev/null @@ -1,258 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jaxws.xml b/release/tools/jaxws.xml deleted file mode 100644 index 4f1ea2835f..0000000000 --- a/release/tools/jaxws.xml +++ /dev/null @@ -1,210 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jaxwsnose.xml b/release/tools/jaxwsnose.xml deleted file mode 100644 index c7c9514078..0000000000 --- a/release/tools/jaxwsnose.xml +++ /dev/null @@ -1,126 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jdbc.xml b/release/tools/jdbc.xml deleted file mode 100644 index 513bdc0863..0000000000 --- a/release/tools/jdbc.xml +++ /dev/null @@ -1,83 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jms.xml b/release/tools/jms.xml deleted file mode 100644 index e586b0fda3..0000000000 --- a/release/tools/jms.xml +++ /dev/null @@ -1,193 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jpa.xml b/release/tools/jpa.xml deleted file mode 100644 index 124292ba34..0000000000 --- a/release/tools/jpa.xml +++ /dev/null @@ -1,204 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jsp.xml b/release/tools/jsp.xml deleted file mode 100644 index 0ea2cbb109..0000000000 --- a/release/tools/jsp.xml +++ /dev/null @@ -1,214 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jstl.xml b/release/tools/jstl.xml deleted file mode 100644 index a72011dded..0000000000 --- a/release/tools/jstl.xml +++ /dev/null @@ -1,204 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jta.xml b/release/tools/jta.xml deleted file mode 100644 index 3758586368..0000000000 --- a/release/tools/jta.xml +++ /dev/null @@ -1,176 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/jte.props.sanitize b/release/tools/jte.props.sanitize deleted file mode 100644 index 10db3bee59..0000000000 --- a/release/tools/jte.props.sanitize +++ /dev/null @@ -1,40 +0,0 @@ -# -# Copyright (c) 2018 Oracle and/or its affiliates. All rights reserved. -# -# This program and the accompanying materials are made available under the -# terms of the Eclipse Public License v. 2.0, which is available at -# http://www.eclipse.org/legal/epl-2.0. -# -# This Source Code may also be made available under the following Secondary -# Licenses when the conditions for such availability set forth in the -# Eclipse Public License v. 2.0 are satisfied: GNU General Public License, -# version 2 with the GNU Classpath Exception, which is available at -# https://www.gnu.org/software/classpath/license.html. -# -# SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 -# - -# -# find and replace values used to sanitize the ts.jte file before shipping -# - -find_1 = ${line.separator}orb.host= -replace_1 = ${line.separator}orb.host= -find_2 = ${line.separator}javaee.home= -replace_2 = ${line.separator}javaee.home= -find_3 = ${line.separator}orb.host.ri= -replace_3 = ${line.separator}orb.host.ri= -find_4 = ${line.separator}javaee.home.ri= -replace_4 = ${line.separator}javaee.home.ri= -find_5 = ${line.separator}mailuser1= -replace_5 = ${line.separator}mailuser1= -find_6 = ${line.separator}mailHost= -replace_6 = ${line.separator}mailHost= -find_7 = ${line.separator}wsimport.jvmargs= -replace_7 = ${line.separator}wsimport.jvmargs= -find_8 = ${line.separator}ri.wsimport.jvmargs= -replace_8 = ${line.separator}ri.wsimport.jvmargs= -find_9 = ${line.separator}mailFrom= -replace_9 = ${line.separator}mailFrom= -find_10 = ${line.separator}javamail.password= -replace_10= ${line.separator}javamail.password= diff --git a/release/tools/saaj.xml b/release/tools/saaj.xml deleted file mode 100644 index 81627e32bd..0000000000 --- a/release/tools/saaj.xml +++ /dev/null @@ -1,182 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/servlet.xml b/release/tools/servlet.xml deleted file mode 100644 index 28afa2450a..0000000000 --- a/release/tools/servlet.xml +++ /dev/null @@ -1,240 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release/tools/websocket.xml b/release/tools/websocket.xml deleted file mode 100644 index 906e64b9f4..0000000000 --- a/release/tools/websocket.xml +++ /dev/null @@ -1,241 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/pom.xml b/tcks/apis/persistence/persistence-outside-container/docs/userguide/pom.xml index e28d910f82..3899736ce1 100644 --- a/tcks/apis/persistence/persistence-outside-container/docs/userguide/pom.xml +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/pom.xml @@ -57,30 +57,6 @@ - - org.glassfish.doc - glassfish-doc-maven-plugin - - - generate-book - generate-sources - - - generate-toc - generate-sources - - - - - org.jbake - jbake-maven-plugin - - - build-site - generate-resources - - - org.asciidoctor asciidoctor-maven-plugin diff --git a/user_guides/pdf-assembly/src/main/assembly/resources.xml b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/assembly/dist.xml similarity index 70% rename from user_guides/pdf-assembly/src/main/assembly/resources.xml rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/assembly/dist.xml index ce00bda77f..82cfe70cc8 100644 --- a/user_guides/pdf-assembly/src/main/assembly/resources.xml +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/assembly/dist.xml @@ -15,25 +15,26 @@ - resources + dist zip false - ${project.basedir}/.. - legal + ${project.build.directory}/staging + html - LICENSE.md - NOTICE.md + **/css/* + **/img/* + **/*.html - ${project.basedir}/src/main/resources - . + ${project.build.directory}/generated-docs + pdf - **/* + **/*.pdf diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/assembly/pdfs.xml b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/assembly/pdfs.xml new file mode 100644 index 0000000000..0d239f39f4 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/assembly/pdfs.xml @@ -0,0 +1,40 @@ + + bin + + dir + + true + + + pdfs + + *:zip + + true + + + + \ No newline at end of file diff --git a/user_guides/websocket/src/main/jbake/content/README b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/README similarity index 100% rename from user_guides/websocket/src/main/jbake/content/README rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/README diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/attributes.conf b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/attributes.conf new file mode 100644 index 0000000000..1e6a51bef8 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/attributes.conf @@ -0,0 +1,35 @@ +:TechnologyFullName: Jakarta Persistence +:TechnologyShortName: Persistence +:LegacyAcronym: JPA +:ReleaseDate: April 2024 +:CopyrightDates: 2017, 2024 +:TechnologyVersion: 3.2 +:TechnologyRI: EclipseLink 5.0 +:TechnologyRIURL: https://projects.eclipse.org/projects/ee4j.eclipselink +:SpecificationURL: https://jakarta.ee/specifications/persistence/3.2/ +:TCKInquiryList: mailto:jakartaee-tck-dev@eclipse.org[jakartaee-tck-dev@eclipse.org] +:SpecificationInquiryList: mailto:jpa-dev@eclipse.org[jpa-dev@eclipse.org] +:techID: Persistence +// Define this attribute (uncomment it) if the TCK includes no API tests. (Rare.) +// :no-api-tests: +// Define this attribute (uncomment it) if the TCK includes end-to-end tests. +// :end-to-end-tests: +// Define this attribute (uncomment it) if subsets of the API are allowed. +// (Common Annotations only) +// :subset-allowed: +// +// The environment variable used to specify the home directory +// for the technology. Used in config.inc. +:TechnologyHomeEnv: ECLIPSELINK_HOME +:excludeListFileName: TCK-Exclude-List.txt +// Java SE version required. +:SEversion: 17+ +:JakartaEEVersion: 11 +:MavenVersion: 3.6.0+ +:TCKPackageName: jakarta-persistence-tck-3.2.0.zip +// Directory names used in examples in using.adoc. +:sigTestDirectoryExample: ee.jakarta.tck.persistence.signaturetest +:singleTestDirectoryExample: ee.jakarta.tck.persistence.core.annotations.access.field +:subsetTestDirectoryExample: ee.jakarta.tck.persistence.core.annotations +// Define this attribute (uncomment it) if the TCK needs the rebuild appendix. +// :rebuild: diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/book.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/book.adoc new file mode 100644 index 0000000000..a47c51b9e4 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/book.adoc @@ -0,0 +1,22 @@ += TCK User's Guide for Technology Implementors + +include::title.adoc[] + +include::preface.adoc[] + +include::intro.adoc[] + +include::rules.adoc[] + +include::install.adoc[] + +include::config.adoc[] + +include::using.adoc[] + +include::debug.adoc[] + +include::faq.adoc[] + +include::rebuild.adoc[] + diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/config.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/config.adoc new file mode 100644 index 0000000000..14798ce87e --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/config.adoc @@ -0,0 +1,29 @@ +include::attributes.conf[] + +[[GBFVV]] + + + +[[setup-and-configuration]] +4 Setup and Configuration +------------------------- + + +[NOTE] +==== +The Jakarta EE Specification process provides for any number of compatible implementations. +As additional implementations become available, refer to project or product documentation from +those vendors for specific TCK setup and operational guidance. + +==== + +This chapter describes how to set up the {TechnologyShortName} TCK. Before proceeding with the instructions in +this chapter, be sure to install all required software, as described in +link:install.html#GBFTP[Chapter 3, "Installation."] + +After completing the instructions in this chapter, proceed to +link:using.html#GBFWO[Chapter 5, "Executing Tests,"] for instructions on +running the {TechnologyShortName} TCK. + +include::config.inc[] + diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/config.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/config.inc new file mode 100644 index 0000000000..823ab8084b --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/config.inc @@ -0,0 +1,159 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +The following sections should be customized for the technology. +This text was originally from the JAX-RS TCK. Most references +to JAX-RS have been parameterized to serve as a simple starting +point for customization. There are still many details that will +need to be changed or removed. The major sections 4.1, 4.2, and +4.3 should be preserved. If their titles are changed, the links +at the top of config.adoc will need to be changed as well as well +as toc.adoc. +/////////////////////////////////////////////////////////////////////// + +[[GBFVU]][[configuring-your-environment-to-run-the-tck-against-the-reference-implementation]] + +4.1 Configuring Your Environment to Run the TCK Against the Compatible Implementation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +[NOTE] +======================================================================= + +In these instructions, variables in angle brackets need to be expanded +for each platform. For example, `` becomes `$JAVA_HOME` on +Solaris/Linux and `%JAVA_HOME%` on Windows. In addition, the forward +slashes (`/`) used in all of the examples need to be replaced with +backslashes (`\`) for Windows. Finally, be sure to use the appropriate +separator for your operating system when specifying multiple path +entries (`;` on Windows, `:` on UNIX/Linux). + +On Windows, you must escape any backslashes with an extra backslash in +path separators used in any of the following properties, or use forward +slashes as a path separator instead. + +======================================================================= + + +1. Set the following environment variables in your shell environment: + a. `JAVA_HOME` to the directory in which Java SE {SEversion} is installed + b. `M2_HOME` to the directory in which the Apache Maven build tool is installed. + c. +{TechnologyHomeEnv}+ to the directory in which the {TechnologyShortName} + {TechnologyVersion} CI has been installed + d. `PATH` to include the following directories: `JAVA_HOME/bin`, + and `M2_HOME/bin` +2. set the following system properties: + a. Set `jpa.classes` to include all of the necessary JAR files that + pertain to your implementation using comma separator in the TCK runner. + b. Set `jdbc.lib.classpath` to the location where the JDBC drivers are + installed using comma separator in the TCK runner. + c. Set `jdbc.driver.classes` to the location where the JDBC drivers are + installed using CLASSPATH separator in the TCK runner. + d. Set `jdbc.db` to the name of the database under test. Valid values + include: ++ +-- +[source,oac_no_warn] +---- +derby +mysql +sybase +db2 +mssqlserver +oracle +postgresql +---- +-- ++ + e. Set `jakarta.persistence.provider`, `jakarta.persistence.jdbc.driver`, + `jakarta.persistence.jdbc.url`, `jakarta.persistence.jdbc.user`, and + `jakarta.persistence.jdbc.password` to the appropriate values for the + database and persistence provider under test. + + These properties are passed to the Persistence provider during the + creation of the `EntityManagerFactory`. Any additional values, for + example setting an implementation's logging level, must be set by + following the instructions in Step 2e. + f. Set the `jpa.provider.implementation.specific.properties` property + to include any implementation-specific settings that need to be passed + to the provider when the `EntityManagerFactory` is created. + g. Set `sigTestClasspath` to include any additional classes not + specified with the `jpa.classes` property. + h. Set db.supports.sequence to false if the database does not support + the use of SEQUENCE. + + The default value is true. + i. Set `persistence.second.level.caching.supported` to false if your + persistence provider does not support second level caching. + + The default value is true. ++ +3. If you are using MySQL or MS SQL Server, do the following: + a. If you are using MySQL, see link:#GJLIB[Section 4.3.1, "Setup + Considerations for MySQL,"] and proceed to Step 4. + b. If you are using MS SQL Server, see link:#GJLHU[Section 4.3.2, "Setup + Considerations for MS SQL Server,"] and proceed to Step 4. ++ +4. Start the database under test. +5. Initialize the database under test. Execute following SQL scripts for database initilization: + a. .ddl.persistence.sql + b. .ddl.persistence.sprocs.sql + + +[[GCLHU]][[configuring-your-environment-to-repackage-and-run-the-tck-against-the-vendor-implementation]] + +4.2 Configuring Your Environment to Repackage and Run the TCK Against the Vendor Implementation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +[NOTE] +======================================================================= + +In these instructions, variables in angle brackets need to be expanded +for each platform. For example, `` becomes `$JAVA_HOME` on +Solaris/Linux and `%JAVA_HOME%` on Windows. In addition, the forward +slashes (`/`) used in all of the examples need to be replaced with +backslashes (`\`) for Windows. Finally, be sure to use the appropriate +separator for your operating system when specifying multiple path +entries (`;` on Windows, `:` on UNIX/Linux). + +On Windows, you must escape any backslashes with an extra backslash in +path separators used in any of the following properties, or use forward +slashes as a path separator instead. + +======================================================================= + +Adapt the instructions above as appropriate for your implementation. + + +[[GHGDG]][[setup-considerations]] + +4.3 Setup Considerations +~~~~~~~~~~~~~~~~~~~~~~~~ + + +[[GJLIB]][[setup-considerations-for-mysql]] + +=== 4.3.1 Setup Considerations for MySQL + +The {TechnologyFullName} tests require delimited identifiers for +the native query tests. If you are using delimited identifiers on MySQL, +modify the `sql-mode` setting in the `my.cnf` file to set the +ANSI_QUOTES option. After setting this option, reboot the MySQL server. +Set the option as shown in this example: + +[source,oac_no_warn] +---- +sql-mode= + "STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION,ANSI_QUOTES" +---- + +[[GJLHU]][[setup-considerations-for-ms-sql-server]] + +=== 4.3.2 Setup Considerations for MS SQL Server + +If your database already exists and if you use a case-sensitive +collation on MS SQL Server, execute the following command to modify the +database and avert errors caused by case-sensitive collation: + +[source,oac_no_warn] +---- +ALTER DATABASE ctsdb COLLATE Latin1_General_CS_AS ; +---- + diff --git a/user_guides/websocket/src/main/jbake/content/debug-tips.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/debug-tips.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/debug-tips.inc rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/debug-tips.inc diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/debug.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/debug.adoc new file mode 100644 index 0000000000..8375911a31 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/debug.adoc @@ -0,0 +1,70 @@ +include::attributes.conf[] + +[[GBFUV]] + + +[[debugging-test-problems]] +6 Debugging Test Problems +------------------------- + +There are a number of reasons that tests can fail to execute properly. +This chapter provides some approaches for dealing with these failures. + +This chapter includes the following topics: + +* link:#GBFYP[Overview] +* link:#GBFVF[Test Information] +* link:#GBFWI[Configuration Failures] + + +[[GBFYP]][[overview]] + +6.1 Overview +~~~~~~~~~~~~ + +The goal of a test run is for all tests in the test suite that are not +filtered out to have passing results. If the root test suite folder +contains tests with errors or failing results, you must troubleshoot and +correct the cause to satisfactorily complete the test run. + +* Errors: Tests with errors could not be executed by the Junit +framework. These errors usually occur because the test environment is not +properly configured. +* Failures: Tests that fail were executed but had failing results. + + +For every test run, the Junit framework creates a set of report files +in the target directory. + +[NOTE] +======================================================================= + +You can set `junit.log.traceflag=true` as System property to +get more debugging information. + +======================================================================= + +If a large number of tests failed, you should read +link:#GBFYF[Configuration Failures] to see if a +configuration issue is the cause of the failures. + + +[[GBFVF]][[test-information]] + +6.2 Test Information +~~~~~~~~~~~~~~~~~~~~ + +If you need more information to identify the cause of the error or +failure, use the Junit reports generated after running the tests. + + +[[GBFWI]][[configuration-failures]] + +6.3 Configuration Failures +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Configuration failures are easily recognized because many tests fail the +same way. When all your tests begin to fail, you may want to stop the +run immediately and start viewing individual test output. + +include::debug-tips.inc[] diff --git a/user_guides/websocket/src/main/jbake/content/defns.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/defns.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/defns.inc rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/defns.inc diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/faq.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/faq.adoc new file mode 100644 index 0000000000..79e2325b6d --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/faq.adoc @@ -0,0 +1,46 @@ +include::attributes.conf[] + +[[GBFYD]] + + +[[a-frequently-asked-questions]] +A Frequently Asked Questions +---------------------------- + +This appendix contains the following questions. + +* link:#GBFYQ[Where do I start to debug a test failure?] +* link:#GBFYR[How do I restart a crashed test run?] +* link:#GBFWU[What would cause tests be added to the exclude list?] + +[[GBFYQ]][[a.1-where-do-i-start-to-debug-a-test-failure]] + +A.1 Where do I start to debug a test failure? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +See link:debug.html#GBFUV[Chapter 6, "Debugging Test Problems,"] for more +information. + +[[GBFYR]][[a.2-how-do-i-restart-a-crashed-test-run]] + +A.2 How do I restart a crashed test run? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +If you need to restart a test run, you can figure out which test crashed +the test suite by looking at the logs. + +[[GBFWU]][[a.3-what-would-cause-tests-be-added-to-the-exclude-list]] + +A.3 What would cause tests be added to the exclude list? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The exclude file (+{excludeListFileName}+) contains all tests that are not +required to be run. The file is used only for documentation purpose. The tests are excluded using +@Disabled tag in Junit when necessary. The following is a list of reasons for a test to be +included in the Exclude List: + +* An error in a Compatible Implementation that does not allow the test to +execute properly has been discovered. +* An error in the specification that was used as the basis of the test +has been discovered. +* An error in the test has been discovered. diff --git a/user_guides/websocket/src/main/jbake/content/intro.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install-server-vi.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/intro.inc rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install-server-vi.inc diff --git a/user_guides/websocket/src/main/jbake/content/using.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install-server.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/using.inc rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install-server.inc diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install.adoc new file mode 100644 index 0000000000..107a8ad9a0 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/install.adoc @@ -0,0 +1,71 @@ +include::attributes.conf[] + +[[GBFTP]] + + +[[installation]] +3 Installation +-------------- + +This chapter explains how to install the {TechnologyFullName} TCK software. + +After installing the software according to the instructions in this +chapter, proceed to link:config.html#GBFVV[Chapter 4, "Setup and +Configuration,"] for instructions on configuring your test environment. + +[[GBFUD]][[obtaining-the-reference-implementation]] + +3.1 Obtaining a Compatible Implementation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Each compatible implementation (CI) will provide instructions for obtaining +their implementation. +{TechnologyRI} is a compatible implementation which may be obtained +from {TechnologyRIURL} + +[[GBFTS]][[installing-the-software]] + +3.2 Installing the Software +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Before you can run the {TechnologyShortName} TCK tests, you must +install and set up the following software components: + +include::req-software.inc[] +* Java SE {SEversion} +* Apache Maven {MavenVersion} +* A CI for {TechnologyShortName} {TechnologyVersion}, one example is {TechnologyRI} +* {TechnologyShortName} TCK version {TechnologyVersion}, which includes: +include::tck-packages.inc[] +* The {TechnologyShortName} {TechnologyVersion} Vendor Implementation (VI) + +Follow these steps: + +. Install the Java SE {SEversion} software, if it is not already installed. + +Download and install the Java SE {SEversion} software from +http://www.oracle.com/technetwork/java/javase/downloads/index.html. +Refer to the installation instructions that accompany the software for +additional information. +. Install the Apache Maven {MavenVersion} software, if it is not already installed. + +Download and install Apache MAven {MavenVersion} software from Apache Maven +Project. +. Install the {TechnologyShortName} TCK {TechnologyVersion} software. + a. Copy or download the {TechnologyShortName} TCK software to your + local system. + + You can obtain the {TechnologyShortName} TCK software from the + Jakarta EE site {SpecificationURL}. + b. Use the `unzip` command to extract the bundle in the directory of + your choice: + + +unzip {TCKPackageName}+ + +include::install-server.inc[] +. Install a {TechnologyShortName} {TechnologyVersion} Compatible +Implementation. + +A Compatible Implementation is used to validate your initial +configuration and setup of the {TechnologyShortName} TCK +{TechnologyVersion} tests, which are explained further in +link:config.html#GBFVV[Chapter 4, "Setup and Configuration."] + +The Compatible Implementations for {TechnologyShortName} are listed on +the Jakarta EE Specifications web site: {SpecificationURL}. +include::install-server-vi.inc[] +. Install the {TechnologyShortName} VI to be tested. + +Follow the installation instructions for the particular VI under test. diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/intro.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/intro.adoc new file mode 100644 index 0000000000..cec7109781 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/intro.adoc @@ -0,0 +1,283 @@ +include::attributes.conf[] + +[[GBFOW]] + + +[[introduction]] +1 Introduction +-------------- + +This chapter provides an overview of the principles that apply +generally to all Technology Compatibility Kits (TCKs) and describes the +{TechnologyFullName} TCK ({TechnologyShortName} {TechnologyVersion} TCK). +It also includes a high level listing +of what is needed to get up and running with the {TechnologyShortName} +TCK. + +This chapter includes the following topics: + +* link:#GBFTK[Compatibility Testing] +* link:#GBFQR[About the TCK] +* link:#GBFQW[Getting Started With the TCK] + +[[GBFTK]][[compatibility-testing]] + +1.1 Compatibility Testing +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Compatibility testing differs from traditional product testing in a +number of ways. The focus of compatibility testing is to test those +features and areas of an implementation that are likely to differ across +other implementations, such as those features that: + +* Rely on hardware or operating system-specific behavior +* Are difficult to port +* Mask or abstract hardware or operating system behavior + +Compatibility test development for a given feature relies on a complete +specification and compatible implementation (CI) for that feature. +Compatibility testing is not primarily concerned with robustness, +performance, nor ease of use. + +[[GBFQN]][[why-compatibility-testing-is-important]] + +1.1.1 Why Compatibility Testing is Important +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Jakarta platform compatibility is important to different groups involved +with Jakarta technologies for different reasons: + +* Compatibility testing ensures that the Jakarta platform does not become +fragmented as it is ported to different operating systems and hardware +environments. +* Compatibility testing benefits developers working in the Jakarta +programming language, allowing them to write applications once and then +to deploy them across heterogeneous computing environments without +porting. +* Compatibility testing allows application users to obtain applications +from disparate sources and deploy them with confidence. +* Conformance testing benefits Jakarta platform implementors by ensuring a +level playing field for all Jakarta platform ports. + +[[GBFPR]][[tck-compatibility-rules]] + +1.1.2 TCK Compatibility Rules +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Compatibility criteria for all technology implementations are embodied +in the TCK Compatibility Rules that apply to a specified technology. +Each TCK tests for adherence to these Rules as described in +link:rules.html#GBFSN[Chapter 2, "Procedure for Certification."] + +[[GBFPW]][[tck-overview]] + +1.1.3 TCK Overview +^^^^^^^^^^^^^^^^^^ + +A TCK is a set of tools and tests used to verify that a vendor's compatible +implementation of a Jakarta EE technology conforms to the applicable +specification. All tests in the TCK are based on the written +specifications for the Jakarta EE platform. A TCK tests compatibility of a +vendor's compatible implementation of the technology to the applicable +specification of the technology. Compatibility testing is a means of +ensuring correctness, completeness, and consistency across all +implementations developed by technology licensees. + +The set of tests included with each TCK is called the test suite. Most +tests in a TCK's test suite are self-checking, but some tests may +require tester interaction. Most tests return either a Pass or Fail +status. For a given platform to be certified, all of the required tests +must pass. The definition of required tests may change from platform to +platform. + +The definition of required tests will change over time. Before your +final certification test pass, be sure to download the latest version +of this TCK. + +[[GBFPB]][[java-community-process-jcp-program-and-compatibility-testing]] + +1.1.4 Jakarta EE Specification Process (JESP) Program and Compatibility Testing +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The Jakarta EE Specification Process (JESP) program is the formalization of the +open process that has been used since 2019 to develop and revise Jakarta EE +technology specifications in cooperation with the international Jakarta EE +community. The JESP program specifies that the following three major +components must be included as deliverables in a final Jakarta EE technology +release under the direction of the responsible Expert Group: + +* Technology Specification +* Compatible Implementation (CI) +* Technology Compatibility Kit (TCK) + +For further information about the JESP program, go to Jakarta EE Specification +Process community page https://jakarta.ee/specifications. + +[[GBFQR]][[about-the-tck]] + +1.2 About the TCK +~~~~~~~~~~~~~~~~~ + +The {TechnologyShortName} TCK {TechnologyVersion} is designed as a +portable, configurable, automated test suite for verifying the +compatibility of a vendor's implementation of the +{TechnologyShortName} {TechnologyVersion} Specification. + +[[GBFQV]][[tck-specifications-and-requirements]] + +1.2.1 TCK Specifications and Requirements +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +This section lists the applicable requirements and specifications. + +* Specification Requirements: Software requirements for a +{TechnologyShortName} implementation are described in detail in the +{TechnologyShortName} {TechnologyVersion} Specification. Links to the +{TechnologyShortName} specification and other product information can +be found at {SpecificationURL}. +* {TechnologyShortName} Version: The {TechnologyShortName} {TechnologyVersion} TCK +is based on the {TechnologyShortName} +Specification, Version {TechnologyVersion}. +* Compatible Implementation: One {TechnologyShortName} +{TechnologyVersion} Compatible Implementation, {TechnologyRI} is +available from the Eclipse EE4J project +(https://projects.eclipse.org/projects/ee4j). See the CI documentation page at +{TechnologyRIURL} for more information. + +See the {TechnologyShortName} TCK Release Notes for more specific +information about Java SE version requirements, supported platforms, +restrictions, and so on. + +[[GBFSQ]][[tck-components]] + +1.2.2 TCK Components +^^^^^^^^^^^^^^^^^^^^ + +The {TechnologyShortName} TCK {TechnologyVersion} includes the +following components: + +* {TechnologyShortName} TCK signature tests; check that all public APIs +are supported and/or defined as specified in the {TechnologyShortName} +Version {TechnologyVersion} implementation under test. +* If applicable, an exclude list, which provides a list of tests that your +implementation is not required to pass. +ifndef::no-api-tests[] +* API tests for all of the {TechnologyShortName} API in all related packages: +include::packages.inc[] +endif::no-api-tests[] +ifdef::end-to-end-tests[] +* End-to-end tests that demonstrate compliance with the {TechnologyFullName} +Specification. +endif::end-to-end-tests[] + +The {TechnologyShortName} TCK tests run on the following platforms: + +include::platforms.inc[] + +[[GBFRA]][[tck-compatibility-test-suite]] + +1.2.3 TCK Compatibility Test Suite +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The test suite is the collection of tests +to test a particular technology implementation. In this case, it is the +collection of JUnit tests used by the {TechnologyShortName} TCK +{TechnologyVersion} to test a {TechnologyShortName} {TechnologyVersion} +implementation. The tests are designed to verify that a vendor's +runtime implementation of the technology complies with the appropriate +specification. The individual tests correspond to assertions of the +specification. + +The tests that make up the TCK compatibility test suite are precompiled +and indexed within the TCK jar directory structure. + +[[GBFSH]][[exclude-lists]] + +1.2.4 Exclude Lists +^^^^^^^^^^^^^^^^^^^ + +Each version of a TCK includes an Exclude List contained in a `TCK-Exclude-List.txt` +file. +This is a list of test file URLs that identify tests which do not +have to be run for the specific version of the TCK being used. +Whenever tests are run, the Junit framework automatically excludes +these tests from being executed as those are disabled using '@Disabled' tag in JUnit. + +A vendor's compatible implementation is not required to pass or run any test on the Exclude List. +The Exclude List file, +{excludeListFileName}+, is documented in the +{TechnologyShortName} TCK. Please note this file is not parsed to exclude any test and is only +for documentation purpose. + + + +[NOTE] +======================================================================= + +From time to time, updates to the Exclude List are made available. +The exclude list is included in the Jakarta TCK ZIP archive. +Each time an update is approved and released, the version number +will be incremented. +You should always make sure you are using an up-to-date copy of the +Exclude List before running the {TechnologyShortName} TCK to verify your +implementation. + +======================================================================= + + +A test might be in the Exclude List for reasons such as: + +* An error in an underlying implementation API has been discovered which +does not allow the test to execute properly. +* An error in the specification that was used as the basis of the test +has been discovered. +* An error in the test itself has been discovered. +* The test fails due to a bug in the tools used to run the test. + +In addition, all tests are run against the compatible implementations. +Any tests that fail when run on a compatible Jakarta platform are put on the +Exclude List. Any test that is not specification-based, or for which the +specification is vague, may be excluded. Any test that is found to be +implementation dependent (based on a particular thread scheduling model, +based on a particular file system behavior, and so on) may be excluded. + + +[NOTE] +======================================================================= + +Vendors are not permitted to alter or modify Exclude Lists. Changes to +an Exclude List can only be made by using the procedure described in +link:rules.html#CJAJEAEI[Section 2.3.1, "TCK Test Appeals Steps."] + +======================================================================= + + +[[GBFRR]][[tck-configuration]] + +1.3 Getting Started With the TCK +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This section provides an general overview of what needs to be done to +install, set up, test, and use the {TechnologyShortName} TCK. These +steps are explained in more detail in subsequent chapters of this +guide. + +1. Make sure that the following software has been correctly installed +on the system: +include::req-software.inc[] +* Java SE {SEversion} +* Apache Maven {MavenVersion} +* A CI for {TechnologyShortName} {TechnologyVersion}. One example is {TechnologyRI}. +* {TechnologyShortName} TCK version {TechnologyVersion}, which includes: +include::tck-packages.inc[] +* The {TechnologyShortName} {TechnologyVersion} Vendor Implementation (VI) + +See the documentation for each of these software applications for +installation instructions. See link:install.html#GBFTP[Chapter 3, +"Installation,"] for instructions on installing the {TechnologyShortName} TCK. +2. Set up the {TechnologyShortName} TCK software. + +See link:config.html#GBFVV[Chapter 4, "Setup and Configuration,"] for +details about the following steps. + a. Set up your shell environment. + b. Set the required System properties. +3. Test the {TechnologyShortName} {TechnologyVersion} implementation. + +Test the {TechnologyShortName} implementation installation by running +the test suite. See link:using.html#GBFWO[Chapter 5, "Executing Tests."] diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/intro.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/intro.inc new file mode 100644 index 0000000000..94840b5113 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/intro.inc @@ -0,0 +1,20 @@ + +[[GEQNJ]][[additional-jpa-notes]] + +1.2.7 Additional {TechnologyShortName} Notes +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +In addition to the usual signature, API, and end-to-end tests, +the {TechnologyShortName} TCK also includes pluggability tests verify that the +implementation under test can use third-party persistence providers +instead of the one provided by the implementation. + +[NOTE] +======================================================================= + +The following may be useful to users of previous TCK versions: + +No significant changes were made to how tests are run. + +======================================================================= + diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/packages.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/packages.inc new file mode 100644 index 0000000000..c3b95243e1 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/packages.inc @@ -0,0 +1,7 @@ +** `jakarta.persistence` + +** `jakarta.persistence.criteria` + +** `jakarta.persistence.metamodel` + +** `jakarta.persistence.spi` diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/platforms.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/platforms.inc new file mode 100644 index 0000000000..3f54158cb4 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/platforms.inc @@ -0,0 +1,4 @@ +/////////////////////////////////////////////////////////////////////// +List tested operating environments here +/////////////////////////////////////////////////////////////////////// +* CentOS Linux 7 \ No newline at end of file diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/preface.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/preface.adoc new file mode 100644 index 0000000000..0526714cac --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/preface.adoc @@ -0,0 +1,134 @@ +include::attributes.conf[] + +[[TCJRS00001]][[GBFTI]] + + +[[preface]] +Preface +------- + +This guide describes how to install, configure, and run the Technology +Compatibility Kit (TCK) that is used to test the {TechnologyFullName} +({TechnologyShortName} {TechnologyVersion}) technology. + +The {TechnologyShortName} TCK is a portable, configurable automated +test suite for verifying the compatibility of a vendor's +implementation of the {TechnologyShortName} {TechnologyVersion} +Specification (hereafter referred to as the vendor implementation or VI). +The {TechnologyShortName} TCK uses the Junit framework to run the test suite +along with Arquillian to run container tests. + + +[NOTE] +======================================================================= + +Note All references to specific Web URLs are given for the sake of your +convenience in locating the resources quickly. These references are +always subject to changes that are in many cases beyond the control of +the authors of this guide. + +======================================================================= + +Jakarta EE is a community sponsored and community run program. +Organizations contribute, along side individual contributors who use, evolve +and assist others. +Commercial support is not available through the Eclipse Foundation resources. +Please refer to the Eclipse EE4J project site +(https://projects.eclipse.org/projects/ee4j). +There, you will find additional details as well as a list of all the associated sub-projects +(Implementations and APIs), that make up Jakarta EE and define these specifications. +If you have questions about this Specification you may +send inquiries to {SpecificationInquiryList}. +If you have questions about this TCK, you may send inquiries to +{TCKInquiryList}. + +[[TCJRS00034]][[GBFUS]] + + +[[who-should-use-this-book]] +Who Should Use This Book +~~~~~~~~~~~~~~~~~~~~~~~~ + +This guide is for vendors that implement the {TechnologyShortName} +{TechnologyVersion} technology to assist them in running the test suite +that verifies compatibility of their implementation of the +{TechnologyShortName} {TechnologyVersion} Specification. + + +[[TCJRS00035]][[GBFPO]] + + +[[before-you-read-this-book]] +Before You Read This Book +~~~~~~~~~~~~~~~~~~~~~~~~~ + +You should be familiar with the {TechnologyShortName} +{TechnologyVersion}, version {TechnologyVersion} Specification, +which can be found at {SpecificationURL}. + +[[TCJRS00036]][[GBFWF]] + + +[[typographic-conventions]] +Typographic Conventions +~~~~~~~~~~~~~~~~~~~~~~~ + +The following table describes the typographic conventions that are used +in this book. + +[width="100%",cols="15%,40%,45%",options="header",] +|======================================================================= +|Convention |Meaning |Example +|*Boldface* |Boldface type indicates graphical user interface elements +associated with an action, terms defined in text, or what you type, +contrasted with onscreen computer output. a| +From the *File* menu, select *Open Project*. + +A *cache* is a copy that is stored locally. + +`machine_name% *su*` + +`Password:` + +|`Monospace` |Monospace type indicates the names of files and +directories, commands within a paragraph, URLs, code in examples, text +that appears on the screen, or text that you enter. a| +Edit your `.login` file. + +Use `ls` `-a` to list all files. + +`machine_name% you have mail.` + +|_Italic_ |Italic type indicates book titles, emphasis, or placeholder +variables for which you supply particular values. a| +Read Chapter 6 in the _User's Guide_. + +Do _not_ save the file. + +The command to remove a file is `rm` _filename_. + +|======================================================================= + + +[[TCJRS00037]][[FWBSD]] + + +[[shell-prompts-in-command-examples]] +Shell Prompts in Command Examples +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following table shows the default UNIX system prompt and superuser +prompt for the C shell, Bourne shell, and Korn shell. + +[width="100%",cols="50%,50%",options="header",] +|===================================================== +|Shell |Prompt +|C shell |`machine_name%` +|C shell for superuser |`machine_name#` +|Bourne shell and Korn shell |`$` + +|Bourne shell and Korn shell for superuser |`#` + +|Bash shell |`shell_name-shell_version$` +|Bash shell for superuser |`shell_name-shell_version#` +|===================================================== + + + diff --git a/user_guides/websocket/src/main/jbake/content/rebuild.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rebuild.adoc similarity index 58% rename from user_guides/websocket/src/main/jbake/content/rebuild.adoc rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rebuild.adoc index e4021cfa19..a986191f51 100644 --- a/user_guides/websocket/src/main/jbake/content/rebuild.adoc +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rebuild.adoc @@ -1,13 +1,5 @@ -type=page -status=published -title=Appendix B: Rebuild Rules -prev=faq.html -~~~~~~ include::attributes.conf[] -Appendix B: Rebuild Rules -========================= - ifdef::rebuild[] include::rebuild.inc[] diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rebuild.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rebuild.inc new file mode 100644 index 0000000000..6f4297bb1b --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rebuild.inc @@ -0,0 +1,7 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +The following sections should be customized for the technology. +See JAXRS user guide for an example of this include file. +/////////////////////////////////////////////////////////////////////// + +[[GCLIZ]] diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/req-software.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/req-software.inc new file mode 100644 index 0000000000..48014f56ee --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/req-software.inc @@ -0,0 +1,10 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +This is a list of software required in addition to the TCK and the RI. +For many Java EE APIs, the Java EE RI will be required, as described below. +For standalone technologies, no other software may be required, and the +below line can be removed. + +This is used in intro.adoc in section 1.3 and install.adoc in section 3.2. +/////////////////////////////////////////////////////////////////////// + diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rules.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rules.adoc new file mode 100644 index 0000000000..75917e65bb --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rules.adoc @@ -0,0 +1,369 @@ +include::attributes.conf[] + +[[GBFSN]] + + +[[procedure-for-certification]] +2 Procedure for Certification +----------------------------- + +This chapter describes the compatibility testing procedure and +compatibility requirements for {TechnologyFullName}. +This chapter contains the following sections: + +* link:#CJAFFDGI[Certification Overview] +* link:#CJAFGIGG[Compatibility Requirements] +* link:#CJAIIBDJ[Test Appeals Process] +* link:#CJAJECIE[Specifications for {TechnologyFullName}] +* link:#CJABAHGI[Libraries for {TechnologyFullName}] + +[[CJAFFDGI]][[certification-overview]] + +2.1 Certification Overview +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The certification process for {technologyShortName} {TechnologyVersion} +consists of the following activities: + +* Install the appropriate version of the Technology Compatibility Kit +(TCK) and execute it in accordance with the instructions in this User's +Guide. +* Ensure that you meet the requirements outlined in +link:#CJAFGIGG[Compatibility Requirements] below. +* Certify to the Eclipse Foundation that you have finished +testing and that you meet all of the compatibility requirements, +as required by the Eclipse Foundation TCK License. + +[[CJAFGIGG]][[compatibility-requirements]] + +2.2 Compatibility Requirements +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The compatibility requirements for {TechnologyShortName} +{TechnologyVersion} consist of meeting the requirements set forth by +the rules and associated definitions contained in this section. + +[[sthref4]][[definitions]] + +2.2.1 Definitions +^^^^^^^^^^^^^^^^^ + +These definitions are for use only with these compatibility requirements +and are not intended for any other purpose. + +[[sthref5]][[sthref6]] + +Table 2-1 Definitions  + +[width="100%",cols="25%,75%",options="header",] +|======================================================================= +|Term |Definition +|API Definition Product |A Product for which the only Java class files +contained in the product are those corresponding to the application +programming interfaces defined by the Specifications, and which is +intended only as a means for formally specifying the application +programming interfaces defined by the Specifications. + +|Computational Resource a| +A piece of hardware or software that may vary in quantity, existence, or +version, which may be required to exist in a minimum quantity and/or at +a specific or minimum revision level so as to satisfy the requirements +of the Test Suite. + +Examples of computational resources that may vary in quantity are RAM +and file descriptors. + +Examples of computational resources that may vary in existence (that is, +may or may not exist) are graphics cards and device drivers. + +Examples of computational resources that may vary in version are +operating systems and device drivers. + +|Configuration Descriptor |Any file whose format is well defined by a +specification and which contains configuration information for a set of +Java classes, archive, or other feature defined in the specification. + +|Conformance Tests |All tests in the Test Suite for an indicated +Technology Under Test, as released and distributed by the +Eclipse Foundation, excluding those tests on the +published Exclude List for the Technology Under Test. + +|Container |An implementation of the associated Libraries, as specified +in the Specifications, and a version of a Java Platform, Standard +Edition Runtime Product, as specified in the Specifications, or a later +version of a Java Platform, Standard Edition Runtime Product that also +meets these compatibility requirements. + +|Documented |Made technically accessible and made known to users, +typically by means such as marketing materials, product documentation, +usage messages, or developer support programs. + +|Exclude List |The most current list of tests, released and distributed by the +Eclipse Foundation, that are not required to be passed to certify +conformance. The Jakarta EE Specification Committee may add to the Exclude List for that +Test Suite as needed at any time, in which case the updated TCK version +supplants any previous Exclude Lists for that Test Suite. + +|Libraries a| +The class libraries, as specified through the Jakarta EE Specification Process +(JESP), for the Technology Under Test. + +The Libraries for {TechnologyFullName} are listed at the end of this chapter. + +|Location Resource a| +A location of classes or native libraries that are components of the +test tools or tests, such that these classes or libraries may be +required to exist in a certain location in order to satisfy the +requirements of the test suite. + +For example, classes may be required to exist in directories named in a +CLASSPATH variable, or native libraries may be required to exist in +directories named in a PATH variable. + +|Maintenance Lead |The corresponding Jakarta EE Specification Project +is responsible for maintaining the Specification, and the TCK for the +Technology. The Specification Project Team will propose revisions and +updates to the Jakarta EE Specification Committee which will approve +and release new versions of the specification and TCK. + +|Operating Mode a| +Any Documented option of a Product that can be changed by a user in +order to modify the behavior of the Product. + +For example, an Operating Mode can be binary (enable/disable +optimization), an enumeration (select from a list of protocols), or a +range (set the maximum number of active threads). + +Note that an Operating Mode may be selected by a command line switch, an +environment variable, a GUI user interface element, a configuration or +control file, etc. + +|Product |A vendor's product in which the Technology Under Test is +implemented or incorporated, and that is subject to compatibility +testing. + +|Product Configuration a| +A specific setting or instantiation of an Operating Mode. + +For example, a Product supporting an Operating Mode that permits user +selection of an external encryption package may have a Product +Configuration that links the Product to that encryption package. + +|Rebuildable Tests |Tests that must be built using an +implementation-specific mechanism. This mechanism must produce +specification-defined artifacts. Rebuilding and running these tests +against a known compatible implementation verifies that the mechanism generates +compatible artifacts. + +|Resource |A Computational Resource, a Location Resource, or a Security +Resource. + +|Rules |These definitions and rules in this Compatibility Requirements +section of this User's Guide. + +|Runtime |The Containers specified in the Specifications. + +|Security Resource a| +A security privilege or policy necessary for the proper execution of the +Test Suite. + +For example, the user executing the Test Suite will need the privilege +to access the files and network resources necessary for use of the +Product. + +|Specifications a| +The documents produced through the Jakarta EE Specification Process (JESP) +that define a particular Version of a Technology. + +The Specifications for the Technology Under Test are referenced later in +this chapter. + +|Technology |Specifications and one or more compatible implementations produced +through the Jakarta EE Specification Process (JESP). + +|Technology Under Test |Specifications and a compatible implementation +for {TechnologyFullName} Version {TechnologyVersion}. + +|Test Suite |The requirements, tests, and testing tools distributed by +the Maintenance Lead as applicable to a given Version of the Technology. + +|Version |A release of the Technology, as produced through the +Jakarta EE Specification Process (JESP). + +include::defns.inc[] +|======================================================================= + + +[[sthref7]][[rules-for-products]] + +2.2.2 Rules for {TechnologyFullName} Products +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The following rules apply for each implementation: + +*{techID}1* The implementation must be able to satisfy compatibility +requirements, including passing all required TCK Tests. + +*{techID}1.1* Each implementation must have at least one configuration that can be used to pass +all required TCK Tests, although such configuration may need adjustment (e.g. whether statically +or via administrative tooling). + +*{techID}1.2* An API Definition Product is exempt from all functional +testing requirements defined here, except the signature tests. + +*{techID}2* Some Conformance Tests may have properties that may be changed. +Properties that can be changed are identified in the configuration +interview. Apart from changing such properties and other allowed +modifications described in this User's Guide (if any), no source or +binary code for a Conformance Test may be altered in any way without +prior written permission. Any such allowed alterations to the +Conformance Tests will be provided via the Jakarta EE Specification Project +website and apply to all vendor compatible implementations. + +*{techID}3* The testing tools supplied as part of the Test Suite or as +updated by the Maintenance Lead must be used to certify compliance. + +*{techID}4* The Exclude List associated with the Test Suite cannot be +modified. + +*{techID}5* The Maintenance Lead can define exceptions to these Rules. Such +exceptions would be made available as above, and will apply to all vendor implementations. + +*{techID}6* All hardware and software component additions, deletions, and +modifications to a Documented supporting hardware/software platform, +that are not part of the Product but required for the Product to satisfy +the compatibility requirements, must be Documented and available to +users of the Product. + +*{techID}7* The Product must contain the full set of public and protected +classes and interfaces for all the Libraries. Those classes and +interfaces must contain exactly the set of public and protected methods, +constructors, and fields defined by the Specifications for those +Libraries. No subsetting, supersetting, or modifications of the public +and protected API of the Libraries are allowed except only as +specifically exempted by these Rules. + +*{techID}7.1* If a Product includes Jakarta EE Technologies in addition to the +Technology Under Test, then it must contain the full set of combined +public and protected classes and interfaces. The API of the Product +must contain the union of the included Technologies. No further +modifications to the APIs of the included Technologies are allowed. + +ifdef::subset-allowed[] +*{techID}7.2* The Product may contain a subset of the classes and +interfaces for the Libraries. +endif::subset-allowed[] + +*{techID}8* Except for tests specifically required by this TCK to be rebuilt +(if any), the binary Conformance Tests supplied as part of the Test +Suite or as updated by the Maintenance Lead must be used to certify +compliance. + +*{techID}9* The functional programmatic behavior of any binary class or +interface must be that defined by the Specifications. + +include::rules.inc[] + +[[CJAIIBDJ]][[test-appeals-process]] + +2.3 Test Appeals Process +~~~~~~~~~~~~~~~~~~~~~~~~ + +Refer to https://jakarta.ee/committees/specification/tckprocess (version 1.4.1) as the definitive source for +the TCK rules. + +Jakarta has a well established process for managing challenges to its +TCKs. Any implementor may submit a challenge to one or more tests in the +{TechnologyShortName} TCK as it relates to their implementation. Implementor +means the entity as a whole in charge of producing the final certified release. +*Challenges filed should represent the consensus of that entity*. + +2.3.1 Valid Challenges +^^^^^^^^^^^^^^^^^^^^^^ +Any test case (e.g., test class, @Test method), test case configuration (e.g., deployment descriptor), test beans, annotations, and other resources considered part of the TCK may be challenged. + +The following scenarios are considered in scope for test challenges: + +* Claims that a test assertion conflicts with the specification. +* Claims that a test asserts requirements over and above that of the specification. +* Claims that an assertion of the specification is not sufficiently implementable. +* Claims that a test is not portable or depends on a particular implementation. + +2.3.2 Invalid Challenges +^^^^^^^^^^^^^^^^^^^^^^^^ +The following scenarios are considered out of scope for test challenges and will be immediately closed if filed: + +* Challenging an implementation’s claim of passing a test. Certification is an honor system and these issues must be raised directly with the implementation. +* Challenging the usefulness of a specification requirement. The challenge process cannot be used to bypass the specification process and raise in question the need or relevance of a specification requirement. +* Claims the TCK is inadequate or missing assertions required by the specification. See the Improvement section, which is outside the scope of test challenges. +* Challenges that do not represent a consensus of the implementing community will be closed until such time that the community does agree or agreement cannot be made. The test challenge process is not the place for implementations to initiate their own internal discussions. +* Challenges to tests that are already excluded for any reason. +* Challenges that an excluded test should not have been excluded and should be re-added should be opened as a new enhancement request + +Test challenges must be made in writing via the {TechnologyShortName} specification project issue tracker +as described in link:#CJAJEAEI[Section 2.3.3, "TCK Test Appeals Steps."] + +All tests found to be invalid will be placed on the Exclude List +for that version of the {TechnologyShortName} TCK. + + +[[CJAJEAEI]][[tck-test-appeals-steps]] + +2.3.3 TCK Test Appeals Steps +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +1. Challenges should be filed via the {TechnologyFullName} specification project’s issue tracker using the label `challenge` and include the following information: +* The relevant specification version and section number(s) +* The coordinates of the challenged test(s) +* The exact TCK and exclude list versions +* The implementation being tested, including name and company +* The full test name +* A full description of why the test is invalid and what the correct behavior is believed to be +* Any supporting material; debug logs, test output, test logs, run scripts, etc. + + + +2. Specification project evaluates the challenge. + +Challenges can be resolved by a specification project lead, or a project challenge triage team, after a consensus of the specification project committers is reached or attempts to gain consensus fails. +Specification projects may exercise lazy consensus, voting or any practice that follows the principles of Eclipse Foundation Development Process. +The expected timeframe for a response is two weeks or less. +If consensus cannot be reached by the specification project for a prolonged period of time, the default recommendation is to exclude the tests and address the dispute in a future revision of the specification. + +3. Accepted Challenges. + +A consensus that a test produces invalid results will result in the exclusion of that test from certification requirements, and an immediate update and release of an official distribution of the TCK including the new exclude list. The associated `challenge` issue must be closed with an `accepted` label to indicate it has been resolved. + +4. Rejected Challenges and Remedy. + +When a`challenge` issue is rejected, it must be closed with a label of `invalid` to indicate it has been rejected. +There appeal process for challenges rejected on technical terms is outlined in Escalation Appeal. +If, however, an implementer feels the TCK challenge process was not followed, an appeal issue should be filed with specification project’s TCK issue tracker using the label `challenge-appeal`. +A project lead should escalate the issue with the Jakarta EE Specification Committee via email (jakarta.ee-spec@eclipse.org). +The committee will evaluate the matter purely in terms of due process. +If the appeal is accepted, the original TCK challenge issue will be reopened and a label of `appealed-challenge` added, along with a discussion of the appeal decision, and the `challenge-appeal` issue with be closed. +If the appeal is rejected, the `challenge-appeal` issue should closed with a label of `invalid`. + +5. Escalation Appeal. + +If there is a concern that a TCK process issue has not been resolved satisfactorily, the +https://www.eclipse.org/projects/dev_process/#6_5_Grievance_Handling[Eclipse Development Process Grievance Handling] procedure should be followed to escalate the resolution. Note that this is not a mechanism to attempt to handle implementation specific issues. + + +[[CJAJECIE]][[specifications-for-technology]] + +2.4 Specifications for {TechnologyFullName} +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The {TechnologyFullName} specification is available from the specification +project web-site: {SpecificationURL}. + +[[CJABAHGI]][[libraries-for-technology]] + +2.5 Libraries for {TechnologyFullName} +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The following is a list of the packages comprising the required class +libraries for {TechnologyShortName} {TechnologyVersion}: + +include::packages.inc[] + +For the latest list of packages, also see: + +{SpecificationURL} diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rules.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rules.inc new file mode 100644 index 0000000000..0bd49dc945 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/rules.inc @@ -0,0 +1,19 @@ + +*{techID}10* The presence of an XML comment in a Configuration +Descriptor, when processed by a Deployment Tool, must not cause the +functional programmatic behavior of the Deployment Tool to vary from +the functional programmatic behavior of the Deployment Tool in the +absence of that comment. + +*{techID}11* The Runtime must report an error when processing a +Configuration Descriptor that does not conform to the Specifications. + +*{techID}12* The presence of an XML comment in a Configuration +Descriptor, when processed by the Runtime, must not cause the +functional programmatic behavior of the Runtime to vary from +the functional programmatic behavior of the Runtime in the +absence of that comment. + +*{techID}13* An error must be reported when processing a configuration +descriptor that includes a {TechnologyFullName} QL expression that does not +conform to the Specifications. diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/tck-packages.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/tck-packages.inc new file mode 100644 index 0000000000..c3b2e63901 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/tck-packages.inc @@ -0,0 +1,6 @@ +** dbprocedures + +** persistence-tck-common + +** persistence-tck-spec-tests + diff --git a/user_guides/websocket/src/main/jbake/content/title.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/title.adoc similarity index 73% rename from user_guides/websocket/src/main/jbake/content/title.adoc rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/title.adoc index 232172d727..50ad1ef81b 100644 --- a/user_guides/websocket/src/main/jbake/content/title.adoc +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/title.adoc @@ -1,14 +1,5 @@ -type=page -status=published -title=TCK User's Guide for Technology Implementors -next=preface.html -prev=toc.html -~~~~~~ include::attributes.conf[] -TCK User's Guide for {TechnologyFullName}, Release {TechnologyVersion} for Jakarta EE -===================================================================================== - [[eclipse-foundation]] Eclipse Foundation ------------------ diff --git a/user_guides/websocket/src/main/jbake/content/title.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/title.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/title.inc rename to tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/title.inc diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using-examples.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using-examples.inc new file mode 100644 index 0000000000..eab3d3b8bb --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using-examples.inc @@ -0,0 +1,50 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +These CLI examples can be customized as necessary. +/////////////////////////////////////////////////////////////////////// + +Start the Junit tests using the following command: + + +-- +[source,oac_no_warn] +---- +mvn verify +---- +-- + +[[GCMCU]] + +Example 5-1 {TechnologyShortName} TCK Signature Tests + +To run the {TechnologyShortName} TCK signature tests, enter the +following commands: + +[source,subs="attributes"] +---- +mvn verify -Dit.test=ee.jakarta.tck.persistence.signaturetest.** +---- + +[[GCMBV]] + + +Example 5-2 Single Test Directory + +To run a single test directory, enter the following commands: + +[source,subs="attributes"] +---- +mvn verify -Dit.test={singleTestDirectoryExample}.** +---- + +[[GCMCA]] + + +Example 5-3 Subset of Test Directories + +To run a subset of test directories, enter the following commands: + +[source,subs="attributes"] +---- +mvn verify -Dit.test={subsetTestDirectoryExample}.** +---- diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using.adoc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using.adoc new file mode 100644 index 0000000000..274ab0ec92 --- /dev/null +++ b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using.adoc @@ -0,0 +1,136 @@ +include::attributes.conf[] + +[[GBFWO]] + + +[[executing-tests]] +5 Executing Tests +----------------- + +The {TechnologyShortName} TCK uses the Junit and Jboss Arquillian +frameworks to execute the tests. + +This chapter includes the following topics: + +* link:#GBFUZ[Starting Test] +* link:#GBFWM[Running a Subset of the Tests] +* link:#GBFVK[Test Reports] + + +[NOTE] +======================================================================= + +The {TechnologyShortName} TCK is not depended on any particular build tool to +run the tests. It will be convenient and advisable to create a +Apache Maven project to setup and run the TCK. This chapter will +henceforth use instructions and steps to provide setup with Apache +Maven as a build tool. + +======================================================================= + +ifdef::rebuild[] +As explained in link:rebuild.html#GCLIZ[Appendix B, "Packaging the +Test Applications in Servlet-Compliant WAR +Files With VI-Specific Information,"] the {TechnologyShortName} TCK +introduces the concept of repackaging the TCK tests. +endif::rebuild[] + + +[[GBFUZ]][[starting-test]] + +5.1 Starting Test +~~~~~~~~~~~~~~~~~ + +The {TechnologyShortName} TCK can be run from the command line +in your shell environment by executing the TCK jar. + + +[NOTE] +======================================================================= + +The `mvn` command referenced in the following +two procedures and elsewhere in this guide is the Apache Maven +build tool, which will need to be downloaded separately. + +======================================================================= + + +[[GBFVW]][[to-start-test-in-command-line-mode]] + +5.1.1 To Start Test in Command-Line Mode +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +include::using-examples.inc[] + +[[GBFWM]][[running-a-subset-of-the-tests]] + +5.2 Running a Subset of the Tests +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Use the following modes to run a subset of the tests: + +* link:#GBFWK[Section 5.2.1, "To Run a Subset of Tests in Command-Line Mode"] + +[[GBFWK]][[to-run-a-subset-of-tests-in-cmd-mode]] + +5.2.1 To Run a Subset of Tests in Command-Line Mode +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + +Start the test run by executing the following command: + + +[source,subs="attributes"] +---- +mvn verify -Dit.test={subsetTestDirectoryExample} +---- + +The tests in the directory and its subdirectories are run. + +[[GCLRR]][[running-the-tck-against-the-ri]] + +5.3 Running the TCK Against another CI +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some test scenarios are designed to ensure that the configuration and deployment of +all the prebuilt {TechnologyShortName} TCK tests against one Compatible +Implementation are successful operating with other compatible implementations, and that the TCK is ready for +compatibility testing against the Vendor and Compatible Implementations. + +1. Verify that you have followed the configuration instructions in +link:config.html#GBFVU[Section 4.1, "Configuring Your Environment to Run +the TCK Against the Compatible Implementation."] +2. If required, verify that you have completed the steps in +link:config.html#GCLIW[Section 4.3.2, "Deploying the Prebuilt Archives."] +3. Run the tests, as described in link:#GBFUZ[Section 5.1, "Starting +the tests,"] and, if desired, link:#GBFWM[Section 5.2, "Running a Subset +of the Tests."] + +[[GCLRZ]][[running-the-tck-against-a-vendors-implementation]] + +5.4 Running the TCK Against a Vendor's Implementation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This test scenario is one of the compatibility test phases that all +Vendors must pass. + +1. Verify that you have followed the configuration instructions in +link:config.html#GCLHU[Section 4.2, "Configuring Your Environment to +Repackage and Run the TCK Against the Vendor Implementation."] +2. If required, verify that you have completed the steps in +link:config.html#GCLIL[Section 4.3.3, "Deploying the +Test Applications Against the Vendor Implementation."] +3. Run the tests, as described in link:#GBFUZ[Section 5.1, "Starting +the tests,"] and, if desired, link:#GBFWM[Section 5.2, "Running a Subset +of the Tests."] + +[[GBFVK]][[test-reports]] + +5.5 Test Reports +~~~~~~~~~~~~~~~~ + +A set of report files is created for every test run. These report files +can be found in the target directory that the test is run. After a test run is +completed, the Junit framework writes reports for the test run. + +include::using.inc[] + diff --git a/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using.inc b/tcks/apis/persistence/persistence-outside-container/docs/userguide/src/main/asciidoc/using.inc new file mode 100644 index 0000000000..e69de29bb2 diff --git a/tcks/apis/websocket/docs/userguide/src/assembly/dist.xml b/tcks/apis/websocket/docs/userguide/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/tcks/apis/websocket/docs/userguide/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/apply_template.sh b/user_guides/apply_template.sh deleted file mode 100755 index dbaf37aaea..0000000000 --- a/user_guides/apply_template.sh +++ /dev/null @@ -1,84 +0,0 @@ -#!/bin/sh -# -# apply_template -# -export TEMPLATE=$PWD/Template/src/main/jbake -SPECS=${SPECS:-`ls -d [a-z]*/. | grep -v jakartaee`} - -update() { - cmp "$1" "$2" > /dev/null || cp "$1" "$2" -} - -for i in $( (cd $TEMPLATE/content; ls *.adoc) ) -do - echo "=== $i ===" - for j in $SPECS - do - echo $j: - update $TEMPLATE/content/$i $j/src/main/jbake/content/$i - done -done - -for i in $( (cd $TEMPLATE/content; ls *.inc) ) -do - echo "=== $i ===" - for j in $SPECS - do - echo $j: - [ -f $j/src/main/jbake/content/$i ] || \ - cp $TEMPLATE/content/$i $j/src/main/jbake/content/$i - done -done - -for i in README -do - echo "=== $i ===" - for j in $SPECS - do - echo $j: - update $TEMPLATE/content/$i $j/src/main/jbake/content/$i - done -done - -echo "=== attributes.conf ===" -for j in $SPECS -do - ( - echo $j: - cd $j/src/main/jbake/content - ( - echo "ed - $TEMPLATE/content/attributes.conf <<'EOF'" - grep '^:' attributes.conf | \ - sed -e 's;:\([a-zA-Z]*\):*\(.*\);g/:\1:/s,.*,:\1:\2,;' - grep '^:JSRURL:' attributes.conf | \ - sed -e 's;:JSRURL:*\(.*\);g/:SpecificationURL:/s,.*,:SpecificationURL:\1,;' - echo 'g/:JavaTestVersion:/s/.*/:JavaTestVersion: 5.0/' - echo w attributes.conf - echo q - echo EOF - ) > /tmp/ed1 - mv attributes.conf attributes.conf- - sh /tmp/ed1 - ) -done - -for i in $(cd $TEMPLATE; ls templates/*.ftl assets/css/*.css assets/img/*.png) -do - echo "=== $i ===" - for j in $SPECS - do - echo $j: - update $TEMPLATE/$i $j/src/main/jbake/$i - done -done - -for i in $(cd $TEMPLATE/../../theme; ls *) -do - echo "=== $i ===" - for j in $SPECS - do - echo $j: - [ -d $j/src/theme ] || mkdir $j/src/theme - update $TEMPLATE/../../theme/$i $j/src/theme/$i - done -done diff --git a/user_guides/build_tckugs.sh b/user_guides/build_tckugs.sh deleted file mode 100644 index 3b84027d2e..0000000000 --- a/user_guides/build_tckugs.sh +++ /dev/null @@ -1,61 +0,0 @@ -#!/bin/bash -xe - -# Copyright (c) 2019, 2022 Oracle and/or its affiliates. All rights reserved. -# -# This program and the accompanying materials are made available under the -# terms of the Eclipse Public License v. 2.0, which is available at -# http://www.eclipse.org/legal/epl-2.0. -# -# This Source Code may also be made available under the following Secondary -# Licenses when the conditions for such availability set forth in the -# Eclipse Public License v. 2.0 are satisfied: GNU General Public License, -# version 2 with the GNU Classpath Exception, which is available at -# https://www.gnu.org/software/classpath/license.html. -# -# SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 - - -if [ -z "$M2_HOME" ]; then - export M2_HOME=/usr/share/apache-maven/ -fi - -if [ -z "$JAVA_HOME" ]; then - export JAVA_HOME=/opt/jdk-11.0.10 -fi - -export PATH=$JAVA_HOME/bin:$M2_HOME/bin:$PATH -cd ${WORKSPACE} -export BASEDIR=`pwd` -export USERGUIDEDIR=$BASEDIR/user_guides -alltcks="caj el jaxws jca jms jpa jsp jstl jta saaj servlet websocket" - -cd $USERGUIDEDIR -rm -rf $USERGUIDEDIR/tmp -rm -rf $USERGUIDEDIR/userguides.zip -mkdir -p $USERGUIDEDIR/tmp/userguides - -if [ -z "$1" ]; then - tck="all" - echo *************Building All TCK Userguides************ - for j in $alltcks - do - echo *************Building $j TCK Userguide************ - cd $USERGUIDEDIR/$j; - mvn -B -Dmaven.repo.local=$HOME/.m2/repository - cp -r $USERGUIDEDIR/$j/target/staging $USERGUIDEDIR/tmp/userguides/$j - done - bundlename="userguides_alltcks.zip" -else - for i in "$@" - do - echo *************Building $i TCK Userguide************ - cd $USERGUIDEDIR/$i; - mvn -B -Dmaven.repo.local=$HOME/.m2/repository - cp -r $USERGUIDEDIR/$i/target/staging $USERGUIDEDIR/tmp/userguides/$i - done - bundlename="userguides.zip" -fi - -cd $USERGUIDEDIR/tmp -chmod -R 777 userguides -zip -r $USERGUIDEDIR/$bundlename userguides/ diff --git a/user_guides/connector/src/assembly/dist.xml b/user_guides/connector/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/user_guides/connector/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/jms/src/assembly/dist.xml b/user_guides/jms/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/user_guides/jms/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/jms/src/main/resources/theme/jakarta_ee_logo_schooner_color_stacked_default.png b/user_guides/jms/src/main/resources/theme/jakarta_ee_logo_schooner_color_stacked_default.png deleted file mode 100644 index 97b46ce3e162ecff823aa6aac6bda0d261b8c3df..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 46992 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 M07*qoM6N<$f;AIsCIA2c diff --git a/user_guides/jms/src/main/resources/theme/jakartaee-theme.yml b/user_guides/jms/src/main/resources/theme/jakartaee-theme.yml deleted file mode 100644 index f15f8652e7..0000000000 --- a/user_guides/jms/src/main/resources/theme/jakartaee-theme.yml +++ /dev/null @@ -1,134 +0,0 @@ -extends: base -page: - margin: [30,50,30,50] - size: Letter -font: - catalog: - # Noto Serif supports Latin, Latin-1 Supplement, Latin Extended-A, Greek, Cyrillic, Vietnamese & an assortment of symbols - Noto Serif: - normal: GEM_FONTS_DIR/notoserif-regular-subset.ttf - bold: GEM_FONTS_DIR/notoserif-bold-subset.ttf - italic: GEM_FONTS_DIR/notoserif-italic-subset.ttf - bold_italic: GEM_FONTS_DIR/notoserif-bold_italic-subset.ttf - # M+ 1mn supports ASCII and the circled numbers used for conums - M+ 1mn: - normal: GEM_FONTS_DIR/mplus1mn-regular-subset.ttf - bold: GEM_FONTS_DIR/mplus1mn-bold-subset.ttf - italic: GEM_FONTS_DIR/mplus1mn-italic-subset.ttf - bold_italic: GEM_FONTS_DIR/mplus1mn-bold_italic-subset.ttf - # M+ 1p supports Latin, Latin-1 Supplement, Latin Extended, Greek, Cyrillic, Vietnamese, Japanese & an assortment of symbols - # It also provides arrows for ->, <-, => and <= replacements in case these glyphs are missing from font - M+ 1p Fallback: - normal: GEM_FONTS_DIR/mplus1p-regular-fallback.ttf - bold: GEM_FONTS_DIR/mplus1p-regular-fallback.ttf - italic: GEM_FONTS_DIR/mplus1p-regular-fallback.ttf - bold_italic: GEM_FONTS_DIR/mplus1p-regular-fallback.ttf - fallbacks: - - M+ 1p Fallback -base: - font: - color: #151e3d - family: Noto Serif - size: 9 - line-height-length: 11.5 - line-height: $base-line-height-length / $base-font-size -prose: - margin-bottom: 8 -image: - width: 70% - align: center -codespan: - font: - size: 0.94em - family: M+ 1mn - color: #281e5d -code: - font: - size: 0.94em - color: #281e5d - family: M+ 1mn - border-width: 0 - padding: [4,4,4,20] -# background-color: #f7f7f7 -sidebar: - border-width: 0 - title: - align: center -admonition: - label: - vertical-align: top - padding: [4, 8, 4, 8] - column-rule: - style: solid - width: 1 - color: #f0f0f0 - icon: - tip: - stroke-color: #FFC300 - warning: - stroke-color: #FF5733 - caution: - stroke-color: #FF5733 -heading: - font: - color: #001861 - size: 11 - style: bold - line-height: 1.2 - h2-font-size: $base-font-size * 1.3 - h3-font-size: $base-font-size * 1.2 - h4-font-size: $base-font-size * 1.1 - h5-font-size: $base-font-size * 1.0 - margin-bottom: $base-line-height-length -link: - font-color: #002FA7 -list: - indent: $base-font-size * 1.5 - item-spacing: 2 -table: - font-size: 0.94em - caption: - text-align: center - side: top - font-size: 0.94em - grid: - color: #f0f0f0 - style: solid - width: 1 - border: - width: 1 - color: #f0f0f0 - head: - background-color: #f0f0f0 - cell: - padding: 6 -footer: - border-width: 0 -quote: - font-style: italic - font-color: #001861 - font-size: 1.1em - # background-color: #f1f1f1 - border-color: #000000 - border-radius: 2 - border-style: dotted - padding: [10,20,10,25] -title_page: - align: right - logo: - top: 10% - title: - top: 55% - font_size: $heading-h1-font-size - font_color: 999999 - line_height: 0.9 - subtitle: - font_size: $heading-h3-font-size - font_style: bold_italic - line_height: 1 - authors: - margin_top: $base-font-size * 1.25 - font_size: $base-font-size * 1.25 - font_color: 181818 - revision: - margin_top: $base_font_size * 1.25 diff --git a/user_guides/jsp/src/assembly/dist.xml b/user_guides/jsp/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/user_guides/jsp/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/jstl/src/assembly/dist.xml b/user_guides/jstl/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/user_guides/jstl/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/jta/src/assembly/dist.xml b/user_guides/jta/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/user_guides/jta/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/pdf-assembly/src/assembly/dist.xml b/user_guides/pdf-assembly/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/user_guides/pdf-assembly/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/pdf-assembly/src/assembly/pdfs.xml b/user_guides/pdf-assembly/src/assembly/pdfs.xml new file mode 100644 index 0000000000..0d239f39f4 --- /dev/null +++ b/user_guides/pdf-assembly/src/assembly/pdfs.xml @@ -0,0 +1,40 @@ + + bin + + dir + + true + + + pdfs + + *:zip + + true + + + + \ No newline at end of file diff --git a/user_guides/platform/pom.xml b/user_guides/platform/pom.xml index 9f7ce78494..c237a9a955 100644 --- a/user_guides/platform/pom.xml +++ b/user_guides/platform/pom.xml @@ -58,7 +58,14 @@ + org.apache.maven.plugins maven-assembly-plugin + + + build-dist + package + + diff --git a/user_guides/platform/src/assembly/dist.xml b/user_guides/platform/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/user_guides/platform/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/platform/src/main/assembly/assembly.xml b/user_guides/platform/src/main/assembly/assembly.xml deleted file mode 100644 index 3be99c23a6..0000000000 --- a/user_guides/platform/src/main/assembly/assembly.xml +++ /dev/null @@ -1,21 +0,0 @@ - - - bin - platform-tck-ref-guide - - zip - - - - - ${project.build.directory} - / - - generated-docs/** - - - - - diff --git a/user_guides/websocket/pom.xml b/user_guides/websocket/pom.xml index 9a0d73b568..dbd73fa0b5 100644 --- a/user_guides/websocket/pom.xml +++ b/user_guides/websocket/pom.xml @@ -59,20 +59,6 @@ - - org.glassfish.doc - glassfish-doc-maven-plugin - - - generate-toc - generate-sources - - - generate-book - generate-sources - - - org.asciidoctor asciidoctor-maven-plugin diff --git a/user_guides/websocket/src/assembly/dist.xml b/user_guides/websocket/src/assembly/dist.xml new file mode 100644 index 0000000000..82cfe70cc8 --- /dev/null +++ b/user_guides/websocket/src/assembly/dist.xml @@ -0,0 +1,41 @@ + + + + + dist + + zip + + false + + + ${project.build.directory}/staging + html + + **/css/* + **/img/* + **/*.html + + + + ${project.build.directory}/generated-docs + pdf + + **/*.pdf + + + + \ No newline at end of file diff --git a/user_guides/websocket/src/main/asciidoc/README b/user_guides/websocket/src/main/asciidoc/README new file mode 100644 index 0000000000..05fa2c27fd --- /dev/null +++ b/user_guides/websocket/src/main/asciidoc/README @@ -0,0 +1,77 @@ +The file attributes.conf defines several attributes (variables) that +need to be customized for each technology. + +The *.adoc files should not be modified. + +The following "include" files should be customized as necessary +for the specific technology: + +- rules.inc + + Additional compatibility rules needed by some technologies. + The rules in rules.adoc should NOT be changed. + +- defns.inc + + Additional definitions needed by additional compatibility + rules in rules.inc. + +- config.inc + + Detailed instructions for configuring the TCK, included in + Chapter 4. Unfortunately, these are sections 4.1 - 4.3, + so even if the TCK doesn't require 3 sections you need to + make up something, or else change the sections to "N/A". + +- packages.inc + + A simple list of Jakarta EE package names for the technology. + +- tck-packages.inc + + A list of additional software packages included in the TCK. + +- req-software.inc + + A list of software required in addition to the TCK and CI. + +- install-server.inc + + Steps to install the Jakarta EE CI, if needed. + For standalone technologies, no server may be required, + and this file can be empty. + This is used in install.adoc in section 3.2. + +- install-server-vi.inc + + Steps to install a Vendor's web server, if needed. + For standalone technologies, no web server may be required, + and this file can be empty. + This is used in install.adoc in section 3.2. + +- using-examples.inc + + Command line examples showing how to run the TCK. + +- using.inc + + Optional additional instructions for running the TCK. + +- debug-tips.inc + + Technology-specific troubleshooting tips for Chapter 6. + If this isn't needed, it can be an empty file, but toc.adoc + will need to be fixed. + +- rebuild.inc + + Special instructions for rebuilding the WAR files used by some TCKs. + If needed, customize it appropriately and define the "rebuild" + attribute in attributes.conf. + +- title.inc + Add acronym references as required do distinguish between legacy and + current APIs. + +Note that this template is NOT sufficient for the Jakarta EE platform +or Jakarta EE Web Profile. diff --git a/user_guides/websocket/src/main/jbake/content/attributes.conf b/user_guides/websocket/src/main/asciidoc/attributes.conf similarity index 100% rename from user_guides/websocket/src/main/jbake/content/attributes.conf rename to user_guides/websocket/src/main/asciidoc/attributes.conf diff --git a/user_guides/websocket/src/main/asciidoc/book.adoc b/user_guides/websocket/src/main/asciidoc/book.adoc new file mode 100644 index 0000000000..a47c51b9e4 --- /dev/null +++ b/user_guides/websocket/src/main/asciidoc/book.adoc @@ -0,0 +1,22 @@ += TCK User's Guide for Technology Implementors + +include::title.adoc[] + +include::preface.adoc[] + +include::intro.adoc[] + +include::rules.adoc[] + +include::install.adoc[] + +include::config.adoc[] + +include::using.adoc[] + +include::debug.adoc[] + +include::faq.adoc[] + +include::rebuild.adoc[] + diff --git a/user_guides/websocket/src/main/jbake/content/config.adoc b/user_guides/websocket/src/main/asciidoc/config.adoc similarity index 98% rename from user_guides/websocket/src/main/jbake/content/config.adoc rename to user_guides/websocket/src/main/asciidoc/config.adoc index ff8b8639ff..dd6e067330 100644 --- a/user_guides/websocket/src/main/jbake/content/config.adoc +++ b/user_guides/websocket/src/main/asciidoc/config.adoc @@ -1,12 +1,4 @@ -type=page -status=published -title=Setup and Configuration -next=using.html -prev=install.html -~~~~~~ include::attributes.conf[] -Setup and Configuration -======================= [[GBFVV]] diff --git a/user_guides/websocket/src/main/jbake/content/config.inc b/user_guides/websocket/src/main/asciidoc/config.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/config.inc rename to user_guides/websocket/src/main/asciidoc/config.inc diff --git a/user_guides/websocket/src/main/asciidoc/debug-tips.inc b/user_guides/websocket/src/main/asciidoc/debug-tips.inc new file mode 100644 index 0000000000..e69de29bb2 diff --git a/user_guides/websocket/src/main/jbake/content/debug.adoc b/user_guides/websocket/src/main/asciidoc/debug.adoc similarity index 97% rename from user_guides/websocket/src/main/jbake/content/debug.adoc rename to user_guides/websocket/src/main/asciidoc/debug.adoc index 5208c401a6..e9ab8678f9 100644 --- a/user_guides/websocket/src/main/jbake/content/debug.adoc +++ b/user_guides/websocket/src/main/asciidoc/debug.adoc @@ -1,12 +1,4 @@ -type=page -status=published -title=Debugging Test Problems -next=faq.html -prev=using.html -~~~~~~ include::attributes.conf[] -Debugging Test Problems -======================= [[GBFUV]] diff --git a/user_guides/websocket/src/main/asciidoc/defns.inc b/user_guides/websocket/src/main/asciidoc/defns.inc new file mode 100644 index 0000000000..038db2dda3 --- /dev/null +++ b/user_guides/websocket/src/main/asciidoc/defns.inc @@ -0,0 +1,46 @@ +// NOTE TO WRITERS: +// Most technologies will only need the compatibility rules in rules.adoc. +// Some technologies will need additional definitions to go with additional +// rules. If they're needed, remove the comment characters below +// and update the definitions as appropriate. +// +// The first block below is additional definitions needed by +// Jakarta XML Web Services. +// +// The second block below is additional defintions needed by +// Jakarta Server Pages. +// +// NOTE: This set of examples is NOT complete, but should be. +// +// +// Jakarta XML Web Services +// +// |Development Kit |A software product that implements or incorporates a +// Compiler, a Schema Compiler, a Schema Generator, a Java-to-WSDL Tool, a +// WSDL-to-Java Tool, and/or an RMI Compiler. +// +// |Java-to-WSDL Output |Output of a Java-to-WSDL Tool that is required for +// Web service deployment and invocation. +// +// |Java-to-WSDL Tool |A software development tool that implements or +// incorporates a function that generates web service endpoint descriptions +// in WSDL and XML schema format from Source Code as specified by the +// Jakarta XML Web Services Specification. +// +// |WSDL-to-Java Output |Output of a WSDL-to-Java tool that is required for +// Web service deployment and invocation. +// +// |WSDL-to-Java Tool |A software development tool that implements or +// incorporates a function that generates web service interfaces for +// clients and endpoints from a WSDL description as specified by the +// Jakarta XML Web Services Specification. +// +// +// Jakarta Server Pages +// +// |Jakarta Server Page |A text-based document that uses Jakarta Server +// Pages technology. +// +// |Jakarta Server Page Implementation Class |A program constructed by +// transforming the Jakarta Server Page text into a Java language program +// using the transformation rules described in the Specifications. diff --git a/user_guides/websocket/src/main/jbake/content/faq.adoc b/user_guides/websocket/src/main/asciidoc/faq.adoc similarity index 91% rename from user_guides/websocket/src/main/jbake/content/faq.adoc rename to user_guides/websocket/src/main/asciidoc/faq.adoc index 97ca394c55..ec11a913e1 100644 --- a/user_guides/websocket/src/main/jbake/content/faq.adoc +++ b/user_guides/websocket/src/main/asciidoc/faq.adoc @@ -1,12 +1,4 @@ -type=page -status=published -title=Appendix A: Frequently Asked Questions -next=rebuild.html -prev=debug.html -~~~~~~ include::attributes.conf[] -Appendix A: Frequently Asked Questions -====================================== [[GBFYD]] diff --git a/user_guides/websocket/src/main/jbake/content/install-server-vi.inc b/user_guides/websocket/src/main/asciidoc/install-server-vi.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/install-server-vi.inc rename to user_guides/websocket/src/main/asciidoc/install-server-vi.inc diff --git a/user_guides/websocket/src/main/jbake/content/install-server.inc b/user_guides/websocket/src/main/asciidoc/install-server.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/install-server.inc rename to user_guides/websocket/src/main/asciidoc/install-server.inc diff --git a/user_guides/websocket/src/main/jbake/content/install.adoc b/user_guides/websocket/src/main/asciidoc/install.adoc similarity index 96% rename from user_guides/websocket/src/main/jbake/content/install.adoc rename to user_guides/websocket/src/main/asciidoc/install.adoc index a3b93e73ac..5aa48b38ab 100644 --- a/user_guides/websocket/src/main/jbake/content/install.adoc +++ b/user_guides/websocket/src/main/asciidoc/install.adoc @@ -1,12 +1,4 @@ -type=page -status=published -title=Installation -next=config.html -prev=rules.html -~~~~~~ include::attributes.conf[] -Installation -============ [[GBFTP]] diff --git a/user_guides/websocket/src/main/jbake/content/intro.adoc b/user_guides/websocket/src/main/asciidoc/intro.adoc similarity index 99% rename from user_guides/websocket/src/main/jbake/content/intro.adoc rename to user_guides/websocket/src/main/asciidoc/intro.adoc index 774adfd371..12555e556b 100644 --- a/user_guides/websocket/src/main/jbake/content/intro.adoc +++ b/user_guides/websocket/src/main/asciidoc/intro.adoc @@ -1,12 +1,4 @@ -type=page -status=published -title=Introduction -next=rules.html -prev=preface.html -~~~~~~ include::attributes.conf[] -Introduction -============ [[GBFOW]] diff --git a/user_guides/websocket/src/main/asciidoc/intro.inc b/user_guides/websocket/src/main/asciidoc/intro.inc new file mode 100644 index 0000000000..e69de29bb2 diff --git a/user_guides/websocket/src/main/jbake/content/packages.inc b/user_guides/websocket/src/main/asciidoc/packages.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/packages.inc rename to user_guides/websocket/src/main/asciidoc/packages.inc diff --git a/user_guides/websocket/src/main/jbake/content/platforms.inc b/user_guides/websocket/src/main/asciidoc/platforms.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/platforms.inc rename to user_guides/websocket/src/main/asciidoc/platforms.inc diff --git a/user_guides/websocket/src/main/jbake/content/preface.adoc b/user_guides/websocket/src/main/asciidoc/preface.adoc similarity index 97% rename from user_guides/websocket/src/main/jbake/content/preface.adoc rename to user_guides/websocket/src/main/asciidoc/preface.adoc index ea10c28728..ee845a0078 100644 --- a/user_guides/websocket/src/main/jbake/content/preface.adoc +++ b/user_guides/websocket/src/main/asciidoc/preface.adoc @@ -1,12 +1,4 @@ -type=page -status=published -title=Preface -next=intro.html -prev=title.html -~~~~~~ include::attributes.conf[] -Preface -======= [[TCJRS00001]][[GBFTI]] diff --git a/user_guides/websocket/src/main/asciidoc/rebuild.adoc b/user_guides/websocket/src/main/asciidoc/rebuild.adoc new file mode 100644 index 0000000000..a986191f51 --- /dev/null +++ b/user_guides/websocket/src/main/asciidoc/rebuild.adoc @@ -0,0 +1,12 @@ +include::attributes.conf[] + + +ifdef::rebuild[] +include::rebuild.inc[] +endif::rebuild[] +ifndef::rebuild[] + +<<< +Appendix B is not used for the {TechnologyShortName} TCK. + +endif::rebuild[] diff --git a/user_guides/websocket/src/main/jbake/content/rebuild.inc b/user_guides/websocket/src/main/asciidoc/rebuild.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/rebuild.inc rename to user_guides/websocket/src/main/asciidoc/rebuild.inc diff --git a/user_guides/websocket/src/main/jbake/content/req-software.inc b/user_guides/websocket/src/main/asciidoc/req-software.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/req-software.inc rename to user_guides/websocket/src/main/asciidoc/req-software.inc diff --git a/user_guides/websocket/src/main/jbake/content/rules.adoc b/user_guides/websocket/src/main/asciidoc/rules.adoc similarity index 99% rename from user_guides/websocket/src/main/jbake/content/rules.adoc rename to user_guides/websocket/src/main/asciidoc/rules.adoc index f6b08cebb9..41c903fe50 100644 --- a/user_guides/websocket/src/main/jbake/content/rules.adoc +++ b/user_guides/websocket/src/main/asciidoc/rules.adoc @@ -1,12 +1,4 @@ -type=page -status=published -title=Procedure for Certification -next=install.html -prev=intro.html -~~~~~~ include::attributes.conf[] -Procedure for Certification -=========================== [[GBFSN]] diff --git a/user_guides/websocket/src/main/jbake/content/rules.inc b/user_guides/websocket/src/main/asciidoc/rules.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/rules.inc rename to user_guides/websocket/src/main/asciidoc/rules.inc diff --git a/user_guides/websocket/src/main/jbake/content/tck-packages.inc b/user_guides/websocket/src/main/asciidoc/tck-packages.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/tck-packages.inc rename to user_guides/websocket/src/main/asciidoc/tck-packages.inc diff --git a/user_guides/websocket/src/main/asciidoc/title.adoc b/user_guides/websocket/src/main/asciidoc/title.adoc new file mode 100644 index 0000000000..50ad1ef81b --- /dev/null +++ b/user_guides/websocket/src/main/asciidoc/title.adoc @@ -0,0 +1,33 @@ +include::attributes.conf[] + +[[eclipse-foundation]] +Eclipse Foundation +------------------ + +Technology Compatibility Kit User's Guide for {TechnologyFullName} + +Release {TechnologyVersion} for Jakarta EE + +{ReleaseDate} + +[[sthref1]] + +''''' + +Technology Compatibility Kit User's Guide for {TechnologyFullName}, +Release {TechnologyVersion} for Jakarta EE + +Copyright © {CopyrightDates} Oracle and/or its affiliates. All rights reserved. + +This program and the accompanying materials are made available under +the terms of the Eclipse Public License v. 2.0, which is available at +http://www.eclipse.org/legal/epl-2.0. + +SPDX-License-Identifier: EPL-2.0 + +Oracle and Java are registered trademarks of Oracle and/or its +affiliates. Other names may be trademarks of their respective owners. + +include::title.inc[] + + diff --git a/user_guides/websocket/src/main/asciidoc/title.inc b/user_guides/websocket/src/main/asciidoc/title.inc new file mode 100644 index 0000000000..25bf47e08d --- /dev/null +++ b/user_guides/websocket/src/main/asciidoc/title.inc @@ -0,0 +1,11 @@ +/////////////////////////////////////////////////////////////////////// +NOTE TO WRITERS: +This is included at the tail end of the Title page. +The following section should be customized for the technology. +This is provided to allow each technology to customize legacy acronym names +that are used in this TCK. +Be sure to customize LegacyAcronym in attributes.conf +Add additional lines as needed for acronyms found in your TCK user guide. +/////////////////////////////////////////////////////////////////////// + +References in this document to {LegacyAcronym} refer to the {TechnologyFullName} unless otherwise noted. diff --git a/user_guides/websocket/src/main/jbake/content/using-examples.inc b/user_guides/websocket/src/main/asciidoc/using-examples.inc similarity index 100% rename from user_guides/websocket/src/main/jbake/content/using-examples.inc rename to user_guides/websocket/src/main/asciidoc/using-examples.inc diff --git a/user_guides/websocket/src/main/jbake/content/using.adoc b/user_guides/websocket/src/main/asciidoc/using.adoc similarity index 98% rename from user_guides/websocket/src/main/jbake/content/using.adoc rename to user_guides/websocket/src/main/asciidoc/using.adoc index b0a41c51e1..97e27a2cb6 100644 --- a/user_guides/websocket/src/main/jbake/content/using.adoc +++ b/user_guides/websocket/src/main/asciidoc/using.adoc @@ -1,12 +1,4 @@ -type=page -status=published -title=Executing Tests -next=debug.html -prev=config.html -~~~~~~ include::attributes.conf[] -Executing Tests -=============== [[GBFWO]] diff --git a/user_guides/websocket/src/main/asciidoc/using.inc b/user_guides/websocket/src/main/asciidoc/using.inc new file mode 100644 index 0000000000..e69de29bb2 diff --git a/user_guides/websocket/src/main/jbake/assets/README.md b/user_guides/websocket/src/main/jbake/assets/README.md deleted file mode 100644 index f8f962c0ab..0000000000 --- a/user_guides/websocket/src/main/jbake/assets/README.md +++ /dev/null @@ -1,4 +0,0 @@ -# About - -The {{site.title}} project contains the [AsciiDoc](http://asciidoc.org/) -source code for the ... diff --git a/user_guides/websocket/src/main/jbake/assets/_config.yml b/user_guides/websocket/src/main/jbake/assets/_config.yml deleted file mode 100644 index 556037a9ae..0000000000 --- a/user_guides/websocket/src/main/jbake/assets/_config.yml +++ /dev/null @@ -1,14 +0,0 @@ -remote_theme: jakartaee/jekyll-theme-jakarta-ee - -title: [tck_wsk_v1_1] -description: [Eclipse Foundation Technology Compatibility Kit User's Guide for Java API for WebSocket 2.1 for Technology Licensees, Release 2.1.0] - -# sidebar links url -links: - source: https://github.com/javaee/tck_wsk_v1_1 - download: https://github.com/javaee/tck_wsk_v1_1/releases - #mailinglist: https://javaee.groups.io/g/tck_wsk_v1_1 - #javadocs: - docs: https://javaee.github.io/tck_wsk_v1_1 - #faq: -