Package com.helix.core.cache.l4

Class BytecodeCodec

java.lang.Object

com.helix.core.cache.l4.BytecodeCodec

public final class BytecodeCodec
extends Object

Binary serialization codec for compiled JVM rule bytecode and associated metadata. Uses a compact binary framing format with the magic header 0x48454C58 ("HELX").

Field Summary

Fields

Modifier and Type	Field	Description
static final short	FORMAT_VERSION_1
static final int	MAGIC_HEADER

Method Summary

Modifier and Type	Method	Description
static String	calculateRuleHash(String ruleContent)	Calculates a deterministic SHA-256 hash for rule content using RuleKeyHasher.
static SerializedRuleData	decode(byte[] bytes)	Deserializes a binary payload into a SerializedRuleData instance.
static byte[]	encode(SerializedRuleData data)	Serializes a SerializedRuleData instance into a binary payload.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

MAGIC_HEADER

public static final int MAGIC_HEADER

See Also:

• Constant Field Values

FORMAT_VERSION_1

public static final short FORMAT_VERSION_1

See Also:

• Constant Field Values

Method Details

encode

public static byte[] encode(SerializedRuleData data)

Serializes a SerializedRuleData instance into a binary payload.

Parameters:

data - rule metadata and bytecode

Returns:

serialized binary array

decode

public static SerializedRuleData decode(byte[] bytes)

Deserializes a binary payload into a SerializedRuleData instance.

Parameters:

bytes - serialized binary array

Returns:

deserialized SerializedRuleData

Throws:

IllegalArgumentException - if payload has invalid magic header or is corrupted/truncated

calculateRuleHash

public static String calculateRuleHash(String ruleContent)

Calculates a deterministic SHA-256 hash for rule content using RuleKeyHasher.

Parameters:

ruleContent - raw rule definition or expression

Returns:

64-character lowercase hexadecimal hash