Allow arbitrary HTTP method types to be added as routes

[aldas]

Allow arbitrary HTTP method types to be added as routes.

This does not affect routing "usual" use-case performance as these arbitrary HTTP method types and underlying map is accessed only when request is of that type. This code is taken from v5.

Relates to;

• Support for custom HTTP methods #1952
• add WebDAV support(#1610) #2173
• Support LOCK/UNLOCK verbs. #1610
• Support WebDav HTTP methods required #1459

Example:

import (
	"fmt"
	"github.com/labstack/echo/v4"
	"log"
	"net/http"
)

func main() {
	e := echo.New()

	e.Add("COPY", "/*", func(c echo.Context) error {
		return c.String(http.StatusOK, "OK COPY")
	})

	if err := e.Start(":8080"); err != http.ErrServerClosed {
		log.Print(fmt.Errorf("error when starting HTTP server: %w", err))
	}
}

Output:

x@x:~/code/$ curl -v -X COPY "http://localhost:8080/something"
*   Trying 127.0.0.1:8080...
* Connected to localhost (127.0.0.1) port 8080 (#0)
> COPY /something HTTP/1.1
> Host: localhost:8080
> User-Agent: curl/7.81.0
> Accept: */*
> 
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< Content-Type: text/plain; charset=UTF-8
< Date: Sat, 06 Aug 2022 20:34:24 GMT
< Content-Length: 7
< 
* Connection #0 to host localhost left intact
OK COPY

[codecov]

Codecov Report

Merging #2237 (8742207) into master (a9879ff) will increase coverage by 0.12%.
The diff coverage is 76.92%.

@@            Coverage Diff             @@
##           master    #2237      +/-   ##
==========================================
+ Coverage   92.34%   92.46%   +0.12%     
==========================================
  Files          37       37              
  Lines        3123     3134      +11     
==========================================
+ Hits         2884     2898      +14     
+ Misses        150      145       -5     
- Partials       89       91       +2     

Impacted Files	Coverage Δ
echo.go	95.19% <ø> (ø)
router.go	97.63% <76.92%> (+0.88%)	⬆️

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[aldas]

@lammel could you review this PR?

[aldas]

bump @lammel , if you are on summer vacation do not reply :) I'll merge this today and bump a new release.

[lammel]

Pure code review LGTM.

This means we really support any aribtrary HTTP method, even those not known of defined in any standard.

Should we limit the methods to a list of supported additional methods (like those specified for WebDAV)?

[aldas]

To me, it does not make sense or reason to limit it - if you want to support some proprietary method in your app then go ahead.