Collections on Native Method for Java

JAVA中有两种方法：JAVA方法和本地方法
JAVA方法是由JAVA编写的，编译成字节码，存储在class文件中
本地方法是由其它语言编写的，编译成和处理器相关的机器代码
本地方法保存在动态链接库中，即.dll(windows系统)文件中，格式是各个平台专有的
JAVA方法是与平台无关的，但是本地方法不是
运行中的JAVA方法调用本地方法时，虚拟机装载包含这个本地方法的动态库的，并调用这个方法
通过本地方法，JAVA程序可以直接访问底层操作系统的资源，如果你这样用，你的程序就变成平台相关了，因为本地方法的动态库是与平台相关的，此外使用本地方法还可能把程序变得和特定的JAVA平台实现相关
一个本地方法接口——JAVA本地接口JNI——使得本地方法可以在特定主机系统的任何一个JAVA平台实现上运行
JAVA给人们提供了选择的机会
如果希望使用特定主机上的资源，它们又无法从JAVA API访问，那么可以写一个平台相关的JAVA程序来调用本地方法
如果希望保证程序的平台无关性，那么只能通过JAVA API来访问底层系统资源
Java不是完美的，Java的不足除了体现在运行速度上要比传统的C++慢许多之外，Java无法直接访问到操作系统底层（如系统硬件等)，为此Java使用native方法来扩展Java程序的功能。
　　可以将native方法比作Java程序同Ｃ程序的接口，其实现步骤：
　　１、在Java中声明native()方法，然后编译；　　２、用javah产生一个.h文件；　　３、写一个.cpp文件实现native导出方法，其中需要包含第二步产生的.h文件（注意其中又包含了JDK带的jni.h文件）；　　４、将第三步的.cpp文件编译成动态链接库文件；　　５、在Java中用System.loadLibrary(String libname)方法加载第四步产生的动态链接库文件，这个native()方法就可以在Java中被访问了。
　　上述所提及的一些Java技术具有一定的普遍性，它们基本上是在Java各个方面的运用中都需要掌握的术。实际上Java的运用非常广泛，而且每个方面都需要遵循不同的规范。以下是对Java应用的简要介绍。
一. 什么是Native Method
   简单地讲，一个Native Method就是一个java调用非java代码的接口。一个Native Method是这样一个java的方法：该方法的实现由非java语言实现，比如C。这个特征并非java所特有，很多其它的编程语言都有这一机制，比如在C＋＋中，你可以用extern "C"告知C＋＋编译器去调用一个C的函数。
   "A native method is a Java method whose implementation is provided by non-java code."
   在定义一个native method时，并不提供实现体（有些像定义一个java interface），因为其实现体是由非java语言在外面实现的。，下面给了一个示例：    
    public class IHaveNatives
    {
      native public void Native1( int x ) ;
      native static public long Native2() ;
      native synchronized private float Native3( Object o ) ;
      native void Native4( int[] ary ) throws Exception ;
    } 
    这些方法的声明描述了一些非java代码在这些java代码里看起来像什么样子（view）.
    标识符native可以与所有其它的java标识符连用，但是abstract除外。这是合理的，因为native暗示这些方法是有实现体的，只不过这些实现体是非java的，但是abstract却显然的指明这些方法无实现体。native与其它java标识符连用时，其意义同非Native Method并无差别，比如native static表明这个方法可以在不产生类的实例时直接调用，这非常方便，比如当你想用一个native method去调用一个C的类库时。上面的第三个方法用到了native synchronized，JVM在进入这个方法的实现体之前会执行同步锁机制（就像java的多线程。）
    一个native method方法可以返回任何java类型，包括非基本类型，而且同样可以进行异常控制。这些方法的实现体可以制一个异常并且将其抛出，这一点与java的方法非常相似。当一个native method接收到一些非基本类型时如Object或一个整型数组时，这个方法可以访问这非些基本型的内部，但是这将使这个native方法依赖于你所访问的java类的实现。有一点要牢牢记住：我们可以在一个native method的本地实现中访问所有的java特性，但是这要依赖于你所访问的java特性的实现，而且这样做远远不如在java语言中使用那些特性方便和容易。
    native method的存在并不会对其他类调用这些本地方法产生任何影响，实际上调用这些方法的其他类甚至不知道它所调用的是一个本地方法。JVM将控制调用本地方法的所有细节。需要注意当我们将一个本地方法声明为final的情况。用java实现的方法体在被编译时可能会因为内联而产生效率上的提升。但是一个native final方法是否也能获得这样的好处却是值得怀疑的，但是这只是一个代码优化方面的问题，对功能实现没有影响。
    如果一个含有本地方法的类被继承，子类会继承这个本地方法并且可以用java语言重写这个方法（这个似乎看起来有些奇怪），同样的如果一个本地方法被fianl标识，它被继承后不能被重写。
   本地方法非常有用，因为它有效地扩充了jvm.事实上，我们所写的java代码已经用到了本地方法，在sun的java的并发（多线程）的机制实现中，许多与操作系统的接触点都用到了本地方法，这使得java程序能够超越java运行时的界限。有了本地方法，java程序可以做任何应用层次的任务。
 
 
二.为什么要使用Native Method
   java使用起来非常方便，然而有些层次的任务用java实现起来不容易，或者我们对程序的效率很在意时，问题就来了。
   与java环境外交互：
   有时java应用需要与java外面的环境交互。这是本地方法存在的主要原因，你可以想想java需要与一些底层系统如操作系统或某些硬件交换信息时的情况。本地方法正是这样一种交流机制：它为我们提供了一个非常简洁的接口，而且我们无需去了解java应用之外的繁琐的细节。
   与操作系统交互：
   JVM支持着java语言本身和运行时库，它是java程序赖以生存的平台，它由一个解释器（解释字节码）和一些连接到本地代码的库组成。然而不管怎 样，它毕竟不是一个完整的系统，它经常依赖于一些底层（underneath在下面的）系统的支持。这些底层系统常常是强大的操作系统。通过使用本地方法，我们得以用java实现了jre的与底层系统的交互，甚至JVM的一些部分就是用C写的，还有，如果我们要使用一些java语言本身没有提供封装的操作系统的特性时，我们也需要使用本地方法。
    Sun's Java
    Sun的解释器是用C实现的，这使得它能像一些普通的C一样与外部交互。jre大部分是用java实现的，它也通过一些本地方法与外界交互。例如：类java.lang.Thread 的 setPriority()方法是用java实现的，但是它实现调用的是该类里的本地方法setPriority0()。这个本地方法是用C实现的，并被植入JVM内部，在Windows 95的平台上，这个本地方法最终将调用Win32 SetPriority() API。这是一个本地方法的具体实现由JVM直接提供，更多的情况是本地方法由外部的动态链接库（external dynamic link library）提供，然后被JVM调用。
 
 
三.JVM怎样使Native Method跑起来：
    我们知道，当一个类第一次被使用到时，这个类的字节码会被加载到内存，并且只会回载一次。在这个被加载的字节码的入口维持着一个该类所有方法描述符的list，这些方法描述符包含这样一些信息：方法代码存于何处，它有哪些参数，方法的描述符（public之类）等等。
    如果一个方法描述符内有native，这个描述符块将有一个指向该方法的实现的指针。这些实现在一些DLL文件内，但是它们会被操作系统加载到java程序的地址空间。当一个带有本地方法的类被加载时，其相关的DLL并未被加载，因此指向方法实现的指针并不会被设置。当本地方法被调用之前，这些DLL才会被加载，这是通过调用java.system.loadLibrary()实现的。
   
   最后需要提示的是，使用本地方法是有开销的，它丧失了java的很多好处。如果别无选择，我们可以选择使用本地方法。

用java编程语言编写的代码与用C或C++之类的语言编写的代码相比于许多的优点，如用Java更容易编写出没有错的代码、也可以更容易编写出多线程代码和网络编码。当然纯粹的java解决方案是好的，可惜的是对于一个应用程序，有时候需要编写会使用其他语言的代码，而这种代码称为本地代码。即用Java编写的程序调用本地代码。(编写本地代码不必非要是C或C++)。要注意的是，使用了本地的方法就失去了程序的可移植性，所以还是在不得已的情况下使用本地方法如必须在一个程序中获得对设备的访问权，比如串口，此时就需要本地方法。【本地方法使用C语言实现】

1.用native关键字表示本地方法，本地方法不包含Java编程语言的代码，而且方法标题后直接跟着一个表示终结的分号。本地方法既可以是静态的也可以是非静态的。

2.使用个本地方法，我们要做如下三个步骤：

一是，声明一个本地方法，然后用C语言实现；

二是，将本地代码编译到一个动态的装载库中；

三是，在定义本地方法的Java类中添加一个队System.loadLibrary方法的调用，这样可以确保在第一次使用该类之前就会装在这个类，最简单的就是使用静态初始化代码块。

3.实现本地方法的时候，数值和字符串参数的使用

  数值：boolean->jboolean  byte->jbyte  short->jshort int->jint  long->jlong  float->jfloat double->jdouble

  字符串：Java本地接口有两组操作字符串的函数，一组把Java字符串转换成改良的UTF-8字符序列，另一组将它们转换成UTF_16数值数组即转换正jchar数组。（改良的UTF_8编码保持ASCII字符不变，但是其他所有Unicode字符被编码为多字节序列）

如：jstring jstr;

       char greeting[]="Hello,Native world\n";

       jstr=(*env)->NewStringUtf(env,greeting);

   从C代码访问Java字符串：

     jstring NewStringUTF(JNIEnv* env,const char bytes[])//根据改良的UTF-8字节序列，返回一个新的Java字符串对象。

    jsize GetStringUTFLength(JNIEnv* env,jstring string)//返回进行UTF-8编码所需的字节数。

   const ibyte* GetStringUTFChars(JNIEnv* env,jstring string,jboolean* isCopy)//返回改良UTF-8编码的字符串的指针，直到ReleaseStringUTFChars函数调用前该指针一直有效的。

     void ReleaseStringUTFChars(JNIEnv* env,jstring string,const ibyte bytes[])//通知虚拟机本地代码不再需要通过bytes访问Java字符串

     void GetStringRegion(JNIEnv * env,jstring string,jsize start,jsize length,jchar *buffer)//将一个Unicode字符序列从字符串复制到用户提供的缓存中。

     void GetStringUTFREdion(JNIEnv * env,jstring string,jsize start,jsize length,jchar *buffer)//将一个改良的UTF-8字符序列从字符串复制到用户提供的缓存中

     jstring NewString(JNIEnv *env,const jchar chars[],jsize length)//根据Unicode字符串返回一个新的Java字符串对象。

4.访问域：从本地方法访问实例域和静态域(静态的和非静态的本地方法不同，参数类型不同，静态的是jclass，非静态的是jobject)

   访问实例域：

jclass class_Employee=(*env)->GetObjectClass(env,this_obj);

jfieldId id_salary=(*env)->GetFieldId(env,class_Employee,"salary","D");

jdouble salary=(*env)->GetDoubleField(env,this_obj,id_salary);

或SetDoubleField(env,this_obj,id_salary,salary);

    访问静态域：如得到一个System.out的引用的代码

jclass class_system=(*env)->FindClass(env,"java/lang/System);          

jfieldId id_out=(*rnv)->GetStaticFieldId(env,class_system,"out","Ljava/io/printStream;");

                    jobject obj_out=(*env)-GetStaticObjectField(env,class-system,id_out);

5.方法签名：在访问实例域和调用Java编程语言中定义的方法，必须学习编入数据类型的名称和方法签名的规则。

规则：B->byte    c->char   D->double   F->float   I->int   J->long   S->short   V->void    Z->boolean

 其他的：如Employee(java.lang.String,double,java.util.Date)->"(Ljava/lang/String;DLjava/util/Date;)V"

          描述数组类型使用[ ,如String[]->[Ljava/lang/String;

6.调用Java方法，非静态的和静态的

  非静态的：jclass class_printWriter=(*env)->GetObjectClass(env,out);

jmethodId id_print=(*env)->GetMethodId(env,class_printWriter,"print","(Ljava/lang/String;)V");

(*env)->CallVoidMethod(env,out,id_print,str);

  静态的：jclass class_system=(*rnv)->FindClass(env,"lava/lang/System");

             jmenthodidid_getProperty=(*env)->GetStaticMethodId(env,class_system,"getProperty","(Ljava/lang/String;)Ljava/lang/String");

Jobject obj_ret=(*env)->CallStaticMethod(env,class_system,id_property,(*env)->NewStringUTF(env,"java.class.path"));

7.构造器：本地方法可以通过调用构造器来创建新的Java对象，可以通过NewObject函数来调用构造器。

   jobject obj_new=(*env)->newObject（恶女，class，methodId,construction parameters);

8.访问数组元素：以后补充，现在跳过。