1/*
2 *
3 * Copyright 2020 gRPC authors.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 *
9 *     http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 *
17 */
18
19// Package rls implements the RLS LB policy.
20package rls
21
22import (
23	"google.golang.org/grpc/balancer"
24	"google.golang.org/grpc/internal/grpcsync"
25)
26
27const rlsBalancerName = "rls"
28
29func init() {
30	balancer.Register(&rlsBB{})
31}
32
33// rlsBB helps build RLS load balancers and parse the service config to be
34// passed to the RLS load balancer.
35type rlsBB struct{}
36
37// Name returns the name of the RLS LB policy and helps implement the
38// balancer.Balancer interface.
39func (*rlsBB) Name() string {
40	return rlsBalancerName
41}
42
43func (*rlsBB) Build(cc balancer.ClientConn, opts balancer.BuildOptions) balancer.Balancer {
44	lb := &rlsBalancer{
45		done:       grpcsync.NewEvent(),
46		cc:         cc,
47		opts:       opts,
48		lbCfg:      &lbConfig{},
49		ccUpdateCh: make(chan *balancer.ClientConnState),
50	}
51	go lb.run()
52	return lb
53}
54