[FEATURE] Support for terms lookup by query feature in OpenSearch 3.2.0

[kieran-pringle]

Is your feature request related to a problem?

opensearch-java 3.8.0 has a builder for a TermsLookup, but this does not have a query method to set a query, as can be done since OpenSearch 3.2.0:

https://docs.opensearch.org/latest/query-dsl/term/terms/#terms-lookup-by-query

I am willing to contribute this, but I see that these query classes and their builders are generated code, and I do not know which upstream sources to edit.

What solution would you like?

I would like to be able to set a query on the TermsLookup.Builder class

What alternatives have you considered?

I am currently using raw JSON, but this is difficult to manage

[kieran-pringle]

Am I correct that adding this takes updating opensearch-openapi.yaml ?

I see:

    _common.query_dsl___TermsLookup:
      type: object
      properties:
        index:
          $ref: '#/components/schemas/_common___IndexName'
        id:
          $ref: '#/components/schemas/_common___Id'
        path:
          $ref: '#/components/schemas/_common___Field'
        routing:
          $ref: '#/components/schemas/_common___Routing'
        store:
          type: boolean
      required:
        - id
        - index
        - path

Would I change this to?:

    _common.query_dsl___TermsLookup:
      type: object
      properties:
        index:
          $ref: '#/components/schemas/_common___IndexName'
        id:
          $ref: '#/components/schemas/_common___Id'
        path:
          $ref: '#/components/schemas/_common___Field'
        query:
          $ref: '#/components/schemas/_common.query_dsl___QueryContainer'
        routing:
          $ref: '#/components/schemas/_common___Routing'
        store:
          type: boolean
      required:
        - id
        - index
        - path

And add any associated tests etc?

[kieran-pringle]

Closed as I now understand this would be added in https://github.com/opensearch-project/opensearch-api-specification