1
0
mirror of https://github.com/ceph/ceph-csi.git synced 2024-12-22 21:10:22 +00:00
ceph-csi/vendor/github.com/emicklei/go-restful/v3
Humble Chirammal c9ccbf29bb rebase: update to latest snapshotter
this commit update the snapshotter client to v6.1.0

Signed-off-by: Humble Chirammal <hchiramm@redhat.com>
2022-11-11 09:25:57 +00:00
..
log rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
.gitignore rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
.goconvey rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
.travis.yml rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
bench_test.sh rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
CHANGES.md rebase: update to latest snapshotter 2022-11-11 09:25:57 +00:00
compress.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
compressor_cache.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
compressor_pools.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
compressors.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
constants.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
container.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
cors_filter.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
coverage.sh rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
curly_route.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
curly.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
custom_verb.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
doc.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
entity_accessors.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
extensions.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
filter_adapter.go rebase: update to latest snapshotter 2022-11-11 09:25:57 +00:00
filter.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
json.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
jsoniter.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
jsr311.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
LICENSE rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
logger.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
Makefile rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
mime.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
options_filter.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
parameter.go rebase: update to latest snapshotter 2022-11-11 09:25:57 +00:00
path_expression.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
path_processor.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
README.md rebase: update to latest snapshotter 2022-11-11 09:25:57 +00:00
request.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
response.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
route_builder.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
route_reader.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
route.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
router.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
SECURITY.md rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
service_error.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
Srcfile rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
web_service_container.go rebase: update kubernetes to v1.25.0 2022-08-25 16:36:35 +00:00
web_service.go rebase: update to latest snapshotter 2022-11-11 09:25:57 +00:00

go-restful

package for building REST-style Web Services using Google Go

Build Status Go Report Card GoDoc codecov

REST asks developers to use HTTP methods explicitly and in a way that's consistent with the protocol definition. This basic REST design principle establishes a one-to-one mapping between create, read, update, and delete (CRUD) operations and HTTP methods. According to this mapping:

  • GET = Retrieve a representation of a resource
  • POST = Create if you are sending content to the server to create a subordinate of the specified resource collection, using some server-side algorithm.
  • PUT = Create if you are sending the full content of the specified resource (URI).
  • PUT = Update if you are updating the full content of the specified resource.
  • DELETE = Delete if you are requesting the server to delete the resource
  • PATCH = Update partial content of a resource
  • OPTIONS = Get information about the communication options for the request URI

Usage

Without Go Modules

All versions up to v2.*.* (on the master) are not supporting Go modules.

import (
	restful "github.com/emicklei/go-restful"
)

Using Go Modules

As of version v3.0.0 (on the v3 branch), this package supports Go modules.

import (
	restful "github.com/emicklei/go-restful/v3"
)

Example

ws := new(restful.WebService)
ws.
	Path("/users").
	Consumes(restful.MIME_XML, restful.MIME_JSON).
	Produces(restful.MIME_JSON, restful.MIME_XML)

ws.Route(ws.GET("/{user-id}").To(u.findUser).
	Doc("get a user").
	Param(ws.PathParameter("user-id", "identifier of the user").DataType("string")).
	Writes(User{}))		
...
	
func (u UserResource) findUser(request *restful.Request, response *restful.Response) {
	id := request.PathParameter("user-id")
	...
}

Full API of a UserResource

Features

  • Routes for request → function mapping with path parameter (e.g. {id} but also prefix_{var} and {var}_suffix) support
  • Configurable router:
    • (default) Fast routing algorithm that allows static elements, google custom method, regular expressions and dynamic parameters in the URL path (e.g. /resource/name:customVerb, /meetings/{id} or /static/{subpath:*})
    • Routing algorithm after JSR311 that is implemented using (but does not accept) regular expressions
  • Request API for reading structs from JSON/XML and accessing parameters (path,query,header)
  • Response API for writing structs to JSON/XML and setting headers
  • Customizable encoding using EntityReaderWriter registration
  • Filters for intercepting the request → response flow on Service or Route level
  • Request-scoped variables using attributes
  • Containers for WebServices on different HTTP endpoints
  • Content encoding (gzip,deflate) of request and response payloads
  • Automatic responses on OPTIONS (using a filter)
  • Automatic CORS request handling (using a filter)
  • API declaration for Swagger UI (go-restful-openapi, see go-restful-swagger12)
  • Panic recovery to produce HTTP 500, customizable using RecoverHandler(...)
  • Route errors produce HTTP 404/405/406/415 errors, customizable using ServiceErrorHandler(...)
  • Configurable (trace) logging
  • Customizable gzip/deflate readers and writers using CompressorProvider registration
  • Inject your own http.Handler using the HttpMiddlewareHandlerToFilter function

How to customize

There are several hooks to customize the behavior of the go-restful package.

  • Router algorithm
  • Panic recovery
  • JSON decoder
  • Trace logging
  • Compression
  • Encoders for other serializers
  • Use jsoniter by building this package using a build tag, e.g. go build -tags=jsoniter .

Resources

Type git shortlog -s for a full list of contributors.

© 2012 - 2022, http://ernestmicklei.com. MIT License. Contributions are welcome.