Prompt per gestire i conflitti di concorrenza nelle API REST

Contesto e ruolo dell'AI: Sei un ingegnere esperto in progettazione di API REST per servizi di microservizi, specializzato nella prevenzione di conflitti di concorrenza. Il tuo compito è fornire un prompt dettagliato che guidi un AI sviluppatore a implementare una strategia solida per gestire le condizioni di race condition quando più istanze aggiornano lo stesso record. Obiettivi chiari e specifici: - Identificare i principali meccanismi di risoluzione dei conflitti (controllo optimistic, blocco delle transazioni, controllo delle versioni). - Generare un piano passo-passo per integrare questi meccanismi in un endpoint CRUD generico. - Fornire un esempio concreto che illustri come il prompt può essere utilizzato per creare codice riutilizzabile. - Assicurarsi che il prompt sia orientato alle esigenze di chi cerca su Google "come risolvere i conflitti di concorrenza nelle API REST". Input richiesti con placeholder: - [nomeRisorsa]: Nome della risorsa principale (es. "Ordine", "Account"). - [identificativoCliente]: Identificativo univoco del cliente o della tenant che deve essere incluso in ogni richiesta. - [chiavePrimaria] (opzionale): Chiave primaria del record, se diversa dall'identificativo. - [statoVersione] (opzionale): Campo che registra la versione corrente del record per il controllo optimistic. - [tipoBlocco] (opzionale): Tipo di blocco distribuito da utilizzare come fallback (es. Redis, ETCD). Processo step-by-step numerato: 1. Definisci il modello dei dati: includi un campo [statoVersione] con incremento atomico ad ogni aggiornamento. 2. Progetta l'endpoint di LetturaRecupero: restituisci i dati attuali insieme al [statoVersione] corrente. 3. Implementa l'endpoint di Aggiornamento: accetta una versione [statoVersione] in ingresso; se il valore non corrisponde, restituisci un errore 409 (Conflitto). 4. Applica il controllo optimistic come primo meccanismo di difesa; se il conflitto persiste, avvia un blocco distribuito utilizzando [tipoBlocco] per serializzare gli aggiornamenti. 5. Utilizza un campo [identificativoCliente] per garantire l'isolamento per cliente e ridurre al minimo le collisioni. 6. Registra ogni conflitto e blocco in un log centralizzato per il monitoraggio e il debug. 7. Fornisci un meccanismo di ripetizione automatica che consenta al client di recuperare lo stato più recente e riprovare l'aggiornamento. Formato output desiderato: - Funzioni di supporto: `GetResourceAsync`, `UpdateResourceAsync`. - Strutture dei dati: `ResourceDto` (inclusi `ETag`/`Version`). - Errori: 409 Conflict con corpo JSON `{ "message": "Conflitto di versione", "currentVersion": "X", "suggestedVersion": "Y" }`. - Esempio di blocco: snippet di codice che utilizza Redis `SETNX` o ETCD `Txn`. - Documentazione: breve README con diagramma di flusso e passaggi di test. Esempio se utile: ``` // Esempio di controllo optimistic con versione if (incomingVersion != currentVersion) { throw new ConflictException( "La risorsa [nomeRisorsa] con ID [chiavePrimaria] è stata modificata.", currentVersion, GetNewVersion() ); } ``` Inoltre, mostra un blocco distribuito di fallback: ``` using (var lock = await _distributedLock.AcquireAsync([chiavePrimaria], TimeSpan.FromSeconds(5))) { // riesegui l'aggiornamento dopo aver acquisito il lock } ``` Un angolo utile per chi cerca su Google: Fornisci il prompt come una guida completa per "risolvere i conflitti di concorrenza nelle API REST", evidenziando sia le strategie optimistic che quelle basate sul blocco, e includendo snippet di codice pratici con i placeholder richiesti. In questo modo, chi cerca una soluzione concreta troverà una risposta pronta per l'uso che può essere adattata immediatamente al proprio microservizio.