Java Native Interface

Z Multimediaexpo.cz

Nemáte oprávnění „upravit tuto stránku“. Důvod:

Můžete si prohlédnout a zkopírovat zdrojový kód této stránky:

'''JNI''' – '''Java Native Interface''' je rozhraní umožňující propojit kód běžící na [[virtuální stroj|virtuálním stroji]] [[Platforma Java|Javy]] s nativními programy a knihovnami napsanými v jiných jazycích – např. [[C (programovací jazyk)|C]], [[C++]], [[Assembler]], apod., které jsou zkompilované pro určitý hardware, případně operační systém. Jedná se tedy o jakýsi převodní můstek, pomocí kterého se můžeme dostat za hranice virtuálního stroje. JNI není omezeno pouze na jazyk Java. Jako takové je toto rozhraní součástí virtuálního stroje, lze k němu tedy přistupovat z libovolného jazyka překládaného do javovského bytekódu a spouštěného na platformě [[JVM]]. Kromě Javy ho tedy lze využít i v jazycích jako je [[Groovy]], [[Jython]], [[JRuby]], apod. Vše, co bude dále řečeno v souvislosti s JNI, tedy platí i pro tyto jazyky. == Využití JNI == I přesto, že nám platforma virtuálního stroje Javy poskytuje velmi bohaté běhové prostředí, nelze se zcela vyhnout situacím, kdy nám její možnosti nestačí. Toto prostředí s sebou totiž nese i hranice, které v programu není možné překročit. Základní rys virtuálního stroje, který nám zajišťuje nezávislost na platformě nižší úrovně, se tak někdy může stát spíše omezujícím faktorem. Typicky k tomuto dochází, pokud potřebujeme: * Používat specifické rysy konkrétního operačního systému. * Komunikovat s hardwarovými zařízeními. * Využít v naší aplikaci starší, nativní kód nebo naopak v nativním kódu přistupovat k aplikaci běžící uvnitř JVM. V prvním případě se jedná především o situace, kdy chceme uživateli poskytnout komfort, na který je zvyklý z nativních aplikací, zejména grafické uživatelské rozhraní daného operačního systému. Bez JNI se také neobejdeme, pokud chceme využívat některá specifická hardwarová zařízení, např. čtečky čárových kódů nebo karet, které nejsou přístupná skrz virtuální stroj a pro které výrobce neposkytuje javovské rozhraní. Stejně tak je pro nás virtuální stroj nepříjemnou komplikací, pokud potřebujeme komunikovat s již existující nativní aplikací, kterou není možné přepsat do jazyka běžícího nad JVM. Dalším důvodem pro použití tohoto rozhraní může být také fakt, že nativní kód zkompilovaný pro danou platformu se vykonává rychleji, JNI tedy můžeme využít pro zpracování náročných výpočtů, komplikovaných grafických operací, apod. == Historie JNI == Možnost volání nativního kódu je v Javě už od jejího vzniku. Ve verzi Javy 1.0 bylo implementováno rozhraní '''NMI''' – '''Native Method Interface''', které umožňovalo spuštění kódu napsaného v jiném jazyce. Toto rozhraní využívalo i mnoho vlastních tříd Javy, především z balíčků <tt>java.io</tt> a <tt>java.net</tt>. NMI však mělo několik nevhodných vlastností, kvůli kterým nebylo možné nativní knihovny používat na různých virtuálních strojích<ref>[http://java.sun.com/docs/books/jni/html/intro.html#2186 The Java Native Interface : Programmer's Guide and Specification - Evolution of the JNI]</ref>. Ve verzi Javy 1.1 se proto objevilo nové rozhraní JNI, které tyto nedostatky odstranilo. Na rozdíl od NMI ho podporují všechny virtuální stroje a nativní knihovny je možné používat s různými virtuálními stroji bez rekompilace. Ve verzích Javy 1.2 a 1.4 pak bylo toto rozhraní výrazným způsobem rozšířeno, změny však zachovávají zpětnou kompatibilitu. == Role JNI == Java Native Interface představuje obousměrné spojení mezi nativním kódem a kódem napsaným v Javě. Rozhraní je tedy možné využít dvěma zůsoby: * Prvním z nich je volání nativního kódu z javovské aplikace. V aplikaci vytvoříme tzv. nativní metodu, kterou pak voláme stejným způsobem, jako jakoukoliv jinou metodu napsanou v Javě. Nicméně ve skutečnosti je prostřednictvím JNI spuštěna metoda, jejíž implementace je napsaná v jiném jazyce a je uložená v nativní knihovně. * Druhou možností je pak spuštění virtuálního stroje přímo v nativní aplikaci. V nativním kódu vytvoříme propojení na knihovnu, která implementuje virtuální stroj Javy, a pomocí JNI v něm pak můžeme spouštět části aplikace napsané v Javě. Pokud bychom programovali např. internetový prohlížeč v jazyce C++, pomocí JNI bychom v něm takto mohli spouštět applety. == Nevýhody JNI == Pokud se rozhodneme využívat JNI pro volání nativních funkcí z kódu napsaného v Javě, je třeba mít na paměti, že to s sebou nese jisté důsledky: * Především tímto ztrácíme jeden ze základních benefitů jazyka Java, a to nezávislost na platformě. I když část aplikace napsaná v Javě bude stále přenositelná, nativní knihovny bude nutné znovu přeložit pro každé hostitelské prostředí. * Dalším výrazným negativem je také fakt, že Java je typově bezpečná, zatímco nativní jazyky, jako jsou např. C nebo C++, ne. Z tohoto důvodu je nutné věnovat aplikacím využívajícím JNI zvláštní pozornost. Drobná chyba v implementaci nativní metody může způsobit pád celé aplikace. Navíc tyto chyby bývá obvykle velmi těžké ladit nebo reprodukovat. * Kromě toho rozhraní JNI také neposkytuje žádné prostředky pro automatické uvolňování nepotřebných zdrojů z paměti. Pokud nativní kód alokuje nějaké prostředky, nese také zodpovědnost za jejich uvolnění ve chvíli, kdy již nejsou dále potřebné. == Jak JNI funguje == Aby bylo možné z kódu napsaného v Javě zavolat funkci nativní knihovny, je nutné udělat několik kroků<ref>[http://java.sun.com/docs/books/jni/html/start.html#769 The Java Native Interface : Programmer's Guide and Specification - Getting Started]</ref>. Celý proces je možné shrnout v následujících bodech: # Vytvoření javovské třídy, která deklaruje nativní metodu. # Přeložení této třídy do byte kódu. # Vytvoření hlavičkového souboru se signaturou příslušné metody pro její následnou implementaci. # Implementace metody např. v jazycích C, C++, apod. # Zkompilování této implementace do nativní knihovny. Dále jsou tyto kroky podrobněji rozebrány. === Vytvoření třídy deklarující nativní metodu === Nativní metoda se v deklaraci třídy označí klíčovým slovem <tt>native</tt> a její signatura je ukončena středníkem, podobně jako když definujeme metodu v rozhraní. Je nutné pamatovat na to, že před použitím příslušné metody je nutné nejprve nahrát knihovnu, která obsahuje její implementaci. To je možné provést např. voláním metody <tt>System.loadLibrary()</tt>. Jednoduchá třída s deklarací nativní metody by tedy mohla vypadat např. takto: <source lang="java"> public class HelloWorld { private native void sayHello(); public static void main(String[] args) { System.loadLibrary("library"); new HelloWorld().sayHello(); } } </source> === Přeložení třídy do byte kódu === Třídu je v tuto chvíli nutné přeložit, abychom mohli pokračovat dále. Většina vývojových prostředí se o toto samozřejmě postará automaticky, případně je to možné udělat z příkazové řádky jednoduchým zavoláním překladače: javac HelloWorld.java Výsledkem pak samozřejmě bude soubor <tt>HelloWorld.class</tt> s příslušným bytekódem. === Vytvoření souboru se signaturou metody === Abychom mohli metodu v nějakém jazyce naimplementovat, potřebujeme znát její přesnou signaturu. Ta samozřejmě odpovídá definici ze zdrojového kódu Javy. Její zápis v jiných jazycích se od ní však poněkud odlišuje. Pokud budeme metodu implementovat v jazycích C nebo C++, můžeme pro získání hlavičkového souboru se správnou podobou signatury využít nástroj <tt>javah</tt>. Ten však pro tvorbu [[Hlavičkový soubor|hlavičkových souborů]] využívá již soubory s bytekódem, proto bylo nutné třídu v předchozím kroku nejprve přeložit. Metodu je samozřejmě možné naimplementovat i v jiných jazycích, pro ty ale [[Java SDK]] neposkytuje žádné podpůrné nástroje. Na příkazové řádce tedy zavoláme: javah -jni HelloWorld Po zpracování dostaneme hlavičkový soubor <tt>HelloWorld.h</tt>, ve kterém bude mimo jiné uvedena i signatura metody v podobě: JNIEXPORT void JNICALL Java_HelloWorld_sayHello (JNIEnv *, jobject); Jak je z hlavičky patrné, nativní metoda obdrží od rozhraní JNI dva argumenty, přestože původní metoda deklarovaná ve zdrojovém kódu Javy byla bez parametrů. <tt>JNIEnv</tt> je ukazatel na rozhraní JNI, <tt>jobject</tt> potom představuje referenci na javovský objekt, který metodu vyvolal. Tyto dva argumenty obsahuje každá nativní metoda volaná prostřednictvím JNI. Pokud by byly v deklaraci metody v Javě požadovány nějaké parametry, byly by v signatuře uvedeny dále, za těmito dvěma. === Implementace nativní metody === Implementaci nativní metody je možné provést v libovolném jazyce. To jediné, co je potřeba dodržet, je volací konvence jazyka C, tedy způsob a pořadí, jakým jsou do zásobníkového rámce uloženy parametry funkce, apod. Pokud jsme schopni toto zajistit, můžeme metodu klidně napsat v Assembleru nebo kterémkoliv jiném jazyce. Velice jednoduchá implementace nativní metody v jazyce C++ může vypadat např. takto: <source lang="cpp"> #include <jni.h> #include <stdio.h> #include "HelloWorld.h" JNIEXPORT void JNICALL Java_HelloWorld_sayHello(JNIEnv *env, jobject obj) { printf("Hello World!\n"); return; } </source> Metoda pouze vypíše na konzoli řetězec Hello World! a skončí. Argumenty metody v tuto chvíli zcela ignorujeme. Na začátku kódu jsou odkazy na 3 hlavičkové soubory. První z nich obsahuje informace nutné k volání nativních metod prostřednictvím JNI. Při implementaci nativních metod musíme tento soubor vždy vkládat. Druhý soubor je zde jen proto, že v kódu využíváme funkci <tt>printf()</tt>. Třetí soubor byl vygenerován nástrojem <tt>javah</tt> a mimo jiné obsahuje signaturu dané funkce. === Překlad nativní knihovny === Pokud máme napsaný zdrojový kód, je nutné ho zkompilovat do nativní knihovny, kterou pak budeme v programu používat. Tento krok je samozřejmě značně závislý na používaném kompilátoru. Vždy je ale nutné správně uvést cesty ke vkládaným souborům. Soubor <tt>jni.h</tt> najdeme v podadresáři <tt>include</tt> adresáře, ve kterém je nainstalován [[Java SDK]]. Kromě tohoto adresáře musíme mezi cesty uvést ještě podadresář, který odpovídá operačnímu systému, např. <tt>include\win32</tt>, apod. Například na Ubuntu Linuxu s javou 6.0 a překladačem gcc může překlad jednoduchého příkladu vypadat takhle: gcc \ -I/usr/lib/jvm/java-6-sun-1.6.0.15/include/ \ -I/usr/lib/jvm/java-6-sun-1.6.0.15/include/linux/ \ java_Talker.c -shared -o libtalker.so V javě pak budeme načítat knihovnu libtalker.so příkazem <source lang="java"> System.loadLibrary("talker"); </source> Pokud cesty uvedeme správně, po překladu získáme požadovanou knihovnu. Po spuštění dojde k nahrání knihovny a zavolání nativní funkce, která pak vypíše na konzoli příslušný text. == Předávání dat == Pro smysluplné využití JNI je nutné nativním metodám předávat parametry a získávat návratové hodnoty. Aby toto bylo možné, JNI definuje pro všechny datové typy v Javě jejich ekvivalenty, které je pak možné v nativních metodách používat. Je nutné zde rozlišit, zda se jedná o primitivní nebo objektové datové typy. S ekvivalenty primitivních datových typů lze pracovat přímo. Jejich výčet je v následující tabulce: {| class="wikitable" ! Datový typ v Javě !! Nativní datový typ !! Popis |- | boolean || jboolean || 8 bitů, bez znaménka |- | byte || jbyte || 8 bitů, se znaménkem |- | char || jchar || 16 bitů, bez znaménka |- | short || jshort || 16 bitů, se znaménkem |- | int || jint || 32 bitů, se znaménkem |- | long || jlong || 64 bitů, se znaménkem |- | float || jfloat || 32 bitů |- | double || jdouble || 64 bitů |} Objektové datové typy jsou předávány jako ukazatele na vnitřní datové struktury virtuálního stroje. Uspořádání těchto struktur ale zůstává nativnímu programu skryto. Jediný způsob, jak s těmito daty smysluplně manipulovat, je skrze metody, které poskytuje rozhraní JNI. Ty jsou přístupné přes ukazatel <tt>JNIEnv</tt>. Toto platí kromě běžných objektů také pro všechna pole a textové řetězce. === Příklad předávání parametrů === Dříve uvedený příklad nyní rozšíříme tak, aby nativní metoda nevypisovala na konzoli pevně daný text, ale řetězec, který dostane jako parametr. Nejprve proto upravíme deklaraci metody v Javě: <source lang="java"> public class Talker { private native void sayIt(String text); public static void main(String[] args) { System.loadLibrary("library"); new Talker().sayIt("Saying 'Hello World!' is boring..."); } } </source> Opět je nutné třídu přeložit a vygenerovat hlavičkový soubor s příslušnou signaturou dané metody. Ta bude v tomto případě vypadat takto: JNIEXPORT void JNICALL Java_Talker_sayIt (JNIEnv *, jobject, jstring); Nyní je nutné upravit také implementaci nativní metody: <source lang="cpp"> #include <jni.h> #include <stdio.h> #include "Talker.h" JNIEXPORT void JNICALL Java_Talker_sayIt(JNIEnv *env, jobject obj, jstring text) { const char *str; str = env->GetStringUTFChars(text, NULL); if (str == NULL) { return; /* Chyba při alokaci paměti */ } printf("%s", str); env->ReleaseStringUTFChars(text, str); return; } </source> Reference na původní objekt se nejprve převede na ukazatel na sekvenci znaků. Vzhledem k tomu, že pro tuto operaci je nutné alokovat paměť, je potřeba zkontrolovat, zda operace byla úspěšná. Poté se vypíše daný text na konzoli a alokovaná paměť se opět uvolní. === Literatura === * {{Citace elektronické monografie | příjmení = Liang | jméno = Sheng | titul = The Java Native Interface : Programmer's Guide and Specification | url = java.sun.com/docs/books/jni/download/jni.pdf | druh nosiče = PDF online | datum vydání = 1999-06 | datum aktualizace = 2002-02-21 | datum přístupu = 2009-05-17 | vydavatel = Addison-Wesley | isbn = 0-201-32577-2}} * {{Citace periodika | příjmení = Tal | jméno = Liron | titul = Enhance your Java application with Java Native Interface (JNI) | periodikum = JavaWorld | rok = 1999 | měsíc = říjen | den = 20 | url = http://www.javaworld.com/javaworld/jw-10-1999/jw-10-jni.html}} === Související články === * [[Java (programovací jazyk)]] * [[Platforma Java]] == Reference == <references /> == Externí odkazy == * [http://java.sun.com/j2se/1.5.0/docs/guide/jni/spec/jniTOC.html Java Native Interface Specification] * [http://java.sun.com/developer/onlineTraining/Programming/JDCBook/jni.html Tutorials & Code Camps - JNI Technology] {{Článek z Wikipedie}} [[Kategorie:Java]] [[Kategorie:Rozhraní pro programování aplikací]]

Návrat na stránku „Java Native Interface“.