CRUD

Yep that's Create, Read, Update, and Delete. We use the term Insert instead of Create but that doesn't keep us from saying CRUD for fun. MarkLogic provides a simple Java API for CRUD.

The first step is to use our DatabaseClient instance (client) to get a DocumentManager instance (in this case, a JSONDocumentManager instance):

JSONDocumentManager docMgr = client.newJSONDocumentManager();

To insert a document, call the write() method:

docMgr.write("/afternoon-drink", new StringHandle("{name: \"Iced Mocha\", size: \"Grandé\", tasty: true}"));

In the above case, the JSON document is provided using a StringHandle, which is one of many different handle types you can use as wrappers for content passed to and from MarkLogic.

To get the document back, call the read() method:

String doc = docMgr.read("/afternoon-drink", new StringHandle()).get();

If I prefered to have MarkLogic automatically generate a unique URI, I could instead do

DocumentDescriptor docDesc = docMgr.create(docMgr.newDocumentUriTemplate("json"), new StringHandle("{name: \"Iced Mocha\", size: \"Grandé\", tasty: true}"));

(This call will return a DocumentDescriptor that can be queried for the new URI.)

Updating (replacing) the document works exactly the same as creating a document: use the write() method.

To delete the document, call the delete() method:

docMgr.delete("/afternoon-drink");

The Java API provides additional functionality related to CRUD, including

• Updating (patching) pieces of documents
• Transforming documents during retrieval (for example, to HTML on the way out)
• Transforming documents during insertion (for example, to XML on the way in)
• Managing document metadata (collections, permissions, properties, quality)
• And much more!

These techniques are covered in the Java Application Developer's Guide.