Ice Rule Engine Upgrade Guide

⚠️ Important: When upgrading Ice rule engine, upgrade Server first, then Client

v1.3.0 → v1.5.0 Major Version Upgrade

Ice rule engine 1.5.0 is a major version update bringing a brand new visual interface and SpringBoot 3.x support.

Server Upgrade (Ice Server)

New Visual Tree Structure

• ✨ Added drag-and-drop rule orchestration interface
• 🎨 Optimized rule configuration page interaction
• 📊 Enhanced rule visualization display

Client Upgrade (Ice Client)

1. SDK Compatibility

• ✅ This upgrade is fully compatible with the old Client SDK, no upgrade required
• Upgrade recommended for better performance and new features

2. Dependency Name Changes

Ice rule engine client dependency names adjusted to support different SpringBoot versions:

<!-- Old version (no longer recommended) -->
<dependency>
  <groupId>com.waitmoon.ice</groupId>
  <artifactId>ice-client-spring-boot-starter</artifactId>
  <version>1.3.0</version>
</dependency>

<!-- New version - SpringBoot 2.x -->
<dependency>
  <groupId>com.waitmoon.ice</groupId>
  <artifactId>ice-spring-boot-starter-2x</artifactId>
  <version>1.5.0</version>
</dependency>

<!-- New version - SpringBoot 3.x -->
<dependency>
  <groupId>com.waitmoon.ice</groupId>
  <artifactId>ice-spring-boot-starter-3x</artifactId>
  <version>1.5.0</version>
</dependency>

v1.2.0→v1.3.0

• Various improvements and fixes

v1.1.0→v1.2.0

• Configuration

• • Server
• • • Configuration page tweaks
• • Client
• • • Add @IceNode, @IceField, @IceIgnore annotations to improve configuration interpretability

v1.0.4→v1.1.0

• Configuration

• • Server
• • • Added ice.ha configuration for server high availability, no configuration needed for standalone server
• • Client
• • • ice.server configuration supports server high availability, e.g. ice.server=zookeeper:localhost:2181. Standalone server configuration remains the same

v1.0.3→v1.0.4

• Code
• • IceNioClient.connect() changed to start(), only non-Spring projects need modification

v1.0.1→v1.0.2/v1.0.3

• Configuration

• • Client
• • • Added ice.scan configuration for scanning leaf nodes (default scans all, which slows application startup), multiple packages separated by ','

• Code

• • Ice.processCxt and Ice.processSingleCxt renamed to processCtx and processSingleCtx
• • IceErrorHandle.handleError() and BaseNode.errorHandle() added error parameter Throwable t

v1.0.1

Don't use 1.0.0!!! Due to network issues when packaging and pushing to central repository, the 1.0.0 jar package is incomplete!

• Configuration

• • Server
• • • ice.rmi.port removed rmi becomes ice.port, recommended to replace original port number when upgrading to avoid dirty data issues
• • Client
• • • Removed ice.rmi.mode, ice.rmi.port
• • • ice.rmi.server removed rmi becomes ice.server

• Code

• • Ice replaces IceClient, process() becomes asyncProcess()

• Features

• • Run without Spring, client = new IceNioClient(app, server).connect() connect() is a blocking method, can start new thread to run, new Thread(client::connect).start(), end with client.destroy()