Spec-Zone .ru спецификации, руководства, описания, API

Содержание документации

<Содержание

Синтаксис Файла JNLP

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

• Введение
• Пример
• Элементы JNLP
  • jnlp Элемент
  • information Элемент
  • security Элемент
  • update Элемент
  • resources Элемент
  • application-desc Элемент
  • applet-desc Элемент
  • component-desc Элемент
  • installer-desc Элемент

Введение

Формат, используемый в этом выпуске, - то, который определил в Сети Java Запускающийся Протокол & версию 6.0 Спецификации (JSR-56) API. Этот документ описывает обычно используемые элементы файла JNLP. Для полного описания формата обратитесь к спецификации.

Элемент	Атрибуты	Описание	С тех пор	Необходимый
jnlp		Это - основной xml элемент для jnlp файла. Все содержится в пределах jnlp элемента.	1.0	да
	спецификация	Атрибут спецификации может быть 1.0, 1.5.0, 6.0, 6.0.10, 6.0.18, 7.0, или подстановочный знак такой как 1.0 +. Это обозначает минимальную версию Спецификации JNLP, что этот jnlp файл может работать woth.	1.0
	кодовая база	Атрибут кодовой базы определяет основное расположение для всех относительных URL, определенных в атрибутах href в файле JNLP.	1.0
	href	href определяет URL файла JNLP непосредственно.	1.0
	версия	Версия приложения, запускаемого, так же как версия файла JNLP непосредственно.	1.0
информация		Информационный элемент содержит другие элементы, которые описывают приложение, и это - источник.	1.0	да
	рот	Определяет операционные системы, для которых нужно рассмотреть этот информационный элемент.	1.5.0
	дуга	Определяет архитектуру, для которой нужно рассмотреть этот информационный элемент	1.5.0
	платформа	Определяет платформу, для которой нужно рассмотреть этот информационный элемент.	1.5.0
	локаль	Определяет локаль, для которой нужно рассмотреть этот информационный элемент.	1.5.0
заголовок		Элемент заголовка определяет заголовок приложения.	1.0	да
поставщик		Элемент поставщика определяет провайдера приложения.	1.0	да
домашняя страница		Домашняя страница приложения.	1.0
	href	URL, указывающий туда, где больше информации об этом приложении может быть найдено.	1.0	да
описание		Короткий оператор, описывающий приложение.	1.0
	вид	Индикатор относительно того, какое описание это, юридические значения, короток, короток, и подсказка.	1.0
значок		Описывает значок, который может использоваться, чтобы идентифицировать приложение для пользователя.	1.0
	href	URL, указывающий на файл значка, может быть в одном из следующих форматов: gif, jpg, png, ico.	1.0	да
	вид	Указывает на предложенное использование значка, может быть: значение по умолчанию, выбранное, отключенное, трансформация, всплеск, или ярлык.	1.0
	ширина	Может использоваться, чтобы указать на разрешение изображения.	1.0
	высота	Может использоваться, чтобы указать на разрешение изображения.	1.0
	глубина	Может использоваться, чтобы указать на разрешение изображения.	1.0
офлайн позволенный		Указывает, что это приложение может работать, когда клиентская система разъединяется от сети.	1.0
ярлык		Элемент ярлыка может использоваться, чтобы указать на предпочтение приложения интеграции настольных систем.	1.5.0
	онлайн	Может использоваться, чтобы описать предпочтение приложения созданию ярлыка, чтобы работать онлайн или офлайн.	1.5.0
	установка	Дополнительный атрибут установки может использоваться в элементе ярлыка, чтобы описать предпочтение приложения тому, чтобы быть рассмотренным "установленный". Если значение является "истиной", заявление предпочитает быть рассмотренным установленное. Значение по умолчанию атрибута установки является "ложью".	7.0
рабочий стол		Может использоваться, чтобы указать на предпочтение приложения помещению ярлыка в пользовательский рабочий стол.	1.5.0
меню		Может использоваться, чтобы указать на предпочтение приложения помещению пункта меню в пользовательские меню "Пуск".	1.5.0
	подменю	Может использоваться, чтобы указать на предпочтение приложения тому, куда поместить пункт меню.	1.5.0
ассоциация		Может использоваться, чтобы подсказать клиенту JNLP, что это хочет быть зарегистрированным в операционной системе как основной обработчик определенных расширений и определенного типа пантомимы.	1.5.0
	расширения	Содержит список расширений файла (разделенный пробелами), что приложение запрашивает, чтобы оно было зарегистрировано, чтобы обработать.	1.5.0
	тип пантомимы	Содержит тип пантомимы, что приложение запрашивает, чтобы это было зарегистрировано, чтобы обработать.	1.5.0
сходные материалы		Описывает дополнительную часть сходных материалов, которые могут быть интегрированы с приложением.	1.5.0
	href	URL, указывающий на сходные материалы.	1.5.0	да
обновление		Элемент обновления используется, чтобы указать на предпочтение тому, как обновления приложения должны быть обработаны Клиентом JNLP.	6.0
	проверить	Указывает на предпочтение тому, когда Клиент JNLP должен проверить на обновления. Это может всегда быть, тайм-аут, или фон..	6.0
	политика	Указывает на предпочтение тому, как Клиент JNLP должен обработать обновление приложения, когда известно, что обновление доступно прежде, чем приложение будет запущено. Это может всегда быть, быстрое обновление, или управляемое подсказкой.	6.0
			1.0
безопасность		Этот элемент может использоваться, чтобы запросить улучшенные полномочия.	1.0
все-полномочия		Запросы, что приложение быть выполненным со всеми полномочиями.	1.0
j2ee-application-client-permissions		Запросы, что приложение быть выполненным с набором полномочий, который встречает спецификации безопасности Клиентской среды Приложения J2EE.	1.0
			1.0
ресурсы		Описывает все ресурсы, которые необходимы для приложения.	1.0	да
	рот	Определяет операционную систему, для которой нужно рассмотреть элемент ресурсов.	1.0
	дуга	Определяет архитектуру, для которой нужно рассмотреть элемент ресурсов.	1.0
	локаль	Определяет, что локали, для которых нужно рассмотреть элемент ресурсов.
java (или j2se)		Определяет что версия (и) Java запустить приложение с.	6.0 (java)
	версия	Описывает упорядоченный список диапазонов версии, чтобы использовать.	1.0	да
	href	URL, обозначающий поставщика этой версии java, и где это может быть загружено с.	1.0
	java-vm-args	Указывает на дополнительный набор стандартных и нестандартных параметров виртуальной машины, что приложение предпочло бы, чтобы Клиент JNLP использовал, запуская Java.	1.0
	начальный размер "кучи"	Указывает на начальный размер "кучи" Java.	1.0
	максимальный размер "кучи"	Указывает на максимальный размер "кучи" Java.	1.0
фляга		Определяет файл JAR, который является частью пути к классу приложения.	1.0	да
	href	URL файла фляги.	1.0	да
	версия	Требуемая версия файла фляги. Требует использования основанного на версии протокола загрузки	1.0
	основной	Указывает, содержит ли эта фляга класс, содержащий основной метод приложения.	1.0
	загрузка	Может использоваться, чтобы указать, что эта фляга может быть загружена нетерпеливо, лениво, или для индикации продвижения.	1.0 (6.0.18)
	размер	Указывает на загружаемый размер файла фляги в байтах.	1.0
	часть	Может использоваться, чтобы собрать в группу ресурсы, таким образом, они будут загружены одновременно.	1.0
nativelib		Определяет файл JAR, который содержит собственные библиотеки в, это - корневой каталог.	1.0
	href	URL файла фляги.	1.0	да
	версия	Требуемая версия файла фляги. Требует использования основанного на версии протокола загрузки	1.0
	загрузка	Может использоваться, чтобы указать, что эта фляга может быть загружена лениво.	1.0
	размер	Указывает на загружаемый размер файла фляги в байтах.	1.0
	часть	Может использоваться, чтобы собрать в группу ресурсы, таким образом, они будут загружены одновременно.	1.0
расширение		Содержит указатель на дополнительный компонент-desc или установщик-desc, который будет использоваться с этим приложением.	1.0
	href	URL к дополнительному расширению jnlp файл.	1.0	да
	версия	Версия дополнительного расширения jnlp файл.	1.0
	имя	Имя дополнительного расширения jnlp файл	1.0
загрузка расширения		Может использоваться в элементе расширения, чтобы обозначить части, содержавшиеся в компонентном расширении.	1.0
	часть расширения	Описывает имя части, которая, как могут ожидать, будет найдена в расширении.	1.0	да
	загрузка	Может использоваться, чтобы указать, что это расширение может быть загружено нетерпеливо или лениво.	1.0
	часть	Обозначает имя части в этом jnlp файле, чтобы включать расширение в.	1.0
пакет		Может использоваться, чтобы указать Клиенту JNLP, какие пакеты реализуются в который файлы JAR.	1.0
	имя	Имя пакета содержится в файлах фляги данной части.	1.0	да
	часть	Имя части, содержащее файлы фляги, которые включают данное имя пакета.	1.0	да
	рекурсивный	Может привыкнуть к обозначенному, которым все имена пакета, начинающиеся с имени, могут быть найдены в данной части.	1.0
свойство		Определяет системное свойство, которое будет доступно через методы System.getProperty и System.getProperties.	1.0
	имя	Имя системного свойства.	1.0	да
	значение	Значение это будет установлено в.	1.0	да
			1.0
		Отметьте: jnlp файл должен содержать одно из приложения-desc, апплета-desc, компонента-desc, или установщика-desc	1.0	да
приложение-desc		Обозначает, что это - jnlp файл для приложения.	1.0
	основной класс	Имя класса, содержащего общедоступную статическую основную пустоту (Строка []) метод приложения.	1.0	да
	класс продвижения	Имя класса, содержащего реализацию DownloadServiceListener, который может использоваться, чтобы указать на продвижение загрузки.	6.0.18
параметр		Каждый параметр содержит (чтобы) дополнительный параметр, который передадут к основному.	1.0
апплет-desc		Обозначает, что это - jnlp файл для апплета.	1.0
	основной класс	Это - имя основного класса Апплета.	1.0	да
	documentbase	Основа документа для Апплета как URL.	1.0
	имя	Имя Апплета.	1.0	да
	ширина	Ширина апплета в пикселях.	1.0	да
	высота	Высота апплета в пикселях	1.0	да
	класс продвижения	Имя класса, содержащего реализацию DownloadServiceListener, который может использоваться, чтобы указать на продвижение загрузки.	6.0.18
param		Ряд параметров, которые можно передать в апплет.	1.0
	имя	Имя этого параметра	1.0	да
	значение	Значение этого параметра	1.0	да
компонент-desc		Обозначает, что это - jnlp файл для компонентного расширения.	1.0
	класс продвижения	Имя класса, содержащего реализацию DownloadServiceListener, который может использоваться, чтобы указать на продвижение загрузки.	6.0.18
установщик-desc		Обозначает, что это - jnlp файл для установленного расширения.	1.0
	основной класс	Имя класса, содержащего общедоступную статическую основную пустоту (Строка []) метод установщика.	1.0	да

Файл JNLP является XML-документом. Следующие шоу полный пример файла JNLP.

Пример

<?xml version="1.0" encoding="utf-8"?>
<!-- JNLP File for SwingSet2 Demo Application -->
<jnlp
  spec="6.0+"
  codebase="http://my_company.com/jaws/apps"
  href="swingset2.jnlp">
  <information>
    <title>SwingSet2 Demo Application</title>
    <vendor>Sun Microsystems, Inc.</vendor>
    <homepage href="docs/help.html"/>
    <description>SwingSet2 Demo Application</description>
    <description kind="short">A demo of the capabilities 
    of the Swing Graphical User Interface.</description>
    <icon href="images/swingset2.jpg"/>
    <icon kind="splash" href="images/splash.gif"/>
    <offline-allowed/> 
    <association mime-type="application-x/swingset2-file"  extensions="swingset2"/> 
    <shortcut online="false" install="false">
      <desktop/>
      <menu submenu="My Corporation Apps"/>
    </shortcut>
  </information>
  <information os="linux">   
    <title> SwingSet2 Demo on Linux </title>
    <homepage href="docs/linuxhelp.html">
  </information>
  <security>
      <all-permissions/>
  </security>
  <resources>
    <j2se version="1.6+" java-vm-args="-esa -Xnoclassgc"/>
    <jar href="lib/SwingSet2.jar"/>
  </resources>
  <application-desc main-class="SwingSet2"/>
</jnlp> 

Пример показывает основную схему документа. Корневым элементом является jnlp, у которого есть четыре подэлемента: information, security, resources, и application-desc. Кроме того, Java веб-Запуск также поддерживает запускающиеся апплеты при использовании элемента applet-desc. Элементы описываются более подробно ниже.

Элементы JNLP

jnlp Элемент

spec атрибут: Этот атрибут должен быть 1.0 или выше работать с этим выпуском. Значение по умолчанию "1.0 +". Таким образом это может обычно опускаться. Отметьте, что эта версия поддерживает и версию 1.0 спецификации, версию 1.5, и версию 6.0, тогда как предыдущие версии поддерживают только 1.0 и 1.5. jnlp определение файла spec="6.0+" будет работать с этой версией, но не предыдущими версиями Java веб-Запуск.

codebase атрибут: Все относительные URL, определенные в атрибутах href в файле JNLP, используют этот URL в качестве основы.

href атрибут: Это - URL, указывающий на расположение файла JNLP непосредственно.

information Элемент

os атрибут: Этот атрибут содержит список имен операционной системы для этого элемента. Считайте обсуждение resources элемент позже для полного обсуждения os атрибут.

title элемент: имя приложения.

vendor элемент: имя поставщика приложения.

homepage элемент: Содержит единственный атрибут, href, который является URL, определяющим местоположение домашней страницы для Приложения. Это используется Средством просмотра Кэша приложения Java, чтобы указать на пользователя на Веб-страницу, где больше информации о приложении может быть найдено.

description элемент: короткий оператор о приложении. Элементы описания являются дополнительными. Атрибут kind определяет, как описание должно использоваться. У этого может быть одно из следующих значений:

• короткий: Если ссылка на приложение соберется появиться на одной строке в списке или таблице, то это описание будет использоваться.
• короткий: Если ссылка на приложение собирается быть выведенной на экран в ситуации, где есть комната для абзаца, это описание используется.
• подсказка: Если ссылка на приложение собирается появиться в подсказке, это описание используется.

Только один элемент описания каждого вида может быть определен. Элемент описания без вида используется в качестве значения по умолчанию. Таким образом, если Java веб-Запуск нуждается в описании вида short, и это не определяется в файле JNLP, тогда текст из описания без атрибута используется.

Все описания содержат простой текст. Никакое форматирование, такой как с HTML-тэгами, не поддерживается.

icon элемент: Содержит HTTP URL к файлу образа или в ДЖИФЕ или в формате JPEG. Значки привыкли к, представляет приложение

• во время запуска, когда Java веб-Запуск представляет приложение пользователю;
• в Средстве просмотра Кэша приложения Java;
• в настольных ярлыках.

64x64 значок показывают во время загрузки; в Средстве просмотра Кэша приложения Java и в настольных ярлыках 32x32 используется значок. Java веб-Запуск автоматически изменяет размеры значка к соответствующему размеру.

Дополнительный width и атрибуты height могут использоваться, чтобы указать на размер изображений.

Дополнительный атрибут kind="splash" может использоваться в элементе значка, чтобы указать, что изображение должно использоваться в качестве экрана "всплеска" во время запуска приложения. Если файл JNLP не содержит элемент значка с kind="splash" атрибут, Java веб-Запуск создаст экран-заставку, используя другие элементы от information Элемент.

Если файл JNLP не будет содержать изображений icon, то изображение всплеска будет состоять из заголовка приложения и поставщика, как взято от файла JNLP.

В первый раз, когда приложение запускается после дополнения или модификации элемента icon в файле JNLP, старое изображение всплеска будет все еще выведено на экран. Новое изображение всплеска появится на вторых и последующих запусках приложения.

offline-allowed элемент: дополнительный элемент offline-allowed указывает, может ли приложение быть запущено офлайн.

Если офлайн позволено определяется, то приложение может быть запущено офлайн Средством просмотра Кэша приложения Java, и ярлыки могут быть созданы, которые запускают приложение офлайн.

Если приложение будет запущено офлайн, то оно не будет проверять на обновления и вызов API BasicService.isOffline() возвратится true.

Элемент offline-allowed также управляет, как Java веб-Запуск проверяет на обновление к приложению. Если элемент не определяется — то есть, приложение обязано, являются онлайновыми, чтобы работать — Java, который веб-Запуск будет всегда проверять на обновленную версию прежде, чем запустить приложение. И если обновление будет найдено, то новое приложение будет загружено и запущено. Таким образом гарантируется, что пользователь всегда выполняет последнюю версию приложения. Приложение, однако, должно быть запущено онлайн.

Если offline-allowed определяется, Java, который веб-Запуск также проверит, чтобы видеть, доступно ли обновление. Однако, если приложение будет уже загружено, то проверка будет тайм-аут после нескольких секунд, когда кэшируемое приложение будет запущено вместо этого. Учитывая разумно быстрое соединение сервера, будет обычно выполняться последняя версия приложения, но это не гарантируется. Приложение, однако, может быть запущено офлайн.

shortcut элемент: дополнительный элемент ярлыка может использоваться, чтобы указать на предпочтение приложения интеграции настольных систем. Элемент ярлыка и его подэлементы обеспечивают подсказки, что Клиент JNLP может или, возможно, не использует. Элемент ярлыка может содержать дополнительное online и install атрибуты, и два дополнительных подэлемента, desktop и menu.

association элемент: дополнительный элемент ассоциации является подсказкой клиенту JNLP, что он хочет быть зарегистрированным в операционной системе как основной обработчик определенных расширений и определенного типа пантомимы. У элемента ассоциации должны быть расширения и атрибуты типа пантомимы.

related-content элемент: дополнительный элемент сходных материалов описывает дополнительную часть сходных материалов, таких как readme файл, страницы справки, или соединяется с регистрационными страницами как подсказка Клиенту JNLP. Приложение просит, чтобы этот контент был включен в его интеграцию настольных систем. У элемента сходных материалов есть обязательный href и атрибут заголовка. Это может содержать любой из следующих двух подэлементов:

• description элемент: краткое описание сходных материалов.
• icon элемент: значок может использоваться Клиентом JNLP, чтобы идентифицировать сходные материалы для пользователя.

security Элемент

Каждое приложение, по умолчанию, запускается в ограниченной среде выполнения, подобной песочнице Апплета. Элемент безопасности может использоваться, чтобы запросить неограниченный доступ.

Если элемент all-permissions будет определен, то у приложения будет полный доступ к клиентской машине и локальной сети. Если приложение запрашивает полный доступ, то все файлы JAR должны быть подписаны. Пользователь будет запрошен принять сертификат в первый раз, когда приложение запускается.

update Элемент

Элемент обновления используется, чтобы указать на предпочтение тому, как обновления приложения должны быть обработаны Java веб-Запуск.

Элемент обновления может содержать следующие два дополнительных атрибута:

check attribute: Атрибут проверки указывает на предпочтение тому, когда Клиент JNLP должен проверить на обновления, и может иметь одно из трех значений: "всегда", "тайм-аут", и "фон"

Значение "всегда" означает всегда проверять на обновления прежде, чем запустить приложение.

Значение "тайм-аута" (значение по умолчанию) означает проверять на обновления до тайм-аута прежде, чем запустить приложение. Если проверка обновления не завершается перед тайм-аутом запускается приложение, и проверка обновления будет продолжаться в фоновом режиме.

Значение "фона" означает запускать приложение, проверяя на обновления в фоновом режиме.

policy attribute: Атрибут политики указывает на предпочтение тому, как Клиент JNLP должен обработать обновление приложения, когда известно, что обновление доступно прежде, чем приложение будет запущено, и сможет иметь одно из следующих трех значений: "всегда", "быстрое обновление", и "управляемый подсказкой"

Значение "всегда" (значения по умолчанию) означает всегда загружать обновления без любой подсказки.

Значение "быстрого обновления" означает спрашивать пользователя, если он или она хочет загрузить и выполнить обновленную версию, или запустить кэшируемую версию.

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

Например:

resources Элемент

Элемент resources используется, чтобы определить все ресурсы, такие как файлы класса Java, собственные библиотеки, и системные свойства, которые являются частью приложения. Определение ресурса может быть ограничено определенной операционной системе, архитектуре, или локали, используя os, arch, и атрибуты locale.

os атрибут содержит список имен операционной системы для ресурса. Например, Вы могли использовать многократный resources определения, с различным os атрибуты, чтобы предоставить собственную библиотеку для многократных операционных систем.

os атрибут содержит список имен операционной системы, разделенных пробелами. Во время выполнения, os значения по сравнению с началом os.name системное свойство, чтобы найти соответствие. Например, os значение атрибута "Windows" соответствует и "Windows Vista" и операционные системы "Windows 7".

Если Вы хотите перечислить операционную систему, имя которой содержит пространство, используйте наклонную черту влево, чтобы указать, что пространство является частью имени операционной системы. Следующий пример будет определенно соответствовать "Windows Vista" и "Windows 7":

    <resources os="Windows\ Vista Windows\ 7">
      <jar href="hello.jar"/>
    </resources>

resources у элемента есть шесть различных возможных подэлементов: jar, nativelib, j2se, property, package, и extension. package и элементы extension не обсуждаются в этом Руководстве разработчика. См., что Сеть Java Запускает Протокол & версию 6.0 Спецификации (JSR-56) API для деталей.

Элемент jar определяет файл JAR, который является частью пути к классу приложения. Например:

      <jar href="myjar.jar"/>

Файл jar будет загружен в JVM, используя объект ClassLoader. Файл jar будет обычно содержать классы Java, которые содержат код для определенного приложения, но могут также содержать другие ресурсы, такие как значки и конфигурационные файлы, которые доступны через механизм getResource.

Элемент nativelib определяет файл JAR, который содержит собственные библиотеки. Например:

      <nativelib href="lib/windows/corelib.jar"/>

Клиент JNLP должен гарантировать что каждая запись файла в корневом каталоге файла JAR (то есть, /) может быть загружен в рабочий процесс, используя метод System.loadLibrary. Каждая запись должна содержать зависимую от платформы совместно используемую библиотеку с корректным соглашением о присвоении имен, например, *.dll на Windows или lib*.so на Солярисе/Linux. Приложение ответственно за выполнение фактического звонка в System.loadLibrary.

Собственные библиотеки обычно включались бы в элемент resources, который приспосабливается к определенной операционной системе и архитектуре. Например:

    <resources os="SunOS" arch="sparc">
      <nativelib href="lib/solaris/corelibs.jar"/>
    </resources>

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

Атрибут download используется, чтобы управлять, загружается ли ресурс нетерпеливо, лениво, или содержит пользовательскую реализацию продвижения. Например:

   <jar href="sound.jar" download="lazy"/>
   <nativelib href="native-sound.jar" download="eager"/>
   <jar href="progress.jar" download="progress"/>

Фляга, обозначенная с загрузкой =, "продвижение" будет загружено нетерпеливо, и может использоваться, чтобы указать на продвижение, загружая другие ресурсы.

Элемент j2se определяет, какой Java (ТМ) Платформа Standard Edition Среда выполнения версии (JRE) приложение поддерживается на, так же как стандартные параметры к виртуальной машине Java. Если несколько JREs определяются, это указывает на расположенный по приоритетам список поддерживаемого JREs с самой привилегированной версией сначала. Например:

      <j2se version="1.3" initial-heap-size="64m" max-heap-size="128m"/>
      <j2se version="1.4.2+" href="http://java.sun.com/products/autodl/j2se" java-vm-args="-esa -Xnoclassgc"/>

version атрибут отсылает, по умолчанию, к версии платформы (версия спецификации) Java (ТМ) Платформу Standard Edition. В настоящий момент определенные версии платформы 1.2, 1.3, 1.4, 1.5 и 1.6. (Версия платформы не будет обычно содержать микро номер версии; например, 1.4.2.)

Точные версии продукта (версии реализации) могут также быть определены. включением href атрибут. Например, 1.3.1_07, 1.4.2, или 1.5.0-beta2 Sun Microsystems, Inc. Например,

<j2se version="1.4.2" href="http://java.sun.com/products/autodl/j2se"/

или

<j2se version="1.4.2_04" href="http://java.sun.com/products/autodl/j2se"/>

Если версия платформы определяется (то есть, нет href атрибут обеспечивается), Java, веб-Запуск не будет считать установленный не-FCS (то есть, веха) JRE как соответствие. Например, запрос формы

<j2se version="1.4+"/>

не рассмотрел бы установленный JRE с 1.4.2 бетами или с 1.4.1 землями как достойный запроса. Запускаясь с 1.3.0, JRE от Sun Microsystems, Inc., условно не-FCS (веха) JRE, если есть тире (-) в строке версии.

java-vm-args атрибут j2se элемента определяет привилегированный набор параметров виртуальной машины, чтобы использовать, запуская java.

Следующие java-vm-args поддерживаются этой версией:

 -d32,                                                          /* use a 32-bit data model if available (unix platforms only) */
 -client,                                                       /* to select the client VM */
 -server,                                                       /* to select the server VM */
 -verbose,                                                      /* enable verbose output */
 -version,                                                      /* print product version and exit */
 -showversion,                                                  /* print product version and continue */                                              
 -help,                                                         /* print this help message */
 -X,                                                            /* print help on non-standard options */
 -ea,                                                           /* enable assertions */
 -enableassertions,                                             /* enable assertions */
 -da,                                                           /* disable assertions */
 -disableassertions,                                            /* disable assertions */
 -esa,                                                          /* enable system assertions */
 -enablesystemassertions,                                       /* enable system assertions */
 -dsa,                                                          /* disable system assertione */
 -disablesystemassertions,                                      /* disable system assertione */
 -Xmixed,                                                       /* mixed mode execution (default) */
 -Xint,                                                         /* interpreted mode execution only */
 -Xnoclassgc,                                                   /* disable class garbage collection */
 -Xincgc,                                                       /* enable incremental garbage collection */
 -Xbatch,                                                       /* disable background compilation */
 -Xprof,                                                        /* output cpu profiling data */
 -Xdebug,                                                       /* enable remote debugging */
 -Xfuture,                                                      /* enable strictest checks, anticipating future default */
 -Xrs,                                                          /* reduce use of OS signals by Java/VM (see documentation) */
 -XX:+ForceTimeHighResolution,                                  /* use high resolution timer */
 -XX:-ForceTimeHighResolution,                                  /* use low resolution (default) */

Плюс любой параметр, запускающийся с одного из следующего:

-ea,                          /* enable assertions for classes */
-enableassertions,            /* enable assertions for classes */
-da,                          /* disable assertions for classes */
-disableassertions,           /* disable assertions for classes */
-verbose,                     /* enable verbose output */
-Xms,                         /* set initial Java heap size */
-Xmx,                         /* set maximum Java heap size */
-Xss,                         /* set java thread stack size */
-XX:NewRatio,                 /* set Ratio of new/old gen sizes */
-XX:NewSize,                  /* set initial size of new generation */
-XX:MaxNewSize,               /* set max size of new generation */
-XX:PermSize,                 /* set initial size of permanent gen */
-XX:MaxPermSize,              /* set max size of permanent gen */
-XX:MaxHeapFreeRatio,         /* heap free percentage (default 70) */
-XX:MinHeapFreeRatio,         /* heap free percentage (default 40) */
-XX:UseSerialGC,              /* use serial garbage collection */
-XX:ThreadStackSize,          /* thread stack size (in KB) */
-XX:MaxInlineSize,            /* set max num of bytecodes to inline */
-XX:ReservedCodeCacheSize,    /* Reserved code cache size (bytes) */
-XX:MaxDirectMemorySize,

Элемент свойства определяет системное свойство, которое будет доступно через методы System.getProperty и System.setProperties. У этого есть два необходимых атрибута: имя и значение. Например:

Набор свойств в jnlp файле будет обычно устанавливаться Java веб-Запуск после того, как VM будет запущен, но прежде, чем приложение будет вызвано. Некоторые свойства считают "безопасными" свойствами и могут быть переданы как-Dkey=value параметры на командной строке вызова java.

Следующие свойства, так же как свойства, начинающиеся с любого "javaws". или "jnlp"., считаются "безопасными" и будет передан к VM таким образом:

    sun.java2d.noddraw,
    swing.useSystemFontSettings,
    swing.metalTheme,
    http.agent,
    http.keepAlive,
    sun.awt.noerasebackground,
    sun.java2d.opengl,
    sun.java2d.d3d,
    java.awt.syncLWRequests,
    java.awt.Window.locationByPlatform,
    sun.awt.erasebackgroundonresize,
    swing.noxp,
    swing.boldMetal,
    awt.useSystemAAFontSettings,
    sun.java2d.dpiaware,
    sun.awt.disableMixing,
    sun.lang.ClassLoader.allowArraySyntax

Для недоверяемого приложения системный набор свойств в файле JNLP будет только установлен Java веб-Запуск, если их будут считать безопасными.

Для получения информации о свойствах, которые влияют на поведение Java веб-приложения Запуска, см. Свойства, Которые Влияют на Поведение Богатых Интернет-приложений.

application-desc Элемент

Элемент application указывает, что файл JNLP запускает приложение (в противоположность апплету). У элемента приложения есть дополнительный атрибут, main-class, который может использоваться, чтобы определить имя основного класса приложения, то есть, класс, который содержит метод public static void main(String argv[]), где выполнение должно начаться.

main-class атрибут может быть опущен, если первый файл JAR, определенный в файле JNLP, содержит файл манифеста, содержащий main класс.

Параметры могут быть определены к приложению включением того или более вложенных элементов argument. Например:

 <application-desc main-class="Main">
   <argument>arg1</argument>
   <argument>arg2</argument>
 </application-desc>

(Дополнительный) progress-class атрибут может использоваться, чтобы указать, что класс этого имени реализует javax.jnlp. Интерфейс DownloadServiceListener. Этот класс может быть загружен сначала и использоваться, чтобы указать на продвижение других загружаемых ресурсов и проверен.

applet-desc Элемент

У Java веб-Запуск есть поддержка запуска апплетов Java. Эта поддержка обеспечивает легкую миграцию существующего кода к Java веб-Запуск.

Апплет запускается, используя элемент applet-desc вместо элемента application-desc. Например:

 <applet-desc
     documentBase="http://..."
     name="TimePilot"
     main-class="TimePilot.TimePilotApp"
     width="527"
     height="428">
   <param name="key1" value="value1"/>
   <param name="key2" value="value2"/>
 </applet-desc>

Файлы JAR, которые составляют апплет, описываются, используя элемент resources что касается приложений. documentBase должен быть обеспечен явно, так как файл JNLP не встраивается в страницу HTML. Остальная часть атрибутов соответствует соответствующим элементам тега апплета HTML.

Атрибут main-class используется вместо атрибута code. Атрибут main-class присваивается имя класса Applet (без расширения .class). Этот атрибут может быть опущен, если класс Applet может быть найден от записи декларации Main-Class в основном файле JAR.

(Дополнительный) progress-class атрибут может использоваться, чтобы указать, что класс этого имени реализует javax.jnlp. Интерфейс DownloadServiceListener. Этот класс может быть загружен сначала и использоваться, чтобы указать на продвижение других загружаемых ресурсов и проверен.

Отметьте: Апплеты должны быть упакованы в файлах JAR, чтобы работать с Java веб-Запуск.

component-desc Элемент

Компонентный-desc элемент обозначает, что этот jnlp файл не является приложением или апплетом, а расширением, которое может использоваться в качестве ресурса в приложении, апплете или другом расширении.

Компонентное расширение обычно используется, чтобы факторизовать ряд ресурсов, которые совместно используются многократными приложениями или у которых есть отдельные потребности безопасности.

(Дополнительный) progress-class атрибут может использоваться, чтобы указать, что класс этого имени реализует javax.jnlp. Интерфейс DownloadServiceListener. Этот класс может быть загружен сначала и использоваться, чтобы указать на продвижение других загружаемых ресурсов и проверен.

installer-desc Элемент

Элемент установщика-desc обозначает, что этот jnlp файл является расширением установщика, которое определяет приложение, которое будет запущено только однажды, в первый раз, когда это расширение jnlp файл используется в приложении, апплете или другом расширении.

Расширение установщика обычно используется, чтобы установить платформу определенный собственный код, который требует более сложной установки чем простая загрузка собственной библиотеки в VM.

---

Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

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