RelationService (Платформа Java SE 7)

java.lang. Объект
- javax.management.NotificationBroadcasterSupport
- - javax.management.relation.RelationService

Все Реализованные Интерфейсы:

EventListener, MBeanRegistration, NotificationBroadcaster, NotificationEmitter, NotificationListener, RelationServiceMBean
```
public class RelationService
extends NotificationBroadcasterSupport
implements RelationServiceMBean, MBeanRegistration, NotificationListener
```
Служба Отношения отвечает за создание и удаление типов отношения и отношений за обработку непротиворечивости и обеспечения механизмов запроса.
Это реализует NotificationBroadcaster, расширяя NotificationBroadcasterSupport, чтобы отправить уведомления, когда отношение удаляется из этого.
Это реализует интерфейс NotificationListener, чтобы быть в состоянии получить уведомления относительно нерегистрации MBeans, на который ссылаются в ролях отношения и отношения MBeans.
Это реализует интерфейс MBeanRegistration, чтобы быть в состоянии получить его ObjectName и Сервер MBean.

С тех пор:

1.5

Сводка конструктора

Конструкторы
Конструктор и Описание

RelationService(boolean immediatePurgeFlag)
Конструктор.

Конструкторы
Конструктор и Описание
`RelationService(boolean immediatePurgeFlag)` Конструктор.

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

Методы
Модификатор и Тип	Метод и Описание
`void`	`addRelation(ObjectName relationObjectName)` Добавляет MBean, создаваемый пользователем (и зарегистрированный им в Сервере MBean) как отношение в Службе Отношения.
`void`	`addRelationType(RelationType relationTypeObj)` Добавляет данный объект как тип отношения.
`Целое число`	`checkRoleReading(String roleName, String relationTypeName)` Проверки, если данный Роль может быть считан в отношении данного типа.
`Целое число`	`checkRoleWriting(Role role, String relationTypeName, Boolean initFlag)` Проверки, если данный Роль может быть установлен в отношении данного типа.
`void`	`createRelation(String relationId, String relationTypeName, RoleList roleList)` Создает простое отношение (представленный объектом RelationSupport) данного типа отношения, и добавляет это в Службе Отношения.
`void`	`createRelationType(String relationTypeName, RoleInfo[] roleInfoArray)` Создает тип отношения (объект RelationTypeSupport) с данной ролью infos (обеспеченный объектами RoleInfo), и добавляет это в Службе Отношения.
`Map<ObjectName,List<String>>`	`findAssociatedMBeans(ObjectName mbeanName, String relationTypeName, String roleName)` Получает MBeans, связанный с данным в отношении.
`Map<String,List<String>>`	`findReferencingRelations(ObjectName mbeanName, String relationTypeName, String roleName)` Получает отношения, где на данный MBean ссылаются.
`List<String>`	`findRelationsOfType(String relationTypeName)` Возвращает идентификаторы отношения для отношений данного типа.
`List<String>`	`getAllRelationIds()` Возвраты все идентификаторы отношения для всех отношений обрабатываются Службой Отношения.
`List<String>`	`getAllRelationTypeNames()` Получает имена всех известных типов отношения.
`RoleResult`	`getAllRoles(String relationId)` Возвраты все роли, существующие в отношении.
`MBeanNotificationInfo[]`	`getNotificationInfo()` Возвращает объект NotificationInfo, содержащий имя класса Java уведомления и отправленных типов уведомления.
`boolean`	`getPurgeFlag()` Возвращает флаг, чтобы указать, должна ли, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении, если непосредственная "чистка" отношений (ищут больше не действительные отношения) быть выполнена, или если это будет выполняться только, когда purgeRelations метод явно вызовут.
`Map<ObjectName,List<String>>`	`getReferencedMBeans(String relationId)` Получает MBeans, на который ссылаются в различных ролях отношения.
`Строка`	`getRelationTypeName(String relationId)` Имя возвратов связанного отношения вводит для данного отношения.
`List<ObjectName>`	`getRole(String relationId, String roleName)` Получает ролевое значение для данного ролевого имени в данном отношении.
`Целое число`	`getRoleCardinality(String relationId, String roleName)` Получает число MBeans, на который в настоящий момент ссылаются в данной роли.
`RoleInfo`	`getRoleInfo(String relationTypeName, String roleInfoName)` Получает ролевую информацию для данного ролевого имени данного типа отношения.
`List<RoleInfo>`	`getRoleInfos(String relationTypeName)` Получает список роли infos (объекты RoleInfo) данного типа отношения.
`RoleResult`	`getRoles(String relationId, String[] roleNameArray)` Получает значения ролей с именами в данном отношении.
`void`	`handleNotification(Notification notif, Object handback)` Вызванный, когда уведомление JMX происходит.
`Булевская переменная`	`hasRelation(String relationId)` Проверки, если есть отношение, идентифицированное в Службе Отношения с данным идентификатором отношения.
`void`	`isActive()` Проверки, если Служба Отношения является активной.
`Строка`	`isRelation(ObjectName objectName)` Возвращает идентификатор отношения, связанный с данным ObjectName, если MBean был добавлен как отношение в Службе Отношения.
`ObjectName`	`isRelationMBean(String relationId)` Если отношение представляется MBean (создаваемый пользователем, и добавил как отношение в Службе Отношения), возвращает ObjectName MBean.
`void`	`postDeregister()` Позволяет MBean выполнять любые операции, необходимые будучи незарегистрированным в сервере MBean.
`void`	`postRegister(Boolean registrationDone)` Позволяет MBean выполнять любые операции, необходимые, будучи зарегистрированным в сервере MBean или после того, как регистрация перестала работать.
`void`	`preDeregister()` Позволяет MBean выполнять любые операции, в которых он нуждается перед стать незарегистрированным сервером MBean.
`ObjectName`	`preRegister(MBeanServer server, ObjectName name)` Позволяет MBean выполнять любые операции, в которых он нуждается прежде, чем быть зарегистрированным в Сервере MBean.
`void`	`purgeRelations()` Производит чистку отношений.
`void`	`removeRelation(String relationId)` Удаляет данное отношение из Службы Отношения.
`void`	`removeRelationType(String relationTypeName)` Удаляет данный тип отношения из Службы Отношения.
`void`	`sendRelationCreationNotification(String relationId)` Отправляет уведомление (RelationNotification) за созданием отношения.
`void`	`sendRelationRemovalNotification(String relationId, List<ObjectName> unregMBeanList)` Отправляет уведомление (RelationNotification) за удалением отношения.
`void`	`sendRoleUpdateNotification(String relationId, Role newRole, List<ObjectName> oldValue)` Отправляет уведомление (RelationNotification) за ролевым обновлением в данном отношении.
`void`	`setPurgeFlag(boolean purgeFlag)` Устанавливает флаг, чтобы указать, должна ли, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении, если непосредственная "чистка" отношений (ищут больше не действительные отношения) быть выполнена, или если это будет выполняться только, когда purgeRelations метод явно вызовут.
`void`	`setRole(String relationId, Role role)` Устанавливает данную роль в данном отношении.
`RoleResult`	`setRoles(String relationId, RoleList roleList)` Устанавливает данные роли в данном отношении.
`void`	`updateRoleMap(String relationId, Role newRole, List<ObjectName> oldValue)` Обновление дескрипторов роли Службы Отношения отображается для обновления данной роли в данном отношении.

Методы, унаследованные от класса javax.management.NotificationBroadcasterSupport
addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - RelationService
```
public RelationService(boolean immediatePurgeFlag)
```
    Конструктор.
    
    Параметры:
    immediatePurgeFlag - флаг, чтобы указать, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении, если непосредственная "чистка" отношений (ищут больше не действительные отношения) должна быть выполнена, или если это будет выполняться только, когда purgeRelations метод явно вызовут.
    истина является непосредственной чисткой.
- Деталь метода
  - isActive
```
public void isActive()
              throws RelationServiceNotRegisteredException
```
    Проверки, если Служба Отношения является активной. Текущее положение состоит в том, что Служба Отношения должна быть зарегистрирована в Сервере MBean
    
    Определенный:
    
    isActive в интерфейсе RelationServiceMBean
    
    Броски:
    
    RelationServiceNotRegisteredException - если это не регистрируется
  - предварительный регистр
```
public ObjectName preRegister(MBeanServer server,
                     ObjectName name)
                       throws Exception
```
    Описание скопировало с интерфейса: MBeanRegistration
    
    Позволяет MBean выполнять любые операции, в которых он нуждается прежде, чем быть зарегистрированным в Сервере MBean. Если имя MBean не определяется, MBean может обеспечить имя для своей регистрации. Если какое-либо исключение будет повышено, то MBean не будет зарегистрирован в Сервере MBean.
    
    Определенный:
    
    preRegister в интерфейсе MBeanRegistration
    
    Параметры:
    server - Сервер MBean, в котором будет зарегистрирован MBean.
    name - Имя объекта MBean. Это имя является нулем если параметр имени к одному из createMBean или registerMBean методы в MBeanServer интерфейс является нулем. В этом случае этот метод должен возвратить ненулевой ObjectName для нового MBean.
    
    Возвраты:
    Имя, под которым должен быть зарегистрирован MBean. Это значение не должно быть нулем. Если name параметр не является нулем, он обычно будет, но не обязательно быть возвращенным значением.
    
    Броски:
    
    Exception - Это исключение будет поймано Сервером MBean и повторно брошено как MBeanRegistrationException.
  - пострегистр
```
public void postRegister(Boolean registrationDone)
```
    Описание скопировало с интерфейса: MBeanRegistration
    
    Позволяет MBean выполнять любые операции, необходимые, будучи зарегистрированным в сервере MBean или после того, как регистрация перестала работать.
    Если реализация этого метода бросает a RuntimeException или Error, Сервер MBean повторно бросит тех внутри a RuntimeMBeanException или RuntimeErrorException, соответственно. Однако, выдавая исключение в postRegister не будет изменять состояние MBean: если MBean был уже зарегистрирован (registrationDone true), MBean останется зарегистрированным.
    
    Это могло бы сбить с толку вызов кода createMBean() или registerMBean(), как таковой кодируют, мог бы предположить, что регистрация MBean перестала работать, когда такое исключение повышается. Поэтому этому рекомендуют это реализации postRegister не бросайте Исключения на этапе выполнения или Ошибки, если этого можно избежать.
    
    Определенный:
    
    postRegister в интерфейсе MBeanRegistration
    
    Параметры:
    registrationDone - Указывает, был ли MBean успешно зарегистрирован в сервере MBean. Ложь значения означает, что регистрационная фаза перестала работать.
  - предварительно вычеркнуть из списка
```
public void preDeregister()
                   throws Exception
```
    Описание скопировало с интерфейса: MBeanRegistration
    
    Позволяет MBean выполнять любые операции, в которых он нуждается перед стать незарегистрированным сервером MBean.
    
    Определенный:
    
    preDeregister в интерфейсе MBeanRegistration
    
    Броски:
    
    Exception - Это исключение будет поймано сервером MBean и повторно брошено как MBeanRegistrationException.
  - поствычеркнуть из списка
```
public void postDeregister()
```
    Описание скопировало с интерфейса: MBeanRegistration
    
    Позволяет MBean выполнять любые операции, необходимые будучи незарегистрированным в сервере MBean.
    Если реализация этого метода бросает a RuntimeException или Error, Сервер MBean повторно бросит тех внутри a RuntimeMBeanException или RuntimeErrorException, соответственно. Однако, выдавая исключение в postDeregister не будет изменять состояние MBean: MBean был уже успешно вычеркнут из списка и останется так.
    
    Это могло бы сбить с толку вызов кода unregisterMBean(), поскольку это могло бы предположить, что MBean deregistration перестал работать. Поэтому этому рекомендуют это реализации postDeregister не бросайте Исключения на этапе выполнения или Ошибки, если этого можно избежать.
    
    Определенный:
    
    postDeregister в интерфейсе MBeanRegistration
  - getPurgeFlag
```
public boolean getPurgeFlag()
```
    Возвращает флаг, чтобы указать, должна ли, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении, если непосредственная "чистка" отношений (ищут больше не действительные отношения) быть выполнена, или если это будет выполняться только, когда purgeRelations метод явно вызовут.
    истина является непосредственной чисткой.
    
    Определенный:
    
    getPurgeFlag в интерфейсе RelationServiceMBean
    
    Возвраты:
    истина, если чистки являются автоматическими.
    См. Также:
    setPurgeFlag(boolean)
  - setPurgeFlag
```
public void setPurgeFlag(boolean purgeFlag)
```
    Устанавливает флаг, чтобы указать, должна ли, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении, если непосредственная "чистка" отношений (ищут больше не действительные отношения) быть выполнена, или если это будет выполняться только, когда purgeRelations метод явно вызовут.
    истина является непосредственной чисткой.
    
    Определенный:
    
    setPurgeFlag в интерфейсе RelationServiceMBean
    
    Параметры:
    purgeFlag - флаг
    См. Также:
    getPurgeFlag()
  - createRelationType
```
public void createRelationType(String relationTypeName,
                      RoleInfo[] roleInfoArray)
                        throws IllegalArgumentException,
                               InvalidRelationTypeException
```
    Создает тип отношения (объект RelationTypeSupport) с данной ролью infos (обеспеченный объектами RoleInfo), и добавляет это в Службе Отношения.
    
    Определенный:
    
    createRelationType в интерфейсе RelationServiceMBean
    
    Параметры:
    relationTypeName - имя типа отношения
    roleInfoArray - массив роли infos
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    InvalidRelationTypeException - Если:
    - уже есть тип отношения с тем именем
    - то же самое имя использовалось для двух различных ролей infos
    - никакая ролевая информация не обеспечила
    - одна нулевая ролевая информация обеспечила
  - addRelationType
```
public void addRelationType(RelationType relationTypeObj)
                     throws IllegalArgumentException,
                            InvalidRelationTypeException
```
    Добавляет данный объект как тип отношения. Объект, как ожидают, реализует интерфейс RelationType.
    
    Определенный:
    
    addRelationType в интерфейсе RelationServiceMBean
    
    Параметры:
    relationTypeObj - объект типа отношения (реализация интерфейса RelationType)
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр или если relationTypeObj.getRelationTypeName() нуль возвратов.
    
    InvalidRelationTypeException - если:
    - то же самое имя использовалось для двух различных ролей
    - никакая ролевая информация не обеспечила
    - одна нулевая ролевая информация обеспечила
    - уже есть тип отношения с тем именем
  - getAllRelationTypeNames
```
public List<String> getAllRelationTypeNames()
```
    Получает имена всех известных типов отношения.
    
    Определенный:
    
    getAllRelationTypeNames в интерфейсе RelationServiceMBean
    
    Возвраты:
    ArrayList имен типов отношения (Строки)
  - getRoleInfos
```
public List<RoleInfo> getRoleInfos(String relationTypeName)
                            throws IllegalArgumentException,
                                   RelationTypeNotFoundException
```
    Получает список роли infos (объекты RoleInfo) данного типа отношения.
    
    Определенный:
    
    getRoleInfos в интерфейсе RelationServiceMBean
    
    Параметры:
    relationTypeName - имя типа отношения
    
    Возвраты:
    ArrayList RoleInfo.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если нет никакого типа отношения с тем именем.
  - getRoleInfo
```
public RoleInfo getRoleInfo(String relationTypeName,
                   String roleInfoName)
                     throws IllegalArgumentException,
                            RelationTypeNotFoundException,
                            RoleInfoNotFoundException
```
    Получает ролевую информацию для данного ролевого имени данного типа отношения.
    
    Определенный:
    
    getRoleInfo в интерфейсе RelationServiceMBean
    
    Параметры:
    relationTypeName - имя типа отношения
    roleInfoName - имя роли
    
    Возвраты:
    Объект RoleInfo.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если тип отношения не известен в Службе Отношения
    
    RoleInfoNotFoundException - если роль не является частью типа отношения.
  - removeRelationType
```
public void removeRelationType(String relationTypeName)
                        throws RelationServiceNotRegisteredException,
                               IllegalArgumentException,
                               RelationTypeNotFoundException
```
    Удаляет данный тип отношения из Службы Отношения.
    Объекты отношения того типа будут удалены из Службы Отношения.
    
    Определенный:
    
    removeRelationType в интерфейсе RelationServiceMBean
    
    Параметры:
    relationTypeName - имя отношения вводит, чтобы быть удаленным
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - Если нет никакого типа отношения с тем именем
  - createRelation
```
public void createRelation(String relationId,
                  String relationTypeName,
                  RoleList roleList)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RoleNotFoundException,
                           InvalidRelationIdException,
                           RelationTypeNotFoundException,
                           InvalidRoleValueException
```
    Создает простое отношение (представленный объектом RelationSupport) данного типа отношения, и добавляет это в Службе Отношения.
    Роли инициализируются согласно ролевому списку, обеспеченному в параметре. Те не инициализированные таким образом устанавливаются в пустой ArrayList ObjectNames.
    RelationNotification, с типом RELATION_BASIC_CREATION, отправляется.
    
    Определенный:
    
    createRelation в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения, чтобы идентифицировать уникально отношение в Службе Отношения
    relationTypeName - имя типа отношения (должен быть создан в Службе Отношения),
    roleList - ролевой список, чтобы инициализировать роли отношения (может быть нуль).
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр, кроме ролевого списка, который может быть нулем если никакая ролевая инициализация
    
    RoleNotFoundException - если значение обеспечивается для роли, которая не существует в типе отношения
    
    InvalidRelationIdException - если идентификатор отношения уже используется
    
    RelationTypeNotFoundException - если тип отношения, не известный в Службе Отношения
    
    InvalidRoleValueException - если:
    - то же самое ролевое имя используется для двух различных ролей
    - число MBeans, на который ссылаются, в данном значении менее чем ожидается минимальный градус
    - число MBeans, на который ссылаются, в обеспеченном значении превышает ожидаемый максимальный градус
    - один ссылался на MBean в значении, не Объект класса MBean, ожидаемого для той роли
    - MBean, предусмотренный та роль, не существует
  - addRelation
```
public void addRelation(ObjectName relationObjectName)
                 throws IllegalArgumentException,
                        RelationServiceNotRegisteredException,
                        NoSuchMethodException,
                        InvalidRelationIdException,
                        InstanceNotFoundException,
                        InvalidRelationServiceException,
                        RelationTypeNotFoundException,
                        RoleNotFoundException,
                        InvalidRoleValueException
```
    Добавляет MBean, создаваемый пользователем (и зарегистрированный им в Сервере MBean) как отношение в Службе Отношения.
    Чтобы быть добавленным как отношение, MBean должен соответствовать следующему:
    - реализуйте интерфейс Отношения
    - имейте для RelationService ObjectName ObjectName текущей Службы Отношения
    - имейте идентификатор отношения, уникальный и неиспользованный в текущей Службе Отношения
    - имейте для типа отношения тип отношения, создаваемый в Службе Отношения
    - имейте роли, соответствующие ролевой информации, обеспеченной в типе отношения.
    
    Определенный:
    
    addRelation в интерфейсе RelationServiceMBean
    
    Параметры:
    relationObjectName - ObjectName отношения MBean, который будет добавлен.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    NoSuchMethodException - Если MBean не реализует интерфейс Отношения
    
    InvalidRelationIdException - если:
    - никакой идентификатор отношения в MBean
    - идентификатор отношения уже используется в Службе Отношения
    
    InstanceNotFoundException - если MBean для данного ObjectName не был зарегистрирован
    
    InvalidRelationServiceException - если:
    - никакая Служба Отношения не называет в MBean
    - имя Службы Отношения в MBean не является тем текущей Службы Отношения
    
    RelationTypeNotFoundException - если:
    - никакое имя типа отношения в MBean
    - имя типа отношения в MBean не соответствует типу отношения, создаваемому в Службе Отношения
    
    InvalidRoleValueException - если:
    - число MBeans, на который ссылаются, в роли менее чем ожидается минимальный градус
    - число MBeans, на который ссылаются, в роли превышает ожидаемый максимальный градус
    - один ссылался на MBean в значении, не Объект класса MBean, ожидаемого для той роли
    - MBean, предусмотренный роль, не существует
    
    RoleNotFoundException - если значение обеспечивается для роли, которая не существует в типе отношения
  - isRelationMBean
```
public ObjectName isRelationMBean(String relationId)
                           throws IllegalArgumentException,
                                  RelationNotFoundException
```
    Если отношение представляется MBean (создаваемый пользователем, и добавил как отношение в Службе Отношения), возвращает ObjectName MBean.
    
    Определенный:
    
    isRelationMBean в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения, идентифицирующий отношение
    
    Возвраты:
    ObjectName соответствующего отношения MBean, или нуль, если отношение не является MBean.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - нет никакого отношения, связанного с тем идентификатором
  - isRelation
```
public String isRelation(ObjectName objectName)
                  throws IllegalArgumentException
```
    Возвращает идентификатор отношения, связанный с данным ObjectName, если MBean был добавлен как отношение в Службе Отношения.
    
    Определенный:
    
    isRelation в интерфейсе RelationServiceMBean
    
    Параметры:
    objectName - ObjectName воображаемого отношения
    
    Возвраты:
    идентификатор отношения (Строка) или нуль (если ObjectName не является отношением, обработанным Службой Отношения),
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
  - hasRelation
```
public Boolean hasRelation(String relationId)
                    throws IllegalArgumentException
```
    Проверки, если есть отношение, идентифицированное в Службе Отношения с данным идентификатором отношения.
    
    Определенный:
    
    hasRelation в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения, идентифицирующий отношение
    
    Возвраты:
    булевская переменная: истина, если еще есть отношение, ложь
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
  - getAllRelationIds
```
public List<String> getAllRelationIds()
```
    Возвраты все идентификаторы отношения для всех отношений обрабатываются Службой Отношения.
    
    Определенный:
    
    getAllRelationIds в интерфейсе RelationServiceMBean
    
    Возвраты:
    ArrayList Строки
  - checkRoleReading
```
public Integer checkRoleReading(String roleName,
                       String relationTypeName)
                         throws IllegalArgumentException,
                                RelationTypeNotFoundException
```
    Проверки, если данный Роль может быть считан в отношении данного типа.
    
    Определенный:
    
    checkRoleReading в интерфейсе RelationServiceMBean
    
    Параметры:
    roleName - имя роли, которая будет проверена
    relationTypeName - имя типа отношения
    
    Возвраты:
    Целое число, обертывающее целое число, соответствующее возможным проблемам, представленным как константы в RoleUnresolved:
    - 0, если роль может быть считана
    - целочисленное соответствие RoleStatus. NO_ROLE_WITH_NAME
    - целочисленное соответствие RoleStatus. ROLE_NOT_READABLE
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если тип отношения не известен в Службе Отношения
  - checkRoleWriting
```
public Integer checkRoleWriting(Role role,
                       String relationTypeName,
                       Boolean initFlag)
                         throws IllegalArgumentException,
                                RelationTypeNotFoundException
```
    Проверки, если данный Роль может быть установлен в отношении данного типа.
    
    Определенный:
    
    checkRoleWriting в интерфейсе RelationServiceMBean
    
    Параметры:
    role - роль, которая будет проверена
    relationTypeName - имя типа отношения
    initFlag - флаг, чтобы определить, что проверка делается для инициализации роли, доступ для записи, не должен быть проверен.
    
    Возвраты:
    Целое число, обертывающее целое число, соответствующее возможным проблемам, представленным как константы в RoleUnresolved:
    - 0, если роль может быть установлена
    - целочисленное соответствие RoleStatus. NO_ROLE_WITH_NAME
    - целое число для RoleStatus. ROLE_NOT_WRITABLE
    - целое число для RoleStatus. LESS_THAN_MIN_ROLE_DEGREE
    - целое число для RoleStatus. MORE_THAN_MAX_ROLE_DEGREE
    - целое число для RoleStatus. REF_MBEAN_OF_INCORRECT_CLASS
    - целое число для RoleStatus. REF_MBEAN_NOT_REGISTERED
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если неизвестный тип отношения
  - sendRelationCreationNotification
```
public void sendRelationCreationNotification(String relationId)
                                      throws IllegalArgumentException,
                                             RelationNotFoundException
```
    Отправляет уведомление (RelationNotification) за созданием отношения. Тип уведомления:
    - RelationNotification.RELATION_BASIC_CREATION, если отношение является объектом, внутренним к Службе Отношения
    - RelationNotification.RELATION_MBEAN_CREATION, если отношение является MBean, добавленным как отношение.
    Исходный объект является Службой Отношения непосредственно.
    Это вызывают в Службе Отношения createRelation () и addRelation () методы.
    
    Определенный:
    
    sendRelationCreationNotification в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения обновленного отношения
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если нет никакого отношения для данного идентификатора отношения
  - sendRoleUpdateNotification
```
public void sendRoleUpdateNotification(String relationId,
                              Role newRole,
                              List<ObjectName> oldValue)
                                throws IllegalArgumentException,
                                       RelationNotFoundException
```
    Отправляет уведомление (RelationNotification) за ролевым обновлением в данном отношении. Тип уведомления:
    - RelationNotification.RELATION_BASIC_UPDATE, если отношение является объектом, внутренним к Службе Отношения
    - RelationNotification.RELATION_MBEAN_UPDATE, если отношение является MBean, добавленным как отношение.
    Исходный объект является Службой Отношения непосредственно.
    Это вызывают в отношении MBean setRole () (для данной роли) и setRoles () (для каждой роли) методы (реализация, обеспеченная в классе RelationSupport).
    Это также вызывают в Службе Отношения setRole () (для данной роли) и setRoles () (для каждой роли) методы.
    
    Определенный:
    
    sendRoleUpdateNotification в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения обновленного отношения
    newRole - новая роль (имя и новое значение)
    oldValue - старое ролевое значение (Список объектов ObjectName)
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если нет никакого отношения для данного идентификатора отношения
  - sendRelationRemovalNotification
```
public void sendRelationRemovalNotification(String relationId,
                                   List<ObjectName> unregMBeanList)
                                     throws IllegalArgumentException,
                                            RelationNotFoundException
```
    Отправляет уведомление (RelationNotification) за удалением отношения. Тип уведомления:
    - RelationNotification.RELATION_BASIC_REMOVAL, если отношение является объектом, внутренним к Службе Отношения
    - RelationNotification.RELATION_MBEAN_REMOVAL, если отношение является MBean, добавленным как отношение.
    Исходный объект является Службой Отношения непосредственно.
    Это вызывают в Службе Отношения removeRelation () метод.
    
    Определенный:
    
    sendRelationRemovalNotification в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения обновленного отношения
    unregMBeanList - Список ObjectNames MBeans, который, как ожидают, будет незарегистрирован из-за удаления отношения (может быть нуль),
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если нет никакого отношения для данного идентификатора отношения
  - updateRoleMap
```
public void updateRoleMap(String relationId,
                 Role newRole,
                 List<ObjectName> oldValue)
                   throws IllegalArgumentException,
                          RelationServiceNotRegisteredException,
                          RelationNotFoundException
```
    Обновление дескрипторов роли Службы Отношения отображается для обновления данной роли в данном отношении.
    Это вызывают в отношении MBean setRole () (для данной роли) и setRoles () (для каждой роли) методы (реализация, обеспеченная в классе RelationSupport).
    Это также вызывают в Службе Отношения setRole () (для данной роли) и setRoles () (для каждой роли) методы.
    Чтобы позволить Службе Отношения поддерживать непротиворечивость (в случае нерегистрации MBean) и быть в состоянии выполнить запросы, этот метод нужно вызвать, когда роль обновляется.
    
    Определенный:
    
    updateRoleMap в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения обновленного отношения
    newRole - новая роль (имя и новое значение)
    oldValue - старое ролевое значение (Список объектов ObjectName)
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    RelationNotFoundException - если никакое отношение для данного идентификатора.
  - removeRelation
```
public void removeRelation(String relationId)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException
```
    Удаляет данное отношение из Службы Отношения.
    Уведомление RelationNotification отправляется, его тип быть:
    - RelationNotification.RELATION_BASIC_REMOVAL, если отношение было только внутренним к Службе Отношения
    - RelationNotification.RELATION_MBEAN_REMOVAL, если отношение регистрируется как MBean.
    Для MBeans, на который ссылаются в таком отношении, ничто не будет сделано,
    
    Определенный:
    
    removeRelation в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения отношения, которое будет удалено
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение, соответствующее данному идентификатор отношения
  - purgeRelations
```
public void purgeRelations()
                    throws RelationServiceNotRegisteredException
```
    Производит чистку отношений.
    В зависимости от значения purgeFlag этот метод или вызывают автоматически, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении (если флаг устанавливается в истину), или не (если флаг устанавливается в ложь).
    В этом случае это до пользователя, чтобы вызвать это, чтобы поддержать непротиворечивость отношений. Чтобы быть учтенным что, если MBean незарегистрирован и чистка, не сделанная сразу, если ObjectName снова используется и присваивается другому MBean, на который ссылаются в отношении, вызывая вручную этот purgeRelations (), метод доставит неприятности, как рассмотрит ObjectName как соответствие незарегистрированному MBean, не видя новый.
    Поведение зависит от количества элементов роли, где на незарегистрированный MBean ссылаются:
    - если удаление одной ссылки MBean в роли делает свое число ссылок меньше чем минимальный градус, отношение должно быть удалено.
    - если остающееся число ссылок после удаления ссылки MBean находится все еще в диапазоне количества элементов, сохраните отношение и обновите его вызывающий его handleMBeanUnregistration () обратный вызов.
    
    Определенный:
    
    purgeRelations в интерфейсе RelationServiceMBean
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean.
  - findReferencingRelations
```
public Map<String,List<String>> findReferencingRelations(ObjectName mbeanName,
                                                String relationTypeName,
                                                String roleName)
                                                  throws IllegalArgumentException
```
    Получает отношения, где на данный MBean ссылаются.
    Это соответствует "Ссылкам" CIM и операциям "ReferenceNames".
    
    Определенный:
    
    findReferencingRelations в интерфейсе RelationServiceMBean
    
    Параметры:
    mbeanName - ObjectName MBean
    relationTypeName - может быть нуль; если определено, только отношения того типа рассмотрят в поиске. Еще все типы отношения рассматривают.
    roleName - может быть нуль; если определено, только отношения, где на MBean ссылаются в той роли, будут возвращены. Еще все роли рассматривают.
    
    Возвраты:
    HashMap, где ключи являются идентификаторами отношения отношений, где на MBean ссылаются, и значение, для каждого ключа, ArrayList ролевых имен (поскольку на MBean можно сослаться в нескольких ролях в том же самом отношении).
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
  - findAssociatedMBeans
```
public Map<ObjectName,List<String>> findAssociatedMBeans(ObjectName mbeanName,
                                                String relationTypeName,
                                                String roleName)
                                                  throws IllegalArgumentException
```
    Получает MBeans, связанный с данным в отношении.
    Это соответствует CIM Associators и операциям AssociatorNames.
    
    Определенный:
    
    findAssociatedMBeans в интерфейсе RelationServiceMBean
    
    Параметры:
    mbeanName - ObjectName MBean
    relationTypeName - может быть нуль; если определено, только отношения того типа рассмотрят в поиске. Еще все типы отношения рассматривают.
    roleName - может быть нуль; если определено, только отношения, где на MBean ссылаются в той роли, рассмотрят. Еще все роли рассматривают.
    
    Возвраты:
    HashMap, где ключами является ObjectNames MBeans, связанного с данным MBean, и значением, для каждого ключа, ArrayList идентификаторов отношения отношений, где ключ MBean связывается с данным один (как они могут быть связаны в нескольких различных отношениях).
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
  - findRelationsOfType
```
public List<String> findRelationsOfType(String relationTypeName)
                                 throws IllegalArgumentException,
                                        RelationTypeNotFoundException
```
    Возвращает идентификаторы отношения для отношений данного типа.
    
    Определенный:
    
    findRelationsOfType в интерфейсе RelationServiceMBean
    
    Параметры:
    relationTypeName - имя типа отношения
    
    Возвраты:
    ArrayList идентификаторов отношения.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если нет никакого типа отношения с тем именем.
  - getRole
```
public List<ObjectName> getRole(String relationId,
                       String roleName)
                         throws RelationServiceNotRegisteredException,
                                IllegalArgumentException,
                                RelationNotFoundException,
                                RoleNotFoundException
```
    Получает ролевое значение для данного ролевого имени в данном отношении.
    
    Определенный:
    
    getRole в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения
    roleName - имя роли
    
    Возвраты:
    ArrayList объектов ObjectName, являющихся ролевым значением
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    
    RoleNotFoundException - если:
    - нет никакой роли с именем
    или
    - роль не читаема.
    См. Также:
    setRole(java.lang.String, javax.management.relation.Role)
  - getRoles
```
public RoleResult getRoles(String relationId,
                  String[] roleNameArray)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException
```
    Получает значения ролей с именами в данном отношении.
    
    Определенный:
    
    getRoles в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения
    roleNameArray - массив имен ролей, которые будут получены
    
    Возвраты:
    объект RoleResult, включая RoleList (для ролей, успешно полученных) и RoleUnresolvedList (для ролей, не полученных).
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    См. Также:
    setRoles(java.lang.String, javax.management.relation.RoleList)
  - getAllRoles
```
public RoleResult getAllRoles(String relationId)
                       throws IllegalArgumentException,
                              RelationNotFoundException,
                              RelationServiceNotRegisteredException
```
    Возвраты все роли, существующие в отношении.
    
    Определенный:
    
    getAllRoles в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения
    
    Возвраты:
    объект RoleResult, включая RoleList (для ролей, успешно полученных) и RoleUnresolvedList (для ролей, не читаемых).
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение для данного идентификатора
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
  - getRoleCardinality
```
public Integer getRoleCardinality(String relationId,
                         String roleName)
                           throws IllegalArgumentException,
                                  RelationNotFoundException,
                                  RoleNotFoundException
```
    Получает число MBeans, на который в настоящий момент ссылаются в данной роли.
    
    Определенный:
    
    getRoleCardinality в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения
    roleName - имя роли
    
    Возвраты:
    число MBeans, на который в настоящий момент ссылаются, в той роли
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    
    RoleNotFoundException - если нет никакой роли с именем
  - setRole
```
public void setRole(String relationId,
           Role role)
             throws RelationServiceNotRegisteredException,
                    IllegalArgumentException,
                    RelationNotFoundException,
                    RoleNotFoundException,
                    InvalidRoleValueException
```
    Устанавливает данную роль в данном отношении.
    Проверит роль согласно ее соответствующему ролевому определению, обеспеченному в типе отношения отношения
    Служба Отношения отследит изменение, чтобы сохранить непротиворечивость отношений, обрабатывая, ссылался на нерегистрацию MBean.
    
    Определенный:
    
    setRole в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения
    role - роль, которая будет определена (имя и новое значение)
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    
    RoleNotFoundException - если роль не существует или не перезаписываема
    
    InvalidRoleValueException - если значение, предусмотренное роль, не допустимо:
    - число MBeans, на который ссылаются, в данном значении менее чем ожидается минимальный градус
    или
    - число MBeans, на который ссылаются, в обеспеченном значении превышает ожидаемый максимальный градус
    или
    - один ссылался на MBean в значении, не Объект класса MBean, ожидаемого для той роли
    или
    - MBean, предусмотренный та роль, не существует
    См. Также:
    getRole(java.lang.String, java.lang.String)
  - setRoles
```
public RoleResult setRoles(String relationId,
                  RoleList roleList)
                    throws RelationServiceNotRegisteredException,
                           IllegalArgumentException,
                           RelationNotFoundException
```
    Устанавливает данные роли в данном отношении.
    Проверит роль согласно ее соответствующему ролевому определению, обеспеченному в типе отношения отношения
    Служба Отношения отслеживает изменения, чтобы сохранить непротиворечивость отношений, обрабатывая, ссылался на нерегистрацию MBean.
    
    Определенный:
    
    setRoles в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения
    roleList - список ролей, которые будут установлены
    
    Возвраты:
    объект RoleResult, включая RoleList (для ролей успешно набор) и RoleUnresolvedList (для ролей не набор).
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    См. Также:
    getRoles(java.lang.String, java.lang.String[])
  - getReferencedMBeans
```
public Map<ObjectName,List<String>> getReferencedMBeans(String relationId)
                                                 throws IllegalArgumentException,
                                                        RelationNotFoundException
```
    Получает MBeans, на который ссылаются в различных ролях отношения.
    
    Определенный:
    
    getReferencedMBeans в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения
    
    Возвраты:
    отображение HashMap:
    ObjectName-> ArrayList Строки (ролевые имена)
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение для данного идентификатора отношения
  - getRelationTypeName
```
public String getRelationTypeName(String relationId)
                           throws IllegalArgumentException,
                                  RelationNotFoundException
```
    Имя возвратов связанного отношения вводит для данного отношения.
    
    Определенный:
    
    getRelationTypeName в интерфейсе RelationServiceMBean
    
    Параметры:
    relationId - идентификатор отношения
    
    Возвраты:
    имя связанного типа отношения.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение для данного идентификатора отношения
  - handleNotification
```
public void handleNotification(Notification notif,
                      Object handback)
```
    Вызванный, когда уведомление JMX происходит. В настоящий момент уведомления о дескрипторах для нерегистрации MBeans, на который или ссылаются в роли отношения или быть отношением непосредственно.
    
    Определенный:
    
    handleNotification в интерфейсе NotificationListener
    
    Параметры:
    notif - Уведомление.
    handback - Непрозрачный объект, который помогает слушателю связать информацию относительно эмиттера MBean (может быть нуль).
  - getNotificationInfo
```
public MBeanNotificationInfo[] getNotificationInfo()
```
    Возвращает объект NotificationInfo, содержащий имя класса Java уведомления и отправленных типов уведомления.
    
    Определенный:
    
    getNotificationInfo в интерфейсе NotificationBroadcaster
    
    Переопределения:
    
    getNotificationInfo в классе NotificationBroadcasterSupport
    
    Возвраты:
    массив возможных уведомлений.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс RelationService

Сводка конструктора

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

Методы, унаследованные от класса javax.management.NotificationBroadcasterSupport

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

RelationService

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

isActive

предварительный регистр

пострегистр

предварительно вычеркнуть из списка

поствычеркнуть из списка

getPurgeFlag

setPurgeFlag

createRelationType

addRelationType

getAllRelationTypeNames

getRoleInfos

getRoleInfo

removeRelationType

createRelation

addRelation

isRelationMBean

isRelation

hasRelation

getAllRelationIds

checkRoleReading

checkRoleWriting

sendRelationCreationNotification

sendRoleUpdateNotification

sendRelationRemovalNotification

updateRoleMap

removeRelation

purgeRelations

findReferencingRelations

findAssociatedMBeans

findRelationsOfType

getRole

getRoles

getAllRoles

getRoleCardinality

setRole

setRoles

getReferencedMBeans

getRelationTypeName

handleNotification

getNotificationInfo