api

package

v1.18.3-focal Latest Latest Go to latest Published: Jul 9, 2022 License: Apache-2.0 Imports: 5 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/focalsolution/micro-go-micro

Documentation ¶

Index ¶

func Encode(e *Endpoint) map[string]string
func Validate(e *Endpoint) error
func WithEndpoint(e *Endpoint) server.HandlerOption
type Endpoint
- func Decode(e map[string]string) *Endpoint
type Service

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Encode ¶

func Encode(e *Endpoint) map[string]string

Encode encodes an endpoint to endpoint metadata

func Validate ¶

func Validate(e *Endpoint) error

Validate validates an endpoint to guarantee it won't blow up when being served

func WithEndpoint ¶

func WithEndpoint(e *Endpoint) server.HandlerOption

WithEndpoint returns a server.HandlerOption with endpoint metadata set

Usage:

proto.RegisterHandler(service.Server(), new(Handler), api.WithEndpoint(
	&api.Endpoint{
		Name: "Greeter.Hello",
		Path: []string{"/greeter"},
	},
))

Types ¶

type Endpoint ¶

type Endpoint struct {
	// RPC Method e.g. Greeter.Hello
	Name string
	// Description e.g what's this endpoint for
	Description string
	// API Handler e.g rpc, proxy
	Handler string
	// HTTP Host e.g example.com
	Host []string
	// HTTP Methods e.g GET, POST
	Method []string
	// HTTP Path e.g /greeter. Expect POSIX regex
	Path []string
}

Endpoint is a mapping between an RPC method and HTTP endpoint

func Decode ¶

func Decode(e map[string]string) *Endpoint

Decode decodes endpoint metadata into an endpoint

type Service ¶

type Service struct {
	// Name of service
	Name string
	// The endpoint for this service
	Endpoint *Endpoint
	// Versions of this service
	Services []*registry.Service
}

Service represents an API service

Source Files ¶

View all Source files

api.go

Directories ¶

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

Path	Synopsis
handler Package handler provides http handlers	Package handler provides http handlers
api Package api provides an http-rpc handler which provides the entire http request over rpc	Package api provides an http-rpc handler which provides the entire http request over rpc
broker Package broker provides a go-micro/broker handler	Package broker provides a go-micro/broker handler
cloudevents Package cloudevents provides a cloudevents handler publishing the event using the go-micro/client	Package cloudevents provides a cloudevents handler publishing the event using the go-micro/client
event Package event provides a handler which publishes an event	Package event provides a handler which publishes an event
file Package file serves file relative to the current directory	Package file serves file relative to the current directory
http Package http is a http reverse proxy handler	Package http is a http reverse proxy handler
registry Package registry is a go-micro/registry handler	Package registry is a go-micro/registry handler
rpc Package rpc is a go-micro rpc handler.	Package rpc is a go-micro rpc handler.
udp Package udp reads and write from a udp connection	Package udp reads and write from a udp connection
unix Package unix reads from a unix socket expecting it to be in /tmp/path	Package unix reads from a unix socket expecting it to be in /tmp/path
web Package web contains the web handler including websocket support	Package web contains the web handler including websocket support
internal
proto
proto
resolver Package resolver resolves a http request to an endpoint	Package resolver resolves a http request to an endpoint
grpc Package grpc resolves a grpc service like /greeter.Say/Hello to greeter service	Package grpc resolves a grpc service like /greeter.Say/Hello to greeter service
host Package host resolves using http host	Package host resolves using http host
micro Package micro provides a micro rpc resolver which prefixes a namespace	Package micro provides a micro rpc resolver which prefixes a namespace
path Package path resolves using http path	Package path resolves using http path
vpath Package vpath resolves using http path and recognised versioned urls	Package vpath resolves using http path and recognised versioned urls
router Package router provides api service routing	Package router provides api service routing
registry Package registry provides a dynamic api service router	Package registry provides a dynamic api service router
server Package server provides an API gateway server which handles inbound requests	Package server provides an API gateway server which handles inbound requests
acme Package acme abstracts away various ACME libraries	Package acme abstracts away various ACME libraries
acme/autocert Package autocert is the ACME provider from golang.org/x/crypto/acme/autocert This provider does not take any config.	Package autocert is the ACME provider from golang.org/x/crypto/acme/autocert This provider does not take any config.
acme/certmagic Package certmagic is the ACME provider from github.com/mholt/certmagic	Package certmagic is the ACME provider from github.com/mholt/certmagic
http Package http provides a http server with features; acme, cors, etc	Package http provides a http server with features; acme, cors, etc