Hazelcast

DeepSeek V3 中英对照 Hazelcast

如果 Hazelcast 在 classpath 上并且找到了合适的配置，Spring Boot 会自动配置一个 HazelcastInstance，你可以将其注入到你的应用程序中。

Spring Boot 首先会通过检查以下配置选项来创建客户端：

• 存在一个 ClientConfig bean。

• 由 spring.hazelcast.config 属性定义的配置文件。

• 存在 hazelcast.client.config 系统属性。

• 在工作目录或类路径根目录下的 hazelcast-client.xml 文件。

• 在工作目录或类路径根目录下的 hazelcast-client.yaml（或 hazelcast-client.yml）文件。

如果无法创建客户端，Spring Boot 会尝试配置一个嵌入式服务器。如果你定义了一个 Config bean，Spring Boot 将使用它。如果你的配置中定义了一个实例名称，Spring Boot 会尝试定位现有的实例，而不是创建一个新实例。

你也可以通过配置指定要使用的 Hazelcast 配置文件，如下例所示：

Properties

spring.hazelcast.config=classpath:config/my-hazelcast.xml

properties

YAML

spring:
  hazelcast:
    config: "classpath:config/my-hazelcast.xml"

yaml

否则，Spring Boot 会尝试从默认位置查找 Hazelcast 配置：工作目录或类路径根目录下的 hazelcast.xml，或者在相同位置的 YAML 文件。我们还会检查是否设置了 hazelcast.config 系统属性。有关更多详细信息，请参阅 Hazelcast 文档。

提示

默认情况下，Hazelcast 组件支持 @SpringAware。可以通过声明一个 HazelcastConfigCustomizer bean 并指定 @Order 值大于零来覆盖 ManagedContext。

备注

Spring Boot 还提供了对 Hazelcast 的显式缓存支持。如果启用了缓存，HazelcastInstance 会自动被包装在 CacheManager 实现中。