Native.js for Android

   Native.js for Android封装一条通过JS语法直接调用Native Java接口通道,通过plus.android可调用几乎所有的系统API。

1、方法

1.1、importClass: 导入Java类对象

         ClassObject plus.android.importClass( String classname );

说明:导入类对象后,就可以通过.操作符直接调用对象(类对象/实例对象)的方法。 注意:导入类对象将会消耗较多的系统资源,通常不应该导入过多的类对象,可以使用plus.android.invoke()来调用未导入类实例对象的方法。

参数:classname: ( String | InstanceObject ) 必选 要导入的Java类名或者实例对象,使用"."分割命名空间。在类名中可以使用"*"来导入指定命名空间下的所有类对象; 如果指定的类名无效,则导入类对象失败。

返回值:ClassObject : Java类对象,如果导入类对象失败则返回null。

示例:






Android Native.js






1.2、newObject: 创建实例对象

        void plus.android.newObject( String classname, Object..args );

参数:

classname: ( String ) 必选 要创建实例对象的类名,使用"."分割命名空间。如果指定的类名不存在,则创建对象失败,不会抛出异常。

args: ( Object ) 可选 创建实例对象的构造参数。如果指定的构造参数类型不区配,则创建对象失败,不会抛出异常。

返回值:InstanceObject : Android实例对象,如果创建对象失败则返回null。

示例:






Android Native.js






1.3、getAttribute: 获取对象(类对象/实例对象)的属性值

         Object plus.android.getAttribute( Object obj, String name );

参数:

obj: ( IntanceObject | ClassObject | String ) 必选 要获取属性值的对象,也可以是类的名称。如果obj为实例对象(InstanceObject),则获取的是实例的属性值; 如果obj为类对象(ClassObject),则获取的是类的静态属性值; 如果obj为字符串类型,其值必须是类的名称,则获取是类的静态属性值;

name: ( String ) 必选 要获取的属性名称。如果指定的属性名称不存在,则获取属性失败,不会抛出异常。

返回值:Object : 属性值对象,如果获取属性失败则返回null。

示例:






Android Native.js






1.4、setAttribute: 设置对象(类对象/实例对象)的属性值

   void plus.android.setAttribute( Object obj, String name, Object value );

参数:

obj: ( InstanceObject ) 必选 要设置属性值的对象,也可以是类的名称。如果obj为实例对象(InstanceObject),则设置的是实例的属性值; 如果obj为类对象(ClassObject),则设置的是类的静态属性值; 如果obj为字符串类型,其值必须是类的名称,则设置是类的静态属性值;

name: ( String ) 必选 要设置的属性名称。如果指定的属性名称不存在,则操作不生效,不会抛出异常。

value: ( Object ) 必选 要设置的属性值。如果指定的属性值类型不区配,则操作不生效,不会抛出异常。

返回值:void : 无

示例: 






Android Native.js






1.5、invoke: 调用对象(类对象/实例对象)的方法

      Object plus.android.invoke( Object obj, String name, Object... args );

参数:

obj: ( InstanceObject | ClassObject | String ) 必选 调用方法所属的对象,也可以是类的名称。如果obj为实例对象(InstanceObject),则调用的是实例的方法; 如果obj为类对象(ClassObject),则调用的是类的静态方法; 如果obj为字符串类型,其值必须是类的名称,则调用的是类的静态方法;

name: ( String ) 必选 要调用的方法名称。如果指定的方法名称不存在,则调用方法失败,不会抛出异常。

args: ( Object ) 可选 调用方法的参数。如果指定的参数数目或类型不区配,则调用方法失败,不会抛出异常。

返回值:

Object : 调用方法的返回值,如果调用方法失败,则返回undefined。

示例:






Android Native.js






1.6、implements: 实现Interface的方法

     Object plus.android.implements( String name, Object obj );

参数:

name: ( String ) 必选 Interface的名称,也可以是自定的字符串名称。如果name为自定的字符串名称,则自定义一个Interface;

obj: ( Object ) 必选 JSON对象类型,Interface实现方法的定义。JSON对象中key值为Interface方法的名称;value值为Function。

返回值:InstanceObject : Interface实例对象。

示例:






Android Native.js






1.7、runtimeMainActivity: 获取应用主Activity实例对象

      InstanceObject plus.android.runtimeMainActivity();

说明:Android平台完整Java类名为android.app.Activity,完整API请参考Android开发文档 android.app.Activity

返回值:InstanceObject : 程序原生Java层主Activity实例对象。

示例:






Android Native.js






1.8、currentWebview: 获取当前Webview窗口对象的native层实例对象

             InstanceObject plus.android.currentWebview();

说明:Android平台完整Java类名为android.webkit.Webview,完整API请参考Android开发文档 android.webkit.Webview

返回值:InstanceObject : Webview窗口对象的native层android.webkit.Webview实例对象,如果调用方法失败,则返回null。

示例:






iOS Javascript Bridge



获取当前Webview窗口对象的native层实例对象


2、对象

2.1、ClassObject: Java类对象

interface ClassObject {

// ...

function Object plusGetAttribute( String name );

function Object plusSetAttribute( String name, Object value );

// ...

}

说明:Java类对象,可通过其属性获取类的常量,可通过方法来操作类的静态变量和方法,也通过new方法来创建类的实例对象。 对于类的常量,则直接通过.后面跟随常量名称调用即可。

2.1.1、方法

(1)、plusGetAttribute: 获取Java类对象的静态属性

         Object clsobj.plusGetAttribute( String name );

参数:name: ( String ) 必选 要获取的静态属性名称。如果指定的属性名称不存在,则返回null。

返回值:Object : 静态属性实例对象

示例:






Android Native.js






(2)、plusSetAttribute: 设置Java类对象的静态属性

         void clsobj.plusSetAttribute( String name, Object value );

参数:

name: ( String ) 必选 要设置的静态属性名称。如果指定的属性名称不存在,则操作不生效,不会抛出异常。

value: ( Object ) 必选 要设置的静态属性值。如果指定的属性值类型不区配,则操作不生效,不会抛出异常。

返回值:void : 无

示例:






Android Native.js






2.2、InstanceObject: Java实例对象

interface InstanceObject {

// ...

function Object plusGetAttribute( String name );

function Object plusSetAttribute( String name, Object value );

// ...

}

说明:Java实例对象,可通过其方法来操作实例的变量和方法。 注意:必须通过plusGetAttribute()方法读取实例对象的属性值,通过plusSetAttribute()方法设置实例对象的属性值。

2.2.1、方法

(1)、plusGetAttribute: 获取Java实例对象的属性

       Object insobj.plusGetAttribute( String name );

参数:name: ( String ) 必选 实例属性的名称。如果指定的属性名称不存在,则返回null。

返回值:Object : 属性的值

示例:






Android Native.js






(2)、plusSetAttribute: 设置Java实例对象的属性

  void insobj.plusSetAttribute( String name, Object value );

参数:

name: ( String ) 必选 要设置的属性名称。如果指定的属性名称不存在,则操作不生效,不会抛出异常。

value: ( Object ) 必选 要设置的属性值。如果指定的属性值类型不区配,则操作不生效,不会抛出异常。

返回值:void : 无

示例:






Android Native.js






你可能感兴趣的:(HTML5+,Native.js)