[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [jaxrs-dev] TCK Assertion Numbers
|
You may find these references helpful:
Very roughly, the process (and it is not even remotely
error-free, nor fully automated):
- Extract spec assertions from pdf spec docs as xml using https://github.com/eclipse-ee4j/jakartaee-tck-tools/tree/master/tools/extract-spec-assertions
- Extract api assertions from pdf spec docs as xml using https://github.com/eclipse-ee4j/jakartaee-tck-tools/tree/master/tools/extract-api-assertions
- Convert xml spec assertions to html documents : https://github.com/eclipse-ee4j/jakartaee-tck/wiki/Steps-to-generate-the-html-version-of-the-SpecAssertions.xml
Any additional clarifications/updates would be welcomed as an
addition to the TCK Wiki page.
For the purposes of our Jakarta EE 9 effort, we have tried to
limit the changes to simple substitution of jakarta for javax in
method/assertion signatures. Little to no effort has been spent on
the assertion description bodies. We realize this is imperfect,
but we haven't had the time to properly regenerate the assertion
lists.
Thanks!
On 8/28/2020 7:55 AM, arjan tijms
wrote:
Cool, thanks!
Btw, I think we should try to recover and/or recreate the
tooling to generate the HTML files at least. Ideally, the
original XML file would be generated from annotations in the
actual spec document (e.g. by a Maven plugin in the spec
project).
The entire process is now quite error prone.
I do understand that for the larger specs it will be no
small undertaking to annotate the document, but for a tiny
thing like Jakarta Authentication (only a dozen or so
assertions), I could try it.
Kind regards,
Arjan
Just
copied this great question and answer to
https://github.com/eclipse-ee4j/jakartaee-tck/wiki/Jakarta-EE-9-Platform-TCK-Questions---Answers
Scott
On 8/28/20 10:29 AM, arjan tijms wrote:
> Hi,
>
> The list of assertions is kept here:
>
> https://github.com/eclipse-ee4j/jakartaee-tck/blob/master/internal/docs/jaxrs/JAXRSSpecAssertions.xml
>
> From that an HTML version is generated:
>
> https://github.com/eclipse-ee4j/jakartaee-tck/blob/master/internal/docs/jaxrs/JAXRSSpecAssertions.html
>
> And just to be sure nobody accidentally deletes them,
there's also a
> backup copy being kept here:
>
> https://github.com/eclipse-ee4j/jakartaee-tck/blob/master/install/jaxrs/docs/assertions/JAXRSSpecAssertions.html
>
> If you update the spec document, all those 3 files need
to be updated to
> mirror exactly what's in the spec document, as the
> "JAXRSSpecAssertions.xml" file essentially contains
verbatim quotes from
> the spec document. The HTML versions are manually updated
these days,
> since the tools to generate them have largely been lost
(there's some
> stuff here though: https://github.com/eclipse-ee4j/jakartaee-tck-tools).
>
> Hope this helps.
>
> Kind regards,
> Arjan Tijms
>
>
>
>
>
>
>
> On Fri, Aug 28, 2020 at 4:19 PM Markus KARG <markus@xxxxxxxxxxxxxxx
> <mailto:markus@xxxxxxxxxxxxxxx>>
wrote:
>
> When extending the JAX-RS TCK, apparently unique
Assertion Numbers
> have to get assigned. Is there some list of the
existing assertions
> somewhere? How to know the next free number?____
>
> -Markus____
>
> _______________________________________________
> jaxrs-dev mailing list
> jaxrs-dev@xxxxxxxxxxx
<mailto:jaxrs-dev@xxxxxxxxxxx>
> To unsubscribe from this list, visit
> https://www.eclipse.org/mailman/listinfo/jaxrs-dev
>
>
> _______________________________________________
> jaxrs-dev mailing list
> jaxrs-dev@xxxxxxxxxxx
> To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jaxrs-dev
>
_______________________________________________
jaxrs-dev mailing list
jaxrs-dev@xxxxxxxxxxx
To unsubscribe from this list, visit https://urldefense.com/v3/__https://www.eclipse.org/mailman/listinfo/jaxrs-dev__;!!GqivPVa7Brio!MME_VURdLnHAawq_9mqTiBgL6srUjOJ4HgNjsV5zFMrHRtieCz8-7JwKOQ5aJaQ$