开放原子开发者工作坊

1. outerJoinVertices函数

首先给出源代码

override def outerJoinVertices[U: ClassTag, VD2: ClassTag]
      (other: RDD[(VertexId, U)])                   //带插入的顶点信息
      (updateF: (VertexId, VD, Option[U]) => VD2)   //更新函数
      (implicit eq: VD =:= VD2 = null): Graph[VD2, ED] = {
    // The implicit parameter eq will be populated by the compiler if VD and VD2 are equal, and left
    // null if not
　　　　// 其中，VD2表示最终生成的新图的VD类型；VD表示原图的VD类型

    if (eq != null) {         //如果新旧两个图的VD类型不一致
      vertices.cache()
      // updateF preserves type, so we can use incremental replication
      val newVerts = vertices.leftJoin(other)(updateF).cache()                   //对图的顶点做左连接
      val changedVerts = vertices.asInstanceOf[VertexRDD[VD2]].diff(newVerts)    //比较新生成的定点序列与原始定点序列直接修改格式后的序列之间的差异
      val newReplicatedVertexView = replicatedVertexView.asInstanceOf[ReplicatedVertexView[VD2, ED]]
        .updateVertices(changedVerts)                                            //根据changedVerts构造新的replicatedVertexView

 　　　new GraphImpl(newVerts, newReplicatedVertexView) 
 　　} else { 
        // updateF does not preserve type, so we must re-replicate all vertices 
        val newVerts = vertices.leftJoin(other)(updateF) 
 　　　　GraphImpl(newVerts, replicatedVertexView.edges) 
 　　　}
}

 其中， replicatedVertexView的官方解释是：“Manages shipping vertex attributes to the edge partitions of an EdgeRDD. Vertex attributes may be partially shipped to construct a triplet view with vertex attributes on only one side, and they may be updated. ”    个人理解是在边对象的上面增加了顶点属性。

 

针对官方的例子：

1 val graph = followerGraph.outerJoinVertices(users) {
2   case (uid, deg, Some(attrList)) => attrList
3   case (uid, deg, None) => Array.empty[String]
4 }

    首先介绍代码目的： followerGraph是通过调用GraphLoader.edgeListFile()函数，从边文件中读入的。由于边文件中只存储了相应的顶点编号，没有定点对应的属性。因此需要使用user(VertexId, attr)来将定点信息补全。

    其中，deg为followerGraph的顶点属性，case的第三个参数attrList表示user的顶点属性。箭头(=>)后的attrList表示修改后followerGraph的顶点属性。

    通过源代码可以看出，在执行outerJoinVertices时，首先执行的是顶点序列(VertexRDD)的LeftJoin，也就是将顶点编号一致的顶点的属性替换到followerGraph中。