🔥 Feature: Add ability to restart route handling

[mtneug]

Please provide enough information so that others can review your pull request:

Adds the ability to restart the route handling e.g. after an internal redirect.

Fixes #1731

Explain the details for making this change. What existing problem does the pull request solve?

The example from #1731 is changed in the following way:

package main

import "github.com/gofiber/fiber/v2"

func main() {
	app := fiber.New()

	app.Get("/new", func(c *fiber.Ctx) error {
		return c.SendString("new")
	})

	app.Use(func(c *fiber.Ctx) error {
		c.Path("/new")
		// instead of c.Next() as this would execute the catch-all handler
		// note that this example works because GET /new is registered first. Infinit loops are possible with RestartRouting.
		return c.RestartRouting()
	})

	app.Use(func(c *fiber.Ctx) error {
		// e.g. catch-all for 404
		return fiber.ErrNotFound
	})

	app.Listen(":3000")
}

Edit 1: changed method name to RestartRouting

[welcome]

Thanks for opening this pull request! 🎉 Please check out our contributing guidelines. If you need help or want to chat with us, join us on Discord https://gofiber.io/discord

[ReneWerner87]

can we use a more descriptive name

at first glance you can not see what should be restarted

maybe RestartRouting

[mtneug]

Sure. I thought of this as an alternative to return c.Next(); therefore the shorter name.

[ReneWerner87]

thanks for the pull request, had such an idea too
#1398 (comment)
in my imagination i would have combined the restart and the setting of the route in one method and called the whole thing internalRedirect

[ReneWerner87]

@mtneug

[mtneug]

@ReneWerner87: I already renamed it to RestartRouting. Have I missed something?

[ReneWerner87]

oh I had not seen

can we rename the test cases too ? -> done with my last commit

[welcome]

Congrats on merging your first pull request! 🎉 We here at Fiber are proud of you! If you need help or want to chat with us, join us on Discord https://gofiber.io/discord

[ReneWerner87]

@mtneug please add a PR for the docs repository https://github.com/gofiber/docs

[mtneug]

can we rename the test cases too ? -> done with my last commit

Sorry I missed that.

Will update the docs.

[ReneWerner87]

thx