browserapi

Documentation

Overview

Package browserapi implements the public API of the browser.example microservice, including clients and data structures.

The browser microservice implements a simple web browser that utilizes the egress proxy.

Index

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

Constants

const Hostname = "browser.example"

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

Variables

var (
	URLOfBrowse = httpx.JoinHostAndPath(Hostname, `:443/browse`)
)

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 browser.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 browser.example microservice.

func (*Client) Browse

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

Browser shows a simple address bar and the source code of a URL.

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

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

Browse_Get performs a GET request to the Browse endpoint.

Browser shows a simple address bar and the source code of a URL.

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

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

Browse_Post performs a POST request to the Browse endpoint.

Browser shows a simple address bar and the source code of a URL.

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.

func (*Client) ForHost

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

ForHost replaces the default hostname of this client.

func (*Client) WithOptions

func (_c *Client) WithOptions(opts ...pub.Option) *Client

WithOptions applies options to requests made by this client.

type MulticastClient

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

MulticastClient is an interface to calling the endpoints of the browser.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 browser.example microservice.

func (*MulticastClient) Browse

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

Browser shows a simple address bar and the source code of a URL.

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

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

Browse_Get performs a GET request to the Browse endpoint.

Browser shows a simple address bar and the source code of a URL.

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

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

Browse_Post performs a POST request to the Browse endpoint.

Browser shows a simple address bar and the source code of a URL.

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.

func (*MulticastClient) ForHost

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

ForHost replaces the default hostname of this client.

func (*MulticastClient) WithOptions

func (_c *MulticastClient) WithOptions(opts ...pub.Option) *MulticastClient

WithOptions applies options to requests made by this client.