helloworldapi

Documentation

Overview

Package helloworldapi implements the public API of the helloworld.example microservice, including clients and data structures.

The HelloWorld microservice demonstrates the minimalist classic example.

Index

• Constants
• Variables
• type Client
  • func NewClient(caller service.Publisher) *Client
  • func (_c *Client) ForHost(host string) *Client
  • func (_c *Client) HelloWorld(r *http.Request) (res *http.Response, err error)
  • func (_c *Client) HelloWorld_Get(ctx context.Context, url string) (res *http.Response, err error)
  • func (_c *Client) HelloWorld_Post(ctx context.Context, url string, contentType string, body any) (res *http.Response, err error)
• type MulticastClient
  • func NewMulticastClient(caller service.Publisher) *MulticastClient
  • func (_c *MulticastClient) ForHost(host string) *MulticastClient
  • func (_c *MulticastClient) HelloWorld(ctx context.Context, r *http.Request) <-chan *pub.Response
  • func (_c *MulticastClient) HelloWorld_Get(ctx context.Context, url string) <-chan *pub.Response
  • func (_c *MulticastClient) HelloWorld_Post(ctx context.Context, url string, contentType string, body any) <-chan *pub.Response

Constants

const Hostname = "helloworld.example"

Hostname is the default hostname of the microservice: helloworld.example.

Variables

var (
	URLOfHelloWorld = httpx.JoinHostAndPath(Hostname, `:443/hello-world`)
)

Fully-qualified URLs of the microservice's endpoints.

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client is an interface to calling the endpoints of the helloworld.example microservice. This simple version is for unicast calls.

func NewClient

func NewClient(caller service.Publisher) *Client

NewClient creates a new unicast client to the helloworld.example microservice.

func (*Client) ForHost

func (_c *Client) ForHost(host string) *Client

ForHost replaces the default hostname of this client.

func (*Client) HelloWorld

func (_c *Client) HelloWorld(r *http.Request) (res *http.Response, err error)

HelloWorld prints the classic greeting.

If a request is not provided, it defaults to the URL of the endpoint. Otherwise, it is resolved relative to the URL of the endpoint.

func (*Client) HelloWorld_Get

func (_c *Client) HelloWorld_Get(ctx context.Context, url string) (res *http.Response, err error)

HelloWorld_Get performs a GET request to the HelloWorld endpoint.

HelloWorld prints the classic greeting.

If a URL is not provided, it defaults to the URL of the endpoint. Otherwise, it is resolved relative to the URL of the endpoint.

func (*Client) HelloWorld_Post

func (_c *Client) HelloWorld_Post(ctx context.Context, url string, contentType string, body any) (res *http.Response, err error)

HelloWorld_Post performs a POST request to the HelloWorld endpoint.

HelloWorld prints the classic greeting.

If a URL is not provided, it defaults to the URL of the endpoint. Otherwise, it is resolved relative to the URL of the endpoint. If the body if of type io.Reader, []byte or string, it is serialized in binary form. If it is of type url.Values, it is serialized as form data. All other types are serialized as JSON. If a content type is not explicitly provided, an attempt will be made to derive it from the body.

type MulticastClient

type MulticastClient struct {
	// contains filtered or unexported fields
}

MulticastClient is an interface to calling the endpoints of the helloworld.example microservice. This advanced version is for multicast calls.

func NewMulticastClient

func NewMulticastClient(caller service.Publisher) *MulticastClient

NewMulticastClient creates a new multicast client to the helloworld.example microservice.

func (*MulticastClient) ForHost

func (_c *MulticastClient) ForHost(host string) *MulticastClient

ForHost replaces the default hostname of this client.

func (*MulticastClient) HelloWorld

func (_c *MulticastClient) HelloWorld(ctx context.Context, r *http.Request) <-chan *pub.Response

HelloWorld prints the classic greeting.

If a request is not provided, it defaults to the URL of the endpoint. Otherwise, it is resolved relative to the URL of the endpoint.

func (*MulticastClient) HelloWorld_Get

func (_c *MulticastClient) HelloWorld_Get(ctx context.Context, url string) <-chan *pub.Response

HelloWorld_Get performs a GET request to the HelloWorld endpoint.

HelloWorld prints the classic greeting.

If a URL is not provided, it defaults to the URL of the endpoint. Otherwise, it is resolved relative to the URL of the endpoint.

func (*MulticastClient) HelloWorld_Post

func (_c *MulticastClient) HelloWorld_Post(ctx context.Context, url string, contentType string, body any) <-chan *pub.Response

HelloWorld_Post performs a POST request to the HelloWorld endpoint.

HelloWorld prints the classic greeting.

If a URL is not provided, it defaults to the URL of the endpoint. Otherwise, it is resolved relative to the URL of the endpoint. If the body if of type io.Reader, []byte or string, it is serialized in binary form. If it is of type url.Values, it is serialized as form data. All other types are serialized as JSON. If a content type is not explicitly provided, an attempt will be made to derive it from the body.