спецификации, руководства, описания, API

Параметры Развертывания апплета

Java Богатое Руководство по Интернет-приложениям > Руководство разработчика апплета> Параметры Развертывания Апплета

Апплеты могут быть развернуты кодированием руки applet, object или embed теги с обязательными параметрами. Этот раздел описывает эти параметры. Однако, чтобы гарантировать перекрестную совместимость браузера, рекомендуется, чтобы Инструментарий Развертывания использовался, чтобы развернуть апплеты. Отошлите к Java Богатый Совет Развертывания Интернет-приложений для информации об использовании Инструментария Развертывания и развертывании апплетов, используя JNLP.

Следующие темы затрагиваются:

Развертывание используя JNLP
- jnlp_href
Загрузка Экрана
- boxborder
- centerimage
Параметры командной строки
- java_arguments
- separate_jvm
Выбор Версии JRE
Кэширование Загрузчика класса
- classloader_cache
Кэш Java
- cache_archive

Развертывание используя JNLP

`jnlp_href`

Файл, содержащий информацию, которую плагин должен использовать, чтобы запустить апплет.

Загрузка Экрана

Плагин Java предлагает лучшую настройку изображения, которое выводится на экран прежде, чем апплет загружается. Анимированные GIFs теперь поддерживаются как цель image параметр, как описано в Специальных Атрибутах. Дополнительно, следующие параметры поддерживаются:

`boxborder`

Загружается булев параметр, указывающий, должна ли граница с одним пикселем быть оттянута вокруг края области апплета, выводя на экран изображение, показанное перед апплетом. Значения по умолчанию к true. Мы рекомендуем установить это значение в false, в особенности при использовании анимированного ДЖИФА как загружающееся изображение, чтобы избежать возможности мерцания.

`centerimage`

Булев параметр, указывающий, должно ли загружающееся изображение центрироваться в пределах области апплета вместо того, чтобы произойти в левом верхнем углу. Значения по умолчанию к false.

Пример используя boxborder и centerimage параметры:

   <APPLET archive="large_archive.jar"
                   code="MyApplet"
                   width="300" height="300">
          <!-- Use an animated GIF as an indeterminate progress bar
                   while the applet is loading -->
          <PARAM NAME="image" VALUE="animated_gif.gif">
          <!-- Turn off the box border for better blending with the
                   surrounding web page -->
          <PARAM NAME="boxborder" VALUE="false">
          <!-- Center the image in the applet's area -->
          <PARAM NAME="centerimage" VALUE="true">
        </APPLET>

Параметры командной строки

`java_arguments`

Определяет параметры командной строки JVM, которые будут использоваться, выполняя этот экземпляр апплета. Почти все параметры командной строки JVM поддерживаются, хотя есть определенные правила и ограничения.

Примеры

Определение большего чем значение по умолчанию максимального размера "кучи":

<APPLET archive="my_applet.jar" code="MyApplet" width="300" height="300">
    <PARAM name="java_arguments" value="-Xmx128m">
</APPLET>

Определение размера "кучи" не по умолчанию и Java 2-D опция аппаратного ускорения, обычно используемая для апплетов, используя OpenGL через Привязку Java для API OpenGL (JOGL):
```
<APPLET archive="my_applet.jar" code="MyApplet" width="300" height="300">
    <PARAM name="java_arguments" value="-Xmx256m -Dsun.java2d.noddraw=true">
</APPLET>
     
```
Включение многословному выводу сборщика "мусора", и средству утверждения в языке программирования Java:
```
<APPLET archive="my_applet.jar" code="MyApplet" width="300" height="300">
    <PARAM name="java_arguments" value="-verbose:gc -ea:MyApplet">
</APPLET>
  
```

Ряд "безопасных" параметров командной строки JVM и системных свойств определяется в разделе Синтаксиса Файла JNLP Сети Java, Запускают Руководство Разработчиков. В Плагине Java, пока все параметры командной строки JVM, определенные через java_arguments параметр безопасен, тогда апплет, или любые классы, которые это загружает, может быть без знака.

Небезопасные параметры командной строки JVM (другими словами, те не в безопасном списке) могут также быть определены через java_arguments параметр. В этом случае есть потенциал для угрозы безопасности, таким образом, Плагин Java осуществляет правило, что никакие классы без знака не могут быть загружены. Другими словами только доверяемый код, для которого пользователь принял диалоговое окно безопасности, может быть загружен таким экземпляром JVM. Если попытка предпринимается, чтобы загрузить или недоверяемый class без знака в экземпляре JVM, для которого небезопасные системные свойства были определены, a ClassNotFoundException будет брошен, указывая, что данный class не мог быть загружен, потому что он не был подписан.

Есть относительно немного ограничений на то, какие параметры командной строки можно передать через java_arguments параметр. Вообще, -Xbootclasspath параметр запрещается, так же как любой параметр командной строки, используемый, чтобы определить путь, такой как -classpath или -jar. Все другие параметры командной строки, настоящее и будущее, должны поддерживаться с протестом о безопасных и небезопасных параметрах командной строки, описанных выше.

Параметры командной строки, которые передают через java_arguments параметр добавляется к любому определенному через диалоговое окно Настроек Времени выполнения Апплета Java в Панели управления Java. Параметры командной строки от панели управления используются для всех экземпляров JVM версии, для которой они определяются; java_arguments параметры не полностью заменяют их. (Диалоговое окно Настроек Времени выполнения Апплета Java было также улучшено в 6u10, чтобы лучше управлять многократными версиями JRE, и теперь имеет те же самые возможности, как диалоговое окно Настроек Времени выполнения Апплета Java, используемое для Сети Java, Запускается.)

Когда параметры командной строки JVM определяются, вероятно, что Плагин Java должен будет запустить другой экземпляр JVM, чтобы удовлетворить их. Другими словами маловероятно, что существующий ранее экземпляр JVM будет запущен с корректного набора параметров командной строки, чтобы удовлетворить запрос. Правила для точно, когда новый экземпляр JVM запускается, чтобы запустить данный апплет, сознательно оставляют неуказанными и, возможно, должны измениться в последующих выпусках. Вот грубый набор направляющих линий для совместного использования и создания новых экземпляров JVM:

Если параметры командной строки, используемые, чтобы запустить существующий ранее экземпляр JVM, будут надмножеством требуемых параметров, то существующий ранее экземпляр JVM будет использоваться.
Если экземпляр JVM запускается для набора "значения по умолчанию" параметров командной строки (то есть, определенные в Панели управления Java, без java_arguments определенный), тогда этот экземпляр JVM никогда не будет использоваться, чтобы запустить любой апплет, у которого есть даже один параметр командной строки, определенный через java_arguments.
-Xmx обрабатывается особенно: если существующий ранее экземпляр JVM был запущен с например -Xmx256m через java_arguments, и новый апплет запрашивает -Xmx128m, тогда новый апплет будет очень вероятно выполнен в существующем ранее экземпляре JVM. Другими словами, -Xmx спецификации являются соответствующими с большим чем или равным тестом.

Нет никакого способа "назвать" экземпляр JVM используемым, чтобы запустить определенный апплет и "вызвать" последующие апплеты в тот экземпляр JVM.

См. раздел по separate_jvm параметр, чтобы изолировать определенный апплет в его собственном экземпляре JVM, отделитесь от всех других апплетов.

`separate_jvm`

Булев параметр, определяющий, что определенный апплет должен работать в его собственном экземпляре JVM. Это поддерживает определенные мощные настольные апплеты, которые не могут терпеть интерференцию от других апплетов, работающих в той же самой JVM и потенциально использующих пространство "кучи" или другие ресурсы.

<APPLET archive="my_applet.jar" code="MyApplet" width="300" height="300">
    <PARAM name="java_arguments" value="...">
    <PARAM name="separate_jvm" value="true">
</APPLET>

Выбор Версии JRE

`java_version`

Определяет версию JRE, на которую можно запустить определенный апплет.

Примеры

Определение определенной версии JRE для определенного апплета:

<APPLET archive="my_applet.jar" code="MyApplet" width="300" height="300">
    <PARAM name="java_version" value="1.5.0_09">
</APPLET>

Запрос любого JRE в определенном семействе для определенного апплета:

<APPLET archive="my_applet.jar" code="MyApplet" width="300" height="300">
    <PARAM name="java_version" value="1.5*">
</APPLET>

Определение JRE от определенного семейства или любого более позднего семейства:
```
<APPLET archive="my_applet.jar" code="MyApplet" width="300" height="300">
    <PARAM name="java_version" value="1.5+">
</APPLET>
```

`classid` Атрибут в Internet Explorer

Браузер Internet Explorer использует classid атрибут <object> тег, чтобы указать, как контент того тега должен быть выведен на экран. classid атрибут может использоваться в соединении с codebase припишите автоматически загрузке и установите определенную версию JRE, если ни один не в настоящий момент доступен на системе (см. classid использование). Понятие семейства CLSID было представлено позже, чтобы обеспечить способ выбрать произвольный JRE в данном семействе. (См. Развертывающиеся Апплеты Java С семейством Версии JRE в Плагине Java для Internet Explorer для получения дополнительной информации.)

Не все classid опции, описанные в более ранней документации, работают в соединении с Плагином Java, чтобы и выбрать, и потенциально автоматически загрузить и установить, определенная версия JRE. Этот раздел описывает, какие работы в соединении с Плагином Java, и что механизмы обратной совместимости на месте.

Обратная совместимость

Чтобы ослабить переход для разработчиков, уже использующих атрибут classid, два механизма обратной совместимости были представлены: возможность использовать classid, чтобы выбрать или определенную версию JRE, или произвольный JRE в данном семействе. В обоих случаях ожидание состоит в том, что и Плагин Java, и целевая версия JRE для апплета, уже устанавливаются и конфигурируются. В соединении с этими механизмами обратной совместимости не поддерживается автозагрузка любого JRE, или тот, предоставляющий Плагин Java или тот, который будет использоваться, чтобы выполнить апплет.

Отметьте, что эти механизмы обратной совместимости могут быть удалены в будущем выпуске. Oracle рекомендует перейти существующий контент к новым механизмам, описанным ранее.

Выбор определенной версии (1.5.0_11) JRE для отдельного апплета:

  <object 
    classid="clsid:CAFEEFAC-0015-0000-0011-ABCDEFFEDCBA"
    width="200" height="200">
      <param name="code" value="MyApplet">
  </object>

Выбор последнего JRE от определенного семейства (1.5), использующего семейство CLSID:

  <object 
    classid="clsid:CAFEEFAC-0015-0000-FFFF-ABCDEFFEDCBA"
    width="200" height="200">
      <param name="code" value="MyApplet">
  </object>

Отметьте что попытки загрузить более старые версии JRE использование codebase параметр будет проигнорирован, потому что эти classids регистрируются на системе, чтобы указать на более свежие версии DLL во время процесса установки Плагина Java. Отметьте также что использование java_version параметр в соединении с этими classids не поддерживается. Определение обоих java_version параметр так же как или помехи или семейство classid приведет к неопределенному поведению.

`version` и `jpi-version` атрибуты в Mozilla Browser Family

Использование семейства браузера Mozilla MIME вводит <embed> тег, чтобы указать, как контент того тега должен быть выведен на экран. <embed> тег также поддерживает автоматическую загрузку определенной версии JRE.

Предыдущие версии Плагина Java, используемого version и jpi-version части application/x-java-applet Тип MIME, чтобы выполнить выбор версии JRE. Не все эти механизмы, описанные в более ранней документации, работают в соединении с Плагином Java, чтобы и выбрать, и потенциально автоматически загрузить и установить, определенная версия JRE. Этот раздел описывает, какие работы в соединении с Плагином Java, и что механизмы обратной совместимости на месте.

Обратная совместимость

Ослабить переход для разработчиков, уже использующих version и jpi-version части типа MIME, ограниченный уровень обратной совместимости поддерживается в Плагине Java. Определенно, version атрибут поддерживается, чтобы запросить произвольный JRE в данном семействе или любом более позднем семействе. Используя jpi-version атрибут, чтобы выбрать определенную версию JRE больше не поддерживается. Его использованию строго обескураживают, так как это может разрушить корректную работу Плагина Java.

Отметьте, что этот механизм обратной совместимости может быть удален в будущем выпуске. Oracle рекомендует перейти существующий контент к механизмам, описанным ранее.

Использовать version атрибут, чтобы потребовать 1.5 JRE или более позднего:

  <embed code="MyApplet"
    type="application/x-java-applet;version=1.5"
    width="200" height="200">
  </embed>

Отметьте что семантика version атрибут подразумевает, что вышеупомянутый тег эквивалентен использованию java_version параметр со значением 1.5+. Так как этот Плагин Java поставляется с Java SE 6 обновлений 10, который является более поздней версией чем 5.0, этот запрос версии по существу не имеет никакого эффекта.

Отметьте также то объединение version атрибут с java_version параметр не поддерживается. Определение обоих java_version параметр так же как a version атрибут приведет к неопределенному поведению.

Кэширование Загрузчика класса

`classloader_cache`

Плагин Java обеспечивает способ выбрать из использования кэша загрузчика class на апплете основанием апплета.

<APPLET archive="my_applet.jar" code="MyApplet" width="300" height="300">
    <PARAM name="classloader_cache" value="false">
</APPLET>

Значение по умолчанию classloader_cache параметр true; кэширование загрузчика class включается по умолчанию. Можно просмотреть, какие файлы, которые являются

Кэш Java

Файлы, которые Вы используете в приложениях Java, хранятся в специальной папке для быстрого выполнения позже; эту папку также вызывают кэшем Java. Подпанель Temporary Internet Files в панели General в Панели управления Java позволяет Вам просмотреть, какие файлы хранятся в кэше Java и управляют, сколько дискового пространства это может привести в рабочее состояние в Вашем компьютере.

`cache_archive`

Атрибут cache_archive содержит список файлов, которые будут кэшироваться:

<param name="cache_archive" VALUE="a.jar,b.jar,c.jar">

Как атрибут archive в теге applet, список файлов фляги в атрибуте cache_archive не содержит полный URL, но всегда загружается с codebase, определенного в embed/object тег.

Свяжитесь с Нами

Параметры Развертывания апплета

Развертывание используя JNLP

`jnlp_href`

Загрузка Экрана

`boxborder`

`centerimage`

Параметры командной строки

`java_arguments`

`separate_jvm`

Выбор Версии JRE

`java_version`

`classid` Атрибут в Internet Explorer

Рекомендуемое Использование

Обратная совместимость

`version` и `jpi-version` атрибуты в Mozilla Browser Family

Рекомендуемое Использование

Обратная совместимость

Кэширование Загрузчика класса

`classloader_cache`

Кэш Java

`cache_archive`