如何从Cypher查询反序列化关系并保留动态关系类型？

核心思路 #

无需继承Neo4jClient自带的Relationship/RelationshipInstance等固定类型类，自定义纯POCO/DTO，利用Neo4jClient的自动序列化特性获取关系类型与属性。

方案1：固定属性场景（已知关系属性） #

如果明确要处理的关系属性（如示例中的really和timespan），直接定义包含关系类型和对应可空属性的POCO：

public class MixedRelationship
{
    // 自动映射Neo4j关系类型（HAS/NEEDS）
    public string Type { get; set; }
    // HAS关系的属性，可空避免无值时报错
    public bool? Really { get; set; }
    // NEEDS关系的属性，可空避免无值时报错
    public int? Timespan { get; set; }
}

查询时直接使用该类：

client.Cypher
    .Match("(a:AlphaNode)-[r:HAS|NEEDS]->(b:BetaNode)")
    .ReturnDistinct((a, r, b) => new
    {
        A = a.As<AlphaNode>(),
        R = r.As<MixedRelationship>(),
        B = b.As<BetaNode>()
    });

返回结果中，R.Type会被自动填充为对应的关系类型，存在的属性会赋值，不存在的属性为null。

方案2：动态属性场景（未知/多变关系属性） #

如果关系属性不确定或多变，可利用JsonExtensionData特性捕获所有动态属性，同时保留关系类型：

using System.Text.Json.Serialization;

public class DynamicRelationship
{
    // 自动映射Neo4j关系类型
    public string Type { get; set; }

    // 捕获所有未显式定义的关系属性
    [JsonExtensionData]
    public IDictionary<string, object> ExtraProperties { get; set; } = new Dictionary<string, object>();
}

查询时同样直接使用：

client.Cypher
    .Match("(a:AlphaNode)-[r:HAS|NEEDS]->(b:BetaNode)")
    .ReturnDistinct((a, r, b) => new
    {
        A = a.As<AlphaNode>(),
        R = r.As<DynamicRelationship>(),
        B = b.As<BetaNode>()
    });

此时R.Type仍会正确获取关系类型，所有关系属性都会存入ExtraProperties字典中，无需提前定义属性字段。

关键说明 #

• Neo4jClient在反序列化关系时，会自动将关系的类型值赋值给POCO中名为Type的属性
• 可空属性或JsonExtensionData字典能避免因关系属性不匹配导致的反序列化错误
• 全程无需继承Neo4jClient的关系类，完全是自定义POCO，无奇怪的构造函数或继承约束

内容的提问来源于stack exchange，提问作者Chris Tophski