Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

SOLR-16825: Migrate v2 API definitions to 'api' module, pt 8 #2833

Merged
merged 8 commits into from
Nov 12, 2024

Conversation

gerlowskija
Copy link
Contributor

@gerlowskija gerlowskija commented Nov 1, 2024

https://issues.apache.org/jira/browse/SOLR-16825

Description

SOLR-16825 added a new gradle module, 'api', which holds v2 API definitions as interfaces. This allows us to generate an OAS (and SolrRequest implementations from that) as a part of the solrj build.

But these artifacts (the OAS and generated Java code), only cover the v2 APIs that have interfaces in the 'api' module. We need to extract interfaces to live in 'api' for each v2 API in 'core' that doesn't already have one.

Solution

This PR creates 'api' interfaces for a number of v2 APIs, allowing them to be included in Solr's generated clients. The following APIs are covered in this PR:

  • create alias
  • replication "fetch file list"
  • replication "fetch index version"
  • schema "list fields"
  • schema "get field info"
  • schema "list copy fields"
  • schema "list dynamic fields"
  • schema "get dynamic field info"
  • schema "list fieldtypes"
  • schema "get fieldtype info"

Tests

PR is a refactor, so doesn't add any additional tests. But manual testing has been done to make sure the affected v2 APIs continue to work, and existing tests continue to pass.

Checklist

Please review the following and check all that apply:

  • I have reviewed the guidelines for How to Contribute and my code conforms to the standards described there to the best of my ability.
  • I have created a Jira issue and added the issue ID to my pull request title.
  • I have given Solr maintainers access to contribute to my PR branch. (optional but recommended, not available for branches on forks living under an organisation)
  • I have developed this patch against the main branch.
  • I have run ./gradlew check.

SOLR-16825 added a new gradle module, 'api', which holds v2 API
definitions as interfaces.  This allwos us to generate an OAS (and other
artifacts) as a part of the solrj build.  But these artifacts only cover
the v2 APIs present in the 'api' module.

This commit moves v2 API defining annotations to new interfaces in the
'api' module for several "schema" fetching and listing APIs.
@gerlowskija gerlowskija marked this pull request as ready for review November 7, 2024 14:39
@gerlowskija gerlowskija merged commit eef9bbc into apache:main Nov 12, 2024
3 of 4 checks passed
@gerlowskija gerlowskija deleted the SOLR-16825-migrate-apis-pt8 branch November 12, 2024 18:26
gerlowskija added a commit that referenced this pull request Nov 12, 2024
SOLR-16825 added a new gradle module, 'api', which holds v2 API
definitions as interfaces.  This allows us to generate an OAS (and other
artifacts) as a part of the solrj build.  But these artifacts only cover
the v2 APIs present in the 'api' module.

This commit moves v2 API defining annotations to new interfaces in the
'api' module for several "schema", "replication", and "logging" APIs as
well as 'create-alias'.  This APIs are all now reflected in our OAS and
generated artifacts.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant