Foreign Linker API 是 Java 16 引入的孵化特性，位于 java.lang.foreign 包，需显式启用预览支持；它提供静态类型、纯 Java 方式访问本地代码，须配合 SymbolLookup 和 MemoryLayout 精确声明函数签名与内存布局，并由 Arena 显式管理内存生命周期。
Foreign Linker API 是 Java 16+ 的正式特性，但默认不启用
Java 16 引入了 java.lang.foreign 包（含 Linker、SymbolLookup、MemorySegment 等），但它属于预览特性，直到 Java 22 才转正。如果你用的是 Java 17–21，必须显式开启预览支持，否则编译或运行时会报 InaccessibleObjectException 或 ClassNotFoundException。
- 编译时加参数：
--enable-preview --source 17（版本需匹配） - 运行时加参数：
--enable-preview - IDE 中（如 IntelliJ）需在 Project Settings → Java Compiler 和 Run Configuration 里同步配置，否则只在终端能跑通
加载 C 函数前必须先获取 native library 的符号表
不能像 JNI 那样靠 System.loadLibrary("xxx") 后直接调用；Foreign Linker 要求你显式构造 SymbolLookup 实例，指向动态库的绝对路径或系统查找路径。
- 推荐用
Linker.nativeLinker().defaultLookup()获取系统级符号（如libc），适用于printf、malloc等标准函数 - 加载自定义库时，用
SymbolLookup.libraryLookup(Paths.get("/path/to/libmath.so"), Arena.ofConfined())—— 注意路径必须存在且有执行权限，Windows 下是.dll，macOS 是.dylib - 如果
lookup("my_func").get()返回null，大概率是函数名被 C 编译器修饰（比如 C++ 导出未加extern "C"），或库未正确导出符号（Linux 下需加-fvisibility=default编译）
函数签名必须用 MemoryLayout 显式声明，类型不匹配会崩溃
Foreign Linker 不做隐式类型转换。C 的 int、long、指针在不同平台宽度不同，Java 侧必须用 ValueLayout 或 AddressLayout 精确对齐，否则运行时报 IllegalStateException: Layout size mismatch 或直接 segfault。
- C 函数
int add(int a, int b)对应 Java 签名：FunctionDescriptor.of(C_INT, C_INT, C_INT) - C 函数
char* strdup(const char* s)：参数用C_POINTER，返回值也用C_POINTER，且调用后需手动free（通过libc的free符号） - 结构体传参必须定义
MemoryLayout.structLayout(...)，字段顺序、padding 必须和 C 头文件完全一致（可用clang -Xclang -fdump-record-layouts辅助验证）
内存生命周期必须由 Arena 显式管理，别依赖 GC
MemorySegment 不受垃圾回收器自动管理，所有 native 内存都绑定到某个 Arena 实例。一旦 Arena 关闭（close()），其内所有 MemorySegment 立即失效，后续访问会触发 IllegalStateException: Segment is already closed。
- 短生命周期场景（如单次函数调用）用
Arena.ofConfined()，作用域结束自动释放 - 长生命周期（如缓存一段 native buffer）用
Arena.ofShared()，但需确保线程安全，且必须显式close() - 千万别把
MemorySegment存到静态变量或跨线程传递而忽略所属Arena的生命周期 —— 这是段错误最常见来源
Foreign Linker 看似比 JNI “更现代”，但类型安全和内存控制全靠开发者手工对齐。C 头文件里的每个 typedef、#pragma pack、指针层级，都会变成 Java 侧一连串 MemoryLayout 声明。漏掉一个 ADDRESS 后缀，或搞错 ByteOrder，程序就可能在某台机器上静默出错。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
