The gold standard

JAX-RS: A standard for RESTful microservices

Markus Karg
© Shutterstock / Sadovski

JAX-RS was one of the first projects to join under the new Jakarta EE community. Long-term JAX-RS EG team member Markus Karg explains why this standard API for RESTful web services is still needed in this era of microservices.

While REST and Microservices are common terms these days, few people know JAX-RS, or do have a rather blurry vision of it. In fact, JAX-RS started a decade ago to provide a standard API for more sophisticated support in writing RESTful web service than the Servlet API. Back then, “fat” application servers were state of the art, still having CORBA, EJBs and SOAP onboard. REST was the new kid on the block, and JAX-RS made it pretty simple to get it right, without getting into vendor lock-in, and without simply doing XML-over-HTTP. JAX-RS started with native support for automatic encoding and decoding headers, parameters, and even better, XML payloads. Yes, there had been a time before JSON, and thanks to JAX-RS’s perfect JAXB integration, it was a painless no-brainer to turn XML representations into Java parameters, and back. But the best of all was the complete separation of business logic and technological aspects, all greatly served by the concept of providers, part of a highly extensible SPI layer. BTW, while CDI still was in the making, JAX-RS already provided annotation-based context and dependency injection, and automatic detection of custom providers.

Times have changed. Today application servers feel clumsy compared to Microservices, with their strange deployment model, slow boot times, and complex configuration. Generation Y is used to instantaneous REPL workstyle, expects no boiler plates and slow turnaround cycles. Nobody cares for XML anymore, as it clogs our gigabit pipes with masses of unnecessary white space and tags. With feeble-powered mobile devices there came the rise of JSON. Furthermore, modern programmers like to find support for reactive streams. And a whole industry works on their next revolution, this time accepting IT protocols like MQTT, AMQP but also certainly REST to be used in myriads of micro-devices – with no room for a full server. All that are massive challenges to the grownup ex-Java EE member API. But the master driver behind Java EE lost pace. And then stuck. There was no progress for a very long time.

And then came Jakarta EE

Under the auspices of the Eclipse Foundation, a lot did change. Besides Oracle now others could actively participate in really everything – not only contribute code, but also commit, manage, and have a say in rather every aspect of JAX-RS. Thanks to GitHub, collaborating was easy, and really fair. No more waiting for Oracle. The community picked up leadership immediately, so JAX-RS became one of the first active projects of Jakarta EE, and is still today. Volunteers, like long-term JAX-RS EG member Markus Karg and MVC API project lead Christian Kaltepoth, chimed in with organizational improvements and first fully-externally developed features additions. They work alongside people from Oracle, Payara, IBM, Red Hat, Apache, and many more, on the next, better, greater JAX-RS. Together they provide the heart of Java Microservices: A standard for REST in the Java ecosystem.

Updated to meet current needs and trends, like supporting pure Java SE deployments without application servers, CDI, Flow, and much more, JAX-RS will not just be the layer between Servlets and business logic. It will become the centerpiece driving your applications. And it will be made for the community by the community. Innovation, made at the Eclipse Foundation.

If you like to join the JAX-RS team: Contributions are welcome! Pick an issue from our GitHub tracker, discuss it with us, send us PRs. We are glad for every helping hand!


This post was originally published in the August 2018 issue of the Eclipse Newsletter: Exploring Jakarta EE Technologies

For more information and articles check out the Eclipse Newsletter.


Markus Karg

Markus Karg is a Java Guru with +30 years of experience in professional software development. I travelled the whole world of IT, starting from Sinclair’s great ZX Spectrum 48K, Commodore’s 4040, over S/370, PCs since legendary XT, CP/M, VM/ESA, DOS, Windows (remember 3.1?), OS/2 WARP, Linux to Android and iOS… and still coding is my passion, and Java is my favourite drug! His website is here.

Leave a Reply

1 Comment threads
0 Thread replies
Most reacted comment
Hottest comment thread
1 Comment authors
Aislan Recent comment authors

Wonderful article. Great thanks Markus!