next.js v14 从入门到跑路

用next.js也有几天了，也是这么一个边看边用这么一个状态，现在主要使用app router模式，更新下next.js v14 app router模式方面的姿势吧。

区别于前面的pages router, app router虽然也是根据目录结构来划分路由，但是它不再依赖于使用getServerSideProps/getStaticProps在服务器时期去获取数据，在app router模式下只区分服务器组件和客户端组件，且一些在pages路由模式下的方法也无法在app路由下使用。

那现在服务器组件怎么获取数据呢？

nextjs app router现在约定的结构是：

app 
	目录名 (即路由名，比如名字是home，对用的路径是/home)
	page.ts 当前页面对应的路由
	layout.ts layout布局组件
	loading.ts loading加载动画
	not-found.ts 404页面
	api restful api文件夹

每一个目录下至少需要一个page.ts文件，否则访问该路由会报错。而layout布局文件则根据是否需要来创建；loading加载文件相当于suspense里的loading，也就是加载这个路由前的加载动画（Suspense应该是唯一一个能用的react组件了吧在服务器组件里，且suspense不需要指定loaidng了）；not-found 404页面，只有app根目录下才需要，其他子路由创建无效；api文件夹是存放restful api文件的地址，同app router,一个文件就是一个路由，且同app router的page.ts，restful只认route.ts文件为当前路由文件。

next.js只区分服务器组件和客户端组件，服务器组件可以是异步的。所以如果我们需要在服务器组件里获取数据，直接await请求就可以了。真的比pages路由里的export function getServerSideProps啥的不要方便太多。比如：

import React from 'react';

export default async function Home() {
	const { data } = await fetch(xxx);
	...
	return (
	<div>
		...
		<Child result={data} />
		...
	</div>
	)
}

我们把请求好的数据当成props传给子组件就行了，逻辑是与pages的getServerSideProps是一样的；
但是一定要小心，千万不要在服务器组件里使用任何react的hooks或其他api，连组件的合成事件都不行！

这里补充下RESTFUL api的使用方法！

目录结构：

tips: api文件是在app目录下的。

api
	login 
		route.ts // 访问地址是(/api/login)
	getGamelist 
		route.ts // 访问地址是(/api/getGamelist)
	...

前面说了只有当前目录下的route.ts才会被当成路由文件，一个route.ts里可以定义GET/POST/PUT/DELETE等method名称的函数，即每个函数对应请求该接口的method属性的接口，所以可以根据需求来设计对应的方法。
route.ts文件

import { NextResponse, NextRequest } from 'next/server';

export function Post(req: NextRequest ) {
	...
	return NextResponse.json({...}, {status: 200})
}

补充2：
怎么获取Post请求携带的参数？
NextRequest 这个类型是在Web Request api的基础上继承来的(NextResponse也是同理)，在Request基础上拓展更多更好使用的属性或方法，具体可看文档。所以想要获取post请求里的req.body 我们可以看mdn上Request的说明，其描述携带参数后body是ReadableStream类型，那我们获取直接json格式化就可以了，注意这是一个异步操作。
例如login下的route.ts是这样的：

import { NextResponse, NextRequest } from 'next/server';

export async function Post(req: NextRequest ) {
	const { token } = (await request.json()) as { token?: string };
	...
	return NextResponse.json({...}, {status: 200})
}

这样我们就能拿到body里传过来的token字段了。
使用则直接fetch/xmlHttpRequest请求/api/login

...
const request = new Request('/api/login', {
	 method: 'post',
     body: JSON.stringify({ token }),
})
fetch(request).then((res) => res.json()).then((res) => {...})

一些个人使用后的发现：

虽然区分服务器组件和客户端组件，但是客户端组件不是说一定在浏览器里动态给你渲染出来，它也是在服务器里给你渲染好的。真正想要在浏览器里渲染你可以使用动态导入并指明不需要ssr；

import dynamic from 'next/dynamic';

const Loading = dynamic(() => import('@/components/loading'), { ssr: false });

这个Loading组件就不会在服务器时期渲染了。dynamic不止用来延迟加载组件，也可以延迟加载库。

动态路由怎么定义，同pages路由，凡是[xxx]的文件夹都是对应的动态路由。在app router下是不能使用next/router，因为它是只为pages路由服务的，next.js把路由相关的api封装到了next/navigation里。注意pages路由模式也不能使用next/navigation，这是为app router设计的。

那怎么获取路由参数呢？

import { useParams } from 'next/navigation' 通过useParams来获取当前的路由参数。
即 const params = useParams() 输出这个params就能看到当前所有的路由参数;
import { useSearchParams } from 'next/navigation' 来获取location.search参数
usePathname 则是获取当前的路由地址
编程式导航则给到了useRouter，这个api跟vue router常用用法基本一致，也是啥push/replace/back（vue是go）
以上几个api都来自next/navigation，需要注意的是这几个都是只能在客户端组件内调用,不能用在服务器组件里。
next/navigation里服务器组件能用的api：
notFound 打开404页面
redirect 重定向到某个页面

其他一些补充（server api）：
fetch同样是拓展了Web fetch 方法，现在可以指定cache字段来设置缓存时间，所以fetch方法不需要额外导入。
next/headers暴露的headersapi可以让你获取请求头里的参数，只读。
next/headers暴露的cookies`则可以增删改查cookies。怎么用直接看MDN。