Ecto Model Schema Extension

The post belongs to NectarCommerce and Extension Framework Awareness

  1. NectarCommerce Vision

  2. Extension Framework Game Plan

  3. Introduction to Metaprogramming
  4. Ecto Model Schema Extension
  5. Ecto Model Support Functions Extension
  6. Phoenix Router Extension
  7. Phoenix View Extension
  8. Running Multiple Elixir Apps Together
  9. Extension Approach Explained
  10. Developer Experience and Workflow developing Favorite Product Extension
  11. Developer Experience and Workflow testing Favorite Product Extension

What will be NectarCommerce

Off-the-shelf Opensource E-commerce application for building an online store.

Provides an Extension Framework to support features not included in core as extensions.

Strives for unobtrusive parallel development of NectarCommerce and Extensions

NectarCommerce is committed to providing a ready-to-use e-commerce solution but the definition of 100% is different under different business domains. It aims to solve common use-cases as part of the project and relying on extension framework to tap the rest.

Ecto Model Schema Extension


We want to allow Extensions to modify the schema of existing Nectar Models without changing the Nectar Models.

Extensions should be able to add new fields and associations to existing models as and when needed.


Minimum three parts are needed to create & use an extension effectively:

  • Library Code
  • Service Code
  • Consumer Code

An extension and its use with Nectar can be viewed as Producer / Consumer relationship bound by a communication protocol.

Extensionwhich wants to add a virtual field, say special, to Nectar Product Model Schema is a Producer (Service Code)

Nectar Modelis a Consumer (Consumer Code)
allowing the schema changes through a communication protocol (Library Code)

Let’s begin the journey of incremental changes to bring consumer, service and library code into existence starting from a simple use-case of adding a virtual boolean field, say special, to Nectar Product.

Note: Please refer Introduction to Metaprogramming
for more information on Metaprogramming in Elixir

  1. A straightforward way to add a virtual field, say special, to Nectar Product would be adding it directly in Nectar.Product Schema definition, but it requires change in Nectar source. Let’s move to the next step for avoiding any modification to Nectar.Product

  2. We can add a function to Nectar Model Schema to which other extensions can delegate the responsibility of schema changes, see full version here
    . See Nectar.ExtendProduct example below on how to use it.

  3. Now, with delegation function extensions
    in place, we can work towards providing a way to register the schema changes, see full version here
    . Please check the usage of Module attributes for same below.

  4. Earlier, Module.put_attribute was used multiple times to define multiple schema changes whereas now we wrapped it in an anonymous function to encapsulate the collection of schema changes through a simple and consistent interface, see full version here
    . There can be multiple extensions used for different functionality and hence multiple schema changes need to be registered and defined

  5. Now, Nectar.ExtendProduct is getting cluttered with ancillary method definitions. Let’s move it out to another module and use it, see full version here

  6. Let’s further reduce the boilerplate of registering schema_changes module attribute and importing add_to_schema method definition with using
    callback, see full version here

  7. Reference of schema_changes Module attribute is scattered across Nectar.ExtendProduct and Nectar.ModelExtension so let’s move it out to Nectar.ModelExtension to consolidate the usage via __before_compile__
    and definition together, see full version here

  8. With above changes, it’s now possible to define schema changes any number of times, see full version here
    . Also, schema changes can now be added using include_method
    in Nectar.ExtendProduct without making any changes to Nectar.Product.

Check all the revisions at once, here

Now, in the final version
, you can easily find the three components, consumer, service and library code
, as desired in extensible system

Please refer the demonstration approach for library code
, service code
and consumer code
as used with
favorite products extension

Our aim with these posts is to start a dialog with the Elixir community on validity and technical soundness of our approach. We would really appreciate your feedback and reviews, and any ideas/suggestions/pull requests for improvements to our current implementation or entirely different and better way to do things to achieve the goals we have set out for NectarCommerce.

Enjoy the Elixir potion !!

稿源:Vinsol (源链) | 关于 | 阅读提示

本站遵循[CC BY-NC-SA 4.0]。如您有版权、意见投诉等问题,请通过eMail联系我们处理。
酷辣虫 » 综合编程 » Ecto Model Schema Extension

喜欢 (0)or分享给?

专业 x 专注 x 聚合 x 分享 CC BY-NC-SA 4.0

使用声明 | 英豪名录