http.Handler adaptor

Background

  • Phasing out the poorly maintained hertz app.FS implementation
  • Providing a compatible and performant fs implementation through the official net/http ecosystem
  • Extending hertz functionality through the official net/http ecosystem to reduce custom implementations

What is adaptor.HertzHandler

  • Allows you to convert existing http.HandlerFunc methods directly to HertzHandler
  • Enables direct use of standard library methods like http.FileServer and embed.FS
  • Even allows direct use of github.com/gorilla/websocket in Hertz

Example

package main

import (
  "embed"
  "net/http"

  "github.com/cloudwego/hertz/pkg/app/server"
  "github.com/cloudwego/hertz/pkg/common/adaptor"
)

//go:embed static/*
var staticFiles embed.FS

func main() {
  h := server.Default()

  helloHandler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("Hello hertz!"))
  })
  h.GET("/hello", adaptor.HertzHandler(helloHandler))

  staticFS := adaptor.HertzHandler(http.FileServer(http.FS(staticFiles)))
  h.GET("/static/*filepath", staticFS)
  h.HEAD("/static/*filepath", staticFS)
  h.Spin()
}

Last modified May 22, 2025 : docs: add doc for hertz v0.10.0 (#1337) (83097454e9)