Интерфейс BeanContextServices

Все суперинтерфейсы:: BeanContext, BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, Collection, DesignMode, EventListener, Iterable, Visibility

Все известные реализующие классы:: BeanContextServicesSupport

@Deprecated(since="23", forRemoval=true) public interface BeanContextServices extends BeanContext, BeanContextServicesListener

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Интерфейс BeanContextServices предоставляет механизм, позволяющий BeanContext предоставлять универсальные «службы» объектам BeanContextChild, входящим в него.

Краткое описание полей

Поля, объявленные в интерфейсе BeanContext

globalHierarchyLock

Модификатор и тип	Поле	Описание
`static final Object`	`globalHierarchyLock`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Эта глобальная блокировка используется как реализациями `BeanContext`, так и `BeanContextServices` для сериализации изменений в иерархии `BeanContext`, любых запросов служб и т. д.

Поля, объявленные в интерфейсе DesignMode

PROPERTYNAME

Модификатор и тип	Поле	Описание
`static final String`	`PROPERTYNAME`	Стандартное значение propertyName, передаваемое из BeanContext или другого источника событий PropertyChangeEvents.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addBeanContextServicesListener(BeanContextServicesListener bcsl)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Добавляет `BeanContextServicesListener` в этот BeanContext
`boolean`	`addService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Добавляет службу в этот BeanContext.
`Iterator<?>`	`getCurrentServiceClasses()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Получает список доступных в данный момент служб для этого контекста.
`Iterator<?>`	`getCurrentServiceSelectors(Class<?> serviceClass)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Получает список параметров службы, зависящих от службы (селекторов служб), для указанной службы, вызывая getCurrentServiceSelectors() у базового поставщика BeanContextServiceProvider.
`Object`	`getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. `BeanContextChild` или любой произвольный объект, связанный с `BeanContextChild`, может получить ссылку на зарегистрированную в данный момент службу из своего вложенного `BeanContextServices`, вызвав этот метод.
`boolean`	`hasService(Class<?> serviceClass)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Сообщает, доступна ли в данный момент указанная служба из этого контекста.
`void`	`releaseService(BeanContextChild child, Object requestor, Object service)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Освобождает ссылку `BeanContextChild` (или любого произвольного объекта, связанного с BeanContextChild) на указанную службу, вызывая releaseService() у базового `BeanContextServiceProvider`.
`void`	`removeBeanContextServicesListener(BeanContextServicesListener bcsl)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Удаляет `BeanContextServicesListener` из этого `BeanContext`
`void`	`revokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Поставщики BeanContextServiceProvider, желающие удалить зарегистрированную в данный момент службу из этого контекста, могут сделать это, вызвав данный метод.

Методы, объявленные в интерфейсе BeanContext

addBeanContextMembershipListener, getResource, getResourceAsStream, instantiateChild, removeBeanContextMembershipListener

Модификатор и тип	Метод	Описание
`void`	`addBeanContextMembershipListener(BeanContextMembershipListener bcml)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Добавляет указанный `BeanContextMembershipListener` для получения `BeanContextMembershipEvents` от этого `BeanContext` при каждом добавлении или удалении дочернего элемента `Component`(s).
`URL`	`getResource(String name, BeanContextChild bcc)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Подобно `java.lang.ClassLoader.getResource()`, этот метод позволяет реализации `BeanContext` вставлять дополнительное поведение между дочерним элементом `Component` и базовым `ClassLoader`.
`InputStream`	`getResourceAsStream(String name, BeanContextChild bcc)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Подобно `java.lang.ClassLoader.getResourceAsStream()`, этот метод позволяет реализации `BeanContext` вставлять дополнительное поведение между дочерним элементом `Component` и базовым `ClassLoader`.
`Object`	`instantiateChild(String beanName)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Создает экземпляр javaBean с указанным именем в качестве дочернего элемента этого `BeanContext`.
`void`	`removeBeanContextMembershipListener(BeanContextMembershipListener bcml)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Удаляет указанный `BeanContextMembershipListener`, чтобы он больше не получал `BeanContextMembershipEvent` при добавлении или удалении дочерних элементов `Component`(s).

Методы, объявленные в интерфейсе BeanContextChild

addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext

Модификатор и тип	Метод	Описание
`void`	`addPropertyChangeListener(String name, PropertyChangeListener pcl)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Добавляет `PropertyChangeListener` в этот `BeanContextChild` для получения `PropertyChangeEvent` при изменении указанного свойства.
`void`	`addVetoableChangeListener(String name, VetoableChangeListener vcl)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Добавляет `VetoableChangeListener` в этот `BeanContextChild` для получения событий при каждом изменении указанного свойства.
`BeanContext`	`getBeanContext()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Получает `BeanContext`, связанный с этим `BeanContextChild`.
`void`	`removePropertyChangeListener(String name, PropertyChangeListener pcl)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Удаляет `PropertyChangeListener` из этого `BeanContextChild`, чтобы он больше не получал `PropertyChangeEvents` при изменении указанного свойства.
`void`	`removeVetoableChangeListener(String name, VetoableChangeListener vcl)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Удаляет `VetoableChangeListener` из этого `BeanContextChild`, чтобы он больше не получал события при изменении указанного свойства.
`void`	`setBeanContext(BeanContext bc)`	Объекты, реализующие этот интерфейс, должны генерировать java.beans.PropertyChangeEvent со следующими параметрами: propertyName "beanContext", oldValue (предыдущий экземпляр вложенного `BeanContext` или `null`), newValue (текущий экземпляр вложенного `BeanContext` или `null`).

Методы, объявленные в интерфейсе BeanContextServiceRevokedListener

serviceRevoked

Модификатор и тип	Метод	Описание
`void`	`serviceRevoked(BeanContextServiceRevokedEvent bcsre)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Указанная служба отозвана. Запросы getService для этой службы больше не будут удовлетворяться.

Методы, объявленные в интерфейсе BeanContextServicesListener

serviceAvailable

Модификатор и тип	Метод	Описание
`void`	`serviceAvailable(BeanContextServiceAvailableEvent bcsae)`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Указанная служба зарегистрирована. Теперь можно отправлять запросы getService для этой службы.

Методы, объявленные в интерфейсе Collection

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray, toArray

Модификатор и тип	Метод	Описание
`boolean`	`add(Object e)`	Гарантирует, что эта коллекция содержит указанный элемент (необязательная операция).
`boolean`	`addAll(Collection c)`	Добавляет в эту коллекцию все элементы указанной коллекции (необязательная операция).
`void`	`clear()`	Удаляет из этой коллекции все элементы (необязательная операция).
`boolean`	`contains(Object o)`	Возвращает `true`, если эта коллекция содержит указанный элемент.
`boolean`	`containsAll(Collection c)`	Возвращает `true`, если эта коллекция содержит все элементы указанной коллекции.
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этой коллекцией на равенство.
`int`	`hashCode()`	Возвращает значение хеш-кода этой коллекции.
`boolean`	`isEmpty()`	Возвращает `true`, если эта коллекция не содержит элементов.
`Iterator`	`iterator()`	Возвращает итератор по элементам этой коллекции.
`default Stream`	`parallelStream()`	Возвращает, возможно, параллельный `Stream` с этой коллекцией в качестве источника.
`boolean`	`remove(Object o)`	Удаляет из этой коллекции один экземпляр указанного элемента, если он присутствует (необязательная операция).
`boolean`	`removeAll(Collection c)`	Удаляет из этой коллекции все элементы, которые также содержатся в указанной коллекции (необязательная операция).
`default boolean`	`removeIf(Predicate filter)`	Удаляет из этой коллекции все элементы, удовлетворяющие заданному предикату (необязательная операция).
`boolean`	`retainAll(Collection c)`	Оставляет в этой коллекции только элементы, содержащиеся в указанной коллекции (необязательная операция).
`int`	`size()`	Возвращает количество элементов в этой коллекции.
`default Spliterator`	`spliterator()`	Создает `Spliterator` для элементов этой коллекции.
`default Stream`	`stream()`	Возвращает последовательный `Stream` с этой коллекцией в качестве источника.
`Object[]`	`toArray()`	Возвращает массив, содержащий все элементы этой коллекции.
`default <T> Object[]`	`toArray(IntFunction generator)`	Возвращает массив, содержащий все элементы этой коллекции; для выделения возвращаемого массива используется предоставленная функция `generator`.
`<T> Object[]`	`toArray(Object[] a)`	Возвращает массив, содержащий все элементы этой коллекции; тип возвращаемого массива во время выполнения совпадает с типом указанного массива.

Методы, объявленные в интерфейсе DesignMode

isDesignTime, setDesignTime

Модификатор и тип	Метод	Описание
`boolean`	`isDesignTime()`	Значение true означает, что JavaBeans должны работать в режиме проектирования, а значение false — в режиме выполнения.
`void`	`setDesignTime(boolean designTime)`	Устанавливает «значение» свойства «designTime».

Методы, объявленные в интерфейсе Iterable

forEach

Модификатор и тип	Метод	Описание
`default void`	`forEach(Consumer action)`	Выполняет заданное действие для каждого элемента `Iterable`, пока не будут обработаны все элементы или действие не вызовет исключение.

Методы, объявленные в интерфейсе Visibility

avoidingGui, dontUseGui, needsGui, okToUseGui

Модификатор и тип	Метод	Описание
`boolean`	`avoidingGui()`	Определяет, избегает ли этот компонент использования графического интерфейса.
`void`	`dontUseGui()`	Этот метод указывает компоненту, что ему не следует использовать графический интерфейс.
`boolean`	`needsGui()`	Определяет, требуется ли этому компоненту графический интерфейс.
`void`	`okToUseGui()`	Этот метод указывает компоненту, что использовать графический интерфейс разрешено.

Подробное описание методов

addService

boolean addService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider)

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Добавляет службу в этот BeanContext. BeanContextServiceProviders вызывают этот метод, чтобы зарегистрировать определенную службу в данном контексте. Если служба ранее не добавлялась, BeanContextServices связывает ее с BeanContextServiceProvider и отправляет BeanContextServiceAvailableEvent всем зарегистрированным на данный момент BeanContextServicesListeners. Затем метод возвращает true, указывая на успешное добавление службы. Если указанная служба уже добавлена, этот метод просто возвращает false.

Параметры:: serviceClass — служба, которую необходимо добавить; serviceProvider — BeanContextServiceProvider, связанный со службой
Возвращает:: true, если служба успешно добавлена; в противном случае false

revokeService

void revokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow)

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Поставщики BeanContextServiceProvider, желающие удалить зарегистрированную в данный момент службу из этого контекста, могут сделать это, вызвав данный метод. При отзыве службы BeanContextServices отправляет BeanContextServiceRevokedEvent списку зарегистрированных на данный момент BeanContextServiceRevokedListeners и BeanContextServicesListeners.

Параметры:: serviceClass — служба, которую необходимо отозвать из этого BeanContextServices; serviceProvider — BeanContextServiceProvider, связанный с отзываемой службой; revokeCurrentServicesNow — значение true указывает на исключительные обстоятельства, при которых BeanContextServiceProvider или BeanContextServices требуется немедленно прекратить обслуживание всех существующих ссылок на указанную службу.

hasService

boolean hasService(Class<?> serviceClass)

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Сообщает, доступна ли в данный момент указанная служба из этого контекста.

Параметры:: serviceClass — проверяемая служба
Возвращает:: true, если служба доступна

getService

Object getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) throws TooManyListenersException

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

BeanContextChild или любой произвольный объект, связанный с BeanContextChild, может получить ссылку на зарегистрированную в данный момент службу из своего вложенного BeanContextServices, вызвав этот метод. При вызове метод получает службу, вызывая метод getService() у базового BeanContextServiceProvider.

Параметры:: child — BeanContextChild, связанный с этим запросом; requestor — объект, запрашивающий службу; serviceClass — класс запрашиваемой службы; serviceSelector — параметр, зависящий от службы; bcsrl — BeanContextServiceRevokedListener, которому следует отправить уведомление, если позднее служба будет отозвана
Возвращает:: ссылку на именованную службу этого контекста согласно запросу или null
Выбрасывает:: TooManyListenersException — если слушателей слишком много

releaseService

void releaseService(BeanContextChild child, Object requestor, Object service)

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Освобождает ссылку BeanContextChild (или любого произвольного объекта, связанного с BeanContextChild) на указанную службу, вызывая releaseService() у базового BeanContextServiceProvider.

Параметры:: child — BeanContextChild; requestor — запрашивающий объект; service — служба

getCurrentServiceClasses

Iterator<?> getCurrentServiceClasses()

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

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

Возвращает:: Iterator, содержащий доступные в данный момент службы

getCurrentServiceSelectors

Iterator<?> getCurrentServiceSelectors(Class<?> serviceClass)

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Получает список параметров службы, зависящих от службы (селекторов служб), для указанной службы, вызывая getCurrentServiceSelectors() у базового поставщика BeanContextServiceProvider.

Параметры:: serviceClass — указанная служба
Возвращает:: доступные в данный момент селекторы служб для указанного serviceClass

addBeanContextServicesListener

void addBeanContextServicesListener(BeanContextServicesListener bcsl)

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Добавляет BeanContextServicesListener в этот BeanContext

Параметры:: bcsl — BeanContextServicesListener, который необходимо добавить

removeBeanContextServicesListener

void removeBeanContextServicesListener(BeanContextServicesListener bcsl)

Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.

Удаляет BeanContextServicesListener из этого BeanContext

Параметры:: bcsl — BeanContextServicesListener, который необходимо удалить из этого контекста

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.