fiber/docs/middleware/adaptor.md

id
adaptor

Adaptor

Converter for net/http handlers to/from Fiber request handlers, special thanks to @arsmn!

Signatures

Name	Signature	Description
HTTPHandler	HTTPHandler(h http.Handler) fiber.Handler	http.Handler -> fiber.Handler
HTTPHandlerFunc	HTTPHandlerFunc(h http.HandlerFunc) fiber.Handler	http.HandlerFunc -> fiber.Handler
HTTPMiddleware	HTTPHandlerFunc(mw func(http.Handler) http.Handler) fiber.Handler	func(http.Handler) http.Handler -> fiber.Handler
FiberHandler	FiberHandler(h fiber.Handler) http.Handler	fiber.Handler -> http.Handler
FiberHandlerFunc	FiberHandlerFunc(h fiber.Handler) http.HandlerFunc	fiber.Handler -> http.HandlerFunc
FiberApp	FiberApp(app *fiber.App) http.HandlerFunc	Fiber app -> http.HandlerFunc
ConvertRequest	ConvertRequest(c fiber.Ctx, forServer bool) (*http.Request, error)	fiber.Ctx -> http.Request
CopyContextToFiberContext	CopyContextToFiberContext(context any, requestContext *fasthttp.RequestCtx)	context.Context -> fasthttp.RequestCtx

Examples

net/http to Fiber

package main

import (
	"fmt"
	"net/http"

	"github.com/gofiber/fiber/v3"
	"github.com/gofiber/fiber/v3/middleware/adaptor"
)

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

	// http.Handler -> fiber.Handler
	app.Get("/", adaptor.HTTPHandler(handler(greet)))

	// http.HandlerFunc -> fiber.Handler
	app.Get("/func", adaptor.HTTPHandlerFunc(greet))

	// Listen on port 3000
	app.Listen(":3000")
}

func handler(f http.HandlerFunc) http.Handler {
	return http.HandlerFunc(f)
}

func greet(w http.ResponseWriter, r *http.Request) {
	fmt.Fprint(w, "Hello World!")
}

net/http middleware to Fiber

package main

import (
	"log"
	"net/http"

	"github.com/gofiber/fiber/v3"
	"github.com/gofiber/fiber/v3/middleware/adaptor"
)

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

	// http middleware -> fiber.Handler
	app.Use(adaptor.HTTPMiddleware(logMiddleware))

	// Listen on port 3000
	app.Listen(":3000")
}

func logMiddleware(next http.Handler) http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		log.Println("log middleware")
		next.ServeHTTP(w, r)
	})
}

Fiber Handler to net/http

package main

import (
	"net/http"

	"github.com/gofiber/fiber/v3"
	"github.com/gofiber/fiber/v3/middleware/adaptor"
)

func main() {
	// fiber.Handler -> http.Handler
	http.Handle("/", adaptor.FiberHandler(greet))

  	// fiber.Handler -> http.HandlerFunc
	http.HandleFunc("/func", adaptor.FiberHandlerFunc(greet))

	// Listen on port 3000
	http.ListenAndServe(":3000", nil)
}

func greet(c fiber.Ctx) error {
	return c.SendString("Hello World!")
}

Fiber App to net/http

package main

import (
	"net/http"

	"github.com/gofiber/fiber/v3"
	"github.com/gofiber/fiber/v3/middleware/adaptor"
)

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

	app.Get("/greet", greet)

	// Listen on port 3000
	http.ListenAndServe(":3000", adaptor.FiberApp(app))
}

func greet(c fiber.Ctx) error {
	return c.SendString("Hello World!")
}

Fiber Context to (net/http).Request

package main

import (
	"net/http"

	"github.com/gofiber/fiber/v3"
	"github.com/gofiber/fiber/v3/middleware/adaptor"
)

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

	app.Get("/greet", greetWithHTTPReq)

	// Listen on port 3000
	http.ListenAndServe(":3000", adaptor.FiberApp(app))
}

func greetWithHTTPReq(c fiber.Ctx) error {
	httpReq, err := adaptor.ConvertRequest(c, false)
	if err != nil {
		return err
	}

	return c.SendString("Request URL: " + httpReq.URL.String())
}