Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

native — método fora de Java

native — método fora de Java: O modificador native declara um método implementado fora da linguagem Java; a declaração termina em ponto e vírgula e não tem corpo Java.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

native

O modificador native declara um método implementado fora da linguagem Java; a declaração termina em ponto e vírgula e não tem corpo Java.

Usa native só numa fronteira JNI ou runtime estreita e controlada, escondida atrás de uma API Java segura que valide dados.

Se faltar a implementação, UnsatisfiedLinkError pode ocorrer ao usar o método ou antes, conforme o momento da resolution da JVM; a assinatura tem de coincidir com o código nativo.

Um método native pode ser static ou de instância e é visível por reflexão; o exemplo inspeciona o modificador sem o chamar.

A reflexão encontra o método add não chamado; Modifier.isNative produz native=true e o tipo de retorno produz return=int.

Exemplos

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());
    }
}

Resultado

native=true
return=int

A reflexão encontra o método add não chamado; Modifier.isNative produz native=true e o tipo de retorno produz return=int.

Fontes