AisLib Java库使用指南

1. 项目介绍

AisLib是一个专为处理自动识别系统（Automatic Identification System, AIS）消息而设计的Java库。它支持从各种来源读取AIS数据，包括串口连接、TCP连接及文件，并提供了对原始数据句柄的处理能力，例如专有源标签句子处理、消息过滤、解码与编码AIS消息等。此外，该库还包括了应用于消息处理的测试代码和实用工具示例。AisLib要求Java 8及以上版本和Maven 3作为构建工具。

2. 项目快速启动

安装依赖

首先，确保您的开发环境已经配置好了Java 8和Maven。然后，可以通过以下命令将AisLib添加到您的项目中：

<!-- 在您的Maven项目的pom.xml文件中加入依赖 -->
<dependency>
    <groupId>com.dma-ais</groupId>
    <artifactId>AisLib</artifactId>
    <version>(查看最新版本号)</version>
</dependency>

快速编码实例

简单读取并处理AIS消息

示例代码展示如何从字符串解析单个AIS消息和多个消息的合并句子。

import com.dma-ais.AisLib.Vdm;
import com.dma-ais.AisLib.AisMessage;

public class QuickStart {
    public static void main(String[] args) {
        String aisSingleSentence = "AIVDM,1,1,,A,181:Jqh02c1Qra`E46I<@9n@059l,0*30";
        Vdm vdm = new Vdm();
        vdm.parse(aisSingleSentence);
        AisMessage aisMessage = AisMessage.getInstance(vdm);

        // 处理多部分消息
        String aisMultiSentencePart1 = "AIVDM,2,1,9,B,53nFBv01SJ<thHp6220H4heHTf2222222222221,50:454o<`9QSlUDp,0*09";
        String aisMultiSentencePart2 = "AIVDM,2,2,9,B,888888888888880,2*2E";
        vdm.parse(aisMultiSentencePart1);
        vdm.parse(aisMultiSentencePart2);
        aisMessage = AisMessage.getInstance(vdm);
        System.out.println("消息ID: " + aisMessage.getMsgId());
    }
}

构建与运行

在项目根目录下执行Maven命令来编译和测试：

mvn clean install
mvn test

3. 应用案例和最佳实践

文件读取消息

通过AisLib轻松实现从文件中读取AIS消息。

try (AisReader reader = AisReaders.createReaderFromFile("sentences.txt")) {
    reader.registerHandler((aisMessage) -> {
        System.out.println("消息ID: " + aisMessage.getMsgId());
    });
    reader.start();
    reader.join();
}

消息处理策略

对于复杂的场景，可以根据消息类型采用不同的处理逻辑，利用面向对象特性：

reader.registerHandler((aisMessage) -> {
    if (aisMessage instanceof AisPositionMessage) {
        AisPositionMessage posMsg = (AisPositionMessage) aisMessage;
        System.out.println("速度: " + posMsg.getSog());
    }
});

4. 典型生态项目

虽然AisLib本身是处理AIS消息的核心库，它在海事监控、海洋安全、物流跟踪等领域的整合应用是其生态的一部分。开发者可以结合GPS定位服务、船舶追踪系统、或是数据分析平台，开发出智能化的解决方案。例如，集成到基于Spring Boot的海洋信息系统中，实时分析和展示全球船舶动态，或者用于构建自动化港口管理系统的组件，以提升效率和安全性。

---

通过以上步骤和实践，您可以快速上手AisLib，探索在特定场景下的高效应用，构建强大的AIS数据处理和分析系统。记得关注项目更新以获取新功能和性能优化。