server

package
v3.17.0+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 12, 2020 License: Apache-2.0 Imports: 35 Imported by: 1

Documentation

Overview

Package server is a generated GoMock package.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ClientVersionCheckMiddleware 

func ClientVersionCheckMiddleware(h http.Handler, rng VersionRange) http.Handler

ClientVersionCheckMiddleware checks the client version.

func CompressionLevel 

func CompressionLevel(level int) func(*serverConfig)

func NewRouter 

func NewRouter(c Controller) *mux.Router

NewRouter returns a mux.Router with no middleware. This is so we can attach additional routes to the router if necessary

func PanicMiddleware added in v1.2.3 

func PanicMiddleware(h http.Handler) http.Handler

PanicMiddleware logs any panics. For now, we're continue throwing the panic up the stack so this may crash the process.

func TracingMiddleware added in v1.2.3 

func TracingMiddleware(h http.Handler) http.Handler

TracingMiddleware creates a new span named after the URL path of the request. It places this span in the request context, for use by other handlers via opentracing.SpanFromContext() If a span exists in request headers, the span created by this middleware will be a child of that span.

func WithTracingOpName added in v1.2.3 

func WithTracingOpName(ctx context.Context, opName string) context.Context

WithTracingOpName adds the op name to a context for use by the tracing library. It uses a pointer because it's called below in the stack and the only way to pass the info up is to have it a set a pointer. Even though it doesn't change the context we still have this return a context to maintain the illusion.

Types

type Controller 

type Controller interface {

	// GetAuthors handles GET requests to /authors
	// Returns response object and the ID of the next page
	// Gets authors
	// 200: *models.AuthorsResponse
	// 400: *models.BadRequest
	// 500: *models.InternalError
	// default: client side HTTP errors, for example: context.DeadlineExceeded.
	GetAuthors(ctx context.Context, i *models.GetAuthorsInput) (*models.AuthorsResponse, string, error)

	// GetAuthorsWithPut handles PUT requests to /authors
	// Returns response object and the ID of the next page
	// Gets authors, but needs to use the body so it's a PUT
	// 200: *models.AuthorsResponse
	// 400: *models.BadRequest
	// 500: *models.InternalError
	// default: client side HTTP errors, for example: context.DeadlineExceeded.
	GetAuthorsWithPut(ctx context.Context, i *models.GetAuthorsWithPutInput) (*models.AuthorsResponse, string, error)

	// GetBooks handles GET requests to /books
	// Returns response object and the ID of the next page
	// Returns a list of books
	// 200: []models.Book
	// 400: *models.BadRequest
	// 500: *models.InternalError
	// default: client side HTTP errors, for example: context.DeadlineExceeded.
	GetBooks(ctx context.Context, i *models.GetBooksInput) ([]models.Book, int64, error)

	// CreateBook handles POST requests to /books
	// Creates a book
	// 200: *models.Book
	// 400: *models.BadRequest
	// 500: *models.InternalError
	// default: client side HTTP errors, for example: context.DeadlineExceeded.
	CreateBook(ctx context.Context, i *models.Book) (*models.Book, error)

	// PutBook handles PUT requests to /books
	// Puts a book
	// 200: *models.Book
	// 400: *models.BadRequest
	// 500: *models.InternalError
	// default: client side HTTP errors, for example: context.DeadlineExceeded.
	PutBook(ctx context.Context, i *models.Book) (*models.Book, error)

	// GetBookByID handles GET requests to /books/{book_id}
	// Returns a book
	// 200: *models.Book
	// 400: *models.BadRequest
	// 401: *models.Unathorized
	// 404: *models.Error
	// 500: *models.InternalError
	// default: client side HTTP errors, for example: context.DeadlineExceeded.
	GetBookByID(ctx context.Context, i *models.GetBookByIDInput) (*models.Book, error)

	// GetBookByID2 handles GET requests to /books2/{id}
	// Retrieve a book
	// 200: *models.Book
	// 400: *models.BadRequest
	// 404: *models.Error
	// 500: *models.InternalError
	// default: client side HTTP errors, for example: context.DeadlineExceeded.
	GetBookByID2(ctx context.Context, id string) (*models.Book, error)

	// HealthCheck handles GET requests to /health/check
	//
	// 200: nil
	// 400: *models.BadRequest
	// 500: *models.InternalError
	// default: client side HTTP errors, for example: context.DeadlineExceeded.
	HealthCheck(ctx context.Context) error
}

Controller defines the interface for the swagger-test service.

type MockController 

type MockController struct {
	// contains filtered or unexported fields
}

MockController is a mock of Controller interface

func NewMockController 

func NewMockController(ctrl *gomock.Controller) *MockController

NewMockController creates a new mock instance

func (*MockController) CreateBook 

func (m *MockController) CreateBook(ctx context.Context, i *models.Book) (*models.Book, error)

CreateBook mocks base method

func (*MockController) EXPECT 

func (m *MockController) EXPECT() *MockControllerMockRecorder

EXPECT returns an object that allows the caller to indicate expected use

func (*MockController) GetAuthors added in v1.3.0 

func (m *MockController) GetAuthors(ctx context.Context, i *models.GetAuthorsInput) (*models.AuthorsResponse, string, error)

GetAuthors mocks base method

func (*MockController) GetAuthorsWithPut added in v1.5.0 

func (m *MockController) GetAuthorsWithPut(ctx context.Context, i *models.GetAuthorsWithPutInput) (*models.AuthorsResponse, string, error)

GetAuthorsWithPut mocks base method

func (*MockController) GetBookByID 

func (m *MockController) GetBookByID(ctx context.Context, i *models.GetBookByIDInput) (*models.Book, error)

GetBookByID mocks base method

func (*MockController) GetBookByID2 

func (m *MockController) GetBookByID2(ctx context.Context, id string) (*models.Book, error)

GetBookByID2 mocks base method

func (*MockController) GetBooks 

func (m *MockController) GetBooks(ctx context.Context, i *models.GetBooksInput) ([]models.Book, int64, error)

GetBooks mocks base method

func (*MockController) HealthCheck 

func (m *MockController) HealthCheck(ctx context.Context) error

HealthCheck mocks base method

func (*MockController) PutBook added in v1.4.3 

func (m *MockController) PutBook(ctx context.Context, i *models.Book) (*models.Book, error)

PutBook mocks base method

type MockControllerMockRecorder added in v1.5.1 

type MockControllerMockRecorder struct {
	// contains filtered or unexported fields
}

MockControllerMockRecorder is the mock recorder for MockController

func (*MockControllerMockRecorder) CreateBook added in v1.5.1 

func (mr *MockControllerMockRecorder) CreateBook(ctx, i interface{}) *gomock.Call

CreateBook indicates an expected call of CreateBook

func (*MockControllerMockRecorder) GetAuthors added in v1.5.1 

func (mr *MockControllerMockRecorder) GetAuthors(ctx, i interface{}) *gomock.Call

GetAuthors indicates an expected call of GetAuthors

func (*MockControllerMockRecorder) GetAuthorsWithPut added in v1.5.1 

func (mr *MockControllerMockRecorder) GetAuthorsWithPut(ctx, i interface{}) *gomock.Call

GetAuthorsWithPut indicates an expected call of GetAuthorsWithPut

func (*MockControllerMockRecorder) GetBookByID added in v1.5.1 

func (mr *MockControllerMockRecorder) GetBookByID(ctx, i interface{}) *gomock.Call

GetBookByID indicates an expected call of GetBookByID

func (*MockControllerMockRecorder) GetBookByID2 added in v1.5.1 

func (mr *MockControllerMockRecorder) GetBookByID2(ctx, id interface{}) *gomock.Call

GetBookByID2 indicates an expected call of GetBookByID2

func (*MockControllerMockRecorder) GetBooks added in v1.5.1 

func (mr *MockControllerMockRecorder) GetBooks(ctx, i interface{}) *gomock.Call

GetBooks indicates an expected call of GetBooks

func (*MockControllerMockRecorder) HealthCheck added in v1.5.1 

func (mr *MockControllerMockRecorder) HealthCheck(ctx interface{}) *gomock.Call

HealthCheck indicates an expected call of HealthCheck

func (*MockControllerMockRecorder) PutBook added in v1.5.1 

func (mr *MockControllerMockRecorder) PutBook(ctx, i interface{}) *gomock.Call

PutBook indicates an expected call of PutBook

type Server 

type Server struct {
	// Handler should generally not be changed. It exposed to make testing easier.
	Handler http.Handler
	// contains filtered or unexported fields
}

Server defines a HTTP server that implements the Controller interface.

func AttachMiddleware 

func AttachMiddleware(router *mux.Router, addr string, m []func(http.Handler) http.Handler, options ...func(*serverConfig)) *Server

AttachMiddleware attaches the given middleware to the router; this is to be used in conjunction with NewServer. It attaches custom middleware passed as arguments as well as the built-in middleware for logging, tracing, and handling panics. It should be noted that the built-in middleware executes first followed by the passed in middleware (in the order specified).

func New 

func New(c Controller, addr string, options ...func(*serverConfig)) *Server

New returns a Server that implements the Controller interface. It will start when "Serve" is called.

func NewWithMiddleware added in v1.2.0 

func NewWithMiddleware(c Controller, addr string, m []func(http.Handler) http.Handler, options ...func(*serverConfig)) *Server

NewWithMiddleware returns a Server that implemenets the Controller interface. It runs the middleware after the built-in middleware (e.g. logging), but before the controller methods. The middleware is executed in the order specified. The server will start when "Serve" is called.

func (*Server) Serve 

func (s *Server) Serve() error

Serve starts the server. It will return if an error occurs.

type VersionRange 

type VersionRange func(version string) bool

VersionRange decides whether to accept a version.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.