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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
/*
* Copyright 2017, OpenCensus 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.opencensus.tags;
import io.opencensus.common.Scope;
import io.opencensus.internal.NoopScope;
import io.opencensus.internal.Utils;
import io.opencensus.tags.propagation.TagContextBinarySerializer;
import io.opencensus.tags.propagation.TagPropagationComponent;
import java.util.Collections;
import java.util.Iterator;
import javax.annotation.concurrent.Immutable;
import javax.annotation.concurrent.ThreadSafe;
/** No-op implementations of tagging classes. */
final class NoopTags {
private NoopTags() {}
/**
* Returns a {@code TagsComponent} that has a no-op implementation for {@link Tagger}.
*
* @return a {@code TagsComponent} that has a no-op implementation for {@code Tagger}.
*/
static TagsComponent newNoopTagsComponent() {
return new NoopTagsComponent();
}
/**
* Returns a {@code Tagger} that only produces {@link TagContext}s with no tags.
*
* @return a {@code Tagger} that only produces {@code TagContext}s with no tags.
*/
static Tagger getNoopTagger() {
return NoopTagger.INSTANCE;
}
/**
* Returns a {@code TagContextBuilder} that ignores all calls to {@link TagContextBuilder#put}.
*
* @return a {@code TagContextBuilder} that ignores all calls to {@link TagContextBuilder#put}.
*/
static TagContextBuilder getNoopTagContextBuilder() {
return NoopTagContextBuilder.INSTANCE;
}
/**
* Returns a {@code TagContext} that does not contain any tags.
*
* @return a {@code TagContext} that does not contain any tags.
*/
static TagContext getNoopTagContext() {
return NoopTagContext.INSTANCE;
}
/** Returns a {@code TagPropagationComponent} that contains no-op serializers. */
static TagPropagationComponent getNoopTagPropagationComponent() {
return NoopTagPropagationComponent.INSTANCE;
}
/**
* Returns a {@code TagContextBinarySerializer} that serializes all {@code TagContext}s to zero
* bytes and deserializes all inputs to empty {@code TagContext}s.
*/
static TagContextBinarySerializer getNoopTagContextBinarySerializer() {
return NoopTagContextBinarySerializer.INSTANCE;
}
@ThreadSafe
private static final class NoopTagsComponent extends TagsComponent {
private volatile boolean isRead;
@Override
public Tagger getTagger() {
return getNoopTagger();
}
@Override
public TagPropagationComponent getTagPropagationComponent() {
return getNoopTagPropagationComponent();
}
@Override
public TaggingState getState() {
isRead = true;
return TaggingState.DISABLED;
}
@Override
@Deprecated
public void setState(TaggingState state) {
Utils.checkNotNull(state, "state");
Utils.checkState(!isRead, "State was already read, cannot set state.");
}
}
@Immutable
private static final class NoopTagger extends Tagger {
static final Tagger INSTANCE = new NoopTagger();
@Override
public TagContext empty() {
return getNoopTagContext();
}
@Override
public TagContext getCurrentTagContext() {
return getNoopTagContext();
}
@Override
public TagContextBuilder emptyBuilder() {
return getNoopTagContextBuilder();
}
@Override
public TagContextBuilder toBuilder(TagContext tags) {
Utils.checkNotNull(tags, "tags");
return getNoopTagContextBuilder();
}
@Override
public TagContextBuilder currentBuilder() {
return getNoopTagContextBuilder();
}
@Override
public Scope withTagContext(TagContext tags) {
Utils.checkNotNull(tags, "tags");
return NoopScope.getInstance();
}
}
@Immutable
private static final class NoopTagContextBuilder extends TagContextBuilder {
static final TagContextBuilder INSTANCE = new NoopTagContextBuilder();
@Override
public TagContextBuilder put(TagKey key, TagValue value) {
Utils.checkNotNull(key, "key");
Utils.checkNotNull(value, "value");
return this;
}
@Override
public TagContextBuilder remove(TagKey key) {
Utils.checkNotNull(key, "key");
return this;
}
@Override
public TagContext build() {
return getNoopTagContext();
}
@Override
public Scope buildScoped() {
return NoopScope.getInstance();
}
}
@Immutable
private static final class NoopTagContext extends TagContext {
static final TagContext INSTANCE = new NoopTagContext();
// TODO(sebright): Is there any way to let the user know that their tags were ignored?
@Override
protected Iterator<Tag> getIterator() {
return Collections.<Tag>emptySet().iterator();
}
}
@Immutable
private static final class NoopTagPropagationComponent extends TagPropagationComponent {
static final TagPropagationComponent INSTANCE = new NoopTagPropagationComponent();
@Override
public TagContextBinarySerializer getBinarySerializer() {
return getNoopTagContextBinarySerializer();
}
}
@Immutable
private static final class NoopTagContextBinarySerializer extends TagContextBinarySerializer {
static final TagContextBinarySerializer INSTANCE = new NoopTagContextBinarySerializer();
static final byte[] EMPTY_BYTE_ARRAY = {};
@Override
public byte[] toByteArray(TagContext tags) {
Utils.checkNotNull(tags, "tags");
return EMPTY_BYTE_ARRAY;
}
@Override
public TagContext fromByteArray(byte[] bytes) {
Utils.checkNotNull(bytes, "bytes");
return getNoopTagContext();
}
}
}
|