如何在不标注领域模型类的情况下实现Neo4j节点与Java POJO的映射

完全可以做到，不需要在领域模型里加任何Neo4j专属注解（比如@Node、@Id），下面给你两种实用的实现方式，分别基于Spring Data Neo4j和Neo4j OGM：

方法一：用Spring Data Neo4j的映射元数据配置 #

这种方式贴合Spring生态，适合Spring Boot项目：

• 定义纯POJO领域模型：写一个完全干净的类，没有任何数据库相关注解

public class User {
    private Long id;
    private String name;
    private Integer age;
    
    // 常规的getter、setter、构造方法
}

• 编写映射配置类：通过实现Neo4jMappingContextCustomizer，手动指定实体和Neo4j节点的映射规则

import org.springframework.data.neo4j.core.mapping.Neo4jMappingContext;
import org.springframework.data.neo4j.core.mapping.Neo4jPersistentEntity;
import org.springframework.data.neo4j.core.mapping.Neo4jPersistentProperty;
import org.springframework.stereotype.Component;

@Component
public class CustomNeo4jMappingConfig implements Neo4jMappingContextCustomizer {

    @Override
    public void customize(Neo4jMappingContext mappingContext) {
        // 配置User类的映射规则
        var userEntity = (Neo4jPersistentEntity<User>) mappingContext.getRequiredNodeDescription(User.class);
        
        // 设置节点标签
        userEntity.setPrimaryLabel("User");
        
        // 指定id字段作为Neo4j的节点ID
        var idProperty = userEntity.getRequiredPersistentProperty("id");
        idProperty.setIdProperty(true);
        
        // 如果需要自定义属性映射（比如属性名和节点属性名不一致），可以这么做
        // var nameProperty = userEntity.getRequiredPersistentProperty("name");
        // nameProperty.setFieldName("username"); // 把类的name属性映射到节点的username属性
    }
}

• 编写Repository接口：和普通Spring Data Neo4j的Repository用法完全一致

import org.springframework.data.neo4j.repository.Neo4jRepository;

public interface UserRepository extends Neo4jRepository<User, Long> {
}

方法二：用Neo4j OGM的XML映射配置 #

这是Neo4j OGM原生的映射方式，灵活性更高：

• 定义纯POJO领域模型：和上面的User类一样，无任何注解
• 创建OGM映射XML文件：在src/main/resources下新建neo4j-ogm-mappings.xml，配置实体与节点的对应关系

<?xml version="1.0" encoding="UTF-8"?>
<mappings xmlns="http://neo4j.org/schema/ogm"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://neo4j.org/schema/ogm http://neo4j.org/schema/ogm/neo4j-ogm.xsd">

    <mapping class="com.example.domain.User">
        <node label="User"/> <!-- 指定节点标签 -->
        <id name="id" type="Long"/> <!-- 指定ID字段 -->
        <property name="name" type="String"/> <!-- 配置属性映射 -->
        <property name="age" type="Integer"/>
    </mapping>

</mappings>

• 配置OGM会话工厂：在Spring配置类里初始化SessionFactory，指定数据库连接和映射文件

import org.neo4j.ogm.config.Configuration;
import org.neo4j.ogm.session.SessionFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class Neo4jOgmConfig {

    @Bean
    public SessionFactory sessionFactory() {
        var config = new Configuration.Builder()
                .uri("bolt://localhost:7687")
                .credentials("neo4j", "your-password")
                .build();
        // 指定领域模型所在包和映射文件位置
        return new SessionFactory(config, "com.example.domain", "neo4j-ogm-mappings.xml");
    }
}

• 用Session操作数据：通过SessionFactory获取Session，执行CRUD操作

import org.neo4j.ogm.session.Session;
import org.neo4j.ogm.session.SessionFactory;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    private final Session session;

    public UserService(SessionFactory sessionFactory) {
        this.session = sessionFactory.openSession();
    }

    public void saveUser(User user) {
        session.save(user);
    }

    public User getUserById(Long id) {
        return session.load(User.class, id);
    }
}

总的来说，两种方法都能让你的领域模型完全脱离数据库注解，保持领域层的纯净。如果是Spring Boot项目，优先选第一种方法，和Spring生态整合更顺畅；第二种方法适合需要更精细控制映射规则的场景。

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