go-micro/examples/README.md

Examples

This directory contains example usage of Micro

Client contains examples usage of the Client package to call a service.

• main.go - calls each of the go.micro.srv.example handlers and includes the use of the streaming handler
• codegen - demonstrates how to use code generation to remove boilerplate code
• dc_filter - shows how to use Select filters inside a call wrapper for filtering to the local DC
• dc_selector - is the same as dc_filter but as a Selector implementation itself
• pub - publishes messages using the Publish method. By default encoding in protobuf
• selector - shows how to write and load your own Selector
• wrapper - provides examples for how to use client Wrappers (middleware)

PubSub contains an example of using the Broker for Publish and Subscribing.

• main.go - demonstrates simple runs pub-sub as two go routines running for 10 seconds.
• producer - publishes messages to the broker every second
• consumer - consumes any messages sent by the producer

Server contains example usage of the Server package to server requests.

• main.go - initialises and runs the the server
• handler - is an example RPC request handler for the Server
• proto - contains the protobuf defintion for the Server API
• subscriber - is a handler for subscribing via the Server
• wrapper - demonstrates use of a server HandlerWrapper
• codegen - shows how to use codegenerated registration to reduce boilerplate

Service contains example usage of the top level Service in go-micro.

• main.go - is the main definition of the service, handler and client
• proto - contains the protobuf definition of the API
• wrapper - demonstrates the use of Client and Server Wrappers