forked from grpc/grpc-java
/
XdsNameResolverProvider.java
103 lines (89 loc) · 3.22 KB
/
XdsNameResolverProvider.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
/*
* Copyright 2019 The gRPC Authors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package io.grpc.xds;
import static com.google.common.base.Preconditions.checkNotNull;
import com.google.common.base.Preconditions;
import io.grpc.Internal;
import io.grpc.NameResolver.Args;
import io.grpc.NameResolverProvider;
import io.grpc.internal.ObjectPool;
import java.net.URI;
import java.util.Map;
import java.util.concurrent.atomic.AtomicLong;
import javax.annotation.Nullable;
/**
* A provider for {@link XdsNameResolver}.
*
* <p>It resolves a target URI whose scheme is {@code "xds"}. The authority of the
* target URI is never used for current release. The path of the target URI, excluding the leading
* slash {@code '/'}, will indicate the name to use in the VHDS query.
*
* <p>This class should not be directly referenced in code. The resolver should be accessed
* through {@link io.grpc.NameResolverRegistry} with the URI scheme "xds".
*/
@Internal
public final class XdsNameResolverProvider extends NameResolverProvider {
private static final String SCHEME = "xds";
/**
* Allows injecting bootstrapOverride to the name resolver.
* */
public XdsNameResolver newNameResolver(URI targetUri, Args args,
@Nullable Map<String, ?> bootstrapOverride) {
if (SCHEME.equals(targetUri.getScheme())) {
String targetPath = checkNotNull(targetUri.getPath(), "targetPath");
Preconditions.checkArgument(
targetPath.startsWith("/"),
"the path component (%s) of the target (%s) must start with '/'",
targetPath,
targetUri);
String name = targetPath.substring(1);
return new XdsNameResolver(name, args.getServiceConfigParser(),
args.getSynchronizationContext(), args.getScheduledExecutorService(),
bootstrapOverride);
}
return null;
}
@Override
public XdsNameResolver newNameResolver(URI targetUri, Args args) {
return newNameResolver(targetUri, args, null);
}
@Override
public String getDefaultScheme() {
return SCHEME;
}
@Override
protected boolean isAvailable() {
return true;
}
@Override
protected int priority() {
// Set priority value to be < 5 as we still want DNS resolver to be the primary default
// resolver.
return 4;
}
interface XdsClientPoolFactory {
void setBootstrapOverride(Map<String, ?> bootstrap);
@Nullable
ObjectPool<XdsClient> get();
ObjectPool<XdsClient> getOrCreate() throws XdsInitializationException;
}
/**
* Provides the counter for aggregating outstanding requests per cluster:eds_service_name.
*/
interface CallCounterProvider {
AtomicLong getOrCreate(String cluster, @Nullable String edsServiceName);
}
}