You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@syncope.apache.org by Francesco Chicchiriccò <il...@apache.org> on 2020/05/29 13:22:25 UTC
[PROPOSAL] Get rid of JAXB (2nd attempt)
Hi all,
about 3.5 years after my first attempt [1], here I am again to propose to replace JAXB for XML payloads management, still with Jackson Dataformat XML [2].
During our first discussion, the main objection was about WADL being removed, for at least two reasons:
1. client code generation from WADL
2. WADL being used for REST services documentation [3]
Compared to 3.5 years ago, I think it's a rather shared opinion that OpenAPI is a very solid mean for client-code generation, with wide range of languages being supported.
Moreover, we have been using Swagger UI for REST service since quite some time, with very satisfactory results.
For the reasons above, I have submitted a PR [4] against master branch, which:
1. removes JAXB completely
2. replaces REST services documentation with Swagger UI
3. adds application/xml ITs to Travis, thus fixing SYNCOPE-1565 for master branch
Please have a look and review, thanks.
Regards.
[1] https://lists.apache.org/thread.html/abffcf286c15ff622093916287948b40d86f645b6feae4befa65f1d3%40%3Cdev.syncope.apache.org%3E
[2] https://github.com/FasterXML/jackson-dataformat-xml
[3] http://syncope.apache.org/rest/2.1/index.html
[4] https://github.com/apache/syncope/pull/192
--
Francesco Chicchiriccò
Tirasa - Open Source Excellence
http://www.tirasa.net/
Member at The Apache Software Foundation
Syncope, Cocoon, Olingo, CXF, OpenJPA, PonyMail
http://home.apache.org/~ilgrosso/
Re: [PROPOSAL] Get rid of JAXB (2nd attempt)
Posted by Francesco Chicchiriccò <il...@apache.org>.
On 02/06/20 15:39, Misagh Moayyed wrote:
> +1. Excellent work.
>
> You had me at "Get rid of JAXB" :)
Thanks for your feedback, Misagh :-)
Since the PR is building fine and there are no objections, I am going to merge it.
Regards.
> ----- Original Message -----
>> From: "Francesco Chicchiriccò" <il...@apache.org>
>> To: "dev" <de...@syncope.apache.org>
>> Sent: Friday, May 29, 2020 5:52:25 PM
>> Subject: [PROPOSAL] Get rid of JAXB (2nd attempt)
>> Hi all,
>> about 3.5 years after my first attempt [1], here I am again to propose to
>> replace JAXB for XML payloads management, still with Jackson Dataformat XML
>> [2].
>>
>> During our first discussion, the main objection was about WADL being removed,
>> for at least two reasons:
>>
>> 1. client code generation from WADL
>> 2. WADL being used for REST services documentation [3]
>>
>> Compared to 3.5 years ago, I think it's a rather shared opinion that OpenAPI is
>> a very solid mean for client-code generation, with wide range of languages
>> being supported.
>> Moreover, we have been using Swagger UI for REST service since quite some time,
>> with very satisfactory results.
>>
>> For the reasons above, I have submitted a PR [4] against master branch, which:
>>
>> 1. removes JAXB completely
>> 2. replaces REST services documentation with Swagger UI
>> 3. adds application/xml ITs to Travis, thus fixing SYNCOPE-1565 for master
>> branch
>>
>> Please have a look and review, thanks.
>> Regards.
>>
>> [1] https://lists.apache.org/thread.html/abffcf286c15ff622093916287948b40d86f645b6feae4befa65f1d3%40%3Cdev.syncope.apache.org%3E
>> [2] https://github.com/FasterXML/jackson-dataformat-xml
>> [3] http://syncope.apache.org/rest/2.1/index.html
>> [4] https://github.com/apache/syncope/pull/192
--
Francesco Chicchiriccò
Tirasa - Open Source Excellence
http://www.tirasa.net/
Member at The Apache Software Foundation
Syncope, Cocoon, Olingo, CXF, OpenJPA, PonyMail
http://home.apache.org/~ilgrosso/
Re: [PROPOSAL] Get rid of JAXB (2nd attempt)
Posted by Misagh Moayyed <mi...@tirasa.net>.
+1. Excellent work.
You had me at "Get rid of JAXB" :)
--Misagh
----- Original Message -----
> From: "Francesco Chicchiriccò" <il...@apache.org>
> To: "dev" <de...@syncope.apache.org>
> Sent: Friday, May 29, 2020 5:52:25 PM
> Subject: [PROPOSAL] Get rid of JAXB (2nd attempt)
> Hi all,
> about 3.5 years after my first attempt [1], here I am again to propose to
> replace JAXB for XML payloads management, still with Jackson Dataformat XML
> [2].
>
> During our first discussion, the main objection was about WADL being removed,
> for at least two reasons:
>
> 1. client code generation from WADL
> 2. WADL being used for REST services documentation [3]
>
> Compared to 3.5 years ago, I think it's a rather shared opinion that OpenAPI is
> a very solid mean for client-code generation, with wide range of languages
> being supported.
> Moreover, we have been using Swagger UI for REST service since quite some time,
> with very satisfactory results.
>
> For the reasons above, I have submitted a PR [4] against master branch, which:
>
> 1. removes JAXB completely
> 2. replaces REST services documentation with Swagger UI
> 3. adds application/xml ITs to Travis, thus fixing SYNCOPE-1565 for master
> branch
>
> Please have a look and review, thanks.
> Regards.
>
> [1]
> https://lists.apache.org/thread.html/abffcf286c15ff622093916287948b40d86f645b6feae4befa65f1d3%40%3Cdev.syncope.apache.org%3E
> [2] https://github.com/FasterXML/jackson-dataformat-xml
> [3] http://syncope.apache.org/rest/2.1/index.html
> [4] https://github.com/apache/syncope/pull/192
>
> --
> Francesco Chicchiriccò
>
> Tirasa - Open Source Excellence
> http://www.tirasa.net/
>
> Member at The Apache Software Foundation
> Syncope, Cocoon, Olingo, CXF, OpenJPA, PonyMail
> http://home.apache.org/~ilgrosso/