A Quick Intro to Vuex ORM
Learn what Vue ORM is, how it works, how it compares to Vuex, and let's get started making a scalable Vue or Nuxt application.
Join the DZone community and get the full member experience.
Join For FreeIf you're looking to make a scalable Vue or Nuxt app, you might consider using Vuex ORM. I've recently used it in a project, and in this article, I'll share with you how it works and why I think you'll like it, too.
What Is Vuex ORM?
Vuex introduces some powerful concepts for managing your application state including the store, mutations, actions, and so on.
Vuex ORM is an abstraction of Vuex that allows you to think about your application state in terms of models e.g. Posts, Users, Orders, etc, and CRUD operations, e.g. create, update, delete, etc.
ORM tools (object-relational mapping) transform data between incompatible system using objects. ORMs are very popular for databases.
You may also like: Vue.js Tutorial 1 — Hello Vue
This allows for a significant simplification of your code. For example, rather than this.$store.state.commit("UPDATE_USER", { ... })
, you can use User.update({ ... })
, making your Vue code much easier to reason about.
The other advantages of Vuex ORM are that it reduces boilerplate code by setting up the mutations and getter you'll need automatically, and also makes it easy to work with nested data structures in your application state.
From Vuex to Vuex ORM
As a way of demonstrating the advantages, let's refactor some raw Vuex code using Vuex ORM.
We'll use a classic to-do list example where we can mark a to-do as "done". Here's the store which will represent that:
store/index.js
xxxxxxxxxx
store: {
state: { todos: [] },
mutations: {
MARK_DONE(state, id) {
const todo = state.todos.find(todo => todo.id === id);
todo.done = true;
}
}
}
Let's say we display our to-do items on the home page of the app. We'll use a computed property todos
and a v-for
to link the to-do items to the template.
When a to-do is clicked, we'll mark it as "done" by making a commitment to the MARK_DONE
mutation.
components/Home.vue
xxxxxxxxxx
<template>
<todo-item
v-for="todo in todos"
:todo="todo"
="markDone(todo.id)"
/>
</template>
<script>
export default {
computed: {
todos() {
return this.$store.state.todos;
}
},
methods: {
markDone(id) {
this.$store.state.commit(MARK_DONE, id);
}
}
}
</script>
The Vuex ORM way
As I said, Vuex ORM represents data as models. So we'll first create a Todo model and define the fields we'd need like id
, title
, and done
.
Unlike most Vue software, Vuex ORM uses ES6 classes for configuration.
store/models/post.js
xxxxxxxxxx
import { Model } from "@vuex-orm/core";
export default class Todo extends Model {
static entity = "todos";
static fields () {
return {
id: this.string(""),
title: this.string(""),
done: this.boolean(false),
...
};
}
}
Now it's time to register the model to the Vuex ORM "database", which allows you to use the model.
While we're at it, we can register the Vuex ORM plugin with Vuex.
store/index.js
xxxxxxxxxx
import VuexORM from "@vuex-orm/core";
import Todo from "./models/Todo";
const database = new VuexORM.Database();
database.register(Todo, {});
const plugin = VuexORM.install(database);
export default {
plugins: [plugin]
};
With our Vuex ORM store set up, we can start using it in our components. First, import the model into a component file. Now, rather than using the "weird" syntax of Vuex, we can use standard CRUD methods to query our store:
components/Home.vue
xxxxxxxxxx
import Todo from "../store/models/todo";
export default {
computed: {
// posts() {
// return this.$store.state.todos;
// }
todos: () => Todos.all();
},
methods: {
markAsRead(id) {
// this.$store.state.commit(MARK_DONE, id);
Todo.update({
where: id,
data: { done: true }
});
}
}
}
I don't know about you, but I find that much more readable!
Store config
But hang on, where is the store configuration for the Todo model? Unless you want to customize it, you don't need any! Vuex ORM will automatically create state, mutations, and getters that are aliased to the model API e.g. read
, update
, find
.
Plugins
Even better, you can add some really handy plugins to Vuex ORM (that's right, a plugin for a plugin for a plugin), include ones to abstract your server communication.
For example, there is an Axios plugin that is almost zero config so long as your model endpoints fit the RESTful pattern.
Let's say when our app loads, it retrieves all the to-do items from the server and pushes them to the store:
xxxxxxxxxx
created() {
try {
let { data } = await this.$http.get("/todos");
data.forEach(todo => this.$store.state.commit(ADD_TODO, todo));
} catch (err) {
// handle error
}
}
The Vuex ORM Axios plugin adds additional model methods like fetch
which allows you to replace the above code with:
xxxxxxxxxx
created() {
Todo.$fetch();
}
How easy is that?
Resources
There's plenty more to know about Vuex ORM so check out the docs:
Learn and master what professionals know about building, testing, and deploying, full-stack Vue apps in our latest course. Learn more
Further Reading
Vue Development in 2019: What You Need to Know
Published at DZone with permission of Anthony Gore, DZone MVB. See the original article here.
Opinions expressed by DZone contributors are their own.
Trending
-
Top 10 Pillars of Zero Trust Networks
-
Mastering Time Series Analysis: Techniques, Models, and Strategies
-
How To Use Pandas and Matplotlib To Perform EDA In Python
-
Is Podman a Drop-in Replacement for Docker?
Comments