httpserver

type AccessLogWriter struct {

	// The path of the log file to be written to (and created if required)
	LogPath string

	// The format of each log line. See the top of this GoDoc page for supported formats. Mutually exclusive with LogLinePreset.
	LogLineFormat string

	// A pre-defined format. Supported values are framework or combined. Mutually exclusive with LogLineFormat.
	LogLinePreset string

	//The number of lines that can be buffered for asynchronous writing to the log file before calls to LogRequest block.
	LineBufferSize int

	//Whether or not timestamps should be converted to UTC before they are written to the access log.
	UtcTimes bool
	// contains filtered or unexported fields
}

type HttpServer struct {

	// Logger used by Granitic framework components. Automatically injected.
	FrameworkLogger logging.Logger

	// A component able to write an access log. Automatically added by this facility's builder, is access log support is enabled.
	AccessLogWriter *AccessLogWriter

	// Whether or not access logging should be enabled.
	AccessLogging bool

	// Whether or not instances of httpendpoint.HttpEndpointProvider found in the IoC container should be automatically
	// registered with this server
	AutoFindHandlers bool

	// The TCP port on which the HTTP server should listen for requests.
	Port int

	// The IP/hostname this server should listen on, follows standard Go net package syntax. Empty string means listen on all.
	Address string

	// A component able to write valid HTTP responses in the event a user request results in an abnormal result
	// (not found, server too busy, panic in application logic). If you use the JsonWs or XmlWs facility, this is automatically injected.
	AbnormalStatusWriter ws.AbnormalStatusWriter

	// The name of a component in the IoC container that should be used as an AbnormalStatusWriter if one is not being auto-injected.
	AbnormalStatusWriterName string

	// The number of HTTP requests currently being handled by the server.
	ActiveRequests int64

	// Allow request instrumentation to begin BEFORE too-busy/suspended checks. Allows instrumentation of requests that would be trivially
	// rejected, but potentially increases risk of denial-of-service if instrumentation setup causes load or consumes memory.
	AllowEarlyInstrumentation bool

	// How many concurrent requests the server should allow before returning 'too busy' responses to subsequent requests.
	MaxConcurrent int64

	// The HTTP status code returned with 'too busy responses'. Normally 503
	TooBusyStatus int

	// A component able to examine an incoming request and determine which version of functionality is being requested.
	VersionExtractor httpendpoint.RequestedVersionExtractor

	// A component able to use data in an HTTP request's headers to populate a context
	IdContextBuilder IdentifiedRequestContextBuilder

	// ID of a component that implements instrument.RequestInstrumentationManager
	RequestInstrumentationManagerName string
	// contains filtered or unexported fields
}

type HttpServerFacilityBuilder struct {
}

type IdentifiedRequestContextBuilder interface {
	// WithIdentity uses information in the supplied request to assign an ID to this context
	WithIdentity(ctx context.Context, req *http.Request) (context.Context, error)
	Id(ctx context.Context) string
}