gotosocial/vendor/github.com/go-openapi/runtime/middleware/doc.go

// Copyright 2015 go-swagger maintainers
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//    http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

/*
Package middleware provides the library with helper functions for serving swagger APIs.

Pseudo middleware handler

	import (
		"net/http"

		"github.com/go-openapi/errors"
	)

	func newCompleteMiddleware(ctx *Context) http.Handler {
		return http.HandlerFunc(func(rw http.ResponseWriter, r *http.Request) {
			// use context to lookup routes
			if matched, ok := ctx.RouteInfo(r); ok {

				if matched.NeedsAuth() {
					if _, err := ctx.Authorize(r, matched); err != nil {
						ctx.Respond(rw, r, matched.Produces, matched, err)
						return
					}
				}

				bound, validation := ctx.BindAndValidate(r, matched)
				if validation != nil {
					ctx.Respond(rw, r, matched.Produces, matched, validation)
					return
				}

				result, err := matched.Handler.Handle(bound)
				if err != nil {
					ctx.Respond(rw, r, matched.Produces, matched, err)
					return
				}

				ctx.Respond(rw, r, matched.Produces, matched, result)
				return
			}

			// Not found, check if it exists in the other methods first
			if others := ctx.AllowedMethods(r); len(others) > 0 {
				ctx.Respond(rw, r, ctx.spec.RequiredProduces(), nil, errors.MethodNotAllowed(r.Method, others))
				return
			}
			ctx.Respond(rw, r, ctx.spec.RequiredProduces(), nil, errors.NotFound("path %s was not found", r.URL.Path))
		})
	}
*/
package middleware