在 Node.js 中调度 CQRS 消息

Question

我想为 Node 应用做 CQRS。

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

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

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

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

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

Answer 1

TL:DR ：您不需要一些花哨的框架，尤其是当您只进行进程内通信时，即可应用 CQRS 架构。 events 模块中的原生 EventEmitter 就足够了。如果您想要进程间通信servicebus 做得非常好。要查看实现示例（以下长版本答案），您可以深入了解此存储库的代码：simple node 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,
};

由于我们在 javascript 中没有 interface，因此我们使用 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