前言
Headless CMS 是一种新型的求解思路,其中 The Graph 和 Contentful 作为其中最为强大、灵活的工具,与微服务的结合可以增强 Headless CMS 的实现能力。
正文
一、Headless CMS 简介
Headless CMS 的出现与 Web 应用程序的发展有关。传统的 CMS 主要负责内容管理工作,而 Web 应用程序则需要更灵活、更快速的数据链接和交换方式。Headless CMS 是为解决这些问题而出现的一种新型解决方案,它抛弃了传统 CMS 的“一切都在一起”的架构,只提供内容管理、数据存储等基础服务,而将数据输出以 API 的形式进行交互,开放了数据查询、增删改的自由度,使得前后端分离不再是一个梦想,而更加容易实现。
二、The Graph 简介
The Graph 是为分散应用服务提供基础数据访问的协议,它提供了一种用于各种分散应用程序的标准方法,这种方法可以使这些应用程序更加灵活、更加快速地交换数据和呈现内容。The Graph 服务可以整合基于以太坊的区块链技术为基础的分散应用,从而方便用户在以太坊上使用智能合约和其他交换协议,方便协议之间的互相连接。
三、Contentful 简介
Contentful 是一款 Headless CMS 工具,它提供了一个可扩展的 Web 服务 API 和一个 Web 界面,用于创建各种不同类型的内容模型。这个 CMS 工具为 Web 应用程序开发提供了更高的灵活性和速度,支持多语言、图像、视频、音频等多种类型的内容类型,为开发人员提供了模板引擎等更丰富的选择来呈现内容。
四、微服务的优化
由于 Headless CMS 因其灵活性得到许多开发者的青睐,但其实际上仍然需要微服务支持,将其服务化并按照业务模块进行划分,不仅方面后期维护与扩展,也使得整体服务的分布式特点增强,进一步加强它的实现能力。微服务有效地实现了服务的分解,以便更便利的实现多种不同的业务逻辑,同时使开发者可以更加底层地掌握整个业务服务。
五、The Graph 和 Contentful 的集成
- 注册 The Graph 服务
在 The Graph 官网 https://thegraph.com/ 注册一个账号,创建一个 Graph。我们假设本示例中我们将要创建一个 blog_post 数据库,用于存储博客文章的相关信息,如标题、内容、创建时间、评论等信息。
- NPM 包的安装
我们在项目中安装以下 NPM 包:
yarn add @contentful/rich-text-react-renderer @contentful/rich-text-types apollo-client graphql jsonwebtoken jszip react-helmet react-markdown
- 配置 Contentful
在 Contentful 管理界面中,创建一个 blog_post 的 Content Type,用于保存博客文章的标题、图片、创建时间、内容等信息。
我们还可以使用 Contentful 提供的 webhooks,以通知应用程序新的博客文章到达。
- 编写 The Graph Schema
The Graph 默认使用 GraphQL 作为查询语句的语言,因此我们需要为我们的数据库创建一个数据模型架构。这个模型将被用于决定数据库的数据结构以及我们将在 GraphQL 中呈现的哪些数据。
在 Graph 官网 dashboard 中新建一个 DataService,创建 dataSource 和 mapping config。并创建一个 .graphql 文件,定义数据类型及其关系。如下:
type BlogPost @entity { id: ID! title: String! content: String! createdAt: BigInt! comments: [BlogPostComment!]! @derivedFrom(field: "post") }
创建一个与上一步中的 .graphql 文件匹配的 AssemblyScript 模块,用于处理数据操作,包括查询和变更。执行 yarn codegen
收集 .graphql 文件中的类型和操作,并将其导出到 TypeScript 定义中。
- 在 React 应用程序中使用 The Graph 和 Contentful
首先需要在应用程序中使用 The Graph 对应用程序的所需数据进行查询,然后使用 Contentful 获取具有优美格式化的内容。
针对 The Graph 数据的查询代码如下所示:
-- -------------------- ---- ------- ------ - --- - ---- --------------- ------ ------------ ---- --------------- ----- ------ - --- -------------- ---- ------------------------------------------- --- ----- --------- - ---- - ---------- --------- - -- ---- ----------- -------------- ------------------ - - -- ------ -------- ------ --------- -- ------------ -- ---------------------
Contentful 的格式化内容代码如下:
-- -------------------- ---- ------- ------ - ------------------------- - ---- --------------------------------------- ------ - ------ - ---- ------------------------------ ------ ------------- ---- ----------------- ------ ------- -------- ---------- ---- -- - ----- ------- - - ----------- - ------------------------ ---- -- - ---- -------------------------------------- ----------------------------------- -- - - -- ------ - ----- --------------------- ---------------- -- ------------------------ ---------------------------------------- --------- ------ -- - ----- -------- ------------------- - ----- ------ - -------------- ------ -------------------- ------------ ----------------------- --- ------ ----- ------------------- ------------- ----------- -------------- ---- --- -
六、总结
本文讲解了 Headless CMS、The Graph 和 Contentful 的概念以及在 Web 应用程序中使用它们的方法。通过将这些强而有力的工具和微服务结合使用,合理规划和划分业务逻辑,开发者可以大大增强 Headless CMS 的实现能力,提升开发效率。
参考资料
- https://www.contentful.com/
- https://thegraph.com/
- https://medium.com/@mda590/how-to-setup-the-graph-using-contentful-graphql-c6a90b67729c
- https://www.codementor.io/@lamnguyen/headless-cms-with-contentful-graphql-and-the-graph-6xmbj0z34
- https://www.joshmorony.com/building-a-headless-cms-with-contentful-and-the-graph/
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/648e954648841e9894cf4e3b