1. 概述
本文主要分享 Agent DictionaryManager 字典管理。先来简单了解下字典的定义和用途：
-
字典实际上是一个 Map 映射。目前 Agent 上有两种字典：应用编码与应用编号的映射，操作名与操作编号的映射。
-
应用的定义：例如，Tomcat 启动的应用，或者程序里访问的 MongoDB 、MySQL 都可以认为是应用。
-
操作的定义：例如，访问的 URL 地址，Mongo 的执行操作。
-
Agent 在每次上传调用链路 Segment 给 Collector 时，Segment 里面需要包含应用和操作相关信息。考虑到减少网络流量，应用编号少于应用编号，操作编号少于操作名。
Agent 字典，会定时从 Collector 【同步】需要( 需要的定义，下文代码会看到 )的字典。
下面，我们分成两个小节，分别从 API 的实现与调用，分享代码的具体实现。
2. Collector 同步相关 API
Collector 同步相关 API 相关有四个接口：
- 2.1 应用的同步 API
- 2.2 操作的同步 API
API处理的流程大体如下：
2.1 应用的同步 API
应用的同步 API ，实际使用的是应用的注册 API，在 「2.1 应用的注册 API」 有详细解析。
2.2 操作的同步 API
我们先来看看 API 的定义，DiscoveryService ，如下图所示：
整体代码和 「2.1 应用的同步 API」 非常相似，所以本小节，更多的是提供代码的链接地址。
2.2.1 ServiceNameDiscoveryServiceHandler#discovery(…)
ServiceNameDiscoveryServiceHandler#discovery(ServiceNameCollection, StreamObserver<ServiceNameMappingCollection>)，根据操作名数组，查找操作编号数组。
2.2.2 IServiceNameService#getOrCreate(…)
org.skywalking.apm.collector.agent.stream.service.register.IServiceNameService ，继承 Service 接口，操作名服务接口。
- 定义了 #getOrCreate(applicationId, serviceName) 接口方法，根据应用编号 + 操作名字，获取或创建操作名( ServiceName )，并获得操作编号。
org.skywalking.apm.collector.agent.stream.worker.register.ServiceNameService ，实现 IServiceNameService 接口，操作名服务实现类。
2.2.3 Graph#start(ServiceName)
在 #createServiceNameRegisterGraph() 方法中，我们可以看到 ServiceName 对应的 Graph<ServiceName> 对象的创建。
-
org.skywalking.apm.collector.agent.stream.worker.register.ServiceNameRegisterRemoteWorker ，继承 AbstractRemoteWorker 抽象类，操作名注册远程 Worker 。
-
org.skywalking.apm.collector.agent.stream.worker.register.ServiceNameRegisterSerialWorker ，继承 AbstractLocalAsyncWorker 抽象类，异步保存应用 Worker 。
-
相同于 Application ，ServiceName 的操作编号，从
"1"双向递增。
2.2.4 ServiceName
org.skywalking.apm.collector.storage.table.register.ServiceName ，操作名。例如记录在 ES 如下图：
3. Agent 调用同步 API
在《SkyWalking 源码分析 —— 应用于应用实例的注册》「3. Agent 调用注册 API」 一文中，在 【第 170 至 173 行】的代码，我们可以看到，AppAndServiceRegisterClient 会定时从 Collector 同步所有字典信息。
3.1 DictionaryManager
org.skywalking.apm.agent.core.dictionary.DictionaryManager ，字典管理器。目前管理有两种字典：
- ApplicationDictionary
- OperationNameDictionary
3.1 ApplicationDictionary
org.skywalking.apm.agent.core.dictionary.ApplicationDictionary ，应用字典。
- INSTANCE 枚举属性，单例。
- applicationDictionary 属性，应用编码与应用编号的映射。
- unRegisterApplications 属性，未知应用编码集合。Agent 会定时从 Collector 同步。这也是文章开头说的，“需要”的定义。
#find(applicationCode) 方法，根据应用编码，查询应用编号。
- 第 57 行：根据应用编码，从 applicationDictionary 中，查询应用编号。
- 第 58 至 59 行：当应用编号查找到时，返回 Found 。Found 会在下文详细解析。
- 第 61 至 64 行：当应用编号查找不到时，添加到 unRegisterApplications 中，返回 NotFound 。NotFound 会在下文详细解析。
#syncRemoteDictionary(ApplicationRegisterServiceGrpc.ApplicationRegisterServiceBlockingStub) 方法，调用 「2.1 应用的同步 API」 ，从 Collector 同步 unRegisterApplications 对应的应用编号集合。
3.2 OperationNameDictionary
org.skywalking.apm.agent.core.dictionary.OperationNameDictionary ，操作名字典。
和ApplicationDictionary 基本类似，胖友点击 代码 ，自己阅读理解。
3.2 PossibleFound
在分享PossibleFound 之前，我们先来看一段代码，了解该类的意图：
- 我们在使用 XXXXDictionary#find(xxx) 方法时，返回的会是 Found 或者 NotFound 。这两个类本身是互斥的，并且继承 PossibleFound 。在 PossibleFound 提供 #doInCondition(method01, method02) 方法，优雅的处理两种情况。
org.skywalking.apm.agent.core.dictionary.PossibleFound ，抽象类，代码如下：
-
found 属性，是否找到。
-
value 属性，找到的结果。
-
org.skywalking.apm.agent.core.dictionary.Found 实现 PossibleFound 类，found = true 并且 value 为找到的值。
-
org.skywalking.apm.agent.core.dictionary.NotFound 实现 PossibleFound 类，found = false 并且 value 不赋值。
-
#doInCondition(Found, NotFound) 方法，根据查找结果，执行不同的逻辑，【无返回】。
-
第一个参数，
PossibleFound.Found接口，Found 时的处理逻辑接口。 -
第二个参数，
PossibleFound.NotFound接口，NotFound 时的处理逻辑接口。 -
#doInCondition(FoundAndObtain, NotFoundAndObtain) 方法，根据查找结果，执行不同的逻辑，【有返回】。
-
第一个参数，
PossibleFound.FoundAndObtain接口，Found 时的处理逻辑接口。 -
第二个参数，
PossibleFound.NotFoundAndObtain接口，NotFound 时的处理逻辑接口。