Multiple API Versions using Crnk or Katharsis











up vote
0
down vote

favorite












We're evaluating crnk (since Katharsis is dead) for implementing json:api. We're also considering having multiple API versions in a single binary, so that all versions are more continuously maintained/scanned. Finally, we've selected the URI versioning strategy, thus our URIs will contain /v1, /v2 etc. We are using Spring Boot 1.5.



In typical @RestController RESTServices, you can easily specify @RequestMapping paths to allow for multiple versions in a URI...



@Controller
@RequestMapping("/v1")
@RequestMapping(value = "/customers/{identifier}", method = RequestMethod.GET, produces = "application/json")

@Controller
@RequestMapping("/v2")
@RequestMapping(value = "/customers/{identifier}", method = RequestMethod.GET, produces = "application/json")


However, in crnk, how is this done? I've somewhat found a workaround by adding the API version to the resource path, but that feels horribly wrong.



@JsonApiResource(type = "customer", resourcePath = "/v1/customers")
public class Customer {

@JsonApiId
private long identifier;


This will indeed put the customers resource beneath the API version, but it feels like I'm versioning the resource, rather than the API. Furthermore, as I attempted this earlier today, I ended up creating copies of all the resources and repositories which created bean conflicts and other issues.



Has anybody found a clean way of doing this, or will we need to use separate binaries for different API versions?



Thanks for your time!



John










share|improve this question




























    up vote
    0
    down vote

    favorite












    We're evaluating crnk (since Katharsis is dead) for implementing json:api. We're also considering having multiple API versions in a single binary, so that all versions are more continuously maintained/scanned. Finally, we've selected the URI versioning strategy, thus our URIs will contain /v1, /v2 etc. We are using Spring Boot 1.5.



    In typical @RestController RESTServices, you can easily specify @RequestMapping paths to allow for multiple versions in a URI...



    @Controller
    @RequestMapping("/v1")
    @RequestMapping(value = "/customers/{identifier}", method = RequestMethod.GET, produces = "application/json")

    @Controller
    @RequestMapping("/v2")
    @RequestMapping(value = "/customers/{identifier}", method = RequestMethod.GET, produces = "application/json")


    However, in crnk, how is this done? I've somewhat found a workaround by adding the API version to the resource path, but that feels horribly wrong.



    @JsonApiResource(type = "customer", resourcePath = "/v1/customers")
    public class Customer {

    @JsonApiId
    private long identifier;


    This will indeed put the customers resource beneath the API version, but it feels like I'm versioning the resource, rather than the API. Furthermore, as I attempted this earlier today, I ended up creating copies of all the resources and repositories which created bean conflicts and other issues.



    Has anybody found a clean way of doing this, or will we need to use separate binaries for different API versions?



    Thanks for your time!



    John










    share|improve this question


























      up vote
      0
      down vote

      favorite









      up vote
      0
      down vote

      favorite











      We're evaluating crnk (since Katharsis is dead) for implementing json:api. We're also considering having multiple API versions in a single binary, so that all versions are more continuously maintained/scanned. Finally, we've selected the URI versioning strategy, thus our URIs will contain /v1, /v2 etc. We are using Spring Boot 1.5.



      In typical @RestController RESTServices, you can easily specify @RequestMapping paths to allow for multiple versions in a URI...



      @Controller
      @RequestMapping("/v1")
      @RequestMapping(value = "/customers/{identifier}", method = RequestMethod.GET, produces = "application/json")

      @Controller
      @RequestMapping("/v2")
      @RequestMapping(value = "/customers/{identifier}", method = RequestMethod.GET, produces = "application/json")


      However, in crnk, how is this done? I've somewhat found a workaround by adding the API version to the resource path, but that feels horribly wrong.



      @JsonApiResource(type = "customer", resourcePath = "/v1/customers")
      public class Customer {

      @JsonApiId
      private long identifier;


      This will indeed put the customers resource beneath the API version, but it feels like I'm versioning the resource, rather than the API. Furthermore, as I attempted this earlier today, I ended up creating copies of all the resources and repositories which created bean conflicts and other issues.



      Has anybody found a clean way of doing this, or will we need to use separate binaries for different API versions?



      Thanks for your time!



      John










      share|improve this question















      We're evaluating crnk (since Katharsis is dead) for implementing json:api. We're also considering having multiple API versions in a single binary, so that all versions are more continuously maintained/scanned. Finally, we've selected the URI versioning strategy, thus our URIs will contain /v1, /v2 etc. We are using Spring Boot 1.5.



      In typical @RestController RESTServices, you can easily specify @RequestMapping paths to allow for multiple versions in a URI...



      @Controller
      @RequestMapping("/v1")
      @RequestMapping(value = "/customers/{identifier}", method = RequestMethod.GET, produces = "application/json")

      @Controller
      @RequestMapping("/v2")
      @RequestMapping(value = "/customers/{identifier}", method = RequestMethod.GET, produces = "application/json")


      However, in crnk, how is this done? I've somewhat found a workaround by adding the API version to the resource path, but that feels horribly wrong.



      @JsonApiResource(type = "customer", resourcePath = "/v1/customers")
      public class Customer {

      @JsonApiId
      private long identifier;


      This will indeed put the customers resource beneath the API version, but it feels like I'm versioning the resource, rather than the API. Furthermore, as I attempted this earlier today, I ended up creating copies of all the resources and repositories which created bean conflicts and other issues.



      Has anybody found a clean way of doing this, or will we need to use separate binaries for different API versions?



      Thanks for your time!



      John







      spring-boot json-api katharsis crnk






      share|improve this question















      share|improve this question













      share|improve this question




      share|improve this question








      edited Nov 9 at 4:44









      Michael Petch

      24.7k55599




      24.7k55599










      asked Nov 9 at 3:25









      Powdered Toast Man

      13




      13





























          active

          oldest

          votes











          Your Answer






          StackExchange.ifUsing("editor", function () {
          StackExchange.using("externalEditor", function () {
          StackExchange.using("snippets", function () {
          StackExchange.snippets.init();
          });
          });
          }, "code-snippets");

          StackExchange.ready(function() {
          var channelOptions = {
          tags: "".split(" "),
          id: "1"
          };
          initTagRenderer("".split(" "), "".split(" "), channelOptions);

          StackExchange.using("externalEditor", function() {
          // Have to fire editor after snippets, if snippets enabled
          if (StackExchange.settings.snippets.snippetsEnabled) {
          StackExchange.using("snippets", function() {
          createEditor();
          });
          }
          else {
          createEditor();
          }
          });

          function createEditor() {
          StackExchange.prepareEditor({
          heartbeatType: 'answer',
          convertImagesToLinks: true,
          noModals: true,
          showLowRepImageUploadWarning: true,
          reputationToPostImages: 10,
          bindNavPrevention: true,
          postfix: "",
          imageUploader: {
          brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
          contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
          allowUrls: true
          },
          onDemand: true,
          discardSelector: ".discard-answer"
          ,immediatelyShowMarkdownHelp:true
          });


          }
          });














           

          draft saved


          draft discarded


















          StackExchange.ready(
          function () {
          StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53219415%2fmultiple-api-versions-using-crnk-or-katharsis%23new-answer', 'question_page');
          }
          );

          Post as a guest















          Required, but never shown






























          active

          oldest

          votes













          active

          oldest

          votes









          active

          oldest

          votes






          active

          oldest

          votes
















           

          draft saved


          draft discarded



















































           


          draft saved


          draft discarded














          StackExchange.ready(
          function () {
          StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f53219415%2fmultiple-api-versions-using-crnk-or-katharsis%23new-answer', 'question_page');
          }
          );

          Post as a guest















          Required, but never shown





















































          Required, but never shown














          Required, but never shown












          Required, but never shown







          Required, but never shown

































          Required, but never shown














          Required, but never shown












          Required, but never shown







          Required, but never shown







          Popular posts from this blog

          Schultheiß

          Verwaltungsgliederung Dänemarks

          Liste der Kulturdenkmale in Wilsdruff