{"id":16301,"date":"2024-09-16T14:09:35","date_gmt":"2024-09-16T21:09:35","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=16301"},"modified":"2024-09-18T15:31:13","modified_gmt":"2024-09-18T22:31:13","slug":"couchbase-ruby-orm-simplifies-development","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/couchbase-ruby-orm-simplifies-development\/","title":{"rendered":"Introducing the New Couchbase Ruby ORM"},"content":{"rendered":"

A practical guide for Ruby applications<\/span><\/h2>\n

Ruby remains one of the most popular choices for building scalable applications, and Ruby on Rails continues to be one of the most flexible and robust web frameworks available. Notwithstanding the developer ease with working with Ruby and Ruby on Rails, managing the complexities of data operations can still be challenging, especially when dealing with adaptive and flexible data in non-relational databases like Couchbase. This no longer needs to be challenging though, as there is now the newly released Couchbase Ruby ORM.\u00a0<\/span><\/p>\n

The Couchbase Ruby ORM is a tool designed to simplify database interactions and streamline your development process. The Couchbase open source community started this project through the great work of developers at Doctolib, Mapotempo and others. Now, the project has officially been adopted as part of the Couchbase developer tooling ecosystem.<\/span><\/p>\n

In this post, we\u2019ll explore how the ORM can enhance your applications.<\/span><\/p>\n

tl;dr You can find an entire working Rails application using the new Couchbase Ruby ORM on <\/span><\/i>GitHub:<\/span><\/i><\/a><\/p>\n

\"\"<\/a><\/p>\n

Let\u2019s get started!<\/span><\/p>\n

The power of ORMs<\/span><\/h2>\n

Object Relational Mappers (ORMs) are a fundamental staple in modern web development. They allow developers to interact with a database using objects rather than writing raw database queries. In the case of Ruby applications, that means working with your data as if it were Ruby objects. This abstraction not only simplifies the overall codebase, but enhances readability and maintainability.\u00a0<\/span><\/p>\n

Within the context of Couchbase, an ORM is particularly beneficial because it bridges the gap between its document-based storage and the object-oriented nature of Ruby. By using the new Couchbase Ruby ORM, you can leverage many of Couchbase\u2019s features while maintaining the familiar Ruby development experience that we all enjoy.<\/span><\/p>\n

Benefits of using a Ruby ORM in your applications<\/span><\/h2>\n

If you are a Ruby on Rails developer, you are well familiar with the benefits of using ActiveRecord, Rails\u2019 built-in ORM, to manage your data. However, it bears repeating what those benefits precisely are. They can be summarized into four key points:<\/span><\/p>\n

    \n
  1. \n
      \n
    1. Ease of Use<\/strong>: Once you can define your data models as Ruby classes and attributes, you make your codebase more intuitive and easier to navigate.<\/span><\/li>\n
    2. Data Integrity<\/strong>: Automatically handling data validations and constraints at the model level ensures your data stays the way you intended it to stay. No need to add an additional layer of validation on your data, in more server side middleware or on the client, once the data is being validated directly in the model.<\/span><\/li>\n
    3. Enhanced Productivity<\/strong>: Reduce your boilerplate code, allowing you to focus on the business logic rather than getting carried away with database management in your application.<\/span><\/li>\n
    4. Consistency<\/strong>: Standardize data access patterns across your application, and by doing so, make your future self and your colleagues happier when you, or they, need to come back and refactor the application weeks or months later.\u00a0<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n

      With the new Couchbase Ruby ORM you can extend all those benefits to your data on Couchbase, providing a seamless integration between your application and your flexible and adaptive data. In a Rails application context, the ORM extends ActiveRecord functionality, enabling Rails developers to work with Couchbase data using all their familiar methods and conventions.\u00a0<\/span><\/p>\n

      A practical example<\/span><\/h2>\n

      Let\u2019s consider a fictional blogging platform. This platform needs to manage user profiles, comments, tags and content efficiently. The platform manages all sorts of content with different types of data, which is why building with a JSON document database like Couchbase is the way to go.<\/span><\/p>\n

      How would that look in reality?<\/span><\/p>\n

      Defining models with the Couchbase ORM<\/span><\/h3>\n

      Let\u2019s start with an <\/span>Article<\/code><\/span> model:<\/span><\/p>\n

      class Article < CouchbaseOrm::Base\r\n\u00a0\u00a0attribute :slug, :string\r\n\u00a0\u00a0attribute :title, :string\r\n\u00a0\u00a0attribute :description, :string\r\n\u00a0\u00a0attribute :body, :string\r\n\u00a0\u00a0attribute :tag_list, :string\r\n\u00a0\u00a0attribute :created_at, :time\r\n\u00a0\u00a0attribute :updated_at, :time\r\n\u00a0\u00a0attribute :author_id, :string\r\n\u00a0\u00a0attribute :favorites\r\n\u00a0\u00a0attribute :favorites_count, :integer, default: 0\r\n\r\n\u00a0\u00a0view :by_id, emit_key: :id\r\n\u00a0\u00a0view :by_slug, emit_key: :slug\r\n\u00a0\u00a0view :by_author_id, emit_key: :author_id\r\n\u00a0\u00a0view :by_article_id, emit_key: :id\r\n\r\n\u00a0\u00a0validates :slug, presence: true\r\n\u00a0\u00a0validates :title, presence: true\r\n\u00a0\u00a0validates :description, presence: true\r\n\u00a0\u00a0validates :body, presence: true\r\n\u00a0\u00a0validates :tag_list, presence: true\r\n\u00a0\u00a0validates :author_id, presence: true\r\nend<\/pre>\n
      This model defines an article with various attributes, leveraging Couchbase\u2019s ability to handle diverse data types. The attributes are defined similarly to how they would be in any ActiveRecord usage, making it easy for Ruby developers, and Rails developers in particular, to adopt it.<\/span><\/p>\n
      The <\/span>view<\/code><\/span> statements shown above establish defined ways to query documents stored in Couchbase. Each view is essentially an index that allows you query documents by a specific attribute more efficiently. For example, the <\/span>view :by:slug, emit_key :slug<\/code><\/span> statement creates a view that indexes articles by their <\/span>slug<\/code><\/span> attribute. This view allows you to retrieve articles based on their slug.<\/span><\/p>\n
      Defining associations with the Couchbase ORM<\/span><\/h3>\n
      Now, what about associations of data in the blogging platform? The blogging platform needs to ensure that each comment belongs to a specific user and to a specific article. The same way that can be done in a standard Rails model, is how it can be done using the Couchbase Ruby ORM. Here\u2019s how that can be set up:<\/span><\/p>\n
      class Comment < CouchbaseOrm::Base\r\n\u00a0\u00a0belongs_to :user\r\n\u00a0\u00a0belongs_to :article\r\nend<\/pre>\n
      With those associations, comments belong to both a user and an article. Similarly, you can also define a dependent relationship in the model, too. Take a look again at the <\/span>Article<\/code><\/span> class to see this in action:<\/span><\/p>\n
      class Article < CouchbaseOrm::Base\r\n\u00a0\u00a0belongs_to :user\r\n\u00a0\u00a0has_many :comments, dependent: :destroy\r\nend\r\n<\/pre>\n
      The same way that we demonstrated creating attributes on data models and defining associations, the ORM similarly provides functionality for querying, creating custom SQL++ queries, working with nested documents and a lot more. <\/span>The documentation<\/span><\/a> provides a rich array of example code for all the possible scenarios you may need to work with.<\/span><\/p>\n
      Wrapping up<\/span><\/h2>\n
      The new Couchbase Ruby ORM brings powerful and flexible database management to Ruby, and to Ruby on Rails applications. By abstracting any of the complexities of Couchbase\u2019s document-oriented design, it enables developers to build scalable and maintainable applications with ease. No matter what the nature of the application is, from an ecommerce platform to a blogging content management system, the Couchbase ORM offers a robust solution for integrating Couchbase within your Ruby stack. <\/span><\/p>\n
      Try it out yourself and experience the benefits!\u00a0<\/span><\/p>\n