此版本仍在开发中，尚未被视为稳定版本。如需最新的稳定版本，请使用 Spring Data Neo4j 7.4.0！spring-doc.cn

转换

基于约定的映射

Neo4j 转换器在未提供其他映射元数据时具有一些用于映射对象的约定。 约定是：spring-doc.cn

  • 短 Java 类名按以下方式映射到主标签： 该类映射到主标签。com.bigbank.SavingsAccountsavingsAccountspring-doc.cn

  • 该转换器使用向其注册的任何 Spring Converter 来覆盖对象属性到节点字段和值的默认 Map。spring-doc.cn

  • 对象的字段用于与图形中的字段相互转换。 不使用公共属性。JavaBeanspring-doc.cn

  • 如果你有一个非零参数的构造函数，其构造函数参数名称与 node 的顶级属性名称匹配，则使用该构造函数。 否则，使用零参数构造函数。 如果有多个非零参数构造函数，则会引发异常。spring-doc.cn

我们支持各种开箱即用的转换。 在官方驱动程序手册中找到支持的密码类型列表：Type mapping。spring-doc.cn

同样支持包装器类型的基元类型。spring-doc.cn

域类型 密码类型 直接映射到本机类型

java.lang.Booleanspring-doc.cn

布尔spring-doc.cn

✔spring-doc.cn

boolean[]spring-doc.cn

布尔值列表spring-doc.cn

✔spring-doc.cn

java.lang.Longspring-doc.cn

整数spring-doc.cn

✔spring-doc.cn

long[]spring-doc.cn

整数列表spring-doc.cn

✔spring-doc.cn

java.lang.Doublespring-doc.cn

浮spring-doc.cn

✔spring-doc.cn

double[]spring-doc.cn

浮点数列表spring-doc.cn

✔spring-doc.cn

java.lang.Stringspring-doc.cn

字符串spring-doc.cn

✔spring-doc.cn

java.lang.String[]spring-doc.cn

字符串列表spring-doc.cn

✔spring-doc.cn

byte[]spring-doc.cn

字节数组spring-doc.cn

✔spring-doc.cn

java.lang.Bytespring-doc.cn

长度为 1 的 ByteArrayspring-doc.cn

java.lang.Characterspring-doc.cn

长度为 1 的字符串spring-doc.cn

char[]spring-doc.cn

长度为 1 的 String 列表spring-doc.cn

java.util.Datespring-doc.cn

格式为 ISO 8601 Date （） 的字符串。 请注意： SDN 会将所有实例存储在 . 如果需要时区，请使用支持它的类型（即 ）或将时区存储为单独的属性。yyyy-MM-dd’T’HH:mm:ss.SSSZZjava.util.DateUTCZoneDateTimespring-doc.cn

java.lang.Floatspring-doc.cn

字符串spring-doc.cn

float[]spring-doc.cn

字符串列表spring-doc.cn

java.lang.Integerspring-doc.cn

整数spring-doc.cn

int[]spring-doc.cn

整数列表spring-doc.cn

java.util.Localespring-doc.cn

格式为 BCP 47 语言标记的字符串spring-doc.cn

java.lang.Shortspring-doc.cn

整数spring-doc.cn

short[]spring-doc.cn

整数列表spring-doc.cn

java.math.BigDecimalspring-doc.cn

字符串spring-doc.cn

java.math.BigIntegerspring-doc.cn

字符串spring-doc.cn

java.time.LocalDatespring-doc.cn

日期spring-doc.cn

✔spring-doc.cn

java.time.OffsetTimespring-doc.cn

时间spring-doc.cn

✔spring-doc.cn

java.time.LocalTimespring-doc.cn

本地时间spring-doc.cn

✔spring-doc.cn

java.time.ZonedDateTimespring-doc.cn

日期时间spring-doc.cn

✔spring-doc.cn

java.time.LocalDateTimespring-doc.cn

本地日期时间spring-doc.cn

✔spring-doc.cn

java.time.OffsetDateTimespring-doc.cn

日期时间spring-doc.cn

java.time.Instantspring-doc.cn

日期时间spring-doc.cn

java.util.TimeZonespring-doc.cn

字符串spring-doc.cn

java.time.ZoneIdspring-doc.cn

字符串spring-doc.cn

java.time.Periodspring-doc.cn

期间spring-doc.cn

java.time.Durationspring-doc.cn

期间spring-doc.cn

org.neo4j.driver.types.IsoDurationspring-doc.cn

期间spring-doc.cn

✔spring-doc.cn

org.neo4j.driver.types.Pointspring-doc.cn

点spring-doc.cn

✔spring-doc.cn

org.springframework.data.neo4j.types.GeographicPoint2dspring-doc.cn

CRS 4326 的点spring-doc.cn

org.springframework.data.neo4j.types.GeographicPoint3dspring-doc.cn

CRS 4979 的要点spring-doc.cn

org.springframework.data.neo4j.types.CartesianPoint2dspring-doc.cn

带有 CRS 7203 的尖头spring-doc.cn

org.springframework.data.neo4j.types.CartesianPoint3dspring-doc.cn

带有 CRS 9157 的尖spring-doc.cn

org.springframework.data.geo.Pointspring-doc.cn

CRS 为 4326 且 x/y 对应于纬度/经度的点spring-doc.cn

的实例Enumspring-doc.cn

String （枚举的 name 值）spring-doc.cn

的实例Enum[]spring-doc.cn

String 列表（枚举的 name 值）spring-doc.cn

java.net.URLspring-doc.cn

字符串spring-doc.cn

java.net.URIspring-doc.cn

字符串spring-doc.cn

java.util.UUIDspring-doc.cn

字符串spring-doc.cn

自定义转化

对于给定类型的属性

如果您希望在实体中使用自己的类型或将其用作带注释方法的参数，则可以定义并提供自定义转换器实现。 首先，您必须实现 a 并注册您的转换器应该处理的类型。 对于实体属性类型转换器，您需要注意将类型与 Neo4j Java Driver 相互转换。 如果您的转换器应该只使用存储库中的自定义查询方法，则提供到类型的单向转换就足够了。@QueryGenericConverterValueValuespring-doc.cn

自定义转换器实现示例
public class MyCustomTypeConverter implements GenericConverter {

	@Override
	public Set<ConvertiblePair> getConvertibleTypes() {
		Set<ConvertiblePair> convertiblePairs = new HashSet<>();
		convertiblePairs.add(new ConvertiblePair(MyCustomType.class, Value.class));
		convertiblePairs.add(new ConvertiblePair(Value.class, MyCustomType.class));
		return convertiblePairs;
	}

	@Override
	public Object convert(Object source, TypeDescriptor sourceType, TypeDescriptor targetType) {
		if (MyCustomType.class.isAssignableFrom(sourceType.getType())) {
			// convert to Neo4j Driver Value
			return convertToNeo4jValue(source);
		} else {
			// convert to MyCustomType
			return convertToMyCustomType(source);
		}
	}

}

要使 SDN 知道您的转换器，必须在 . 为此，您必须创建类型为 . 否则，将仅使用内部默认转换器在后台创建。Neo4jConversions@Beanorg.springframework.data.neo4j.core.convert.Neo4jConversionsNeo4jConversionsspring-doc.cn

自定义转换器实现示例
@Bean
public Neo4jConversions neo4jConversions() {
	Set<GenericConverter> additionalConverters = Collections.singleton(new MyCustomTypeConverter());
	return new Neo4jConversions(additionalConverters);
}

如果您的应用程序中需要多个转换器，您可以在构造函数中添加任意数量的转换器。Neo4jConversionsspring-doc.cn

仅适用于特定属性

如果您只需要某些特定属性的转化，我们提供 . 这是一个可以放在实体 （） 和关系属性 （） 的属性上的注释 它通过属性 以及 optional 来构造前者。 通过实现给定类型的所有特定转换，可以解决。 此外，还提供了在应用程序上下文中引用任何 Spring bean 实现 .引用的 bean 将优先于构建新的转换器。@ConvertWith@Node@RelationshipPropertiesNeo4jPersistentPropertyConverterconverterNeo4jPersistentPropertyConverterFactoryNeo4jPersistentPropertyConverter@ConvertWithconverterRefNeo4jPersistentPropertyConverterspring-doc.cn

我们提供 and 作为元注释的注释，以便向后兼容不使用本机类型的 Neo4j-OGM 方案。 这些是建立在上述概念之上的元注释。@DateLong@DateStringspring-doc.cn

复合特性

使用 、 类型的属性 或 可以存储为复合属性。 映射中的所有条目都将作为属性添加到包含该属性的节点或关系中。 使用配置的前缀或以属性名称为前缀。 虽然我们只为地图提供开箱即用的功能，但您可以对其进行配置 作为要在 上使用的转换器。A 需要知道给定类型如何 分解为 map 并从 map 组合回来。@CompositePropertyMap<String, Object>Map<? extends Enum, Object>Neo4jPersistentPropertyToMapConverter@CompositePropertyNeo4jPersistentPropertyToMapConverterspring-doc.cn