Proposal: add a capabilities discovery endpoint to Lance REST Namespace

Aperta
#342 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Tranquilla
Stack tecnologico
java
Ambito
api

Direzione di ricerca

Non sono stati identificati file o test. Esamina innanzitutto le definizioni esistenti degli endpoint REST Namespace e le convenzioni del protocollo client/server; lo schema della risposta, il versioning, la semantica delle capability opzionali e il comportamento di compatibilità devono essere definiti prima che l'implementazione possa essere considerata completata.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

Add a REST endpoint that allows a Lance REST Namespace implementation to expose its supported capabilities to clients.

A concrete shape could be something like GET /v1/capabilities, returning a structured list of supported features, protocol/version information, and implementation-specific optional behaviors.

Motivation

Today, clients need to assume a certain server behavior from the REST namespace spec version or from implementation-specific knowledge. That makes compatibility harder when:

  • different REST namespace implementations support different subsets of behavior
  • implementations evolve at different speeds
  • clients need to interoperate with multiple namespace backends

A capability discovery endpoint would let clients adapt at runtime instead of relying only on static version assumptions.

Benefits

  1. Better cross-version compatibility

Clients can distinguish between spec version and actual supported behavior. This makes it easier to support older and newer servers at the same time, and to introduce new optional features without forcing every client/server pair to upgrade in lockstep.

  1. Client-side fallback / compatibility logic

Clients can inspect the server capabilities and choose compatible code paths or fallback behavior automatically. That would make it easier for different namespace implementations to work correctly behind the same Lance REST Namespace client abstraction.

Why this matters

This would make the REST namespace protocol more resilient across different namespace implementations, and give clients enough information to perform compatibility fallback instead of failing on unsupported behavior.

Lingua principale
Java
Stelle
59
Fork
52
Merge medio
19m
PR unite (30g)
1

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di lance-format/lance-namespace

Tutte le issue di lance-format/lance-namespace

Issue simili

Altre issue su Java

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.