micro-client-http/README.md
2021-01-10 14:47:03 +03:00

1.2 KiB

HTTP Client

This plugin is a http client for go-micro.

Overview

The http client wraps net/http to provide a robust go-micro client with service discovery, load balancing and streaming. It complies with the go-micro.Client interface.

Usage

Use directly

import "github.com/micro/go-plugins/client/http"

service := micro.NewService(
	micro.Name("my.service"),
	micro.Client(http.NewClient()),
)

Use with flags

import _ "github.com/micro/go-plugins/client/http"
go run main.go --client=http

Call Service

Assuming you have a http service "my.service" with path "/foo/bar"

// new client
client := http.NewClient()

// create request/response
request := client.NewRequest("my.service", "/foo/bar", protoRequest{})
response := new(protoResponse)

// call service
err := client.Call(context.TODO(), request, response)

Look at http_test.go for detailed use.

Encoding

Default protobuf with content-type application/proto

client.NewRequest("service", "/path", protoRequest{})

Json with content-type application/json

client.NewJsonRequest("service", "/path", jsonRequest{})