Skip to content
New issue

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

Sign up for GitHub

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

Already on GitHub? Sign in to your account

Create jakarta-xml-binding.adoc #119

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Create jakarta-xml-binding.adoc #119

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions src/main/antora/modules/websvcs/pages/xml-websvcs/jakarta-xml-binding.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
== Jakarta XML Binding

Jakarta XML Binding (JAXB) provides a way to convert Java objects to XML and vice versa. It is a part of the Jakarta EE platform.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The first sentence is good, but the 2nd one is redundant (anything in here is a part of the platform). Can you add something like this?

JAXB can be used independently or in combination with Jakarta REST or Jakarta XML Web Services, in which case it provides a standard data binding for web service messages.

Also, can you link to Jakarta REST and Jakarta XML Web Services within the current tutorial?


* https://jakarta.ee/specifications/xml-binding/[Jakarta XML Binding Specification]
* https://jakarta.ee/specifications/xml-binding/3.0/[Example using Jakarta REST with Jakarta XML Binding]
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The last link isn't an example. Here's the example I had in mind: https://jakartaee.github.io/jakartaee-documentation/jakartaee-tutorial/current/websvcs/rest-advanced/rest-advanced.html#_using_jakarta_rest_with_jakarta_xml_binding. (You need to provide an xref link within the tutorial, though -- not an absolute URL).

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also provide a link to this example in the older version of the tutorial (again, use an xref link not this actual URL): https://jakartaee.github.io/jakartaee-documentation/jakartaee-tutorial/9.1/websvcs/jaxws/jaxws.html