You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Use stereotype <<MongoDBAdapter>> on an action node to interact with a MongoDB and to insert, get and manipulate documents.

Example File (Builder project Add-ons/MongoDB):

<your example path>\Add-ons\MongoDB\uml\simpleMongoDbAccess.xml

Using action find you can retrieve data. MongoDB stores data in form of documents that are depicted in a JSON-like format. Queries always return one or more complete documents.

For all actions that refer to existing documents, you need to provide a query string (queryString) to identify them. A query string contains all properties of the document you want to use for selection.
The simplest way to create a query string is to create an object having the structure of the document (queryData in the example above), and set all query values to this object.

Then, provide this object as queryString by converting it to JSON using classToJson().

A find action of a <<MongoDBAdapter>> returns either a result set or a handle.

NameTypeDescription
resultArray of StringAn array of all resulting documents in JSON format.The complete set of found documents in an array.
Array of <document class>

An array of objects of an xUML class representing the document structure.

This only makes sense if you know the structure of the documents you are accessing.

handleMongoDBHandle

A handle to a result set.

This is helpful if

  • you expect a huge amount of documents being returned, and do not want to load the complete result set to the memory
  • you want to iterate over the result set one by one anyway, and e.g. only regard a subset of the result for further processing.

You need to process the result set one by one using fetch.

Refer to Action "find" and Action "fetch" for a detailed description of all parameters and options.

Related Pages:

  • No labels