openapiportalapi

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 9, 2024 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Overview

Package openapiportalapi implements the public API of the openapiportal.core microservice, including clients and data structures.

The OpenAPI microservice lists links to the OpenAPI endpoint of all microservices that provide one on the requested port.

Index

Constants

View Source
const Hostname = "openapiportal.core"

Hostname is the default hostname of the microservice: openapiportal.core.

Variables

View Source
var (
	URLOfList = httpx.JoinHostAndPath(Hostname, `//openapi:0`)
)

Fully-qualified URLs of the microservice's endpoints.

Functions

This section is empty.

Types

type Client

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

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

func NewClient

func NewClient(caller service.Publisher) *Client

NewClient creates a new unicast client to the openapiportal.core microservice.

func (*Client) ForHost

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

ForHost replaces the default hostname of this client.

func (*Client) List

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

List displays links to the OpenAPI endpoint of all microservices that provide one on the request's port.

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) List_Get

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

List_Get performs a GET request to the List endpoint.

List displays links to the OpenAPI endpoint of all microservices that provide one on the request's port.

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) List_Post

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

List_Post performs a POST request to the List endpoint.

List displays links to the OpenAPI endpoint of all microservices that provide one on the request's port.

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 openapiportal.core microservice. This advanced version is for multicast calls.

func NewMulticastClient

func NewMulticastClient(caller service.Publisher) *MulticastClient

NewMulticastClient creates a new multicast client to the openapiportal.core microservice.

func (*MulticastClient) ForHost

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

ForHost replaces the default hostname of this client.

func (*MulticastClient) List

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

List displays links to the OpenAPI endpoint of all microservices that provide one on the request's port.

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) List_Get

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

List_Get performs a GET request to the List endpoint.

List displays links to the OpenAPI endpoint of all microservices that provide one on the request's port.

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) List_Post

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

List_Post performs a POST request to the List endpoint.

List displays links to the OpenAPI endpoint of all microservices that provide one on the request's port.

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.

Jump to

Keyboard shortcuts

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