router

Documentation

Index

• type Level1Router
  • func NewLevel1Router[Route comparable, Handle any]() *Level1Router[Route, Handle]
  • func (slf *Level1Router[Route, Handle]) Match(route Route) Handle
  • func (slf *Level1Router[Route, Handle]) Route(route Route, handleFunc Handle)
• type Level2Router
  • func NewLevel2Router[Route comparable, Handle any]() *Level2Router[Route, Handle]
  • func (slf *Level2Router[Route, Handle]) Match(topRoute Route, route Route) Handle
  • func (slf *Level2Router[Route, Handle]) Route(topRoute Route, route Route, handleFunc Handle)
• type Level3Router
  • func NewLevel3Router[Route comparable, Handle any]() *Level3Router[Route, Handle]
  • func (slf *Level3Router[Route, Handle]) Match(topRoute Route, level2Route Route, route Route) Handle
  • func (slf *Level3Router[Route, Handle]) Route(topRoute Route, level2Route Route, route Route, handleFunc Handle)
• type Multistage
  • func NewMultistage[HandleFunc any](options ...MultistageOption[HandleFunc]) *Multistage[HandleFunc]
  • func (slf *Multistage[HandleFunc]) Match(routes ...any) HandleFunc
  • func (slf *Multistage[HandleFunc]) Register(routes ...any) MultistageBind[HandleFunc]
  • func (slf *Multistage[HandleFunc]) Route(route any, handleFunc HandleFunc)
  • func (slf *Multistage[HandleFunc]) Sub(route any) *Multistage[HandleFunc]
• type MultistageBind
  • func (slf MultistageBind[HandleFunc]) Bind(handleFunc HandleFunc)
• type MultistageOption
  • func WithRouteTrim[HandleFunc any](handle func(route any) any) MultistageOption[HandleFunc]

Examples

• Multistage.Match
• Multistage.Register
• Multistage.Route
• Multistage.Sub
• NewMultistage

Types

type Level1Router

type Level1Router[Route comparable, Handle any] struct {
	// contains filtered or unexported fields
}

Level1Router 支持一级分类的路由器

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func NewLevel1Router

func NewLevel1Router[Route comparable, Handle any]() *Level1Router[Route, Handle]

NewLevel1Router 创建支持一级分类的路由器

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func (*Level1Router[Route, Handle]) Match

func (slf *Level1Router[Route, Handle]) Match(route Route) Handle

Match 匹配路由

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func (*Level1Router[Route, Handle]) Route

func (slf *Level1Router[Route, Handle]) Route(route Route, handleFunc Handle)

Route 创建路由

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

type Level2Router

type Level2Router[Route comparable, Handle any] struct {
	// contains filtered or unexported fields
}

Level2Router 支持二级分类的路由器

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func NewLevel2Router

func NewLevel2Router[Route comparable, Handle any]() *Level2Router[Route, Handle]

NewLevel2Router 创建支持二级分类的路由器

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func (*Level2Router[Route, Handle]) Match

func (slf *Level2Router[Route, Handle]) Match(topRoute Route, route Route) Handle

Match 匹配路由

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func (*Level2Router[Route, Handle]) Route

func (slf *Level2Router[Route, Handle]) Route(topRoute Route, route Route, handleFunc Handle)

Route 创建路由

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

type Level3Router

type Level3Router[Route comparable, Handle any] struct {
	// contains filtered or unexported fields
}

Level3Router 支持三级分类的路由器

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func NewLevel3Router

func NewLevel3Router[Route comparable, Handle any]() *Level3Router[Route, Handle]

NewLevel3Router 创建支持三级分类的路由器

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func (*Level3Router[Route, Handle]) Match

func (slf *Level3Router[Route, Handle]) Match(topRoute Route, level2Route Route, route Route) Handle

Match 匹配路由

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

func (*Level3Router[Route, Handle]) Route

func (slf *Level3Router[Route, Handle]) Route(topRoute Route, level2Route Route, route Route, handleFunc Handle)

Route 创建路由

Deprecated: 从 Minotaur 0.1.7 开始，由于该路由器设计不合理，局限性大，已弃用。建议使用 Multistage 进行代替。

type Multistage

type Multistage[HandleFunc any] struct {
	// contains filtered or unexported fields
}

Multistage 支持多级分类的路由器

func NewMultistage

func NewMultistage[HandleFunc any](options ...MultistageOption[HandleFunc]) *Multistage[HandleFunc]

NewMultistage 创建一个支持多级分类的路由器

Example

package main

import (
	"github.com/kercylan98/minotaur/server/router"
)

func main() {
	router.NewMultistage[func()]()

}

func (*Multistage[HandleFunc]) Match

func (slf *Multistage[HandleFunc]) Match(routes ...any) HandleFunc

Match 匹配已绑定处理函数的路由，返回处理函数

• 如果未找到将会返回空指针

Example

package main

import (
	"github.com/kercylan98/minotaur/server/router"
)

func main() {
	r := router.NewMultistage[func()]()

	r.Route("ServerTime", func() {})
	r.Register("System", "Network", "Ping").Bind(func() {})

	r.Match("ServerTime")()
	r.Match("System", "Network", "Ping")()

}

func (*Multistage[HandleFunc]) Register

func (slf *Multistage[HandleFunc]) Register(routes ...any) MultistageBind[HandleFunc]

Register 注册路由是结合 Sub 和 Route 的快捷方式，用于一次性注册多级路由

• 该函数将返回一个注册函数，可通过调用其将路由绑定到特定处理函数，例如：router.Register("a", "b").Bind(onExec())

Example

package main

import (
	"github.com/kercylan98/minotaur/server/router"
)

func main() {
	r := router.NewMultistage[func()]()

	r.Register("System", "Network", "Ping")(func() {
		// ...
	})

}

func (*Multistage[HandleFunc]) Route

func (slf *Multistage[HandleFunc]) Route(route any, handleFunc HandleFunc)

Route 为特定路由绑定处理函数，被绑定的处理函数将可以通过 Match 函数进行匹配

Example

package main

import (
	"github.com/kercylan98/minotaur/server/router"
)

func main() {
	r := router.NewMultistage[func()]()

	r.Route("ServerTime", func() {
		// ...
	})

}

func (*Multistage[HandleFunc]) Sub

func (slf *Multistage[HandleFunc]) Sub(route any) *Multistage[HandleFunc]

Sub 获取子路由器

Example

package main

import (
	"github.com/kercylan98/minotaur/server/router"
)

func main() {
	r := router.NewMultistage[func()]()

	r.Sub("System").Route("Heartbeat", func() {
		// ...
	})

}

type MultistageBind

type MultistageBind[HandleFunc any] func(HandleFunc)

MultistageBind 多级分类路由绑定函数

func (MultistageBind[HandleFunc]) Bind

func (slf MultistageBind[HandleFunc]) Bind(handleFunc HandleFunc)

Bind 将处理函数绑定到预设的路由中

type MultistageOption

type MultistageOption[HandleFunc any] func(multistage *Multistage[HandleFunc])

MultistageOption 路由器选项

func WithRouteTrim

func WithRouteTrim[HandleFunc any](handle func(route any) any) MultistageOption[HandleFunc]

WithRouteTrim 路由修剪选项

• 将在路由注册前对路由进行对应处理