pingv1connect

Documentation

Index

• Constants
• func NewPingServiceHandler(svc PingServiceHandler, opts ...connect.HandlerOption) (string, http.Handler)
• type PingServiceClient
  • func NewPingServiceClient(httpClient connect.HTTPClient, baseURL string, opts ...connect.ClientOption) PingServiceClient
• type PingServiceHandler
• type UnimplementedPingServiceHandler
  • func (UnimplementedPingServiceHandler) Ping(context.Context, *connect.Request[v1.PingRequest]) (*connect.Response[v1.PingResponse], error)
  • func (UnimplementedPingServiceHandler) PingStream(context.Context, ...) error

Constants

const (
	// PingServicePingProcedure is the fully-qualified name of the PingService's Ping RPC.
	PingServicePingProcedure = "/authn.ping.v1.PingService/Ping"
	// PingServicePingStreamProcedure is the fully-qualified name of the PingService's PingStream RPC.
	PingServicePingStreamProcedure = "/authn.ping.v1.PingService/PingStream"
)

These constants are the fully-qualified names of the RPCs defined in this package. They're exposed at runtime as Spec.Procedure and as the final two segments of the HTTP route.

Note that these are different from the fully-qualified method names used by google.golang.org/protobuf/reflect/protoreflect. To convert from these constants to reflection-formatted method names, remove the leading slash and convert the remaining slash to a period.

const (
	// PingServiceName is the fully-qualified name of the PingService service.
	PingServiceName = "authn.ping.v1.PingService"
)

Functions

func NewPingServiceHandler

func NewPingServiceHandler(svc PingServiceHandler, opts ...connect.HandlerOption) (string, http.Handler)

NewPingServiceHandler builds an HTTP handler from the service implementation. It returns the path on which to mount the handler and the handler itself.

By default, handlers support the Connect, gRPC, and gRPC-Web protocols with the binary Protobuf and JSON codecs. They also support gzip compression.

Types

type PingServiceClient

type PingServiceClient interface {
	// Ping is a unary RPC that returns the same text that was sent.
	Ping(context.Context, *connect.Request[v1.PingRequest]) (*connect.Response[v1.PingResponse], error)
	// PingStream is a bidirectional stream of pings.
	PingStream(context.Context) *connect.BidiStreamForClient[v1.PingStreamRequest, v1.PingStreamResponse]
}

PingServiceClient is a client for the authn.ping.v1.PingService service.

func NewPingServiceClient

func NewPingServiceClient(httpClient connect.HTTPClient, baseURL string, opts ...connect.ClientOption) PingServiceClient

NewPingServiceClient constructs a client for the authn.ping.v1.PingService service. By default, it uses the Connect protocol with the binary Protobuf Codec, asks for gzipped responses, and sends uncompressed requests. To use the gRPC or gRPC-Web protocols, supply the connect.WithGRPC() or connect.WithGRPCWeb() options.

The URL supplied here should be the base URL for the Connect or gRPC server (for example, http://api.acme.com or https://acme.com/grpc).

type PingServiceHandler

type PingServiceHandler interface {
	// Ping is a unary RPC that returns the same text that was sent.
	Ping(context.Context, *connect.Request[v1.PingRequest]) (*connect.Response[v1.PingResponse], error)
	// PingStream is a bidirectional stream of pings.
	PingStream(context.Context, *connect.BidiStream[v1.PingStreamRequest, v1.PingStreamResponse]) error
}

PingServiceHandler is an implementation of the authn.ping.v1.PingService service.

type UnimplementedPingServiceHandler

type UnimplementedPingServiceHandler struct{}

UnimplementedPingServiceHandler returns CodeUnimplemented from all methods.

func (UnimplementedPingServiceHandler) Ping

func (UnimplementedPingServiceHandler) Ping(context.Context, *connect.Request[v1.PingRequest]) (*connect.Response[v1.PingResponse], error)

func (UnimplementedPingServiceHandler) PingStream

func (UnimplementedPingServiceHandler) PingStream(context.Context, *connect.BidiStream[v1.PingStreamRequest, v1.PingStreamResponse]) error