十六 Gremlin Core Notes

GremlinScriptEngineManager

JSR223,是java 的脚本引擎,gremlin 使用groovy 作为脚本语言来定义gremlin

整个 gremlin 的 script-engine-manager 结构是

  • GremlinScriptEngineManager

  • DefaultGremlinScriptEngineManager implements GremlinScriptEngineManager

  • CachedGremlinScriptEngineManager extends DefaultGremlinScriptEngineManager

  • SingleGremlinScriptEngineManager 引用 cachedManager 来实现单例模式;

在DefaultManager中,主要的工作就是
查找GremlinScriptEngineFactory 的实现,通过 Factory来创建 script-engine的实例;
主要使用的机制为java spi 机制; 后续我们可以看看, java 的 service provide interface(spi)的实现

GremlinGroovyScriptEngineFactory: 是对于ScriptEngineFactory的实现;

    @Override
    public GremlinScriptEngine getScriptEngine() {
        final List<Customizer> customizers =  manager.getCustomizers(ENGINE_NAME);
        return (customizers.isEmpty()) ? new GremlinGroovyScriptEngine() :
                new GremlinGroovyScriptEngine(customizers.toArray(new Customizer[customizers.size()]));
    }

核心就是 创建:GremlinGroovyScriptEngine,我们看看这个类的核心实现:

  • ScriptEngine 使用的是javax.script的核心接口
  • GremlinScriptEngine extends ScriptEngine,多出来两个接口,对应图中的travesal
    public default Traversal.Admin eval(final Bytecode bytecode, final String traversalSource) throws ScriptException {
        final Bindings bindings = this.createBindings();
        bindings.putAll(bytecode.getBindings());
        return eval(bytecode, bindings, traversalSource);
    }
    /**
     * Evaluates {@link Traversal} {@link Bytecode} with the specified {@code Bindings}. These {@code Bindings}
     * supplied to this method will be merged with global engine bindings and override them where keys match.
     */
    public Traversal.Admin eval(final Bytecode bytecode, final Bindings bindings, final String traversalSource) throws ScriptException;
  • GremlinGroovyScriptEngine extends GroovyScriptEngineImpl,groovyEngine,是java执行groovy的引擎;
        org.apache.tinkerpop.gremlin.process.traversal.Script script = org.apache.tinkerpop.gremlin.process.traversal.translator.GroovyTranslator.of(HIDDEN_G, typeTranslator).translate(bytecode);

核心就是 translate 成为 TRaversal.Admin, 来看看,是如何把一个gremlin语句翻译成 Traversal的;
核心就是 对gremlin AST 分析,然后每个element 与 GraphTraversal 对应,通过eval 生成 TravesalAdmin;

Traversal 的核心接口

设计的核心原理

  • Traversal<S, E> extends Iterator<E>, Serializable, Cloneable, AutoCloseable
  • public interface Admin<S, E> extends Traversal<S, E>
    Admin 接口是对 traveral 接口的 admin 封装,如果说traveral 代表的是 query,那么admin 就是 CRUD;

traveral 是对一个OLTP 查询的抽象,可以认为是一个 queryPlan;

  • DefaultTraversal<S, E> implements Traversal.Admin<S, E>
  • DefaultGraphTraversal<S, E> extends DefaultTraversal<S, E> implements GraphTraversal.Admin<S, E>

核心的实现是在GraphTraversal
我们写的 g.V().hasId().outE().inV(),等所有的构建traversal 的语句都在这里,可以是builder。

GraphTraversal 创建,使用的是 GraphTraversalSource;我们主要用到的是 g.V(),g.E(),返回一个traversal
当然我们看GraphTraversalSource的代码,还有很多with的方法,也就是在每个traversal的时候,我们可以按需求定义很多我们需要的东西;

另外一个重要的概念是 Traverser, 这个和执行时有关,代表的是tarversal 执行到的某个阶段,我们可以认为是执行到step的指针。
tarverser 有很多种类型,根据不同的step,会生成不同的tarverser

The objects propagating through the traversal are wrapped in a Traverser<T>.
 The traverser provides the means by which steps remain stateless.
  A traverser maintains all the metadata about the traversal — e.g.,
   how many times the traverser has gone through a loop, the path history of the traverser,
    the current object being traversed, etc. Traverser metadata may be accessed by a step.
     A classic example is the path()-step.
Gremlin 的编译

在gremlin-groovy 包里面,使用的是groovy 的eval 功能,也就是 java-jsr-223, scripe-engine
g.V().out() 这样的语法,eval 出来就是一个 graphTraversal,所以最后的核心依旧是Gremlin-core的内容;
到此为止,gremlin 的编译-> execution plan 就结束了;

Gremlin 的执行

g.V().out()的执行引擎,是一个 尾递归的引擎;从尾部递归到头,压栈,然后从头开始执行;
不明白为啥设计成这个样子;
整个引擎是一个单步的DFS,可以使用barrier 变成 BFS。
目前OLTP中,无法实现 并行的查询比如 kout;

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 226,979评论 6 528
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 97,750评论 3 412
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 174,647评论 0 373
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 62,299评论 1 307
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 71,104评论 6 405
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 54,623评论 1 320
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 42,716评论 3 434
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 41,873评论 0 285
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 48,380评论 1 330
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 40,344评论 3 354
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 42,496评论 1 365
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 38,055评论 5 355
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 43,756评论 3 343
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 34,146评论 0 25
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 35,410评论 1 281
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 51,072评论 3 386
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 47,485评论 2 370

推荐阅读更多精彩内容