Swoft Route 路由

Posted 2023-04-22

参考技术A Swoft中路由是通过注解 @Controller + @RequestMapping 组合来实现的，主要包括：

根据约定大于配置的规则，路由应该在用户看到 URI 的时候，就能找到与之对应的 Controller/Action 。

例如：要访问的路由为 /admin/account/index ，路由前缀 @Controller 可以直接定义到控制器这一层 /admin/account 。路由后缀 @RequestMapping 可以直接定义到动作方法这一层 index ，注意不用在前面添加 / ，可以是方法名称也可以是其它名称。

首先，使用路由前，必须引入与之对应的注解类。

注意：视图注解 @View 中的模板与布局参数中的值与路由比较起来会发现，它的路径是不需要前面添加 / 的。

若添加了 / 如 /admin/account/index 则会出现错误

建议这些细节的地方，追踪源码进行修改下，有时间自己会做做。

@Controller 表示类注解，使用在控制器类上，标记当前类是一个HTTP控制器类。

显式指定路由前缀

隐式指定路由前缀

@Controller() 默认自动解析为 controller class 控制器类名，注意使用驼峰法命名格式。

@RequestMapping 表示方法注解，用于控制器类的动作方法 Action 上。

格式： @RequestMapping(route, method)

参数：

使用：

指定路由方法用于限定HTTP请求的方式

指定路由参数，在Action动作方法中可直接使用 $name 作为方法参数。

@RequestMapping(route="index/$name", method=RequestMethod::GET)

例如：要访问路由的URI为 /admin/account/state/1

注意：这里使用的变量名为 pk ，可自由定义，获取出来的是一个字符串类型的值。

说明：

Swoft中HTTP路由的配置文件在 /swoft/config/beans/base.php 。

配置参数解析

route和router 当前与全局路由

参考技术A vue-router中经常会操作的两个对象route和route和router两个。

1、$route对象

$route对象表示当前的路由信息，包含了当前 URL 解析得到的信息。包含当前的路径，参数，query对象等。

1.$route.path**      字符串，对应当前路由的路径，总是解析为绝对路径，如"/foo/bar"。

2.$route.params**      一个 key/value 对象，包含了 动态片段 和 全匹配片段，      如果没有路由参数，就是一个空对象。

3.$route.query**      一个 key/value 对象，表示 URL 查询参数。      例如，对于路径 /foo?user=1，则有$route.query.user == 1，      如果没有查询参数，则是个空对象。

4.$route.hash**      当前路由的hash值 (不带#) ，如果没有 hash 值，则为空字符串。锚点*

5.$route.fullPath**      完成解析后的 URL，包含查询参数和hash的完整路径。

6.$route.matched**      数组，包含当前匹配的路径中所包含的所有片段所对应的配置参数对象。

7.$route.name    当前路径名字

8.$route.meta  路由元信息

```

route object 出现在多个地方:

组件内的 this.route和route和route watcher 回调（监测变化处理）;

router.match(location) 的返回值

scrollBehavior 方法的参数

导航钩子的参数：

router.beforeEach((to,from, next)=>//to 和from都是 路由信息对象,后面使用路由的钩子函数就容易理解了)

2、$router对象

$router对象是全局路由的实例，是router构造方法的实例。

路由实例方法：

1、push

1.字符串this.$router.push('home')

2. 对象this.$router.push(path:'home')

3. 命名的路由this.$router.push(name:'user',params:userId:123)

4.带查询参数，变成 /register?plan=123this.$router.push(path:'register',query:plan:'123')

push方法其实和<router-link :to="...">是等同的。

注意：push方法的跳转会向 history 栈添加一个新的记录，当我们点击浏览器的返回按钮时可以看到之前的页面。

2、go

 页面路由跳转 

前进或者后退this.$router.go(-1)  // 后退

3、replace

push方法会向 history 栈添加一个新的记录，而replace方法是替换当前的页面，

不会向 history 栈添加一个新的记录

05

// 一般使用replace来做404页面

this.$router.replace('/')

配置路由时path有时候会加 '/' 有时候不加,以'/'开头的会被当作根路径，就不会一直嵌套之前的路径。