{"id":88889,"date":"2019-02-26T07:00:47","date_gmt":"2019-02-26T05:00:47","guid":{"rendered":"https:\/\/www.javacodegeeks.com\/?p=88889"},"modified":"2019-02-25T12:06:48","modified_gmt":"2019-02-25T10:06:48","slug":"hypermedia-apis-support-jax-rs-openapi","status":"publish","type":"post","link":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html","title":{"rendered":"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go"},"content":{"rendered":"

Sooner or later, most of the developers who actively work on REST(ful)<\/a> web services and APIs stumble upon this truly extraterrestrial thing called HATEOAS<\/a>: Hypertext As The Engine Of Application State<\/b>. The curiosity of what HATEOAS<\/a> is and how it relates to REST<\/a> would eventually lead to discovery of the Richardson Maturity Model<\/a> which demystifies the industry definitions of REST<\/a> and RESTful<\/a>. The latter comes as an enlightenment, raising the question however: have we been doing REST<\/a> wrong all these years?<\/p>\n

Let us try to answer this question from the different perspectives. The HATEOAS<\/a> is one of the core REST<\/a> architectural constraints. From this perspective, the answer is “yes”, in order to claim REST<\/a> compliance, the web service or API should support that. Nonetheless, if you look around (or even consult your past or present experience), you may find out that the majority of the web services and APIs are just CRUD<\/a> wrappers around the domain models, with no HATEOAS<\/a> support whatsoever. Why is that? Probably, there is more than one reason, but from the developer’s toolbox perspective, the backing of HATEOAS<\/a> is not that great.<\/p>\n

In today’s post we are going to talk about what JAX-RS 2.x<\/a> has to offer with respect to HATEOAS<\/a>, how to use that from the server and client perspectives, and how to augment the OpenAPI v3.0.x specification<\/a> to expose hypermedia as part of the contract. If you are excited, let us get started.<\/p>\n

So our JAX-RS<\/a> web APIs are going to be built around managing companies and their staff. The foundation is Spring Boot<\/a> and Apache CXF<\/a>, with Swagger<\/a> as OpenAPI<\/a> specification implementation. The AppConfig<\/b> is the only piece of configuration we need to define in order to get the application up and running (thanks to Spring Boot<\/a> auto-configuration capabilities).<\/p>\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n
12<\/div>\n
13<\/div>\n
14<\/div>\n<\/td>\n
\n
\n
@SpringBootConfiguration<\/code><\/div>\n
public<\/code> class<\/code> AppConfig {<\/code><\/div>\n
    <\/code>@Bean<\/code><\/div>\n
    <\/code>OpenApiFeature createOpenApiFeature() {<\/code><\/div>\n
        <\/code>final<\/code> OpenApiFeature openApiFeature = <\/code>new<\/code> OpenApiFeature();<\/code><\/div>\n
        <\/code>openApiFeature.setSwaggerUiConfig(<\/code>new<\/code> SwaggerUiConfig().url(<\/code>\"\/api\/openapi.json\"<\/code>));<\/code><\/div>\n
        <\/code>return<\/code> openApiFeature;<\/code><\/div>\n
    <\/code>}<\/code><\/div>\n
    <\/code> <\/div>\n
    <\/code>@Bean<\/code><\/div>\n
    <\/code>JacksonJsonProvider jacksonJsonProvider() {<\/code><\/div>\n
        <\/code>return<\/code> new<\/code> JacksonJsonProvider();<\/code><\/div>\n
    <\/code>}<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

The model is very simple, Company<\/b> and Person<\/b> (please notice that there is no direct relationships between these two classes, purposely).<\/p>\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n<\/td>\n
\n
\n
public<\/code> class<\/code> Company {<\/code><\/div>\n
    <\/code>private<\/code> String id;<\/code><\/div>\n
    <\/code>private<\/code> String name;<\/code><\/div>\n
}<\/code><\/div>\n
 <\/div>\n
public<\/code> class<\/code> Person {<\/code><\/div>\n
    <\/code>private<\/code> String id;<\/code><\/div>\n
    <\/code>private<\/code> String email;<\/code><\/div>\n
    <\/code>private<\/code> String firstName;<\/code><\/div>\n
    <\/code>private<\/code> String lastName;<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

This model is exposed through CompanyResource<\/b>, a typical JAX-RS<\/a> resource class annotated with @Path<\/b>, and additionally with OpenAPI<\/a>‘s @Tag<\/b> annotation.<\/p>\n

\n
\n\n\n\n
\n
1<\/div>\n
2<\/div>\n
3<\/div>\n
4<\/div>\n
5<\/div>\n
6<\/div>\n<\/td>\n
\n
\n
@Component<\/code><\/div>\n
@Path<\/code>( <\/code>\"\/companies\"<\/code> ) <\/code><\/div>\n
@Tag<\/code>(name = <\/code>\"companies\"<\/code>)<\/code><\/div>\n
public<\/code> class<\/code> CompanyResource {<\/code><\/div>\n
    <\/code>@Autowired<\/code> private<\/code> CompanyService service;<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

Great, the resource class has no endpoints defined yet, so let us beef it up. Our first endpoint would lookup the company by identifier and return its representation in JSON<\/a> format. But since we do not incorporate any staff-related details, it would be awesome to hint the consumer (web UI or any other client) where to look it up. There are multiple ways to do that but since we stick to JAX-RS<\/a>, we could use Web Linking<\/a> (RFC-5988<\/a>) which is supported out of the box. The code snippet is worth thousand words.<\/p>\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n
12<\/div>\n
13<\/div>\n
14<\/div>\n
15<\/div>\n
16<\/div>\n
17<\/div>\n
18<\/div>\n
19<\/div>\n
20<\/div>\n
21<\/div>\n
22<\/div>\n
23<\/div>\n
24<\/div>\n
25<\/div>\n
26<\/div>\n
27<\/div>\n
28<\/div>\n<\/td>\n
\n
\n
@Produces<\/code>(MediaType.APPLICATION_JSON)<\/code><\/div>\n
@GET<\/code><\/div>\n
@Path<\/code>(<\/code>\"{id}\"<\/code>)<\/code><\/div>\n
public<\/code> Response getCompanyById(<\/code>@Context<\/code> UriInfo uriInfo, <\/code>@PathParam<\/code>(<\/code>\"id\"<\/code>) String id) {<\/code><\/div>\n
    <\/code>return<\/code> service<\/code><\/div>\n
        <\/code>.findCompanyById(id)<\/code><\/div>\n
        <\/code>.map(company -> Response<\/code><\/div>\n
            <\/code>.ok(company)<\/code><\/div>\n
            <\/code>.links(<\/code><\/div>\n
                <\/code>Link.fromUriBuilder(uriInfo<\/code><\/div>\n
                        <\/code>.getRequestUriBuilder())<\/code><\/div>\n
                    <\/code>.rel(<\/code>\"self\"<\/code>)<\/code><\/div>\n
                    <\/code>.build(),<\/code><\/div>\n
                <\/code>Link.fromUriBuilder(uriInfo<\/code><\/div>\n
                        <\/code>.getBaseUriBuilder()<\/code><\/div>\n
                        <\/code>.path(CompanyResource.<\/code>class<\/code>))<\/code><\/div>\n
                    <\/code>.rel(<\/code>\"collection\"<\/code>)<\/code><\/div>\n
                    <\/code>.build(),<\/code><\/div>\n
                <\/code>Link.fromUriBuilder(uriInfo<\/code><\/div>\n
                       <\/code>.getBaseUriBuilder()<\/code><\/div>\n
                       <\/code>.path(CompanyResource.<\/code>class<\/code>)<\/code><\/div>\n
                       <\/code>.path(CompanyResource.<\/code>class<\/code>, <\/code>\"getStaff\"<\/code>))<\/code><\/div>\n
                    <\/code>.rel(<\/code>\"staff\"<\/code>)<\/code><\/div>\n
                    <\/code>.build(id)<\/code><\/div>\n
             <\/code>)<\/code><\/div>\n
            <\/code>.build())<\/code><\/div>\n
        <\/code>.orElseThrow(() -> <\/code>new<\/code> NotFoundException(<\/code>\"The company with id '\"<\/code> + id + <\/code>\"' does not exists\"<\/code>));<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

There are few things happening here. The one we care about is usage of the ResponseBuilder::links<\/b> method where we supply three links. The first is self<\/b>, which is essentially the link context (defined as part of RFC-5988<\/a>). The second one, collection<\/b>, is pointing out to the CompanyResource<\/b> endpoint which returns the list of companies (also is included into standard relations registry). And lastly, the third one is our own staff<\/b> relation which we assemble from another CompanyResource<\/b> endpoint implemented by the method with the name getStaff<\/b> (we are going to see it shortly). These links are going to be delivered in the Link<\/b> response header and guide the client where to go next. Let us see it in action by running the application.

<\/div> <\/div><\/p>\n
\n
\n\n\n\n
\n
1<\/div>\n
2<\/div>\n<\/td>\n
\n
\n
$ mvn clean <\/code>package<\/code><\/div>\n
$ java -jar target\/jax-rs-<\/code>2.1<\/code>-hateaos-<\/code>0.0<\/code>.<\/code>1<\/code>-SNAPSHOT.jar<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

And inspect the response from this resource endpoint using curl<\/b> (the unnecessary details have been filtered out).<\/p>\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n
12<\/div>\n
13<\/div>\n
14<\/div>\n
15<\/div>\n
16<\/div>\n
17<\/div>\n<\/td>\n
\n
\n
$ curl -v http:<\/code>\/\/localhost:8080\/api\/companies\/1<\/code><\/div>\n
> GET \/api\/companies\/<\/code>1<\/code> HTTP\/<\/code>1.1<\/code><\/div>\n
> Host: localhost:<\/code>8080<\/code><\/div>\n
> User-Agent: curl\/<\/code>7.47<\/code>.<\/code>1<\/code><\/div>\n
> Accept: *\/*<\/code><\/div>\n
><\/code><\/div>\n
< HTTP\/<\/code>1.1<\/code> 200<\/code><\/div>\n
< Link: <http:<\/code>\/\/localhost:8080\/api\/companies\/1>;rel=\"self\"<\/code><\/div>\n
< Link: <http:<\/code>\/\/localhost:8080\/api\/companies\/1\/staff>;rel=\"staff\"<\/code><\/div>\n
< Link: <http:<\/code>\/\/localhost:8080\/api\/companies>;rel=\"collection\"<\/code><\/div>\n
< Content-Type: application\/json<\/code><\/div>\n
< Transfer-Encoding: chunked<\/code><\/div>\n
<<\/code><\/div>\n
{<\/code><\/div>\n
   <\/code>\"id\"<\/code>:<\/code>\"1\"<\/code>,<\/code><\/div>\n
   <\/code>\"name\"<\/code>:<\/code>\"HATEOAS, Inc.\"<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

The Link<\/b> header is there, referring to other endpoints of interest. From the client perspective, the things are looking pretty straightforward as well. The Response<\/b> class provides dedicated getLinks<\/b> method to wrap around the access to Link<\/b> response header, for example:<\/p>\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n
12<\/div>\n
13<\/div>\n
14<\/div>\n
15<\/div>\n
16<\/div>\n
17<\/div>\n
18<\/div>\n
19<\/div>\n
20<\/div>\n
21<\/div>\n<\/td>\n
\n
\n
final<\/code> Client client = ClientBuilder.newClient();<\/code><\/div>\n
 <\/div>\n
try<\/code> (<\/code>final<\/code> Response response = client<\/code><\/div>\n
        <\/code>.target(<\/code>\"http:\/\/localhost:8080\/api\/companies\/<\/a>{id}\"<\/code>)<\/code><\/div>\n
        <\/code>.resolveTemplate(<\/code>\"id\"<\/code>, <\/code>\"1\"<\/code>)<\/code><\/div>\n
        <\/code>.request()<\/code><\/div>\n
        <\/code>.accept(MediaType.APPLICATION_JSON)<\/code><\/div>\n
        <\/code>.get()) {<\/code><\/div>\n
            <\/code> <\/div>\n
    <\/code>final<\/code> Optional  staff = response<\/code><\/div>\n
        <\/code>.getLinks()<\/code><\/div>\n
        <\/code>.stream()<\/code><\/div>\n
        <\/code>.filter(link -> Objects.equals(link.getRel(), <\/code>\"staff\"<\/code>))<\/code><\/div>\n
        <\/code>.findFirst();<\/code><\/div>\n
            <\/code> <\/div>\n
    <\/code>staff.ifPresent(link -> {<\/code><\/div>\n
        <\/code>\/\/ follow the link here <\/code><\/div>\n
    <\/code>});           <\/code><\/div>\n
} <\/code>finally<\/code> {<\/code><\/div>\n
    <\/code>client.close();<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

So far so good. Moving forward, since HATEOAS<\/a> is essentially a part of the web APIs contract, let us find out what OpenAPI<\/a> specification has for it on the table. Unfortunately, HATEOAS<\/a> is not supported as of now<\/a>, but on the bright side, there is a notion of links<\/a> (although they should not be confused with Web Linking<\/a>, they are somewhat similar but not the same). To illustrate the usage of the links as part of the OpenAPI<\/a> specification, let us decorate the endpoint with Swagger<\/a> annotations.<\/p>\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n
12<\/div>\n
13<\/div>\n
14<\/div>\n
15<\/div>\n
16<\/div>\n
17<\/div>\n
18<\/div>\n
19<\/div>\n
20<\/div>\n
21<\/div>\n
22<\/div>\n
23<\/div>\n
24<\/div>\n
25<\/div>\n
26<\/div>\n
27<\/div>\n
28<\/div>\n
29<\/div>\n
30<\/div>\n
31<\/div>\n
32<\/div>\n
33<\/div>\n
34<\/div>\n
35<\/div>\n
36<\/div>\n
37<\/div>\n
38<\/div>\n
39<\/div>\n<\/td>\n
\n
\n
@Operation<\/code>(<\/code><\/div>\n
    <\/code>description = <\/code>\"Find Company by Id\"<\/code>,<\/code><\/div>\n
    <\/code>responses = {<\/code><\/div>\n
        <\/code>@ApiResponse<\/code>(<\/code><\/div>\n
            <\/code>content = <\/code>@Content<\/code>(schema = <\/code>@Schema<\/code>(implementation = Company.<\/code>class<\/code>)),<\/code><\/div>\n
            <\/code>links = {<\/code><\/div>\n
                <\/code>@io<\/code>.swagger.v3.oas.annotations.links.Link(<\/code><\/div>\n
                   <\/code>name = <\/code>\"self\"<\/code>, <\/code><\/div>\n
                   <\/code>operationRef = <\/code>\"#\/paths\/~1companies~1{id}\/get\"<\/code>,<\/code><\/div>\n
                   <\/code>description = <\/code>\"Find Company\"<\/code>,<\/code><\/div>\n
                   <\/code>parameters = <\/code>@LinkParameter<\/code>(name = <\/code>\"id\"<\/code>, expression = <\/code>\"$response.body#\/id\"<\/code>)<\/code><\/div>\n
                <\/code>),<\/code><\/div>\n
                <\/code>@io<\/code>.swagger.v3.oas.annotations.links.Link(<\/code><\/div>\n
                    <\/code>name = <\/code>\"staff\"<\/code>, <\/code><\/div>\n
                    <\/code>operationRef = <\/code>\"#\/paths\/~1companies~1{id}~1staff\/get\"<\/code>,<\/code><\/div>\n
                    <\/code>description = <\/code>\"Get Company Staff\"<\/code>,<\/code><\/div>\n
                    <\/code>parameters = <\/code>@LinkParameter<\/code>(name = <\/code>\"id\"<\/code>, expression = <\/code>\"$response.body#\/id\"<\/code>)<\/code><\/div>\n
                <\/code>),<\/code><\/div>\n
                <\/code>@io<\/code>.swagger.v3.oas.annotations.links.Link(<\/code><\/div>\n
                    <\/code>name = <\/code>\"collection\"<\/code>, <\/code><\/div>\n
                    <\/code>operationRef = <\/code>\"#\/paths\/~1companies\/get\"<\/code>,<\/code><\/div>\n
                    <\/code>description = <\/code>\"List Companies\"<\/code><\/div>\n
                <\/code>)<\/code><\/div>\n
            <\/code>},<\/code><\/div>\n
            <\/code>description = <\/code>\"Company details\"<\/code>,<\/code><\/div>\n
            <\/code>responseCode = <\/code>\"200\"<\/code><\/div>\n
        <\/code>),<\/code><\/div>\n
        <\/code>@ApiResponse<\/code>(<\/code><\/div>\n
            <\/code>description = <\/code>\"Company does not exist\"<\/code>,<\/code><\/div>\n
            <\/code>responseCode = <\/code>\"404\"<\/code><\/div>\n
        <\/code>)<\/code><\/div>\n
    <\/code>}<\/code><\/div>\n
)<\/code><\/div>\n
@Produces<\/code>(MediaType.APPLICATION_JSON)<\/code><\/div>\n
@GET<\/code><\/div>\n
@Path<\/code>(<\/code>\"{id}\"<\/code>)<\/code><\/div>\n
public<\/code> Response getCompanyById(<\/code>@Context<\/code> UriInfo uriInfo, <\/code>@PathParam<\/code>(<\/code>\"id\"<\/code>) String id) {<\/code><\/div>\n
  <\/code>\/\/ ...<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

If we run the application and navigate to the http:\/\/localhost:8080\/api\/api-docs<\/a> in the browser (this is where Swagger UI<\/a> is hosted), we would be able to see the links section along each response.<\/p>\n

\n
\"Hypermedia<\/figure>\n<\/div>\n

But besides that … not much you could do with the links there (please watch for this issue<\/a> if you are interested in the subject). The resource endpoint to get the company’s staff is looking quite similar.<\/p>\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n
12<\/div>\n
13<\/div>\n
14<\/div>\n
15<\/div>\n
16<\/div>\n
17<\/div>\n
18<\/div>\n
19<\/div>\n
20<\/div>\n
21<\/div>\n
22<\/div>\n
23<\/div>\n
24<\/div>\n
25<\/div>\n
26<\/div>\n
27<\/div>\n
28<\/div>\n
29<\/div>\n
30<\/div>\n
31<\/div>\n
32<\/div>\n
33<\/div>\n
34<\/div>\n
35<\/div>\n
36<\/div>\n
37<\/div>\n
38<\/div>\n
39<\/div>\n
40<\/div>\n
41<\/div>\n
42<\/div>\n
43<\/div>\n
44<\/div>\n
45<\/div>\n
46<\/div>\n
47<\/div>\n
48<\/div>\n
49<\/div>\n
50<\/div>\n
51<\/div>\n
52<\/div>\n<\/td>\n
\n
\n
@Operation<\/code>(<\/code><\/div>\n
    <\/code>description = <\/code>\"Get Company Staff\"<\/code>,<\/code><\/div>\n
    <\/code>responses = {<\/code><\/div>\n
        <\/code>@ApiResponse<\/code>(<\/code><\/div>\n
            <\/code>content = <\/code>@Content<\/code>(array = <\/code>@ArraySchema<\/code>(schema = <\/code>@Schema<\/code>(implementation = Person.<\/code>class<\/code>))),<\/code><\/div>\n
            <\/code>links = {<\/code><\/div>\n
                <\/code>@io<\/code>.swagger.v3.oas.annotations.links.Link(<\/code><\/div>\n
                    <\/code>name = <\/code>\"self\"<\/code>, <\/code><\/div>\n
                    <\/code>operationRef = <\/code>\"#\/paths\/~1companies~1{id}~1staff\/get\"<\/code>,<\/code><\/div>\n
                    <\/code>description = <\/code>\"Staff\"<\/code>,<\/code><\/div>\n
                    <\/code>parameters = <\/code>@LinkParameter<\/code>(name = <\/code>\"id\"<\/code>, expression = <\/code>\"$response.body#\/id\"<\/code>)<\/code><\/div>\n
                <\/code>),<\/code><\/div>\n
                <\/code>@io<\/code>.swagger.v3.oas.annotations.links.Link(<\/code><\/div>\n
                    <\/code>name = <\/code>\"company\"<\/code>, <\/code><\/div>\n
                    <\/code>operationRef = <\/code>\"#\/paths\/~1companies~1{id}\/get\"<\/code>,<\/code><\/div>\n
                    <\/code>description = <\/code>\"Company\"<\/code>,<\/code><\/div>\n
                    <\/code>parameters = <\/code>@LinkParameter<\/code>(name = <\/code>\"id\"<\/code>, expression = <\/code>\"$response.body#\/id\"<\/code>)<\/code><\/div>\n
                <\/code>)<\/code><\/div>\n
            <\/code>},<\/code><\/div>\n
            <\/code>description = <\/code>\"The Staff of the Company\"<\/code>,<\/code><\/div>\n
            <\/code>responseCode = <\/code>\"200\"<\/code><\/div>\n
        <\/code>),<\/code><\/div>\n
        <\/code>@ApiResponse<\/code>(<\/code><\/div>\n
            <\/code>description = <\/code>\"Company does not exist\"<\/code>,<\/code><\/div>\n
            <\/code>responseCode = <\/code>\"404\"<\/code><\/div>\n
        <\/code>)<\/code><\/div>\n
    <\/code>}<\/code><\/div>\n
)<\/code><\/div>\n
@Produces<\/code>(MediaType.APPLICATION_JSON)<\/code><\/div>\n
@GET<\/code><\/div>\n
@Path<\/code>(<\/code>\"{id}\/staff\"<\/code>)<\/code><\/div>\n
public<\/code> Response getStaff(<\/code>@Context<\/code> UriInfo uriInfo, <\/code>@PathParam<\/code>(<\/code>\"id\"<\/code>) String id) {<\/code><\/div>\n
    <\/code>return<\/code> service<\/code><\/div>\n
        <\/code>.findCompanyById(id)<\/code><\/div>\n
        <\/code>.map(c -> service.getStaff(c))<\/code><\/div>\n
        <\/code>.map(staff -> Response<\/code><\/div>\n
            <\/code>.ok(staff)<\/code><\/div>\n
            <\/code>.links(<\/code><\/div>\n
                <\/code>Link.fromUriBuilder(uriInfo<\/code><\/div>\n
                        <\/code>.getRequestUriBuilder())<\/code><\/div>\n
                    <\/code>.rel(<\/code>\"self\"<\/code>)<\/code><\/div>\n
                    <\/code>.build(),<\/code><\/div>\n
                <\/code>Link.fromUriBuilder(uriInfo<\/code><\/div>\n
                        <\/code>.getBaseUriBuilder()<\/code><\/div>\n
                        <\/code>.path(CompanyResource.<\/code>class<\/code>)<\/code><\/div>\n
                        <\/code>.path(id))<\/code><\/div>\n
                    <\/code>.rel(<\/code>\"company\"<\/code>)<\/code><\/div>\n
                    <\/code>.build()<\/code><\/div>\n
             <\/code>)<\/code><\/div>\n
            <\/code>.build())<\/code><\/div>\n
        <\/code>.orElseThrow(() -> <\/code>new<\/code> NotFoundException(<\/code>\"The company with id '\"<\/code> + id + <\/code>\"' does not exists\"<\/code>));<\/code><\/div>\n
}<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

As you might expect, beside the link to self<\/b>, it also includes the link to the company. When we try it out using curl<\/b>, the expected response headers are returned back.<\/p>\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n
12<\/div>\n
13<\/div>\n
14<\/div>\n
15<\/div>\n
16<\/div>\n
17<\/div>\n
18<\/div>\n
19<\/div>\n
20<\/div>\n
21<\/div>\n
22<\/div>\n
23<\/div>\n
24<\/div>\n
25<\/div>\n
26<\/div>\n<\/td>\n
\n
\n
$ curl -v http:<\/code>\/\/localhost:8080\/api\/companies\/1\/staff<\/code><\/div>\n
> GET \/api\/companies\/<\/code>1<\/code>\/staff HTTP\/<\/code>1.1<\/code><\/div>\n
> Host: localhost:<\/code>8080<\/code><\/div>\n
> User-Agent: curl\/<\/code>7.47<\/code>.<\/code>1<\/code><\/div>\n
> Accept: *\/*<\/code><\/div>\n
><\/code><\/div>\n
< HTTP\/<\/code>1.1<\/code> 200<\/code><\/div>\n
< Link: <http:<\/code>\/\/localhost:8080\/api\/companies\/1\/staff>;rel=\"self\"<\/code><\/div>\n
< Link: <http:<\/code>\/\/localhost:8080\/api\/companies\/1>;rel=\"company\"<\/code><\/div>\n
< Content-Type: application\/json<\/code><\/div>\n
< Transfer-Encoding: chunked<\/code><\/div>\n
<<\/code><\/div>\n
[<\/code><\/div>\n
    <\/code>{<\/code><\/div>\n
        <\/code>\"id\"<\/code>:<\/code>\"1\"<\/code>,<\/code><\/div>\n
        <\/code>\"email\"<\/code>:<\/code>\"john@smith.com\"<\/code>,<\/code><\/div>\n
        <\/code>\"firstName\"<\/code>:<\/code>\"John\"<\/code>,<\/code><\/div>\n
        <\/code>\"lastName\"<\/code>:<\/code>\"Smith\"<\/code><\/div>\n
    <\/code>},<\/code><\/div>\n
    <\/code>{<\/code><\/div>\n
        <\/code>\"id\"<\/code>:<\/code>\"2\"<\/code>,<\/code><\/div>\n
        <\/code>\"email\"<\/code>:<\/code>\"bob@smith.com\"<\/code>,<\/code><\/div>\n
        <\/code>\"firstName\"<\/code>:<\/code>\"Bob\"<\/code>,<\/code><\/div>\n
        <\/code>\"lastName\"<\/code>:<\/code>\"Smith\"<\/code><\/div>\n
    <\/code>}<\/code><\/div>\n
]<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n

So what kind of conclusions we can draw from that? HATEOAS<\/a> indeed unifies the interaction model between web API providers and consumers by dynamically driving the conversations. This is very powerful, but most of the frameworks and tools out there either have pretty basic support of the HATEOAS<\/a> (for example, Web Linking<\/a>) or none at all.<\/p>\n

There are many use cases when usage of the Web Linking<\/a> is sufficient (the examples we have seen so far, paging, navigation, …), but what about let say creating, editing or patching the existing resources? What about enriching with hypermedia the individual elements which are returned in the collection (described in RFC-6537<\/a>)? Is HATEOAS<\/a> worth all this efforts?<\/p>\n

As always, the answer is “it depends”, may be we should look beyond the JAX-RS<\/a>? In the next post(s_ we are going to continue figuring things out.<\/p>\n

The complete source code is available on Github<\/a>.<\/p>\n

\n\n\n\n
\n

Published on Java Code Geeks with permission by Andrey Redko, partner at our JCG program<\/a>. See the original article here: The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go<\/a><\/p>\n

Opinions expressed by Java Code Geeks contributors are their own.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Sooner or later, most of the developers who actively work on REST(ful) web services and APIs stumble upon this truly extraterrestrial thing called HATEOAS: Hypertext As The Engine Of Application State. The curiosity of what HATEOAS is and how it relates to REST would eventually lead to discovery of the Richardson Maturity Model which demystifies …<\/p>\n","protected":false},"author":141,"featured_media":148,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[1821,439,1859,30,854],"class_list":["post-88889","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-enterprise-java","tag-java-11","tag-jax-rs","tag-jax-rs-2-1","tag-spring","tag-spring-boot"],"yoast_head":"\nThe Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go - Java Code Geeks<\/title>\n<meta name=\"description\" content=\"Interested to learn about Hypermedia APIs ? Check our article explaining the Hypermedia APIs support in JAX-RS and OpenAPI\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go - Java Code Geeks\" \/>\n<meta property=\"og:description\" content=\"Interested to learn about Hypermedia APIs ? Check our article explaining the Hypermedia APIs support in JAX-RS and OpenAPI\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html\" \/>\n<meta property=\"og:site_name\" content=\"Java Code Geeks\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/javacodegeeks\" \/>\n<meta property=\"article:published_time\" content=\"2019-02-26T05:00:47+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2012\/10\/java-logo.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"150\" \/>\n\t<meta property=\"og:image:height\" content=\"150\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Andrey Redko\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@javacodegeeks\" \/>\n<meta name=\"twitter:site\" content=\"@javacodegeeks\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Andrey Redko\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"17 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html\"},\"author\":{\"name\":\"Andrey Redko\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#\\\/schema\\\/person\\\/771a6504862edc45322776832cbce413\"},\"headline\":\"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go\",\"datePublished\":\"2019-02-26T05:00:47+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html\"},\"wordCount\":1016,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.javacodegeeks.com\\\/wp-content\\\/uploads\\\/2012\\\/10\\\/java-logo.jpg\",\"keywords\":[\"Java 11\",\"JAX-RS\",\"jax-rs 2.1\",\"Spring\",\"Spring Boot\"],\"articleSection\":[\"Enterprise Java\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html\",\"url\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html\",\"name\":\"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go - Java Code Geeks\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.javacodegeeks.com\\\/wp-content\\\/uploads\\\/2012\\\/10\\\/java-logo.jpg\",\"datePublished\":\"2019-02-26T05:00:47+00:00\",\"description\":\"Interested to learn about Hypermedia APIs ? Check our article explaining the Hypermedia APIs support in JAX-RS and OpenAPI\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html#primaryimage\",\"url\":\"https:\\\/\\\/www.javacodegeeks.com\\\/wp-content\\\/uploads\\\/2012\\\/10\\\/java-logo.jpg\",\"contentUrl\":\"https:\\\/\\\/www.javacodegeeks.com\\\/wp-content\\\/uploads\\\/2012\\\/10\\\/java-logo.jpg\",\"width\":150,\"height\":150},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/2019\\\/02\\\/hypermedia-apis-support-jax-rs-openapi.html#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.javacodegeeks.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Java\",\"item\":\"https:\\\/\\\/www.javacodegeeks.com\\\/category\\\/java\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Enterprise Java\",\"item\":\"https:\\\/\\\/www.javacodegeeks.com\\\/category\\\/java\\\/enterprise-java\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#website\",\"url\":\"https:\\\/\\\/www.javacodegeeks.com\\\/\",\"name\":\"Java Code Geeks\",\"description\":\"Java Developers Resource Center\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#organization\"},\"alternateName\":\"JCG\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.javacodegeeks.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#organization\",\"name\":\"Exelixis Media P.C.\",\"url\":\"https:\\\/\\\/www.javacodegeeks.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.javacodegeeks.com\\\/wp-content\\\/uploads\\\/2022\\\/06\\\/exelixis-logo.png\",\"contentUrl\":\"https:\\\/\\\/www.javacodegeeks.com\\\/wp-content\\\/uploads\\\/2022\\\/06\\\/exelixis-logo.png\",\"width\":864,\"height\":246,\"caption\":\"Exelixis Media P.C.\"},\"image\":{\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/javacodegeeks\",\"https:\\\/\\\/x.com\\\/javacodegeeks\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.javacodegeeks.com\\\/#\\\/schema\\\/person\\\/771a6504862edc45322776832cbce413\",\"name\":\"Andrey Redko\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/16419ce8394173028eddaeb992859862bab50cfcf74589fa9bb9a3dd8bb27518?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/16419ce8394173028eddaeb992859862bab50cfcf74589fa9bb9a3dd8bb27518?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/16419ce8394173028eddaeb992859862bab50cfcf74589fa9bb9a3dd8bb27518?s=96&d=mm&r=g\",\"caption\":\"Andrey Redko\"},\"description\":\"Andriy is a well-grounded software developer with more then 12 years of practical experience using Java\\\/EE, C#\\\/.NET, C++, Groovy, Ruby, functional programming (Scala), databases (MySQL, PostgreSQL, Oracle) and NoSQL solutions (MongoDB, Redis).\",\"sameAs\":[\"http:\\\/\\\/aredko.blogspot.com\\\/\",\"http:\\\/\\\/ca.linkedin.com\\\/in\\\/aredko\"],\"url\":\"https:\\\/\\\/www.javacodegeeks.com\\\/author\\\/andrey-redko\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go - Java Code Geeks","description":"Interested to learn about Hypermedia APIs ? Check our article explaining the Hypermedia APIs support in JAX-RS and OpenAPI","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html","og_locale":"en_US","og_type":"article","og_title":"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go - Java Code Geeks","og_description":"Interested to learn about Hypermedia APIs ? Check our article explaining the Hypermedia APIs support in JAX-RS and OpenAPI","og_url":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html","og_site_name":"Java Code Geeks","article_publisher":"https:\/\/www.facebook.com\/javacodegeeks","article_published_time":"2019-02-26T05:00:47+00:00","og_image":[{"width":150,"height":150,"url":"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2012\/10\/java-logo.jpg","type":"image\/jpeg"}],"author":"Andrey Redko","twitter_card":"summary_large_image","twitter_creator":"@javacodegeeks","twitter_site":"@javacodegeeks","twitter_misc":{"Written by":"Andrey Redko","Est. reading time":"17 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html#article","isPartOf":{"@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html"},"author":{"name":"Andrey Redko","@id":"https:\/\/www.javacodegeeks.com\/#\/schema\/person\/771a6504862edc45322776832cbce413"},"headline":"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go","datePublished":"2019-02-26T05:00:47+00:00","mainEntityOfPage":{"@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html"},"wordCount":1016,"commentCount":0,"publisher":{"@id":"https:\/\/www.javacodegeeks.com\/#organization"},"image":{"@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html#primaryimage"},"thumbnailUrl":"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2012\/10\/java-logo.jpg","keywords":["Java 11","JAX-RS","jax-rs 2.1","Spring","Spring Boot"],"articleSection":["Enterprise Java"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html","url":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html","name":"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go - Java Code Geeks","isPartOf":{"@id":"https:\/\/www.javacodegeeks.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html#primaryimage"},"image":{"@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html#primaryimage"},"thumbnailUrl":"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2012\/10\/java-logo.jpg","datePublished":"2019-02-26T05:00:47+00:00","description":"Interested to learn about Hypermedia APIs ? Check our article explaining the Hypermedia APIs support in JAX-RS and OpenAPI","breadcrumb":{"@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html#primaryimage","url":"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2012\/10\/java-logo.jpg","contentUrl":"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2012\/10\/java-logo.jpg","width":150,"height":150},{"@type":"BreadcrumbList","@id":"https:\/\/www.javacodegeeks.com\/2019\/02\/hypermedia-apis-support-jax-rs-openapi.html#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.javacodegeeks.com\/"},{"@type":"ListItem","position":2,"name":"Java","item":"https:\/\/www.javacodegeeks.com\/category\/java"},{"@type":"ListItem","position":3,"name":"Enterprise Java","item":"https:\/\/www.javacodegeeks.com\/category\/java\/enterprise-java"},{"@type":"ListItem","position":4,"name":"The Hypermedia APIs support in JAX-RS and OpenAPI: a long way to go"}]},{"@type":"WebSite","@id":"https:\/\/www.javacodegeeks.com\/#website","url":"https:\/\/www.javacodegeeks.com\/","name":"Java Code Geeks","description":"Java Developers Resource Center","publisher":{"@id":"https:\/\/www.javacodegeeks.com\/#organization"},"alternateName":"JCG","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.javacodegeeks.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.javacodegeeks.com\/#organization","name":"Exelixis Media P.C.","url":"https:\/\/www.javacodegeeks.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.javacodegeeks.com\/#\/schema\/logo\/image\/","url":"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2022\/06\/exelixis-logo.png","contentUrl":"https:\/\/www.javacodegeeks.com\/wp-content\/uploads\/2022\/06\/exelixis-logo.png","width":864,"height":246,"caption":"Exelixis Media P.C."},"image":{"@id":"https:\/\/www.javacodegeeks.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/javacodegeeks","https:\/\/x.com\/javacodegeeks"]},{"@type":"Person","@id":"https:\/\/www.javacodegeeks.com\/#\/schema\/person\/771a6504862edc45322776832cbce413","name":"Andrey Redko","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/16419ce8394173028eddaeb992859862bab50cfcf74589fa9bb9a3dd8bb27518?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/16419ce8394173028eddaeb992859862bab50cfcf74589fa9bb9a3dd8bb27518?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/16419ce8394173028eddaeb992859862bab50cfcf74589fa9bb9a3dd8bb27518?s=96&d=mm&r=g","caption":"Andrey Redko"},"description":"Andriy is a well-grounded software developer with more then 12 years of practical experience using Java\/EE, C#\/.NET, C++, Groovy, Ruby, functional programming (Scala), databases (MySQL, PostgreSQL, Oracle) and NoSQL solutions (MongoDB, Redis).","sameAs":["http:\/\/aredko.blogspot.com\/","http:\/\/ca.linkedin.com\/in\/aredko"],"url":"https:\/\/www.javacodegeeks.com\/author\/andrey-redko"}]}},"_links":{"self":[{"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/posts\/88889","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/users\/141"}],"replies":[{"embeddable":true,"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/comments?post=88889"}],"version-history":[{"count":0,"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/posts\/88889\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/media\/148"}],"wp:attachment":[{"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/media?parent=88889"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/categories?post=88889"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.javacodegeeks.com\/wp-json\/wp\/v2\/tags?post=88889"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}