Клиентский JavaScript. Справочник

         

Аргументы


s Детальное сообщение.

filename URL файла, в котором возникла ошибка, если доступен.
lineno Номер строки файла, если доступен.

source Строка, содержащая код JavaScript.
tokenIndex Индекс символа в исходной строке, где возникла ошибка.



Call


Метод. Вызывает JavaScript-метод. Эквивалентен "this.methodName(args[0], args[1], ...)" в JavaScript.



Destroy


Метод. Вызывается при разрушении plug-in'а. Вы никогда не должны вызывать этот метод явно, он вызывается при уничтожении plug-in'а. С момента вызова этого метода plug-in будет продолжать оставаться активным.



Equals


Метод. Определяет, ссылаются ли два объекта JSObject на один и тот же экземпляр.

Переопределяет: equals в классе java.lang.Object



Eval


Метод. Вычисляет выражение JavaScript. Это выражение является строкой исходного кода JavaScript, который вычисляется в контексте "this".



Getmember


Метод. Запрашивает значение свойства объекта JavaScript. Эквивалентен "this.name" в JavaScript.



Getpeer


Метод. Возвращает внешний NPP-объект -- экземпляр plug-in'а, являющийся внешней частью Java-объекта Plugin.
Это поле устанавливается системой, но может читаться из внешних методов plug-in'а путём вызова:

NPP npp = (NPP)netscape_plugin_Plugin_getPeer(env, thisPlugin);



Getslot


Метод. Запрашивает значение элемента массива объекта JavaScript. Эквивалентен "this[index]" в JavaScript.



Getwindow


Static-метод. Возвращает JSObject для окна, содержащего данный аплет. Этот метод используется только в клиентском JavaScript.



Getwindow


Метод. Возвращает окно JavaScript, в которое plug-in внедрён.



Java-классы, конструкторы и методы


В этой главе задокументированы Java-классы, используемые в LiveConnect, и их конструкторы и методы. Это алфавитный справочник по классам, которые дают Java-объектам возможность получать доступ к коду JavaScript.

Этот справочник организован таким образом:

Полные описания всех классов расположены в алфавитном порядке. 



Init


Метод. Вызывается при инициализации plug-in'а. Вы никогда не должны вызывать этот метод явно, он вызывается при создании plug-in'а.



Isactive


Метод. Определяет, ссылается ли по-прежнему Java-отражение plug-in'а на активный plug-in. Plug-in-экземпляры уничтожаются всякий раз при оставлении страницы, содержащей plug-in, вызывая таким образом дезактивацию plug-in'а.



Jsexception


public-класс JSException расширяет Exception.

java.lang.Object
|
   +----java.lang.Throwable
            |
            +----java.lang.Exception
                     |
                     +----netscape.javascript.JSException



Jsexception


Конструктор. Конструирует JSException. Вы специфицируете, имеет ли JSException детальное сообщение и другую информацию.



Jsobject


Класс public final netscape.javascript.JSObject расширяет/extends Object.

java.lang.Object
|
   +----netscape.javascript.JSObject



Конструктор и методы. Резюме.


Класс netscape.plugin.Plugin имеет следующий конструктор:

Конструктор Описание
Plugin Конструирует Plugin.

Класс netscape.plugin.Plugin имеет следующие методы:

Метод Описание
destroy Вызывается при уничтожении plug-in'а.

getPeer Возвращает внешний NPP-объект -- экземпляр plug-in'а, являющийся внешней частью Java-объекта Plugin.

getWindow Возвращает окно JavaScript, в которое plug-in внедрён.

init Вызывается при инициализации plug-in'а.

isActive Определяет, ссылается ли по-прежнему Java-отражение plug-in'а на активный plug-in.

В следующих разделах показано объявление и использование этих конструкторов и методов.



Конструктор. Резюме.


Класс netscape.javascript.JSException имеет следующий конструктор:

КонструкторОписание
JSException Конструирует JSException. Вы специфицируете, имеет ли JSException детальное сообщение и другую информацию.

В следующих разделах показано объявление и использование конструктора.



Методы. Резюме.


Класс netscape.javascript.JSObject имеет следующие методы:

Метод Описание
call Вызывает метод JavaScript.

equals Определяет, ссылаются ли два объекта JSObject на один и тот же экземпляр.

eval Вычисляет выражение JavaScript.

getMember Возвращает значение свойства JavaScript-объекта.

getSlot Запрашивает значение элемента массива JavaScript-объекта.

removeMember Удаляет свойство JavaScript-объекта.

setMember Устанавливает значение свойства JavaScript-объекта.

setSlot Устанавливает значение элемента массива JavaScript-объекта.

toString Конвертирует JSObject в строку.

Класс netscape.javascript.JSObject имеет следующий static-метод:

Метод Описание
getWindow Получает JSObject для окна, содержащего данный аплет.

В следующих разделах разъясняется объявление и использование этих методов.



Объявление


1. public JSException()2. public JSException(String s) 3. public JSException(String s,
String filename,
   int lineno,
   String source,
   int tokenIndex)



Объявление


public Object call(String methodName, Object args[])



Объявление


public boolean equals(Object obj)



Объявление


public Object eval(String s)



Объявление


public Object getMember(String name)



Объявление


public Object getSlot(int index)



Объявление


public static JSObject getWindow(Applet applet)



Объявление


public void removeMember(String name)



Объявление


public void setMember(String name, Object value)



Объявление


public void setSlot(int index, Object value)



Объявление


public String toString()



Объявление


public void destroy()



Объявление


public int getPeer()



Объявление


public JSObject getWindow()



Объявление


public void init()



Объявление


public boolean isActive()



Объявление


public Plugin()



JSException является исключением, которое вызывается,


JSException является исключением, которое вызывается, если код JavaScript возвращает ошибку.

Детальное сообщение это строка, описывающая


Детальное сообщение это строка, описывающая данное конкретное исключение.
Каждая форма конструктора создаёт JSException с различной информацией:
Форма 1 конструирует JSException без детального сообщения. Форма  2 конструирует JSException с детальным сообщением. Форма 3 конструирует JSException с детальным сообщением и всей другой информацией, которая обычно предоставляется вместе с ошибкой JavaScript.

в Java. JSObject позволяет Java


Объекты в JavaScript оборачиваются (помещаются в оболочки) в экземпляры класса netscape.javascript.JSObject и передаются в Java. JSObject позволяет Java работать с объектами JavaScript.
Если объект из JavaScript передаётся в Java, машина выполнения создаёт Java-оболочку типа JSObject; когда JSObject пересылается из Java в JavaScript, машина выполнения снимает оболочку и разворачивает объект в объект оригинального типа JavaScript. Класс JSObject предоставляет способ вызова методов JavaScript и проверки свойств JavaScript.
Любые данные JavaScript, перенесённые в Java, конвертируются в типы данных Java. Когда JSObject передаётся обратно в JavaScript, оболочка с объекта снимается, и он может использоваться в коде JavaScript. См. в книге Клиентский JavaScript. Руководство. информацию о конвертации типов данных.

с ними, должны создавать подкласс


Этот класс представляет отражение plug-in'а в Java. Plug-ins, которым необходимы Java-методы, ассоциированные с ними, должны создавать подкласс данного класса и добавлять новые (возможно, внешние) методы. Это даёт возможность другим объектам Java (таким как аплеты и JavaScript-код) работать с plug-in'ом.

Plugin


public-класс Plugin расширяет Object.

java.lang.Object
|
   +----netscape.plugin.Plugin



Plugin


Конструктор. Конструирует Plugin.



Removemember


Метод. Удаляет свойство объекта JavaScript.



Setmember


Метод. Устанавливает значение свойства объекта JavaScript. Эквивалентен "this.name= value" в JavaScript.



Setslot


Метод. Устанавливает значение элемента массива объекта JavaScript. Эквивалентен "this[index]= value" в JavaScript.



Tostring


Метод. Конвертирует JSObject в String.

Переопределяет: toString в классе java.lang.Object