use crate::error::{PcgError, PcgResult};
use crate::export::CURRENT_SCHEMA_VERSION;
use crate::model::result::GenerationResult;
const BINARY_MAGIC: &[u8; 4] = b"YPCG";
const HEADER_SIZE: usize = 16;
const CRC32_SIZE: usize = 4;
const MIN_FILE_SIZE: usize = HEADER_SIZE + 1 + CRC32_SIZE;
pub fn export_binary(result: &GenerationResult) -> PcgResult<Vec<u8>> {
let body = serde_json::to_vec(result)
.map_err(|e| PcgError::export_err(format!("二进制序列化失败: {}", e), "binary", e))?;
let body_len = body.len();
if body_len > u32::MAX as usize {
return Err(PcgError::export_with_format(
format!("数据体过大,超过 4GB 限制: {} 字节", body_len),
"binary",
None,
));
}
let (major, minor) = parse_schema_version(CURRENT_SCHEMA_VERSION)?;
let total_size = HEADER_SIZE + body_len + CRC32_SIZE;
let mut buffer = Vec::with_capacity(total_size);
buffer.extend_from_slice(BINARY_MAGIC);
buffer.extend_from_slice(&major.to_le_bytes());
buffer.extend_from_slice(&minor.to_le_bytes());
buffer.extend_from_slice(&[0u8; 4]);
buffer.extend_from_slice(&(body_len as u32).to_le_bytes());
buffer.extend_from_slice(&body);
let crc = crc32fast::hash(&buffer);
buffer.extend_from_slice(&crc.to_le_bytes());
Ok(buffer)
}
pub fn import_binary(data: &[u8]) -> PcgResult<GenerationResult> {
if data.len() < MIN_FILE_SIZE {
return Err(PcgError::corrupted_data_with_type(
format!(
"数据长度不足: 期望至少 {} 字节,实际 {} 字节",
MIN_FILE_SIZE,
data.len()
),
"binary",
));
}
let magic = &data[0..4];
if magic != BINARY_MAGIC {
return Err(PcgError::corrupted_data_with_type(
format!(
"Magic 标识不匹配: 期望 {:?},实际 {:?}",
BINARY_MAGIC, magic
),
"binary",
));
}
let file_major = u16::from_le_bytes([data[4], data[5]]);
let _file_minor = u16::from_le_bytes([data[6], data[7]]);
let (current_major, _current_minor) = parse_schema_version(CURRENT_SCHEMA_VERSION)?;
if file_major != current_major {
return Err(PcgError::corrupted_data_with_version(
format!(
"Schema 主版本号不兼容: 文件版本 {},当前版本 {}",
file_major, current_major
),
"binary",
&format!("{}", current_major),
&format!("{}", file_major),
));
}
let body_len = u32::from_le_bytes([data[12], data[13], data[14], data[15]]) as usize;
let expected_total = HEADER_SIZE + body_len + CRC32_SIZE;
if data.len() != expected_total {
return Err(PcgError::corrupted_data_with_type(
format!(
"数据长度不匹配: 头部声明 body 长度 {},期望总长度 {},实际总长度 {}",
body_len,
expected_total,
data.len()
),
"binary",
));
}
let payload = &data[..data.len() - CRC32_SIZE];
let stored_crc = u32::from_le_bytes([
data[data.len() - 4],
data[data.len() - 3],
data[data.len() - 2],
data[data.len() - 1],
]);
let computed_crc = crc32fast::hash(payload);
if stored_crc != computed_crc {
return Err(PcgError::corrupted_data_with_type(
format!(
"CRC32 校验和不匹配: 存储值 0x{:08X},计算值 0x{:08X},数据可能已损坏",
stored_crc, computed_crc
),
"binary",
));
}
let body = &data[HEADER_SIZE..HEADER_SIZE + body_len];
let result: GenerationResult = serde_json::from_slice(body)
.map_err(|e| PcgError::export_err(format!("二进制反序列化失败: {}", e), "binary", e))?;
result.validate_terrain_data()?;
Ok(result)
}
fn parse_schema_version(version: &str) -> PcgResult<(u16, u16)> {
let parts: Vec<&str> = version.split('.').collect();
if parts.len() < 2 {
return Err(PcgError::export_with_format(
format!("无效的版本格式: '{}',期望 semver 格式", version),
"binary",
None,
));
}
let major = parts[0].parse::<u16>().map_err(|_| {
PcgError::export_with_format(format!("无法解析主版本号: '{}'", parts[0]), "binary", None)
})?;
let minor = parts[1].parse::<u16>().map_err(|_| {
PcgError::export_with_format(format!("无法解析次版本号: '{}'", parts[1]), "binary", None)
})?;
Ok((major, minor))
}
#[cfg(test)]
mod __tests__;