npm 包 redux-entities 使用教程

前言

在开发前端应用时,随着业务的复杂度增加,数据状态的管理也越来越困难。为了更好地组织数据状态,我们需要使用状态管理库。

redux 是目前最流行的一个状态管理库,它的设计理念简单明了,而且与 React 配合非常默契。在使用 redux 过程中,我们经常需要写很多的重复性代码,比如 reducer、action 等等。

为了简化 redux 的使用,redux-entities 库应运而生。本文将介绍 redux-entities 的使用教程。

redux-entities 的作用

redux-entities 是一个用于简化数据状态管理的库,它可以帮助我们自动生成 reducer、action 的代码,并提供一些辅助函数来简化我们的编码工作。

redux-entities 的主要作用是:

  • 自动生成常规的 reducer、action 代码;
  • 提供常用的辅助函数,例如 normalize、denormalize 等,方便我们对数据进行转换和处理;
  • 使 reducer 更易于维护和扩展。

redux-entities 的安装和使用

redux-entities 可以通过 npm 安装:

--- ------- -------------- ------

使用 redux-entities 的时候,我们需要定义一个 schema,来描述数据的结构和关系。schema 的定义如下:

-
    ----------- -
    --
    ---
-

其中 entityName 为实体名称,可以是任意字符串,用于区分不同的实体。下面是一个简单的 schema 示例:

-
    ------ ---
    ------ --
-

该 schema 中定义了两个实体,一个是 users,一个是 posts。

在定义完 schema 后,我们需要使用 entitiesReducer 函数来生成对应的 reducer,如下所示:

------ - --------------- - ---- --------
------ - --------------- - ---- -----------------

----- ------ - -
    ------ ---
    ------ --
--

----- ----------- - -----------------
  --------- -----------------------
---

------ ------- ------------

到目前为止,我们已经成功地创建了一个拥有两个实体的 reducer,而且并没有写一行 reducer 代码!

接下来,我们就可以在组件中使用这个 reducer 了。首先,我们需要定义 actions,redux-entities 提供了一个辅助函数 createAction,用于生成标准的 action,如下所示:

------ - ------------ - ---- -----------------

------ ----- --------- - ----------------------------

createAction 接受一个字符串作为参数,字符串的格式为:实体名称/操作名称。在上面的示例中,我们定义了一个 fetchUser 的 action,它的操作名称为 FETCH,操作的实体名称为 users。

接下来,我们就可以在组件中发起 fetchUser 的 action 了,如下所示:

------ - ------- - ---- --------------
------ - --------- - ---- -------------

----- -------- ------- --------- -
  ------------------- -
    -----------------------
  -

  -------- -
    -- ---
  -
-

------ ------- ------------- - --------- -------------

在 componentDidMout 生命周期中,我们向 store 中发起了一个 fetchUser 的 action,在 reducer 中对应的操作是 users/FETCH。

redux-entities 的辅助函数

redux-entities 提供了一些常用的辅助函数,例如 normalize、denormalize 等,用于数据的转换和处理。

normalize 函数

函数签名:normalize(data, entityName, idAttribute = 'id')

normalize 函数用于将数据转换为标准的 normalized 数据,它接受三个参数:

  • data:需要被转换的数据,可以是单个对象或对象数组;
  • entityName:目标实体名称;
  • idAttribute(可选):指定 id 的属性名称,默认为 id。

下面是一个简单的示例:

------ - --------- - ---- -----------------

----- ---- - --
    --- --
    ----- -------
-- -
    --- --
    ----- -----
---

----- -------------- - --------------- ---------

----------------------------

输出结果为:

-
    --------- -
        ------ -
            ---- -
                --- --
                ----- -------
            --
            ---- -
                --- --
                ----- -----
            -
        -
    --
    ------- --- --
-

denormalize 函数

函数签名:denormalize(data, schema, entities)

denormalize 函数用于将 normalized 数据转换为 denormalized 数据,它接受三个参数:

  • data:需要被转换的数据,可以是单个对象或对象数组;
  • schema:目标实体的 schema;
  • entities:标准的 normalized 数据。

下面是一个简单的示例:

------ - ----------- - ---- -----------------

----- ------ - -
    ------ ---
    ------ --
--

----- -------- - -
    ------ -
        ---- -
            --- --
            ----- -------
        --
        ---- -
            --- --
            ----- -----
        -
    --
    ------ -
        ---- -
            --- --
            ------ ----- ------
            ------- -
        --
        ---- -
            --- --
            ------ ---- ------
            ------- -
        -
    -
--

----- ---- - --
    --- --
    ------ ----- ------
    ------- -
        --- --
        ----- -------
    -
-- -
    --- --
    ------ ---- ------
    ------- -
        --- --
        ----- -----
    -
---

----- ---------------- - ----------------- ------- ----------

------------------------------

输出结果为:

--
    --- --
    ------ ----- ------
    ------- -
        --- --
        ----- -------
    -
-- -
    --- --
    ------ ---- ------
    ------- -
        --- --
        ----- -----
    -
--

总结

通过本文的介绍,我们了解了如何使用 redux-entities 来简化数据状态管理的代码,以及一些常用的辅助函数。使用 redux-entities 可以让我们更加专注于业务代码的编写,而不必过多地关注状态管理相关的细节。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/6006700ce361a36e0bce8c69


猜你喜欢

  • npm 包 splinter 使用教程

    随着前端技术的飞速发展,越来越多强大的工具涌现出来,npm 包就是其中之一。npm 包是指已经发布到 npm 上的模块,使用 npm 包可以方便地引入第三方库,并使用其中提供的工具和功能。

    4 年前
  • npm 包 split-after 使用教程

    前言 在前端开发中,遇到字符串分割的问题是很常见的。而 npm 包 split-after 就是一种解决字符串分割问题的工具。在本文中,我们将详细介绍该 npm 包的使用方法,并通过实例代码进行讲解。

    4 年前
  • npm 包 sportjs 使用教程

    sportjs 是一个基于 JavaScript 的前端库,用于实现各种体育运动场景。本文主要介绍如何使用 npm 包 sportjs,以及如何在项目中应用 sportjs 库。

    4 年前
  • npm 包 spy-on-lazy-ass 使用教程

    在前端开发过程中,我们常常需要测试我们的代码是否按照预期运行,这个时候就需要使用一些测试工具来检测我们的代码。其中一个常用的测试工具就是 npm 包 spy-on-lazy-ass。

    4 年前
  • npm 包 Speke 使用教程

    简介 Speke 是一款基于 WebRTC 技术的 JavaScript 库,可用于实现浏览器语音识别功能。它简单易用,支持多语言识别,适合前端开发者快速集成语音识别功能到自己的项目中。

    4 年前
  • npm 包 speedyspeech 使用教程

    简介 Speedyspeech 是一个基于 JavaScript 的 npm 包,可以实现文字语音合成的功能。在前端开发中,文字语音合成是一个很有用的功能,能够让用户更直观地了解应用程序中的内容,也能...

    4 年前
  • npm 包 spejson 使用教程

    如果你正在开发 Web 前端项目,你可能会遇到需要对 JSON 数据进行特定的转换或处理的情况。Spejson 就是一个能够帮助你解决这个问题的 npm 包。通过本文,你将了解到 Spejson 的使...

    4 年前
  • npm 包 spell 使用教程

    在前端开发的过程中,写代码肯定是必不可少的一个环节。就算再细心的代码审查,也难免会出现一些细小的错误。为了发现这些错误并及早解决,我们可以使用 npm 包 spell。

    4 年前
  • NPM包: sport-object-uploader-library使用教程

    前言 随着现代体育运动的普及,越来越多的体育爱好者想要借助于技术手段,记录并分享自己的体育训练成果。为此,一些开源社区推出了一些封装好的工具,例如 sport-object-uploader-libr...

    4 年前
  • npm 包 sport-object-uploader 使用教程

    在前端开发中,我们经常需要上传文件到服务器。为此,npm 包 sport-object-uploader 提供了一个简单易用的 API,可以帮助我们实现上传功能。本文将介绍该包的使用方法,以及基础学习...

    4 年前
  • npm 包 split-at-cursor 使用教程

    在前端开发中,处理文本字符串是很常见的需求,如在输入框中通过光标位置将字符串拆成多个字符串,而 npm 上的 split-at-cursor 包就为我们提供了便捷的实现方案。

    4 年前
  • npm 包 sport-object-uploader-module 使用教程

    简介 sport-object-uploader-module 是一个基于 Node.js 的 npm 包,用于将文件上传到云存储对象存储服务中。本文将详细介绍如何使用该包完成文件上传操作。

    4 年前
  • npm 包 sport-object-viewer 使用教程

    介绍 sport-object-viewer 是一款可以展示运动数据的 npm 包。它可以将以对象形式存储的运动数据,通过可视化的方式展示出来。 安装 首先,需要在本地安装 sport-object-...

    4 年前
  • npm 包 spy-server 使用教程

    许多前端开发者在进行页面优化或调试时需要获取网络请求的详细信息,然而,浏览器提供的开发者工具的信息有限。此时,使用 spy-server 这个 npm 包可以提供详尽的网络请求信息。

    4 年前
  • npm 包 spy-then 使用教程

    介绍 在前端开发中,我们经常需要使用 promise 对象来处理异步操作,而当我们需要在 promise 执行之前或者之后执行某些操作时,我们通常需要使用链式调用中的 then 方法。

    4 年前
  • npm 包 spy-web-client 使用教程

    简介 spy-web-client 是一个用于前端监控的 npm 包,可以帮助我们跟踪网页的浏览数据、错误信息和性能指标等。它是基于前端监控平台 Spy 开发的,让我们可以更加方便地对网站或者应用进行...

    4 年前
  • npm 包 spyder 使用教程

    npm 包 spyder 使用教程 在前端开发过程中,我们经常需要爬取网站数据,分析页面结构等操作。为了方便我们在 Node.js 环境下进行网页爬虫等操作,我们可以使用一个非常强大的工具,这个工具名...

    4 年前
  • npm 包 spye 使用教程

    Spye 是一个 JavaScript 库,它可以监视 JavaScript 对象、数组和函数的访问和修改行为。Spye 数组返回由特定方法调用、属性访问或函数调用产生的值的历史记录。

    4 年前
  • npm 包 spyes 使用教程

    介绍 Spyes 是一个小型的 JavaScript 库,用于窃听事件并返回它们的详细信息。它可以在任何 Web 应用程序中使用,可以方便地跟踪事件,调试代码以及进行数据分析。

    4 年前
  • npm 包 spyfu-vue-factory 使用教程

    前言 在前端开发中,Vue.js 已经成为了一个非常流行和实用的框架,特别是在构建单页面应用程序和组件化开发方面。随着 Vue.js 的越来越普及,社区中也涌现出了很多优秀的第三方库,这里介绍一款非常...

    4 年前

相关推荐

    暂无文章