站点访问|站点访问 Pageviews 实现——相比于 Next.js 我更喜欢 Remix

相比于 Next.js 我更喜欢 Remix 如题,本文以 Next.js 和 Remix 实现访问量统计为例。讲述我为什么更喜欢 Remix 框架。
Next.js Pageviews 首先以 Next.js 为例,其实在我的眼里, Next.js 更像是一个静态网站生成器。它与 Gatsby (另一个基于 React 的网站生成器)相比,门槛较低,可以快速上手。而 Gatsby 则需要一定的 GraphQL 基础。
废话不多说,开始正题。 页面访问点击这个功能肯定是需要数据存储的(数据库或者缓存、键值对存储等后端服务都可以作为替代)。
在我之前的文章里做过 Next.js 与 Remix 的对比——《网站的未来:Next.js 与 Remix》,Next.js 中 API 路由是需要防止在 pages/api/ 目录下的,而 Remix 就是路由,会更加灵活一些。
所以在 Next.js 实现的时候,需要先配置接口。这里我就先放一个比较有名的实际项目:

  • 源码: https://github.com/leerob/lee...
  • 网站: https://leerob.io/
pages/api/views/[slug].ts 中完成接口的实现:
// https://github.com/leerob/leerob.io/blob/main/pages/api/views/%5Bslug%5D.ts import type { NextApiRequest, NextApiResponse } from 'next'; import prisma from 'lib/prisma'; export default async function handler( req: NextApiRequest, res: NextApiResponse ) { try { const slug = req.query.slug.toString(); if (req.method === 'POST') { const newOrUpdatedViews = await prisma.views.upsert({ where: { slug }, create: { slug }, update: { count: { increment: 1 } } }); return res.status(200).json({ total: newOrUpdatedViews.count.toString() }); }if (req.method === 'GET') { const views = await prisma.views.findUnique({ where: { slug } }); return res.status(200).json({ total: views.count.toString() }); } } catch (e) { return res.status(500).json({ message: e.message }); } }

GET 请求为查询, POST 请求为更新。
然后在页面中的话,需要使用 Fetch 库,如 swr 来进行调用:
// https://github.com/leerob/leerob.io/blob/main/components/ViewCounter.tsx import { useEffect } from 'react'; import useSWR from 'swr'; import fetcher from 'lib/fetcher'; import { Views } from 'lib/types'; export default function ViewCounter({ slug }) { const { data } = useSWR(`/api/views/${slug}`, fetcher); const views = new Number(data?.total); useEffect(() => { const registerView = () => fetch(`/api/views/${slug}`, { method: 'POST' }); registerView(); }, [slug]); return {`${views > 0 ? views.toLocaleString() : '–––'} views`}; }

这里你会发现,页面在刚加载的时候,显示的文章阅读量是 ---- views,并且在后台里发了一个请求,完成后才会将文章计数更新到页面中展示出来。当我访问文章列表页面的时候,其实页面上发送了茫茫多的网络请求。
站点访问|站点访问 Pageviews 实现——相比于 Next.js 我更喜欢 Remix
文章图片

在前后端不分离的项目中实现前后端完全分离的代码,并通过 HTTP 的请求再去调用操作。这个操作就……一言难尽,反正性能并不高,对于 Google 搜索引擎收录来说或许影响不大,但是百度就肯定是无解的。
Remix Pageviews 因为 Remix 并不能提供 SSG (静态站点生成) 功能,所以前后端并不分离。这对于一些简单的动态需求的网站系统来说,就非常的友好,甚至在 Typescript 编写代码的时候,都不用特别去关注类型定义的问题。
【站点访问|站点访问 Pageviews 实现——相比于 Next.js 我更喜欢 Remix】app 目录中放置了项目的代码,routes 目录下自定义路由。比如我这个服务的实现,可以放在 app/services/views.server.ts ,其中,如果代码仅会跑在后端运行,可以用 .server.ts 的后缀进行区分。
这里的实现也相对会更简单一些,只需要两个方法即可,一个是写入数据计数,另一个是查询。在 Remix 中,我进行了一些设计思路上的优化,将写入计数和查询都在一次性完成。
因为是使用了 Cloudflare KV 存储(免费服务),所以实现起来有点像 Redis 的用法,总访问量的统计也需要一个键名单独计数。
// services/views.server.ts // 定义返回值的类型, slug 表示地址 /slug 或者 total 表示总数 export interface PageView { slug: string; pv: number; }// 由于本地开发环境中,无法调用 Cloudflare Worker KV 绑定的存储桶,所以写了一个简单的 Mock 方法 const mockDb: KVNamespace = { // eslint-disable-next-line async get(...args: any[]) { return Promise.resolve('9999999'); }, // eslint-disable-next-line async put(...args: any[]) { return Promise.resolve(); } }; export class ViewsModel { db: KVNamespace; constructor(db?: KVNamespace) { this.db = db || mockDb; }// 方法一,用于对特定路径进行计数,并增加访问总数 // 记录完成后,直接将数值作为 return 结果,减少了再次调用 async visit(slug: string) { const [views, total] = await Promise.all( [slug, 'total'].map((key) => this.db.get(key, 'text')) ); const pv = Number(views || 0) + 1; const pvTotal = Number(total || 0) + 1; await Promise.all([ this.db.put(slug, pv.toString()), this.db.put('total', pvTotal.toString()) ]); return [ { slug, pv }, { slug: 'total', pv: pvTotal } ] as PageView[]; }// 专门为文章列表页准备的接口,可以批量查询文章访问量 async list(slugs: string[]) { const result = await Promise.allSettled( slugs.map((slug) => this.db .get(slug, 'text') .then((views) => ({ slug, pv: Number(views || 0) } as PageView)) ) ); return result .filter((x) => x.status === 'fulfilled') .map((x: { value: PageView }) => x.value); } }

然后查询的话根据需要,我将 visit 方法的使用放在了 root.tsx 下:
// app/root.tsx import { ViewsModel,PageView } from './services/views.server'; // 忽略了其他的代码,只保留核心的部分// 类型定义 export type CustomEnv = { VIEWS: KVNamespace; }; export type AppContext = { env: CustomEnv; }; export const loader: LoaderFunction = async ({ request, context = {} }) => { const { env = {} }: CustomEnv = context as AppContext; const url = new URL(request.url); const slug = url.pathname; // eslint-disable-next-line const PV = new ViewsModel(env.VIEWS); const views = await PV.visit(slug); const data: LoaderData = https://www.it610.com/article/{ views }; return json(data); };

代码中类型的定义和默认值的设置占了很大一部分,需要解释一下:因为我目前采用的方案是准备把网站放在 Cloudflare Pages 上(没搞服务器,所以使用的全是免费的方案),KV Namespace 存储方案在本地开发环境中无法调试。才有了这么多奇怪的打补丁一样的代码,忽略这一部分。只看核心内容:
  • 首先是通过 Request 的 URL 取出当前页面的 Slug,并进行计数。
  • 然后将结果返回给 loader 方法。
几行代码完成了接口的调用和数据的查询,该部分会随着页面路由的加载自动执行并将结果返回(我不太确定是否动态路由中每次路由改变都会触发,如果这里与我设想的不一致,后续我会回来修改这篇文章)。
然后在 App 中使用该数据即可:
// app/root.tsx // 依然是刚才那个页面,部分代码export type LoaderData = https://www.it610.com/article/{ views: PageView[] }; function App() { const data = useLoaderData(); return (
{JSON.stringify(data, null, 2)}

{process.env.NODE_ENV === 'development' && } ); }

这里,data 就会返回这样类型的数据:
{ views: [ { slug: '/', pv: 99999}, { slug: 'total', pv: 99999} ] }

把数据传给组件或者状态管理中即可。同理,可以在 routes/blog.tsx 页面中加入 loader 方法,来获取页面上的文章列表,直接拼接每个文章的阅读量数据。
这样的框架在设计和编码的过程中,似乎更符合软件工程的高内聚、低耦合的思想。可以真正意义上的去实现模块化和微前端的开发。
目前我还在摸索中,可以持续关注我的 Remix 个人网站项目:
  • Github: https://github.com/willin/wil...
  • 码云镜像: https://gitee.com/willin/will...
  • 开发预览: https://willin-wang.pages.dev/
  • 正式版发布: https://willin.wang

    推荐阅读