github.com/thetreep/go-swagger@v0.0.0-20240223100711-35af64f14f01/examples/tutorials/custom-server/gen/restapi/configure_greeter.go (about)

     1  // This file is safe to edit. Once it exists it will not be overwritten
     2  
     3  package restapi
     4  
     5  import (
     6  	"crypto/tls"
     7  	"net/http"
     8  
     9  	"github.com/go-openapi/errors"
    10  	"github.com/go-openapi/runtime"
    11  	"github.com/go-openapi/runtime/middleware"
    12  
    13  	"github.com/thetreep/go-swagger/examples/tutorials/custom-server/gen/restapi/operations"
    14  )
    15  
    16  //go:generate swagger generate server --target ../../gen --name Greeter --spec ../../swagger/swagger.yml --principal interface{} --exclude-main
    17  
    18  func configureFlags(api *operations.GreeterAPI) {
    19  	// api.CommandLineOptionsGroups = []swag.CommandLineOptionsGroup{ ... }
    20  }
    21  
    22  func configureAPI(api *operations.GreeterAPI) http.Handler {
    23  	// configure the api here
    24  	api.ServeError = errors.ServeError
    25  
    26  	// Set your custom logger if needed. Default one is log.Printf
    27  	// Expected interface func(string, ...interface{})
    28  	//
    29  	// Example:
    30  	// api.Logger = log.Printf
    31  
    32  	api.UseSwaggerUI()
    33  	// To continue using redoc as your UI, uncomment the following line
    34  	// api.UseRedoc()
    35  
    36  	api.JSONConsumer = runtime.JSONConsumer()
    37  
    38  	api.TxtProducer = runtime.TextProducer()
    39  
    40  	if api.GetGreetingHandler == nil {
    41  		api.GetGreetingHandler = operations.GetGreetingHandlerFunc(
    42  			func(params operations.GetGreetingParams) middleware.Responder {
    43  				return middleware.NotImplemented("operation operations.GetGreeting has not yet been implemented")
    44  			},
    45  		)
    46  	}
    47  
    48  	api.PreServerShutdown = func() {}
    49  
    50  	api.ServerShutdown = func() {}
    51  
    52  	return setupGlobalMiddleware(api.Serve(setupMiddlewares))
    53  }
    54  
    55  // The TLS configuration before HTTPS server starts.
    56  func configureTLS(tlsConfig *tls.Config) {
    57  	// Make all necessary changes to the TLS configuration here.
    58  }
    59  
    60  // As soon as server is initialized but not run yet, this function will be called.
    61  // If you need to modify a config, store server instance to stop it individually later, this is the place.
    62  // This function can be called multiple times, depending on the number of serving schemes.
    63  // scheme value will be set accordingly: "http", "https" or "unix".
    64  func configureServer(s *http.Server, scheme, addr string) {
    65  }
    66  
    67  // The middleware configuration is for the handler executors. These do not apply to the swagger.json document.
    68  // The middleware executes after routing but before authentication, binding and validation.
    69  func setupMiddlewares(handler http.Handler) http.Handler {
    70  	return handler
    71  }
    72  
    73  // The middleware configuration happens before anything, this middleware also applies to serving the swagger.json document.
    74  // So this is a good place to plug in a panic handling middleware, logging and metrics.
    75  func setupGlobalMiddleware(handler http.Handler) http.Handler {
    76  	return handler
    77  }