JavaからC言語のマクロを呼び出す実践ガイド

はじめに (対象読者・この記事でわかること)

本記事は、Java開発者で、C言語の既存コードやヘッダーファイルに定義されたマクロをそのまま利用したいと考えている方を対象としています。
Java だけで完結できるプログラムが増えている中、低レベルの高速処理やハードウェア制御が必要な場面で、C のマクロを活かしたいケースは少なくありません。本記事を読むと、以下が実現できるようになります。

JNI（Java Native Interface）を用いたビルド環境の構築手順
C ヘッダーに定義されたマクロを Java から呼び出す具体的なコード例
ビルド時や実行時に起こりやすいエラーとその回避策

これにより、既存の C ライブラリを再利用しつつ、Java の開発効率を維持できるようになります。執筆のきっかけは、社内プロジェクトで C の定数マクロが大量に使用されており、Java 側に移植する際に手作業で定義を書き換えるのが非効率だった経験です。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。

Java の基本的なプログラミング経験（クラス、メソッド、例外処理など）
C 言語の基礎（関数定義、ヘッダー、プリプロセッサマクロ）
基本的なビルドツール（Gradle または Maven）の使い方
コマンドラインでのコンパイル作業（gcc / clang）の経験

Java と C のマクロ連携：概要と背景

C 言語では #define によるマクロがコンパイル時に展開され、定数やインライン関数として扱われます。一方、Java はバイトコード実行環境上で動作し、プリプロセッサを持たないため、直接的にマクロを参照できません。そのため、C のマクロを Java から呼び出すには、以下のようなステップが必要です。

C マクロを関数化
マクロ自体はプリプロセッサの指示なので、実行時に取得できません。そこで、マクロの値を取得するラッパー関数を C 側に用意します。たとえば、定数マクロ #define MAX_SIZE 1024 であれば、int get_MAX_SIZE(void){ return MAX_SIZE; } とします。
JNI 用のヘッダーを生成
javah（または javac -h）で JNI ヘッダーを自動生成し、C 側に実装する関数のプロトタイプを作ります。
ネイティブライブラリのビルド
C ソースと生成したヘッダーを結合し、プラットフォーム固有の共有ライブラリ（.so、.dll、.dylib）を作成します。ビルド時には -I オプションで Java のヘッダー検索パスを指定し、-shared -fPIC で共有ライブラリ化します。
Java 側からロード
System.loadLibrary("yourlib") により、作成した共有ライブラリをロードし、native メソッドを呼び出します。

この流れを整理すると、マクロは「コンパイル時定数 → ラッパー関数 → JNI 経由で取得」の三段階で Java に橋渡しされます。この記事では、実際のコード例とビルドスクリプトを交えて、Windows と Linux の両環境で動作させる手順を解説します。

実装手順：Java から C マクロを呼び出す完全ガイド

ステップ 1：マクロをラップする C 関数の作成

まずは、対象となるヘッダー constants.h に記述されたマクロを確認します。例として以下のようなマクロがあるとします。

C

/* constants.h */
#define MAX_BUFFER_SIZE   4096
#define VERSION_MAJOR     1
#define VERSION_MINOR     0
#define ENABLE_FEATURE_X  (1 << 2)

上記マクロをそのまま Java で扱えるように、次のようなラッパー関数を constants.c に追加します。

C

/* constants.c */
#include "constants.h"

int get_MAX_BUFFER_SIZE(void) { return MAX_BUFFER_SIZE; }
int get_VERSION_MAJOR(void)   { return VERSION_MAJOR; }
int get_VERSION_MINOR(void)   { return VERSION_MINOR; }
int get_ENABLE_FEATURE_X(void){ return ENABLE_FEATURE_X; }

ポイントは マクロの型に合わせた戻り値 を選ぶことです。整数系マクロは int、文字列マクロ (#define APP_NAME "MyApp" のような) は const char* に変換し、別途 jstring に変換する必要があります。

ステップ 2：JNI ヘッダーの生成

Java 側に以下のようなインタフェースクラスを作成します。

Java

// NativeConstants.java
public class NativeConstants {
    static {
        System.loadLibrary("nativeconstants");
    }

    public static native int getMAX_BUFFER_SIZE();
    public static native int getVERSION_MAJOR();
    public static native int getVERSION_MINOR();
    public static native int getENABLE_FEATURE_X();
}

javac でコンパイル後、javac -h src/main/c を実行して JNI ヘッダーを生成します。

Bash

javac src/main/java/NativeConstants.java
javac -h src/main/c src/main/java/NativeConstants.java

生成された NativeConstants.h には、Java_NativeConstants_getMAX_1BUFFER_1SIZE という名前の関数プロトタイプが記載されています（_1 はアンダースコアエスケープです）。

ステップ 3：C 側の実装とビルド設定

src/main/c に以下のように実装ファイル nativeconstants.c を作ります。

C

/* nativeconstants.c */
#include <jni.h>
#include "NativeConstants.h"
#include "constants.h"

/*
 * Class:     NativeConstants
 * Method:    getMAX_BUFFER_SIZE
 * Signature: ()I
 */
JNIEXPORT jint JNICALL Java_NativeConstants_getMAX_1BUFFER_1SIZE(JNIEnv *env, jclass cls) {
    return (jint)get_MAX_BUFFER_SIZE();
}

/* 同様に他のマクロについても実装 */
JNIEXPORT jint JNICALL Java_NativeConstants_getVERSION_1MAJOR(JNIEnv *env, jclass cls) {
    return (jint)get_VERSION_MAJOR();
}
JNIEXPORT jint JNICALL Java_NativeConstants_getVERSION_1MINOR(JNIEnv *env, jclass cls) {
    return (jint)get_VERSION_MINOR();
}
JNIEXPORT jint JNICALL Java_NativeConstants_getENABLE_1FEATURE_1X(JNIEnv *env, jclass cls) {
    return (jint)get_ENABLE_FEATURE_X();
}

Gradle ビルドスクリプト例（Linux/ macOS）

Groovy

plugins {
    id 'java'
}

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

task compileNative(type: Exec) {
    def javaHome = System.getenv("JAVA_HOME") ?: "${org.gradle.internal.jvm.Jvm.current().javaHome}"
    def jniHeaders = "${javaHome}/include"
    def jniHeadersOs = "${jniHeaders}/${org.gradle.internal.os.OperatingSystem.current().toString().toLowerCase()}"
    commandLine 'gcc',
            '-I', jniHeaders,
            '-I', jniHeadersOs,
            '-I', 'src/main/c',   // ヘッダー検索パス
            '-shared', '-fPIC',
            '-o', "$buildDir/libs/libnativeconstants.so",
            'src/main/c/constants.c',
            'src/main/c/nativeconstants.c'
}

tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
}

processResources.dependsOn compileNative

Windows 環境では gcc を cl.exe に置き換えるか、MinGW の gcc を使用し、出力ファイル名を nativeconstants.dll に変更してください。

ステップ 4：Java から呼び出すテストコード

Java

public class TestNativeConstants {
    public static void main(String[] args) {
        System.out.println("MAX_BUFFER_SIZE = " + NativeConstants.getMAX_BUFFER_SIZE());
        System.out.println("VERSION = " +
                NativeConstants.getVERSION_MAJOR() + "." +
                NativeConstants.getVERSION_MINOR());
        System.out.println("FEATURE_X enabled? = " +
                (NativeConstants.getENABLE_FEATURE_X() != 0));
    }
}

実行例（Linux）:

$ java -cp build/classes/java/main TestNativeConstants
MAX_BUFFER_SIZE = 4096
VERSION = 1.0
FEATURE_X enabled? = true

ハマった点やエラー解決

発生した問題	原因	解決策
`java.lang.UnsatisfiedLinkError: no nativeconstants in java.library.path`	ライブラリのパスが `java.library.path` に含まれていない	`-Djava.library.path=build/libs` オプションで実行、または `System.load(String)` で絶対パスを指定
`Undefined reference to 'Java_NativeConstants_getMAX_1BUFFER_1SIZE'`	JNI ヘッダーと実装関数名の不一致（アンダースコアエスケープ忘れ）	関数名はヘッダー通りに正確に記載（`_1` が必要）
`gcc: error: -fPIC: No such file or directory`	使用している Windows の MinGW が `-fPIC` をサポートしない	Windows 版は `-shared` のみでビルド、`-fPIC` は削除
マクロが文字列で定義されている場合の取得	`const char*` をそのまま返すと Java 側で扱えない	`jstring NewStringUTF(JNIEnv, const char)` を用いて `jstring` に変換し、返す実装に変更

解決策のコード例（文字列マクロ）

C

/* constants.h */
#define APP_NAME "MyJavaApp"

/* nativeconstants.c */
JNIEXPORT jstring JNICALL Java_NativeConstants_getAPP_1NAME(JNIEnv *env, jclass cls) {
    return (*env)->NewStringUTF(env, APP_NAME);
}

Java 側:

Java

public static native String getAPP_NAME();

まとめ

本記事では、Java から C のマクロを利用するためのフルワークフロー を以下のポイントで解説しました。

マクロは関数でラップし、実行時に取得できる形に変換する
JNI ヘッダー生成と C 実装を対応させ、プラットフォームごとの共有ライブラリを作成
Gradle で自動ビルドし、Java 側から native メソッドで呼び出す手順
典型的なエラー例と対処法を提示し、開発時のハードルを低減

これにより、既存の C ライブラリに埋め込まれた定数やインラインロジックを、Java プロジェクト内でシームレスに再利用できるようになります。次回は、マクロ以外の C の複雑な構造体や関数ポインタを JNI で扱う方法、そして JNA との比較についても取り上げる予定です。

参考資料

Oracle – Java™ Platform, Standard Edition Documentation – JNI
The GNU Compiler Collection (GCC) Documentation – Shared Libraries
「Effective Java 第3版」- Josh Bloch（Java とネイティブコードのインターフェースに関する章）
JNIの実例 – Baeldung

JavaからC言語のマクロを呼び出す実践ガイド💻