dmadk/ais-filedump

DMA AisLib & ais-filedump工具

概述

DMA AisLib是一个用于处理AIS（自动识别系统）消息的Java库，提供AIS消息的读取、解码、过滤、发送等全流程功能。ais-filedump是基于该库的实用工具，专注于从TCP源将AIS消息归档为平面文件，适用于海事数据采集与存储场景。

核心功能

• 多源读取：支持从串口、TCP/UDP连接、本地文件读取AIS消息
• 消息处理：解码/编码AIS消息、处理专有源标记语句、过滤重复消息与降采样
• 消息发送：支持发送AIS #6、#8、#12、#14类型消息及应用特定消息
• 多源整合：通过Reader Group实现多源消息统一处理，支持轮询读取故障转移
• 表达式过滤：基于源属性、消息内容、目标特征的灵活过滤规则

使用场景

• 船舶AIS数据实时采集与本地归档
• 海事监控系统的AIS数据预处理与过滤
• 多源AIS数据整合与分析
• 船舶动态跟踪系统的消息处理

配置说明

环境要求

• Java 8及以上
• Maven 3及以上

构建与部署

1. 克隆代码库：git clone https://github.com/dma-ais/AisLib.git
2. 构建项目：mvn clean install
3. 运行测试：mvn test

工具使用示例

ais-filedump工具（TCP源归档）

bash
# 从TCP源localhost:4001归档AIS消息到ais_archive.txt
java -jar ais-filedump.jar --tcp-host localhost --tcp-port 4001 --output ais_archive.txt

基础AIS消息读取示例

java
// 从TCP源读取并打印消息ID
AisReader reader = AisReaders.createReader("localhost", 4001);
reader.registerHandler(aisMessage -> System.out.println("消息ID：" + aisMessage.getMsgId()));
reader.start();
reader.join();

消息过滤示例（降采样+重复过滤）

java
// 注册降采样与重复过滤链
Consumer<AisMessage> handler = msg -> System.out.println("过滤后消息：" + msg);
MessageHandlerFilter downsampleFilter = new MessageHandlerFilter(new DownSampleFilter(60));
downsampleFilter.registerReceiver(handler);
MessageHandlerFilter duplicateFilter = new MessageHandlerFilter(new DuplicateFilter());
duplicateFilter.registerReceiver(downsampleFilter);

// 绑定到TCP源
AisReader reader = AisReaders.createReader("ais163.sealan.dk:4712");
reader.registerHandler(duplicateFilter);
reader.start();
reader.join();