alluxio rpc 分析

RPC 通信

一个类扩展了 AbstractThriftClient 类将成为RPC客户端。使用方法 retryRPC 发起一个 PRC 调用， 然后实现接口Service.Iface的抽象方法的ServiceHandler将会收到调用。

用来统一捕获RPC调用过程中的异常, 比较好的方法是使用静态方法 RpcUtils.call()， 提供一个实例实现RpcCallable 接口的call方法来处理回调。

RPC 调用

RPC 客户端通过 clientService发起一个RPC调用到实现RPC服务端接口的serviceHandler。 Alluxio中有三个角色，调用方向可以是 Client->Master、Worker->Master、 Client->Worker。

实现接口ClientService.Iface的ServiceHandler会被RPC客户端调用, 通常地，ServiceHandler有一个成员用来在master或worker上执行具体的操作。

下表展示Alluxio中的六类RPC调用。

RPC Client	ClientService(thrift)	ServiceHandler	Master/Worker	调用方向
FileSystemMasterClient	FileSystemMasterClientService	FileSystemMasterClientServiceHandler	FileSystemMaster	Client->Master
FileSystemMasterClient’	FileSystemMasterWorkerService	FileSystemMasterWorkerServiceHandler	FileSystemMaster	Worker->Master
RetryHandlingBlockMasterClient	BlockMasterClientService	BlockMasterClientServiceHandler	BlockMaster	Client->Master
BlockMasterClient	BlockMasterWorkerService	BlockMasterWorkerServiceHandler	BlockMaster	Worker->Master
FileSystemWorkerClient	FileSystemWorkerClientService	FileSystemWorkerClientServiceHandler	FileSystemWorker	Client->Worker
RetryHandlingBlockWorkerClient	BlockWorkerClientService	BlockWorkerClientServiceHandler	BlockWorker	Client->Worker

RPC 方法

master

• FileSystemMasterClientServiceHandler

  • checkConsistency
  • completeFile
  • createDirectory
  • createFile
  • free
  • getFileBlockInfoList
  • getNewBlockIdForFile
  • getStatus
  • getStatusInternal
  • getUfsAddress
  • listStatus
  • loadMetadata
  • mount
  • remove
  • rename
  • scheduleAsyncPersist
  • setAttribute
  • unmount

• FileSystemMasterWorkerServiceHandler

  • getFileInfo
  • getPinIdList
  • heartbeat

• BlockMasterClientServiceHandler

  • getWorkerInfoList
  • getCapacityBytes
  • getUsedBytes
  • getBlockInfo

• BlockMasterWorkerServiceHandler

  • getWorkerId
  • registerWorker
  • heartbeat
  • commitBlock

worker

• BlockWorkerClientServiceHandler

  • accessBlock
  • cacheBlock
  • cancelBlock
  • lockBlock
  • promoteBlock
  • removeBlock
  • requestBlockLocation
  • requestSpace
  • unlockBlock
  • sessionHeartbeat

• FileSystemWorkerClientServiceHandler

  • cancelUfsFile
  • closeUfsFile
  • completeUfsFile
  • createUfsFile
  • openUfsFile
  • sessionHeartbeat