Feature request: XmlDocumentManager.write() returns an updated DocumentDescriptor

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);

从 XmlDocumentManager.write(DocumentDescriptor desc, WriteHandle handle) 开始，检查其接口、实现和现有测试。更新 API，使写入操作返回包含新文档版本的更新后 DocumentDescriptor，然后验证受影响的写入行为和调用方。