CKTIS / Java
native — metoda spoza Javy
native — metoda spoza Javy: Modyfikator native deklaruje metodę zaimplementowaną poza językiem Java; deklaracja kończy się średnikiem i nie ma ciała Java.
Wersja: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Składnia
nativeModyfikator native deklaruje metodę zaimplementowaną poza językiem Java; deklaracja kończy się średnikiem i nie ma ciała Java.
Stosuj native tylko na wąskiej, kontrolowanej granicy JNI lub runtime i ukrywaj ją za bezpiecznym API Java z walidacją danych.
Gdy brakuje implementacji, UnsatisfiedLinkError może wystąpić przy użyciu metody albo wcześniej, zależnie od chwili resolution w danej JVM; podpis musi zgadzać się z kodem natywnym.
Metoda native może być static lub instancyjna i jest wykrywalna przez reflection; przykład sprawdza modyfikator, lecz celowo jej nie wywołuje.
Reflection odnajduje niewywołaną metodę add; Modifier.isNative daje native=true, a typ zwracany metody daje drugi wiersz return=int.
Przykłady
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
public class Main {
private static native int add(int left, int right);
public static void main(String[] args) throws Exception {
Method method = Main.class.getDeclaredMethod("add", int.class, int.class);
System.out.println("native=" + Modifier.isNative(method.getModifiers()));
System.out.println("return=" + method.getReturnType().getSimpleName());
}
}
Wynik
native=true return=int
Reflection odnajduje niewywołaną metodę add; Modifier.isNative daje native=true, a typ zwracany metody daje drugi wiersz return=int.