CKTIS / Java
native — metóda mimo Javy
native — metóda mimo Javy: Modifikátor native deklaruje metódu implementovanú mimo jazyk Java; deklarácia končí bodkočiarkou a nemá telo Java.
Verzia: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
nativeModifikátor native deklaruje metódu implementovanú mimo jazyk Java; deklarácia končí bodkočiarkou a nemá telo Java.
Použi native iba na úzkej riadenej hranici JNI či runtime a skry ju za bezpečné Java API s validáciou dát.
Ak implementácia chýba, UnsatisfiedLinkError môže nastať pri použití metódy alebo skôr podľa okamihu resolution v JVM; signatúra musí zodpovedať natívnemu kódu.
Native metóda môže byť static či inštančná a je viditeľná reflexiou; príklad skontroluje modifikátor, ale zámerne ju nezavolá.
Reflexia nájde nezavolanú metódu add; Modifier.isNative vypíše native=true a návratový typ metódy vypíše return=int.
Príklady
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());
}
}
Výsledok
native=true return=int
Reflexia nájde nezavolanú metódu add; Modifier.isNative vypíše native=true a návratový typ metódy vypíše return=int.