Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

native

Modyfikator 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.

Źródła