[jira] [Created] (SOLR-16370) Migrate v2 APIs to JAX-RS framework

["Jason Gerlowski (Jira)" <ji...@apache.org>]

Jason Gerlowski created SOLR-16370:
--------------------------------------

             Summary: Migrate v2 APIs to JAX-RS framework
                 Key: SOLR-16370
                 URL: https://issues.apache.org/jira/browse/SOLR-16370
             Project: Solr
          Issue Type: Improvement
      Security Level: Public (Default Security Level. Issues are Public)
          Components: v2 API
    Affects Versions: main (10.0)
            Reporter: Jason Gerlowski
            Assignee: Jason Gerlowski


Now that a basic JAX-RS framework has been added (see SOLR-16347), we can start migrating our v2 API definitions in that direction. Of course, this will entail a lot of work, but it brings several distinct advantages:
 * JAX-RS API definitions describe inputs and outputs more explicitly than our current framework, hopefully leading to more readable, maintainable code.
 * Moving API logic from existing RequestHandlers to the v2 definition (which JAX-RS is a large part of) will ensure that our v2 definitions don't "fall behind" our v1 code. (i.e. JAX-RS mostly solves SOLR-15736)
 * JAX-RS API definitions are compatible out-of-the-box with most OpenAPI tooling (see SOLR-16346). The more APIs we move to JAX-RS, the easier it'll be to start using OpenAPI to generate clients, etc. down the road.

This ticket aims to serve as an umbrella, with a number of subtasks covering logical "chunks" of our v2 API surface.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@solr.apache.org
For additional commands, e-mail: issues-help@solr.apache.org