Клиентский 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'а путём вызова:
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
