Contact Free trial Login

Object Store Connector - Mule 4

Support Category: Select

Object Store Connector is a Mule component that allows for simple key-value storage. Although it can serve a wide variety of use cases, it is mainly design for:

  • Storing synchronization information, such as watermarks.

  • Storing temporal information such as access tokens.

  • Storing user information.

Additionally, Mule Runtime uses Object Stores to support some of its own components, for example:

  • The Cache module uses an Object Store to maintain all of the cached data.

  • The OAuth module (and every OAuth enabled connector) uses Object Stores to store the access and refresh tokens.

Object Store Limitations

Object Stores are not a universal solution for data storage. They do not replace a database, and they are not suitable for every use case. Most importantly, they do not support transactional access or modification. For use cases in which ACID semantics are needed, or for cases where you expect the same key to be updated in parallel, consider another solution.

Use the Default Object Store

By default, each Mule app has an Object Store that is persistent and always available to the app without any configuration. Flows can use it to persist and share data.

If you want to use the default Object Store, you can specify a key for the Object Store without selecting or creating an Object Store reference for the Object Store operation, and without specifying an objectStore attribute in the XML element for the Object Store component.

The Mule app is deployed to CloudHub workers using Anypoint Platform Runtime Manager, but the contents of the default Object Store are not visible in Runtime Manager in the Application Data page for the app.

It is important to understand that the only Object Store displayed in the Runtime Manager Application Data tab is the default Object Store.

Use a Custom Object Store

Custom Object Stores must specify an objectStore attribute. These Object Stores can be configured to behave differently than the default Object Store. For example, you can indicate whether the Object Store is persistent (so that the Object Store data survives a Mule Runtime crash) or transient (where data does not survive a Mule Runtime crash). Here are some common reasons for defining custom Object Stores:

  • You want to partition your information by storing it in different Object Stores.

  • You want to use advanced Object Store features such as these:

    • Transient/Persistent storage.

    • Specification of a time to live (TTL).

    • Specification of a max capacity.

  • You want to keep different components from sharing state by feeding them with different Object Stores.

  • You want different components to share information by feeding them with the same Object Stores.