Documentation ¶
Overview ¶
Package v1 is a reverse proxy.
It translates gRPC into RESTful JSON APIs.
Index ¶
- Constants
- Variables
- func RegisterLinkServiceHandler(ctx context.Context, mux *runtime.ServeMux, conn *grpc.ClientConn) error
- func RegisterLinkServiceHandlerClient(ctx context.Context, mux *runtime.ServeMux, client LinkServiceClient) error
- func RegisterLinkServiceHandlerFromEndpoint(ctx context.Context, mux *runtime.ServeMux, endpoint string, ...) (err error)
- func RegisterLinkServiceHandlerServer(ctx context.Context, mux *runtime.ServeMux, server LinkServiceServer) error
- func RegisterLinkServiceServer(s grpc.ServiceRegistrar, srv LinkServiceServer)
- func RegisterSpan(ctx context.Context) error
- type API
- func (api *API) Close() error
- func (api *API) CreateLink(ctx context.Context, req *CreateLinkRequest) (*CreateLinkResponse, error)
- func (api *API) CustomHTTPError(_ context.Context, _ *runtime.ServeMux, marshaler runtime.Marshaler, ...)
- func (api *API) DeleteLink(ctx context.Context, req *DeleteLinkRequest) (*emptypb.Empty, error)
- func (api *API) GetLink(ctx context.Context, req *GetLinkRequest) (*GetLinkResponse, error)
- func (api *API) GetLinks(ctx context.Context, req *GetLinksRequest) (*GetLinksResponse, error)
- func (api *API) Run(ctx context.Context, i18n *message.Printer, config http_server.Config, ...) error
- type CreateLinkRequest
- type CreateLinkResponse
- func (*CreateLinkResponse) Descriptor() ([]byte, []int)deprecated
- func (x *CreateLinkResponse) GetLink() *v1.Link
- func (*CreateLinkResponse) ProtoMessage()
- func (x *CreateLinkResponse) ProtoReflect() protoreflect.Message
- func (x *CreateLinkResponse) Reset()
- func (x *CreateLinkResponse) String() string
- type DeleteLinkRequest
- type GetLinkRequest
- type GetLinkResponse
- type GetLinksRequest
- func (*GetLinksRequest) Descriptor() ([]byte, []int)deprecated
- func (x *GetLinksRequest) GetFilter() string
- func (x *GetLinksRequest) GetLink() *v1.Link
- func (*GetLinksRequest) ProtoMessage()
- func (x *GetLinksRequest) ProtoReflect() protoreflect.Message
- func (x *GetLinksRequest) Reset()
- func (x *GetLinksRequest) String() string
- type GetLinksResponse
- type LinkServiceClient
- type LinkServiceServer
- type UnimplementedLinkServiceServer
- func (UnimplementedLinkServiceServer) CreateLink(context.Context, *CreateLinkRequest) (*CreateLinkResponse, error)
- func (UnimplementedLinkServiceServer) DeleteLink(context.Context, *DeleteLinkRequest) (*emptypb.Empty, error)
- func (UnimplementedLinkServiceServer) GetLink(context.Context, *GetLinkRequest) (*GetLinkResponse, error)
- func (UnimplementedLinkServiceServer) GetLinks(context.Context, *GetLinksRequest) (*GetLinksResponse, error)
- type UnsafeLinkServiceServer
Constants ¶
const ( LinkService_GetLinks_FullMethodName = "/server.v1.LinkService/GetLinks" LinkService_GetLink_FullMethodName = "/server.v1.LinkService/GetLink" LinkService_CreateLink_FullMethodName = "/server.v1.LinkService/CreateLink" LinkService_DeleteLink_FullMethodName = "/server.v1.LinkService/DeleteLink" )
Variables ¶
var File_server_v1_grpc_api_proto protoreflect.FileDescriptor
var LinkService_ServiceDesc = grpc.ServiceDesc{ ServiceName: "server.v1.LinkService", HandlerType: (*LinkServiceServer)(nil), Methods: []grpc.MethodDesc{ { MethodName: "GetLinks", Handler: _LinkService_GetLinks_Handler, }, { MethodName: "GetLink", Handler: _LinkService_GetLink_Handler, }, { MethodName: "CreateLink", Handler: _LinkService_CreateLink_Handler, }, { MethodName: "DeleteLink", Handler: _LinkService_DeleteLink_Handler, }, }, Streams: []grpc.StreamDesc{}, Metadata: "server/v1/grpc_api.proto", }
LinkService_ServiceDesc is the grpc.ServiceDesc for LinkService service. It's only intended for direct use with grpc.RegisterService, and not to be introspected or modified (even as a copy)
Functions ¶
func RegisterLinkServiceHandler ¶
func RegisterLinkServiceHandler(ctx context.Context, mux *runtime.ServeMux, conn *grpc.ClientConn) error
RegisterLinkServiceHandler registers the http handlers for service LinkService to "mux". The handlers forward requests to the grpc endpoint over "conn".
func RegisterLinkServiceHandlerClient ¶
func RegisterLinkServiceHandlerClient(ctx context.Context, mux *runtime.ServeMux, client LinkServiceClient) error
RegisterLinkServiceHandlerClient registers the http handlers for service LinkService to "mux". The handlers forward requests to the grpc endpoint over the given implementation of "LinkServiceClient". Note: the gRPC framework executes interceptors within the gRPC handler. If the passed in "LinkServiceClient" doesn't go through the normal gRPC flow (creating a gRPC client etc.) then it will be up to the passed in "LinkServiceClient" to call the correct interceptors.
func RegisterLinkServiceHandlerFromEndpoint ¶
func RegisterLinkServiceHandlerFromEndpoint(ctx context.Context, mux *runtime.ServeMux, endpoint string, opts []grpc.DialOption) (err error)
RegisterLinkServiceHandlerFromEndpoint is same as RegisterLinkServiceHandler but automatically dials to "endpoint" and closes the connection when "ctx" gets done.
func RegisterLinkServiceHandlerServer ¶
func RegisterLinkServiceHandlerServer(ctx context.Context, mux *runtime.ServeMux, server LinkServiceServer) error
RegisterLinkServiceHandlerServer registers the http handlers for service LinkService to "mux". UnaryRPC :call LinkServiceServer directly. StreamingRPC :currently unsupported pending https://github.com/grpc/grpc-go/issues/906. Note that using this registration option will cause many gRPC library features to stop working. Consider using RegisterLinkServiceHandlerFromEndpoint instead.
func RegisterLinkServiceServer ¶
func RegisterLinkServiceServer(s grpc.ServiceRegistrar, srv LinkServiceServer)
func RegisterSpan ¶
RegisterSpan - inject spanId in response header
Types ¶
type API ¶
type API struct { LinkServiceServer RPC *rpc.Server // contains filtered or unexported fields }
API ...
func (*API) CreateLink ¶
func (api *API) CreateLink(ctx context.Context, req *CreateLinkRequest) (*CreateLinkResponse, error)
CreateLink ...
func (*API) CustomHTTPError ¶
func (*API) DeleteLink ¶
DeleteLink ...
func (*API) GetLink ¶
func (api *API) GetLink(ctx context.Context, req *GetLinkRequest) (*GetLinkResponse, error)
GetLink ...
func (*API) GetLinks ¶
func (api *API) GetLinks(ctx context.Context, req *GetLinksRequest) (*GetLinksResponse, error)
GetLinks ...
func (*API) Run ¶
func (api *API) Run( ctx context.Context, i18n *message.Printer, config http_server.Config, log logger.Logger, tracer trace.TracerProvider, link_rpc link_rpc.LinkServiceClient, link_command link_cqrs.LinkCommandServiceClient, link_query link_cqrs.LinkQueryServiceClient, sitemap_rpc sitemap_rpc.SitemapServiceClient, ) error
Run HTTP-server
type CreateLinkRequest ¶
type CreateLinkRequest struct { // Link Link *v1.Link `protobuf:"bytes,1,opt,name=link,proto3" json:"link,omitempty"` // contains filtered or unexported fields }
CreateLinkRequest is the request message for CreateLink.
func (*CreateLinkRequest) Descriptor
deprecated
func (*CreateLinkRequest) Descriptor() ([]byte, []int)
Deprecated: Use CreateLinkRequest.ProtoReflect.Descriptor instead.
func (*CreateLinkRequest) GetLink ¶
func (x *CreateLinkRequest) GetLink() *v1.Link
func (*CreateLinkRequest) ProtoMessage ¶
func (*CreateLinkRequest) ProtoMessage()
func (*CreateLinkRequest) ProtoReflect ¶
func (x *CreateLinkRequest) ProtoReflect() protoreflect.Message
func (*CreateLinkRequest) Reset ¶
func (x *CreateLinkRequest) Reset()
func (*CreateLinkRequest) String ¶
func (x *CreateLinkRequest) String() string
type CreateLinkResponse ¶
type CreateLinkResponse struct { // Link Link *v1.Link `protobuf:"bytes,1,opt,name=link,proto3" json:"link,omitempty"` // contains filtered or unexported fields }
CreateLinkResponse is the response message for CreateLink.
func (*CreateLinkResponse) Descriptor
deprecated
func (*CreateLinkResponse) Descriptor() ([]byte, []int)
Deprecated: Use CreateLinkResponse.ProtoReflect.Descriptor instead.
func (*CreateLinkResponse) GetLink ¶
func (x *CreateLinkResponse) GetLink() *v1.Link
func (*CreateLinkResponse) ProtoMessage ¶
func (*CreateLinkResponse) ProtoMessage()
func (*CreateLinkResponse) ProtoReflect ¶
func (x *CreateLinkResponse) ProtoReflect() protoreflect.Message
func (*CreateLinkResponse) Reset ¶
func (x *CreateLinkResponse) Reset()
func (*CreateLinkResponse) String ¶
func (x *CreateLinkResponse) String() string
type DeleteLinkRequest ¶
type DeleteLinkRequest struct { // Link hash Link *v1.Link `protobuf:"bytes,1,opt,name=link,proto3" json:"link,omitempty"` // contains filtered or unexported fields }
DeleteLinkRequest is the request message for DeleteLink.
func (*DeleteLinkRequest) Descriptor
deprecated
func (*DeleteLinkRequest) Descriptor() ([]byte, []int)
Deprecated: Use DeleteLinkRequest.ProtoReflect.Descriptor instead.
func (*DeleteLinkRequest) GetLink ¶
func (x *DeleteLinkRequest) GetLink() *v1.Link
func (*DeleteLinkRequest) ProtoMessage ¶
func (*DeleteLinkRequest) ProtoMessage()
func (*DeleteLinkRequest) ProtoReflect ¶
func (x *DeleteLinkRequest) ProtoReflect() protoreflect.Message
func (*DeleteLinkRequest) Reset ¶
func (x *DeleteLinkRequest) Reset()
func (*DeleteLinkRequest) String ¶
func (x *DeleteLinkRequest) String() string
type GetLinkRequest ¶
type GetLinkRequest struct { // Link hash Link *v1.Link `protobuf:"bytes,1,opt,name=link,proto3" json:"link,omitempty"` // contains filtered or unexported fields }
GetLinkRequest is the request message for GetLink.
func (*GetLinkRequest) Descriptor
deprecated
func (*GetLinkRequest) Descriptor() ([]byte, []int)
Deprecated: Use GetLinkRequest.ProtoReflect.Descriptor instead.
func (*GetLinkRequest) GetLink ¶
func (x *GetLinkRequest) GetLink() *v1.Link
func (*GetLinkRequest) ProtoMessage ¶
func (*GetLinkRequest) ProtoMessage()
func (*GetLinkRequest) ProtoReflect ¶
func (x *GetLinkRequest) ProtoReflect() protoreflect.Message
func (*GetLinkRequest) Reset ¶
func (x *GetLinkRequest) Reset()
func (*GetLinkRequest) String ¶
func (x *GetLinkRequest) String() string
type GetLinkResponse ¶
type GetLinkResponse struct { // Link Link *v1.Link `protobuf:"bytes,1,opt,name=link,proto3" json:"link,omitempty"` // contains filtered or unexported fields }
GetLinkResponse is the response message for GetLink.
func (*GetLinkResponse) Descriptor
deprecated
func (*GetLinkResponse) Descriptor() ([]byte, []int)
Deprecated: Use GetLinkResponse.ProtoReflect.Descriptor instead.
func (*GetLinkResponse) GetLink ¶
func (x *GetLinkResponse) GetLink() *v1.Link
func (*GetLinkResponse) ProtoMessage ¶
func (*GetLinkResponse) ProtoMessage()
func (*GetLinkResponse) ProtoReflect ¶
func (x *GetLinkResponse) ProtoReflect() protoreflect.Message
func (*GetLinkResponse) Reset ¶
func (x *GetLinkResponse) Reset()
func (*GetLinkResponse) String ¶
func (x *GetLinkResponse) String() string
type GetLinksRequest ¶
type GetLinksRequest struct { // Link hash Link *v1.Link `protobuf:"bytes,1,opt,name=link,proto3" json:"link,omitempty"` // Link filter Filter string `protobuf:"bytes,2,opt,name=filter,proto3" json:"filter,omitempty"` // contains filtered or unexported fields }
GetLinksRequest is the request message for GetLinks.
func (*GetLinksRequest) Descriptor
deprecated
func (*GetLinksRequest) Descriptor() ([]byte, []int)
Deprecated: Use GetLinksRequest.ProtoReflect.Descriptor instead.
func (*GetLinksRequest) GetFilter ¶
func (x *GetLinksRequest) GetFilter() string
func (*GetLinksRequest) GetLink ¶
func (x *GetLinksRequest) GetLink() *v1.Link
func (*GetLinksRequest) ProtoMessage ¶
func (*GetLinksRequest) ProtoMessage()
func (*GetLinksRequest) ProtoReflect ¶
func (x *GetLinksRequest) ProtoReflect() protoreflect.Message
func (*GetLinksRequest) Reset ¶
func (x *GetLinksRequest) Reset()
func (*GetLinksRequest) String ¶
func (x *GetLinksRequest) String() string
type GetLinksResponse ¶
type GetLinksResponse struct { // Links Links []*v1.Link `protobuf:"bytes,1,rep,name=links,proto3" json:"links,omitempty"` // contains filtered or unexported fields }
GetLinksResponse is the response message for GetLinks.
func (*GetLinksResponse) Descriptor
deprecated
func (*GetLinksResponse) Descriptor() ([]byte, []int)
Deprecated: Use GetLinksResponse.ProtoReflect.Descriptor instead.
func (*GetLinksResponse) GetLinks ¶
func (x *GetLinksResponse) GetLinks() []*v1.Link
func (*GetLinksResponse) ProtoMessage ¶
func (*GetLinksResponse) ProtoMessage()
func (*GetLinksResponse) ProtoReflect ¶
func (x *GetLinksResponse) ProtoReflect() protoreflect.Message
func (*GetLinksResponse) Reset ¶
func (x *GetLinksResponse) Reset()
func (*GetLinksResponse) String ¶
func (x *GetLinksResponse) String() string
type LinkServiceClient ¶
type LinkServiceClient interface { // GetLinks returns a list of links. GetLinks(ctx context.Context, in *GetLinksRequest, opts ...grpc.CallOption) (*GetLinksResponse, error) // GetLink returns a link. GetLink(ctx context.Context, in *GetLinkRequest, opts ...grpc.CallOption) (*GetLinkResponse, error) // CreateLink creates a link. CreateLink(ctx context.Context, in *CreateLinkRequest, opts ...grpc.CallOption) (*CreateLinkResponse, error) // DeleteLink deletes a link. DeleteLink(ctx context.Context, in *DeleteLinkRequest, opts ...grpc.CallOption) (*emptypb.Empty, error) }
LinkServiceClient is the client API for LinkService service.
For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.
func NewLinkServiceClient ¶
func NewLinkServiceClient(cc grpc.ClientConnInterface) LinkServiceClient
type LinkServiceServer ¶
type LinkServiceServer interface { // GetLinks returns a list of links. GetLinks(context.Context, *GetLinksRequest) (*GetLinksResponse, error) // GetLink returns a link. GetLink(context.Context, *GetLinkRequest) (*GetLinkResponse, error) // CreateLink creates a link. CreateLink(context.Context, *CreateLinkRequest) (*CreateLinkResponse, error) // DeleteLink deletes a link. DeleteLink(context.Context, *DeleteLinkRequest) (*emptypb.Empty, error) }
LinkServiceServer is the server API for LinkService service. All implementations should embed UnimplementedLinkServiceServer for forward compatibility
type UnimplementedLinkServiceServer ¶
type UnimplementedLinkServiceServer struct { }
UnimplementedLinkServiceServer should be embedded to have forward compatible implementations.
func (UnimplementedLinkServiceServer) CreateLink ¶
func (UnimplementedLinkServiceServer) CreateLink(context.Context, *CreateLinkRequest) (*CreateLinkResponse, error)
func (UnimplementedLinkServiceServer) DeleteLink ¶
func (UnimplementedLinkServiceServer) DeleteLink(context.Context, *DeleteLinkRequest) (*emptypb.Empty, error)
func (UnimplementedLinkServiceServer) GetLink ¶
func (UnimplementedLinkServiceServer) GetLink(context.Context, *GetLinkRequest) (*GetLinkResponse, error)
func (UnimplementedLinkServiceServer) GetLinks ¶
func (UnimplementedLinkServiceServer) GetLinks(context.Context, *GetLinksRequest) (*GetLinksResponse, error)
type UnsafeLinkServiceServer ¶
type UnsafeLinkServiceServer interface {
// contains filtered or unexported methods
}
UnsafeLinkServiceServer may be embedded to opt out of forward compatibility for this service. Use of this interface is not recommended, as added methods to LinkServiceServer will result in compilation errors.