v2.2.2 Latest Latest

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

Go to latest
Published: Sep 11, 2020 License: Apache-2.0 Imports: 2 Imported by: 0



Package httpendpoint provides types that allow web-service handlers to be registered with an HTTP server.

Types in this package represent the interface between the HTTPServer facility (which is a thin layer over Go's http.Server) and the Granitic ws and handler packages that define web-services.

In most cases, user applications will not need to interact with the types in this package. Instead they will define components of type handler.WsHandler (which already implements the key Provider interface below) and the framework will automatically register them with the HTTPServer facility.



This section is empty.


This section is empty.


This section is empty.


type HTTPResponseWriter

type HTTPResponseWriter struct {

	// Whether or not any data has already been sent to the underlying http.ResponseWriter.
	DataSent bool

	// The HTTP status code sent to the response or zero if no code yet sent.
	Status int

	// How many bytes have been sent to the response so far (excluding headers).
	BytesServed int
	// contains filtered or unexported fields

HTTPResponseWriter is a wrapper over http.ResponseWriter that provides Granitic with better visibility on the state of response writing.

func NewHTTPResponseWriter

func NewHTTPResponseWriter(rw http.ResponseWriter) *HTTPResponseWriter

NewHTTPResponseWriter creates a new HTTPResponseWriter wrapping the supplied http.ResponseWriter

func (*HTTPResponseWriter) Header

func (w *HTTPResponseWriter) Header() http.Header

Header calls through to http.ResponseWriter.Header()

func (*HTTPResponseWriter) Write

func (w *HTTPResponseWriter) Write(b []byte) (int, error)

Write calls through to http.ResponseWriter.Write while keeping track of the number of bytes sent.

func (*HTTPResponseWriter) WriteHeader

func (w *HTTPResponseWriter) WriteHeader(i int)

WriteHeader sets the HTTP status code of the HTTP response. If this method is called more than once, only the first value is sent to the underlying HTTP response.

type HandlerMethods

type HandlerMethods struct {
	// A map of HTTP method names to a regular expression pattern (eg GET=^/health-check$)
	MethodPatterns map[string]string

	// A handler implementing Go's built-in http.Handler interface
	Handler http.Handler

HandlerMethods associates HTTP methods (GET, POST etc) and path-matching regular expressions with a handler.

type Provider

type Provider interface {
	//SupportedHTTPMethods returns the HTTP methods (GET, POST, PUT etc) that the endpoint supports.
	SupportedHTTPMethods() []string

	// RegexPattern returns an un-compiled regular expression that will be applied to the path element (e.g excluding scheme, domain and query parameters)
	// to potentially match the request to this endpoint.
	RegexPattern() string

	// ServeHTTP handles an HTTP request, including writing normal and abnormal responses. Returns a context that may have
	// been modified.
	ServeHTTP(ctx context.Context, w *HTTPResponseWriter, req *http.Request) context.Context

	// VersionAware returns true if this endpoint supports request version matching.
	VersionAware() bool

	// SupportsVersion returns true if this endpoint supports the version of functionality required by the requester. Behaviour is undefined if
	// VersionAware is false. Version matching is application-specific and not defined by Granitic.
	SupportsVersion(version RequiredVersion) bool

	// AutoWireable returns false if this endpoint should not automatically be registered with HTTP servers.
	AutoWireable() bool

Provider is implemented by a component that is able to support a web-service request with a particular path.

type RequestedVersionExtractor

type RequestedVersionExtractor interface {
	// Extract examines an HTTP request to determine what version of functionality is required.
	Extract(*http.Request) RequiredVersion

RequestedVersionExtractor is implemented by applications to create a component that can determine what version of functionality is required by an incoming HTTP request

type RequiredVersion

type RequiredVersion map[string]interface{}

RequiredVersion is a semi-structured type to allow applications flexibility in defining what a 'version' is.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL