在 Node.js 中调度 CQRS 消息

Question

我想为 Node 应用程序做 CQRS。

我不是一个 Node 人，我来自 .NET，它有一个名为 MediatR 的优秀库，它将命令/查询分派到可用于分离请求和处理程序的中介。所以它允许非常简单和优雅的 CQRS。

在 Node 世界中，我发现了许多库/博客，但它们也总是包含事件溯源。我对 ES 不感兴趣。

我可以很好地为命令和查询建模，但是接下来呢？他们需要以解耦的方式被派往某个地方以避免混乱。

根据我目前对 Node 平台的了解，一个可能的解决方案是使用观察者模式（通过 RxJs 库），这样控制器就可以将消息（即 CQRS 请求）分发给观察者，然后观察者发布相应的事件给订阅者（即请求处理程序）。这在类似 DDD 的设计中分离了控制器和服务。虽然我不确定如何将结果传回控制器。

这是其他人的做法吗？在 Node 中有更好的方法吗？

Answer 1

TL:DR：你不需要一些花哨的框架，特别是当你只做进程内通信时，来应用 CQRS 架构。本机EventEmitter从events模块就够了。如果你想进程间通信servicebus做得非常好。要查看实现示例（以下长版本答案），您可以深入研究此存储库的代码：简单节点 cqrs

让我们举一个非常简单的聊天应用程序的例子，如果聊天没有关闭，您可以发送消息，喜欢/不喜欢消息。

我们的主要聚合（或聚合根，概念上）是Chat( writeModel/domain/chat.js)：

const Chat = ({ id, isClosed } = {}) =>
  Object.freeze({
    id,
    isClosed,
  });

然后，我们有一个Message聚合 ( writeModel/domain/message.js) ：

const Message = ({ id, chatId, userId, content, sentAt, messageLikes = [] } = {}) =>
  Object.freeze({
    id,
    chatId,
    userId,
    content,
    sentAt,
    messageLikes,
  });

发送消息的行为可能是 ( writeModel/domain/chat.js) ：

const invariant = require('invariant');
const { Message } = require('./message');

const Chat = ({ id, isClosed } = {}) =>
  Object.freeze({
    id,
    isClosed,
  });

const sendMessage = ({ chatState, messageId, userId, content, sentAt }) => {
  invariant(!chatState.isClosed, "can't post in a closed chat");
  return Message({ id: messageId, chatId: chatState.id, userId, content, sentAt });
};

我们现在需要命令 ( writeModel/domain/commands.js) ：

const commands = {
  types: {
    SEND_MESSAGE: '[chat] send a message',
  },
  sendMessage({ chatId, userId, content, sentAt }) {
    return Object.freeze({
      type: commands.types.SEND_MESSAGE,
      payload: {
        chatId,
        userId,
        content,
        sentAt,
      },
    });
  },
};

module.exports = {
  commands,
};

由于我们使用的是 javascript，因此我们不必interface提供抽象，因此我们使用higher order functions( writeModel/domain/getChatOfId.js) ：

const { Chat } = require('./message');

const getChatOfId = (getChatOfId = async id => Chat({ id })) => async id => {
  try {
    const chatState = await getChatOfId(id);
    if (typeof chatState === 'undefined') {
      throw chatState;
    }
    return chatState;
  } catch (e) {
    throw new Error(`chat with id ${id} was not found`);
  }
};

module.exports = {
  getChatOfId,
};

( writeModel/domain/saveMessage.js) :

const { Message } = require('./message');

const saveMessage = (saveMessage = async (messageState = Message()) => {}) => saveMessage;

module.exports = {
  saveMessage,
};

我们现在需要实现我们的commandHandlers（应用服务层）：

( writeModel/commandHandlers/handleSendMessage.js)

const { sendMessage } = require('../domain/chat');

const handleSendMessage = ({
  getChatOfId,
  getNextMessageId,
  saveMessage,
}) => async sendMessageCommandPayload => {
  const { chatId, userId, content, sentAt } = sendMessageCommandPayload;
  const chat = await getChatOfId(chatId);
  return saveMessage(
    sendMessage({
      chatState: chat,
      messageId: getNextMessageId(),
      userId,
      content,
      sentAt,
    }),
  );
};

module.exports = {
  handleSendMessage,
};

由于我们interface在 javascript 中没有，所以我们higher order functions通过在运行时注入依赖来应用依赖倒置原则。

然后我们可以实现写入模型的组合根： (`writeModel/index.js) ：

const { handleSendMessage } = require('./commandHandlers/handleSendMessage');
const { commands } = require('./domain/commands');

const SimpleNodeCQRSwriteModel = ({
  dispatchCommand,
  handleCommand,
  getChatOfId,
  getNextMessageId,
  saveMessage,
}) => {
  handleCommand(
    commands.types.SEND_MESSAGE,
    handleSendMessage({ getChatOfId, getNextMessageId, saveMessage }),
  );
};

module.exports = {
  SimpleNodeCQRSwriteModel,
};

您的commands和command handler没有捆绑在一起，然后您可以在运行时提供这些函数的实现，使用内存数据库和节点EventEmitter，例如 ( writeModel/infrastructure/inMemory/index.js) ：

const uuid = require('uuid/v1');
const { saveMessage } = require('../../domain/saveMessage');
const { getChatOfId } = require('../../domain/getChatOfId');
const { getNextMessageId } = require('../../domain/getNextMessageId');

const InMemoryRepository = (initialDbState = { chats: {}, messages: {}, users: {} }) => {
  const listeners = [];

  const db = {
    ...initialDbState,
  };

  const addOnDbUpdatedListener = onDbUpdated => listeners.push(onDbUpdated);

  const updateDb = updater => {
    updater();
    listeners.map(listener => listener(db));
  };

  const saveMessageInMemory = saveMessage(async messageState => {
    updateDb(() => (db.messages[messageState.id] = messageState));
  });

  const getChatOfIdFromMemory = getChatOfId(async id => db.chats[id]);

  const getNextMessageUuid = getNextMessageId(uuid);

  return {
    addOnDbUpdatedListener,
    saveMessage: saveMessageInMemory,
    getChatOfId: getChatOfIdFromMemory,
    getNextMessageId: getNextMessageUuid,
  };
};

module.exports = {
  InMemoryRepository,
};

而我们TestWriteModel将这一切联系在一起：

const EventEmitter = require('events');
const { SimpleNodeCQRSwriteModel } = require('../writeModel');
const { InMemoryRepository } = require('../writeModel/infrastructure/inMemory');

const TestWriteModel = () => {
  const { saveMessage, getChatOfId, getNextMessageId } = InMemoryRepository();
  const commandEmitter = new EventEmitter();
  const dispatchCommand = command => commandEmitter.emit(command.type, command.payload);
  const handleCommand = (commandType, commandHandler) => {
    commandEmitter.on(commandType, commandHandler);
  };
  return SimpleNodeCQRSwriteModel({
    dispatchCommand,
    handleCommand,
    getChatOfId,
    getNextMessageId,
    saveMessage,
  });
};

您可以深入read model研究此存储库中的代码（使用非常简单的）：simple node cqrs