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

javax.enterprise.deploy.spi
Интерфейс DeploymentManager

public interface DeploymentManager

Объект DeploymentManager обеспечивает базовый набор функций, платформа EE Java должна предусмотреть развертывание приложения EE Java. Это обеспечивает соответствующую информацию сервера, такой как, список целей развертывания, и поставщик уникальная конфигурационная информация времени выполнения.

Сводка метода

DeploymentConfiguration	createConfiguration(DeployableObject dObj) Получите объект, который обеспечивает специфичную для сервера конфигурационную информацию развертывания для EE Java развертываемый компонент.
ProgressObject	distribute(Target[] targetList, java.io.File moduleArchive, java.io.File deploymentPlan) Распределять метод выполняет три задачи; это проверяет данных конфигурации развертывания, генерирует все контейнерные определенные классы и интерфейсы, и перемещает полностью испеченный архив в определяемые цели развертывания.
ProgressObject	distribute(Target[] targetList, java.io.InputStream moduleArchive, java.io.InputStream deploymentPlan) Осуждаемый. с EE Java 5, замененный distribute(Target[], ModuleType, InputStream, InputStream)
ProgressObject	distribute(Target[] targetList, ModuleType type, java.io.InputStream moduleArchive, java.io.InputStream deploymentPlan) Распределять метод выполняет три задачи; это проверяет данных конфигурации развертывания, генерирует все контейнерные определенные классы и интерфейсы, и перемещает полностью испеченный архив в определяемые цели развертывания.
TargetModuleID[]	getAvailableModules(ModuleType moduleType, Target[] targetList) Получите список всего выполнения модулей приложения EE Java или не работы идентифицированных целей.
java.util.Locale	getCurrentLocale() Возвращает активную локаль, которую выполняет эта реализация javax.enterprise.deploy.spi подпакетов.
DConfigBeanVersionType	getDConfigBeanVersion() Возвращает номер версии платформы EE Java, для которого обеспечиваются бобы конфигурации.
java.util.Locale	getDefaultLocale() Возвращает локаль значения по умолчанию, поддерживаемую этой реализацией javax.enterprise.deploy.spi подпакетов.
TargetModuleID[]	getNonRunningModules(ModuleType moduleType, Target[] targetList) Получите список модулей приложения EE Java, распределенных идентифицированным целям и которые в настоящий момент не работают на связанном сервере или серверах.
TargetModuleID[]	getRunningModules(ModuleType moduleType, Target[] targetList) Получите список модулей приложения EE Java, распределенных идентифицированным целям и которые в настоящий момент работают на связанном сервере или серверах.
java.util.Locale[]	getSupportedLocales() Возвращает массив поддерживаемых локалей для этой реализации.
Цель[]	getTargets() Получите список целей развертывания, поддерживаемых этим DeploymentManager.
boolean	isDConfigBeanVersionSupported(DConfigBeanVersionType version) Возвращает "true", если бобы конфигурации поддерживают определенную версию платформы EE Java.
boolean	isLocaleSupported(java.util.Locale locale) Отчеты, если эта реализация поддерживает определяемую локаль.
boolean	isRedeploySupported() Этот метод определяет, обеспечивает ли этот поставщик платформы функциональность повторного развертывания приложения.
ProgressObject	redeploy(TargetModuleID[] moduleIDList, java.io.File moduleArchive, java.io.File deploymentPlan) (дополнительный) повторно развернуть метод обеспечивает средство для того, чтобы оно обновило в настоящий момент развернутые приложения EE Java.
ProgressObject	redeploy(TargetModuleID[] moduleIDList, java.io.InputStream moduleArchive, java.io.InputStream deploymentPlan) (дополнительный) повторно развернуть метод обеспечивает средство для того, чтобы оно обновило в настоящий момент развернутые приложения EE Java.
void	release() Метод выпуска является механизмом, которым инструмент сигнализирует к DeploymentManager, что инструмент не нуждается в этом, чтобы продолжать работать соединенный с платформой.
void	setDConfigBeanVersion(DConfigBeanVersionType version) Установите бобы конфигурации, которые привыкнут к версии платформы EE Java specificed.
void	setLocale(java.util.Locale locale) Установите активную локаль для этой реализации javax.enterprise.deploy.spi подпакетов, чтобы работать.
ProgressObject	start(TargetModuleID[] moduleIDList) Запустите выполнение приложения.
ProgressObject	stop(TargetModuleID[] moduleIDList) Остановите выполнение приложения.
ProgressObject	undeploy(TargetModuleID[] moduleIDList) Удалите приложение из целевого сервера.

Деталь метода

getTargets

Target[] getTargets()
                    throws java.lang.IllegalStateException

Получите список целей развертывания, поддерживаемых этим DeploymentManager.

Возвраты:

Список Целевых указателей развертывания, которые пользователь может выбрать для развертывания приложения или 'нуля', если нет ни одного.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

getRunningModules

TargetModuleID[] getRunningModules(ModuleType moduleType,
                                   Target[] targetList)
                                   throws TargetException,
                                          java.lang.IllegalStateException

Получите список модулей приложения EE Java, распределенных идентифицированным целям и которые в настоящий момент работают на связанном сервере или серверах.

Параметры:

moduleType - Предопределенный указатель для типа модуля EE Java.

targetList - Список Целевых указателей развертывания пользователь хочет проверенный на модуль выполненное состояние.

Возвраты:

Массив объектов TargetModuleID, представляющих рабочие модули или 'нуль', если нет ни одного.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

TargetException - Недопустимый Целевой указатель встречался.

getNonRunningModules

TargetModuleID[] getNonRunningModules(ModuleType moduleType,
                                      Target[] targetList)
                                      throws TargetException,
                                             java.lang.IllegalStateException

Получите список модулей приложения EE Java, распределенных идентифицированным целям и которые в настоящий момент не работают на связанном сервере или серверах.

Параметры:

moduleType - Предопределенный указатель для типа модуля EE Java.

targetList - Список Целевых указателей развертывания пользователь хочет проверенный на модуль не рабочее состояние.

Возвраты:

Массив объектов TargetModuleID, представляющих нерабочие модули или 'нуль', если нет ни одного.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

TargetException - Недопустимый Целевой указатель встречался.

getAvailableModules

TargetModuleID[] getAvailableModules(ModuleType moduleType,
                                     Target[] targetList)
                                     throws TargetException,
                                            java.lang.IllegalStateException

Получите список всего выполнения модулей приложения EE Java или не работы идентифицированных целей.

Параметры:

moduleType - Предопределенный указатель для типа модуля EE Java.

targetList - Список Целевых указателей развертывания пользователь хочет проверенный на модуль не рабочее состояние.

Возвраты:

Массив объектов TargetModuleID, представляющих все развернутое выполнение модулей или не или 'нуль', если нет никаких развернутых модулей.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

TargetException - Недопустимый Целевой указатель встречался.

createConfiguration

DeploymentConfiguration createConfiguration(DeployableObject dObj)
                                            throws InvalidModuleException

Получите объект, который обеспечивает специфичную для сервера конфигурационную информацию развертывания для EE Java развертываемый компонент.

Параметры:

dObj - Объект, представляющий EE Java развертываемый компонент.

Броски:

InvalidModuleException - DeployableObject является неизвестным компонентом или компонентом неподдержки для этого инструмента конфигурирования.

распределить

ProgressObject distribute(Target[] targetList,
                          java.io.File moduleArchive,
                          java.io.File deploymentPlan)
                          throws java.lang.IllegalStateException

Распределять метод выполняет три задачи; это проверяет данных конфигурации развертывания, генерирует все контейнерные определенные классы и интерфейсы, и перемещает полностью испеченный архив в определяемые цели развертывания.

Параметры:

targetList - Список целей сервера пользователь определяет это приложение быть развернутым к.

moduleArchive - Имя файла приложения архивирует, чтобы быть disrtibuted.

deploymentPlan - XML-файл, содержащий конфигурационную информацию времени выполнения, связался с этим архивом приложения.

Возвраты:

ProgressObject объект, который отслеживает и сообщает о состоянии процесса дистрибуции.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

распределить

ProgressObject distribute(Target[] targetList,
                          java.io.InputStream moduleArchive,
                          java.io.InputStream deploymentPlan)
                          throws java.lang.IllegalStateException

Осуждаемый. с EE Java 5, замененный distribute(Target[], ModuleType, InputStream, InputStream)

Распределять метод выполняет три задачи; это проверяет данных конфигурации развертывания, генерирует все контейнерные определенные классы и интерфейсы, и перемещает полностью испеченный архив в определяемые цели развертывания.

Параметры:

targetList - Список целей сервера пользователь определяет это приложение быть развернутым к.

moduleArchive - Входной поток, содержащий приложение, архивирует, чтобы быть disrtibuted.

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

Возвраты:

ProgressObject объект, который отслеживает и сообщает о состоянии процесса дистрибуции.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

распределить

ProgressObject distribute(Target[] targetList,
                          ModuleType type,
                          java.io.InputStream moduleArchive,
                          java.io.InputStream deploymentPlan)
                          throws java.lang.IllegalStateException

Распределять метод выполняет три задачи; это проверяет данных конфигурации развертывания, генерирует все контейнерные определенные классы и интерфейсы, и перемещает полностью испеченный архив в определяемые цели развертывания.

Параметры:

targetList - Список целей сервера пользователь определяет это приложение быть развернутым к.

moduleType - Тип модуля этого архива приложения.

moduleArchive - Входной поток, содержащий приложение, архивирует, чтобы быть disrtibuted.

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

Возвраты:

ProgressObject объект, который отслеживает и сообщает о состоянии процесса дистрибуции.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

запустить

ProgressObject start(TargetModuleID[] moduleIDList)
                     throws java.lang.IllegalStateException

Запустите выполнение приложения.

Только TargetModuleIDs, которые представляют корневой модуль, допустимы для того, чтобы быть запущенными. У корневого TargetModuleID нет никакого родителя. TargetModuleID с родителем не может быть индивидуально запущен. Будут запущены корневой модуль TargetModuleID и все его дочерние модули.

Параметры:

moduleIDList - Массив объектов TargetModuleID, представляющих модули, которые будут запущены.

Возвраты:

ProgressObject объект, который отслеживает и сообщает о состоянии работы запуска.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

остановиться

ProgressObject stop(TargetModuleID[] moduleIDList)
                    throws java.lang.IllegalStateException

Остановите выполнение приложения.

Только TargetModuleIDs, которые представляют корневой модуль, допустимы для того, чтобы быть остановленными. У корневого TargetModuleID нет никакого родителя. TargetModuleID с родителем не может быть индивидуально остановлен. Будут остановлены корневой модуль TargetModuleID и все его дочерние модули.

Параметры:

moduleIDList - Массив объектов TargetModuleID, представляющих модули, которые будут остановлены.

Возвраты:

ProgressObject объект, который отслеживает и сообщает о состоянии работы остановки.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

неразвернуться

ProgressObject undeploy(TargetModuleID[] moduleIDList)
                        throws java.lang.IllegalStateException

Удалите приложение из целевого сервера.

Только TargetModuleIDs, которые представляют корневой модуль, допустимы для неразвертывания. У корневого TargetModuleID нет никакого родителя. TargetModuleID с родителем не может быть неразвернут. Будут неразвернуты корневой модуль TargetModuleID и все его дочерние модули. Корневой модуль TargetModuleID и все его дочерние модули должны, остановился прежде, чем они смогут быть неразвернуты.

Параметры:

moduleIDList - Массив объектов TargetModuleID, представляющих корневые модули, которые будут остановлены.

Возвраты:

ProgressObject объект, который отслеживает и сообщает о состоянии работы остановки.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

isRedeploySupported

boolean isRedeploySupported()

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

Возвраты:

Значение истинного повторного развертывания средств поддерживается DeploymentManager этого поставщика. Ложь означает, что это не.

повторно развернуться

ProgressObject redeploy(TargetModuleID[] moduleIDList,
                        java.io.File moduleArchive,
                        java.io.File deploymentPlan)
                        throws java.lang.UnsupportedOperationException,
                               java.lang.IllegalStateException

(дополнительный) повторно развернуть метод обеспечивает средство для того, чтобы оно обновило в настоящий момент развернутые приложения EE Java. Это - дополнительный метод для реализации поставщика. Повторно разверните замены в настоящий момент развернутое приложение с обновленной версией. Конфигурационная информация времени выполнения для обновленного приложения должна остаться идентичной приложению, которое это обновляет. Когда обновление приложения повторно развертывается, все существующие клиентские соединения с исходным рабочим приложением не должны быть разрушены; новые клиенты соединятся с обновлением приложения. Эта работа допустима для TargetModuleIDs, которые представляют корневой модуль. У корневого TargetModuleID нет никакого родителя. Корневой модуль TargetModuleID и все его дочерние модули будут повторно развернуты. Модуль дочернего элемента Тарджетмодулеида не может быть индивидуально повторно развернут. Повторно развернуть работа полна только, когда это действие для всех модулей завершилось.

Параметры:

moduleIDList - Массив указателей приложений, которые будут обновлены.

moduleArchive - Имя файла приложения архивирует, чтобы быть disrtibuted.

deploymentPlan - Конфигурационная информация развертывания связалась с этим архивом приложения.

Возвраты:

ProgressObject объект, который отслеживает и сообщает о состоянии повторно развернуть работы.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

java.lang.UnsupportedOperationException - эта дополнительная команда не поддерживается этой реализацией.

повторно развернуться

ProgressObject redeploy(TargetModuleID[] moduleIDList,
                        java.io.InputStream moduleArchive,
                        java.io.InputStream deploymentPlan)
                        throws java.lang.UnsupportedOperationException,
                               java.lang.IllegalStateException

(дополнительный) повторно развернуть метод обеспечивает средство для того, чтобы оно обновило в настоящий момент развернутые приложения EE Java. Это - дополнительный метод для реализации поставщика. Повторно разверните замены в настоящий момент развернутое приложение с обновленной версией. Конфигурационная информация времени выполнения для обновленного приложения должна остаться идентичной приложению, которое это обновляет. Когда обновление приложения повторно развертывается, все существующие клиентские соединения с исходным рабочим приложением не должны быть разрушены; новые клиенты соединятся с обновлением приложения. Эта работа допустима для TargetModuleIDs, которые представляют корневой модуль. У корневого TargetModuleID нет никакого родителя. Корневой модуль TargetModuleID и все его дочерние модули будут повторно развернуты. Модуль дочернего элемента Тарджетмодулеида не может быть индивидуально повторно развернут. Повторно развернуть работа полна только, когда это действие для всех модулей завершилось.

Параметры:

moduleIDList - Массив указателей приложений, которые будут обновлены.

moduleArchive - Входной поток, содержащий приложение, архивирует, чтобы быть disrtibuted.

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

Возвраты:

ProgressObject объект, который отслеживает и сообщает о состоянии повторно развернуть работы.

Броски:

IllegalStateException - бросается, когда метод вызывают, работая в разъединенном режиме.

java.lang.UnsupportedOperationException - эта дополнительная команда не поддерживается этой реализацией.

выпуск

void release()

Метод выпуска является механизмом, которым инструмент сигнализирует к DeploymentManager, что инструмент не нуждается в этом, чтобы продолжать работать соединенный с платформой. Инструмент может сигнализировать, что хочет работать в разъединенном режиме, или он планирует к завершению работы. Когда выпуск вызывают, DeploymentManager может закрыть любые соединения ресурса EE Java, которые это имело для конфигурации развертывания, и выполните другую уборку связанного ресурса. Это не должно принять новые запросы работы (то есть, распределить, запустить остановку, неразвернуться, повторно развернуться. Это должно закончить любые операции, которые находятся в настоящий момент в процессе. Каждый ProgressObject, связанный с рабочей работой, должен быть отмечен как выпущено (см. ProgressObject).

getDefaultLocale

java.util.Locale getDefaultLocale()

Возвращает локаль значения по умолчанию, поддерживаемую этой реализацией javax.enterprise.deploy.spi подпакетов.

Возвраты:

Локаль локаль значения по умолчанию для этой реализации.

getCurrentLocale

java.util.Locale getCurrentLocale()

Возвращает активную локаль, которую выполняет эта реализация javax.enterprise.deploy.spi подпакетов.

Возвраты:

Локаль активная локаль этой реализации.

setLocale

void setLocale(java.util.Locale locale)
               throws java.lang.UnsupportedOperationException

Установите активную локаль для этой реализации javax.enterprise.deploy.spi подпакетов, чтобы работать.

Броски:

java.lang.UnsupportedOperationException - обеспечить локаль не поддерживается.

getSupportedLocales

java.util.Locale[] getSupportedLocales()

Возвращает массив поддерживаемых локалей для этой реализации.

Возвраты:

Локаль [] список поддерживаемых локалей.

isLocaleSupported

boolean isLocaleSupported(java.util.Locale locale)

Отчеты, если эта реализация поддерживает определяемую локаль.

Возвраты:

Значение 'истины' означает, что это - поддержка и 'ложь', которая это не.

getDConfigBeanVersion

DConfigBeanVersionType getDConfigBeanVersion()

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

Возвраты:

представление объекта DConfigBeanVersionType номера версии платформы, для которого обеспечиваются эти бобы.

isDConfigBeanVersionSupported

boolean isDConfigBeanVersionSupported(DConfigBeanVersionType version)

Возвращает "true", если бобы конфигурации поддерживают определенную версию платформы EE Java. Это возвращает "false", если версия не поддерживается.

Параметры:

version - представление объекта DConfigBeanVersionType версии платформы EE Java, на которую требуют поддержку.

Возвраты:

'истина', если версия поддерживается и 'ложь если нет.

setDConfigBeanVersion

void setDConfigBeanVersion(DConfigBeanVersionType version)
                           throws DConfigBeanVersionUnsupportedException

Установите бобы конфигурации, которые привыкнут к версии платформы EE Java specificed.

Параметры:

version - представление объекта DConfigBeanVersionType версии платформы EE Java, на которую требуют поддержку.

Броски:

DConfigBeanVersionUnsupportedException - когда требуемая бобовая версия не поддерживается.