marklogic / marklogic/java-client-api
Feature request: XmlDocumentManager.write() returns an updated DocumentDescriptor
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Java
- Sterne
- 61
- Forks
- 74
- Ø Merge
- 2 T. 53 Min.
- Gemergte PRs (30 T.)
- 8
Beschreibung
We would like to use the optimistic read feature on XmlDocumentManager.read(DocumentDescriptor desc, String uri). To use it effiently we would store the latest DocumentDescriptor and document in memory on our client side, thus when XmlDocumentManager.read(DocumentDescriptor descr, String uri) returns null - signalling that the content on the server has not changed in between - we know that our descriptor and document in memory is up to date.
Request: to close the loop we would need to enhance the XmlDocumentManager's write method to return the updated DocumentDescriptor (with the updated document version number inside) like this:
DocumentDescriptor write(DocumentDescriptor desc, WriteHandle handle);
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne bei XmlDocumentManager.write(DocumentDescriptor desc, WriteHandle handle) und untersuche dessen Schnittstelle, Implementierungen und vorhandenen Tests. Aktualisiere die API so, dass der Schreibvorgang den aktualisierten DocumentDescriptor mit der neuen Dokumentversion zurückgibt, und überprüfe anschließend das betroffene Schreibverhalten und die Aufrufer.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- java
- Bereich
- api, databases
- Issue-Typ
- Feature
- Schwierigkeit
- 3/5
- Geschätzter Aufwand
- 1-2 Tage
- Aktivitätsstatus
- Ruhig
- Klarheit
- Klar beschrieben
- Anfängerfreundlichkeit
- 58/100