RelationServiceMBean (Платформа Java SE 8 b92)

Все Известные Классы с реализацией:

RelationService
```
public interface RelationServiceMBean
```
Служба Отношения отвечает за создание и удаление типов отношения и отношений за обработку непротиворечивости и обеспечения механизмов запроса.

С тех пор:

1.5

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

Все Методы Методы экземпляра Абстрактные Методы
Модификатор и Тип	Метод и Описание
`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)` Возвраты все роли, существующие в отношении.
`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)` Получает значения ролей с именами в данном отношении.
`Булев`	`hasRelation(String relationId)` Проверки, если есть отношение, идентифицированное в Службе Отношения с данным идентификатором отношения.
`void`	`isActive()` Проверки, если Служба Отношения является активной.
`Строка`	`isRelation(ObjectName objectName)` Возвращает идентификатор отношения, связанный с данным ObjectName, если MBean был добавлен как отношение в Службе Отношения.
`ObjectName`	`isRelationMBean(String relationId)` Если отношение представляется MBean (создаваемый пользователем, и добавил как отношение в Службе Отношения), возвращает ObjectName 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> oldRoleValue)` Отправляет уведомление (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> oldRoleValue)` Обновление дескрипторов роли Службы Отношения отображается для обновления данной роли в данном отношении.

- Деталь метода
  - isActive
```
void isActive()
       throws RelationServiceNotRegisteredException
```
    Проверки, если Служба Отношения является активной. Текущее положение состоит в том, что Служба Отношения должна быть зарегистрирована в Сервере MBean
    
    Броски:
    
    RelationServiceNotRegisteredException - если это не регистрируется
  - getPurgeFlag
```
boolean getPurgeFlag()
```
    Возвращает флаг, чтобы указать, должна ли, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении, если непосредственная "чистка" отношений (ищут больше не действительные отношения) быть выполнена, или если это будет выполняться только, когда purgeRelations метод явно вызовут.
    истина является непосредственной чисткой.
    
    Возвраты:
    
    истина, если чистки непосредственны.
    
    См. Также:
    
    setPurgeFlag(boolean)
  - setPurgeFlag
```
void setPurgeFlag(boolean purgeFlag)
```
    Устанавливает флаг, чтобы указать, должна ли, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении, если непосредственная "чистка" отношений (ищут больше не действительные отношения) быть выполнена, или если это будет выполняться только, когда purgeRelations метод явно вызовут.
    истина является непосредственной чисткой.
    
    Параметры:
    
    purgeFlag - флаг
    
    См. Также:
    
    getPurgeFlag()
  - createRelationType
```
void createRelationType(String relationTypeName,
                        RoleInfo[] roleInfoArray)
                 throws IllegalArgumentException,
                        InvalidRelationTypeException
```
    Создает тип отношения (объект RelationTypeSupport) с данной ролью infos (обеспеченный объектами RoleInfo), и добавляет это в Службе Отношения.
    
    Параметры:
    
    relationTypeName - имя типа отношения
    
    roleInfoArray - массив роли infos
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    InvalidRelationTypeException - Если:
    - уже есть тип отношения с тем именем
    - то же самое имя использовалось для двух различных ролей infos
    - никакая ролевая информация не обеспечила
    - одна нулевая ролевая информация обеспечила
  - addRelationType
```
void addRelationType(RelationType relationTypeObj)
              throws IllegalArgumentException,
                     InvalidRelationTypeException
```
    Добавляет данный объект как тип отношения. Объект, как ожидают, реализует интерфейс RelationType.
    
    Параметры:
    
    relationTypeObj - объект типа отношения (реализация интерфейса RelationType)
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр или если relationTypeObj.getRelationTypeName() нуль возвратов.
    
    InvalidRelationTypeException - если уже есть тип отношения с тем именем
  - getAllRelationTypeNames
```
List<String> getAllRelationTypeNames()
```
    Получает имена всех известных типов отношения.
    
    Возвраты:
    
    ArrayList имен типов отношения (Строки)
  - getRoleInfos
```
List<RoleInfo> getRoleInfos(String relationTypeName)
                     throws IllegalArgumentException,
                            RelationTypeNotFoundException
```
    Получает список роли infos (объекты RoleInfo) данного типа отношения.
    
    Параметры:
    
    relationTypeName - имя типа отношения
    
    Возвраты:
    
    ArrayList RoleInfo.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если нет никакого типа отношения с тем именем.
  - getRoleInfo
```
RoleInfo getRoleInfo(String relationTypeName,
                     String roleInfoName)
              throws IllegalArgumentException,
                     RelationTypeNotFoundException,
                     RoleInfoNotFoundException
```
    Получает ролевую информацию для данной роли данного типа отношения.
    
    Параметры:
    
    relationTypeName - имя типа отношения
    
    roleInfoName - имя роли
    
    Возвраты:
    
    Объект RoleInfo.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если тип отношения не известен в Службе Отношения
    
    RoleInfoNotFoundException - если роль не является частью типа отношения.
  - removeRelationType
```
void removeRelationType(String relationTypeName)
                 throws RelationServiceNotRegisteredException,
                        IllegalArgumentException,
                        RelationTypeNotFoundException
```
    Удаляет данный тип отношения из Службы Отношения.
    Объекты отношения того типа будут удалены из Службы Отношения.
    
    Параметры:
    
    relationTypeName - имя отношения вводит, чтобы быть удаленным
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - Если нет никакого типа отношения с тем именем
  - createRelation
```
void createRelation(String relationId,
                    String relationTypeName,
                    RoleList roleList)
             throws RelationServiceNotRegisteredException,
                    IllegalArgumentException,
                    RoleNotFoundException,
                    InvalidRelationIdException,
                    RelationTypeNotFoundException,
                    InvalidRoleValueException
```
    Создает простое отношение (представленный объектом RelationSupport) данного типа отношения, и добавляет это в Службе Отношения.
    Роли инициализируются согласно ролевому списку, обеспеченному в параметре. Те не инициализированные таким образом устанавливаются в пустой ArrayList ObjectNames.
    RelationNotification, с типом RELATION_BASIC_CREATION, отправляется.
    
    Параметры:
    
    relationId - идентификатор отношения, чтобы идентифицировать уникально отношение в Службе Отношения
    
    relationTypeName - имя типа отношения (должен быть создан в Службе Отношения),
    
    roleList - ролевой список, чтобы инициализировать роли отношения (может быть нуль).
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RoleNotFoundException - если значение обеспечивается для роли, которая не существует в типе отношения
    
    InvalidRelationIdException - если идентификатор отношения уже используется
    
    RelationTypeNotFoundException - если тип отношения, не известный в Службе Отношения
    
    InvalidRoleValueException - если:
    - то же самое ролевое имя используется для двух различных ролей
    - число MBeans, на который ссылаются, в данном значении менее чем ожидается минимальный градус
    - число MBeans, на который ссылаются, в обеспеченном значении превышает ожидаемый максимальный градус
    - один сослался на MBean в значении, не Объект class MBean, ожидаемого для той роли
    - MBean, предусмотренный та роль, не существует
  - addRelation
```
void addRelation(ObjectName relationObjectName)
          throws IllegalArgumentException,
                 RelationServiceNotRegisteredException,
                 NoSuchMethodException,
                 InvalidRelationIdException,
                 InstanceNotFoundException,
                 InvalidRelationServiceException,
                 RelationTypeNotFoundException,
                 RoleNotFoundException,
                 InvalidRoleValueException
```
    Добавляет MBean, создаваемый пользователем (и зарегистрированный им в Сервере MBean) как отношение в Службе Отношения.
    Чтобы быть добавленным как отношение, MBean должен соответствовать следующему:
    - реализуйте интерфейс Отношения
    - имейте для RelationService ObjectName ObjectName текущей Службы Отношения
    - имейте идентификатор отношения, который уникален и неиспользован в текущей Службе Отношения
    - имейте для типа отношения тип отношения, создаваемый в Службе Отношения
    - имейте роли, соответствующие ролевой информации, обеспеченной в типе отношения.
    
    Параметры:
    
    relationObjectName - ObjectName отношения MBean, который будет добавлен.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    NoSuchMethodException - Если MBean не реализует интерфейс Отношения
    
    InvalidRelationIdException - если:
    - никакой идентификатор отношения в MBean
    - идентификатор отношения уже используется в Службе Отношения
    
    InstanceNotFoundException - если MBean для данного ObjectName не был зарегистрирован
    
    InvalidRelationServiceException - если:
    - никакая Служба Отношения не называет в MBean
    - имя Службы Отношения в MBean не является тем текущей Службы Отношения
    
    RelationTypeNotFoundException - если:
    - никакое имя типа отношения в MBean
    - имя типа отношения в MBean не соответствует типу отношения, создаваемому в Службе Отношения
    
    InvalidRoleValueException - если:
    - число MBeans, на который ссылаются, в роли менее чем ожидается минимальный градус
    - число MBeans, на который ссылаются, в роли превышает ожидаемый максимальный градус
    - один сослался на MBean в значении, не Объект class MBean, ожидаемого для той роли
    - MBean, предусмотренный роль, не существует
    
    RoleNotFoundException - если значение обеспечивается для роли, которая не существует в типе отношения
  - isRelationMBean
```
ObjectName isRelationMBean(String relationId)
                    throws IllegalArgumentException,
                           RelationNotFoundException
```
    Если отношение представляется MBean (создаваемый пользователем, и добавил как отношение в Службе Отношения), возвращает ObjectName MBean.
    
    Параметры:
    
    relationId - идентификатор отношения, идентифицирующий отношение
    
    Возвраты:
    
    ObjectName соответствующего отношения MBean, или нуль, если отношение не является MBean.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - нет никакого отношения, связанного с тем идентификатором
  - isRelation
```
String isRelation(ObjectName objectName)
           throws IllegalArgumentException
```
    Возвращает идентификатор отношения, связанный с данным ObjectName, если MBean был добавлен как отношение в Службе Отношения.
    
    Параметры:
    
    objectName - ObjectName воображаемого отношения
    
    Возвраты:
    
    идентификатор отношения (Строка) или нуль (если ObjectName не является отношением, обработанным Службой Отношения),
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
  - hasRelation
```
Boolean hasRelation(String relationId)
             throws IllegalArgumentException
```
    Проверки, если есть отношение, идентифицированное в Службе Отношения с данным идентификатором отношения.
    
    Параметры:
    
    relationId - идентификатор отношения, идентифицирующий отношение
    
    Возвраты:
    
    булев: истина, если еще есть отношение, ложь
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
  - getAllRelationIds
```
List<String> getAllRelationIds()
```
    Возвраты все идентификаторы отношения для всех отношений обрабатываются Службой Отношения.
    
    Возвраты:
    
    ArrayList Строки
  - checkRoleReading
```
Integer checkRoleReading(String roleName,
                         String relationTypeName)
                  throws IllegalArgumentException,
                         RelationTypeNotFoundException
```
    Проверки, если данный Роль может быть считан в отношении данного типа.
    
    Параметры:
    
    roleName - имя роли, которая будет проверена
    
    relationTypeName - имя типа отношения
    
    Возвраты:
    
    Целое число, обертывающее целое число, соответствующее возможным проблемам, представленным как константы в RoleUnresolved:
    - 0, если роль может быть считана
    - целочисленное соответствие RoleStatus. NO_ROLE_WITH_NAME
    - целочисленное соответствие RoleStatus. ROLE_NOT_READABLE
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если тип отношения не известен в Службе Отношения
  - checkRoleWriting
```
Integer checkRoleWriting(Role role,
                         String relationTypeName,
                         Boolean initFlag)
                  throws IllegalArgumentException,
                         RelationTypeNotFoundException
```
    Проверки, если данный Роль может быть установлен в отношении данного типа.
    
    Параметры:
    
    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
```
void sendRelationCreationNotification(String relationId)
                               throws IllegalArgumentException,
                                      RelationNotFoundException
```
    Отправляет уведомление (RelationNotification) за созданием отношения. Тип уведомления:
    - RelationNotification.RELATION_BASIC_CREATION, если отношение является объектом, внутренним к Службе Отношения
    - RelationNotification.RELATION_MBEAN_CREATION, если отношение является MBean, добавленным как отношение.
    Исходный объект является Службой Отношения непосредственно.
    Это вызывают в Службе Отношения createRelation () и addRelation () методы.
    
    Параметры:
    
    relationId - идентификатор отношения обновленного отношения
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если нет никакого отношения для данного идентификатора отношения
  - sendRoleUpdateNotification
```
void sendRoleUpdateNotification(String relationId,
                                Role newRole,
                                List<ObjectName> oldRoleValue)
                         throws IllegalArgumentException,
                                RelationNotFoundException
```
    Отправляет уведомление (RelationNotification) за ролевым обновлением в данном отношении. Тип уведомления:
    - RelationNotification.RELATION_BASIC_UPDATE, если отношение является объектом, внутренним к Службе Отношения
    - RelationNotification.RELATION_MBEAN_UPDATE, если отношение является MBean, добавленным как отношение.
    Исходный объект является Службой Отношения непосредственно.
    Это вызывают в отношении MBean setRole () (для данной роли) и setRoles () (для каждой роли) методы (реализация, обеспеченная в RelationSupport class).
    Это также вызывают в Службе Отношения setRole () (для данной роли) и setRoles () (для каждой роли) методы.
    
    Параметры:
    
    relationId - идентификатор отношения обновленного отношения
    
    newRole - новая роль (имя и новое значение)
    
    oldRoleValue - старое ролевое значение (Список объектов ObjectName)
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если нет никакого отношения для данного идентификатора отношения
  - sendRelationRemovalNotification
```
void sendRelationRemovalNotification(String relationId,
                                     List<ObjectName> unregMBeanList)
                              throws IllegalArgumentException,
                                     RelationNotFoundException
```
    Отправляет уведомление (RelationNotification) за удалением отношения. Тип уведомления:
    - RelationNotification.RELATION_BASIC_REMOVAL, если отношение является объектом, внутренним к Службе Отношения
    - RelationNotification.RELATION_MBEAN_REMOVAL, если отношение является MBean, добавленным как отношение.
    Исходный объект является Службой Отношения непосредственно.
    Это вызывают в Службе Отношения removeRelation () метод.
    
    Параметры:
    
    relationId - идентификатор отношения обновленного отношения
    
    unregMBeanList - Список ObjectNames MBeans, который, как ожидают, будет незарегистрирован из-за удаления отношения (может быть нуль),
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если нет никакого отношения для данного идентификатора отношения
  - updateRoleMap
```
void updateRoleMap(String relationId,
                   Role newRole,
                   List<ObjectName> oldRoleValue)
            throws IllegalArgumentException,
                   RelationServiceNotRegisteredException,
                   RelationNotFoundException
```
    Обновление дескрипторов роли Службы Отношения отображается для обновления данной роли в данном отношении.
    Это вызывают в отношении MBean setRole () (для данной роли) и setRoles () (для каждой роли) методы (реализация, обеспеченная в RelationSupport class).
    Это также вызывают в Службе Отношения setRole () (для данной роли) и setRoles () (для каждой роли) методы.
    Чтобы позволить Службе Отношения поддерживать непротиворечивость (в случае нерегистрации MBean) и быть в состоянии выполнить запросы, этот метод нужно вызвать, когда роль обновляется.
    
    Параметры:
    
    relationId - идентификатор отношения обновленного отношения
    
    newRole - новая роль (имя и новое значение)
    
    oldRoleValue - старое ролевое значение (Список объектов ObjectName)
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    RelationNotFoundException - если никакое отношение для данного идентификатора.
  - removeRelation
```
void removeRelation(String relationId)
             throws RelationServiceNotRegisteredException,
                    IllegalArgumentException,
                    RelationNotFoundException
```
    Удаляет данное отношение из Службы Отношения.
    Уведомление RelationNotification отправляется, его тип быть:
    - RelationNotification.RELATION_BASIC_REMOVAL, если отношение было только внутренним к Службе Отношения
    - RelationNotification.RELATION_MBEAN_REMOVAL, если отношение регистрируется как MBean.
    Для MBeans, на который ссылаются в таком отношении, ничто не будет сделано,
    
    Параметры:
    
    relationId - идентификатор отношения отношения, которое будет удалено
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение, соответствующее данному идентификатор отношения
  - purgeRelations
```
void purgeRelations()
             throws RelationServiceNotRegisteredException
```
    Производит чистку отношений.
    В зависимости от значения purgeFlag этот метод или вызывают автоматически, когда уведомление получается для нерегистрации MBean, на который ссылаются в отношении (если флаг устанавливается в истину), или не (если флаг устанавливается в ложь).
    В этом случае это до пользователя, чтобы вызвать это, чтобы поддержать непротиворечивость отношений. Чтобы быть учтенным что, если MBean незарегистрирован и чистка, не сделанная сразу, если ObjectName снова используется и присваивается другому MBean, на который ссылаются в отношении, вызывая вручную этот purgeRelations (), метод доставит неприятности, как рассмотрит ObjectName как соответствие незарегистрированному MBean, не видя новый.
    Поведение зависит от количества элементов роли, где на незарегистрированный MBean ссылаются:
    - если удаление одной ссылки MBean в роли делает свое число ссылок меньше чем минимальный градус, отношение должно быть удалено.
    - если остающееся число ссылок после удаления ссылки MBean находится все еще в диапазоне количества элементов, сохраните отношение и обновите его вызывающий его handleMBeanUnregistration () обратный вызов.
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean.
  - findReferencingRelations
```
Map<String,List<String>> findReferencingRelations(ObjectName mbeanName,
                                                  String relationTypeName,
                                                  String roleName)
                                           throws IllegalArgumentException
```
    Получает отношения, где на данный MBean ссылаются.
    Это соответствует "Ссылкам" CIM и операциям "ReferenceNames".
    
    Параметры:
    
    mbeanName - ObjectName MBean
    
    relationTypeName - может быть нуль; если определено, только отношения того типа рассмотрят в поиске. Еще все типы отношения рассматривают.
    
    roleName - может быть нуль; если определено, только отношения, где на MBean ссылаются в той роли, будут возвращены. Еще все роли рассматривают.
    
    Возвраты:
    
    HashMap, где ключи являются идентификаторами отношения отношений, где на MBean ссылаются, и значение, для каждого ключа, ArrayList ролевых имен (поскольку на MBean можно сослаться в нескольких ролях в том же самом отношении).
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
  - findAssociatedMBeans
```
Map<ObjectName,List<String>> findAssociatedMBeans(ObjectName mbeanName,
                                                  String relationTypeName,
                                                  String roleName)
                                           throws IllegalArgumentException
```
    Получает MBeans, связанный с данным в отношении.
    Это соответствует CIM Associators и операциям AssociatorNames.
    
    Параметры:
    
    mbeanName - ObjectName MBean
    
    relationTypeName - может быть нуль; если определено, только отношения того типа рассмотрят в поиске. Еще все типы отношения рассматривают.
    
    roleName - может быть нуль; если определено, только отношения, где на MBean ссылаются в той роли, рассмотрят. Еще все роли рассматривают.
    
    Возвраты:
    
    HashMap, где ключами является ObjectNames MBeans, связанного с данным MBean, и значением, для каждого ключа, ArrayList идентификаторов отношения отношений, где ключ MBean связывается с данным один (как они могут быть связаны в нескольких различных отношениях).
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
  - findRelationsOfType
```
List<String> findRelationsOfType(String relationTypeName)
                          throws IllegalArgumentException,
                                 RelationTypeNotFoundException
```
    Возвращает идентификаторы отношения для отношений данного типа.
    
    Параметры:
    
    relationTypeName - имя типа отношения
    
    Возвраты:
    
    ArrayList идентификаторов отношения.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationTypeNotFoundException - если нет никакого типа отношения с тем именем.
  - getRole
```
List<ObjectName> getRole(String relationId,
                         String roleName)
                  throws RelationServiceNotRegisteredException,
                         IllegalArgumentException,
                         RelationNotFoundException,
                         RoleNotFoundException
```
    Получает ролевое значение для данного ролевого имени в данном отношении.
    
    Параметры:
    
    relationId - идентификатор отношения
    
    roleName - имя роли
    
    Возвраты:
    
    ArrayList объектов ObjectName, являющихся ролевым значением
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    
    RoleNotFoundException - если:
    - нет никакой роли с именем
    или
    - роль не читаема.
    
    См. Также:
    
    setRole(java.lang.String, javax.management.relation.Role)
  - getRoles
```
RoleResult getRoles(String relationId,
                    String[] roleNameArray)
             throws RelationServiceNotRegisteredException,
                    IllegalArgumentException,
                    RelationNotFoundException
```
    Получает значения ролей с именами в данном отношении.
    
    Параметры:
    
    relationId - идентификатор отношения
    
    roleNameArray - массив имен ролей, которые будут получены
    
    Возвраты:
    
    объект RoleResult, включая RoleList (для ролей, успешно полученных) и RoleUnresolvedList (для ролей, не полученных).
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    
    См. Также:
    
    setRoles(java.lang.String, javax.management.relation.RoleList)
  - getAllRoles
```
RoleResult getAllRoles(String relationId)
                throws IllegalArgumentException,
                       RelationNotFoundException,
                       RelationServiceNotRegisteredException
```
    Возвраты все роли, существующие в отношении.
    
    Параметры:
    
    relationId - идентификатор отношения
    
    Возвраты:
    
    объект RoleResult, включая RoleList (для ролей, успешно полученных) и RoleUnresolvedList (для ролей, не читаемых).
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение для данного идентификатора
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
  - getRoleCardinality
```
Integer getRoleCardinality(String relationId,
                           String roleName)
                    throws IllegalArgumentException,
                           RelationNotFoundException,
                           RoleNotFoundException
```
    Получает число MBeans, на который в настоящий момент ссылаются в данной роли.
    
    Параметры:
    
    relationId - идентификатор отношения
    
    roleName - имя роли
    
    Возвраты:
    
    число MBeans, на который в настоящий момент ссылаются, в той роли
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    
    RoleNotFoundException - если нет никакой роли с именем
  - setRole
```
void setRole(String relationId,
             Role role)
      throws RelationServiceNotRegisteredException,
             IllegalArgumentException,
             RelationNotFoundException,
             RoleNotFoundException,
             InvalidRoleValueException,
             RelationTypeNotFoundException
```
    Устанавливает данную роль в данном отношении.
    Проверит роль согласно ее соответствующему ролевому определению, обеспеченному в типе отношения отношения
    Служба Отношения отследит изменение, чтобы сохранить непротиворечивость отношений, обрабатывая, сослался на нерегистрацию MBean.
    
    Параметры:
    
    relationId - идентификатор отношения
    
    role - роль, которая будет определена (имя и новое значение)
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    
    RoleNotFoundException - если:
    - внутреннее отношение
    и
    - роль не существует или не перезаписываема
    
    InvalidRoleValueException - если внутреннее отношение и значение, предусмотренное роль, не допустимы:
    - число MBeans, на который ссылаются, в данном значении менее чем ожидается минимальный градус
    или
    - число MBeans, на который ссылаются, в обеспеченном значении превышает ожидаемый максимальный градус
    или
    - один сослался на MBean в значении, не Объект class MBean, ожидаемого для той роли
    или
    - MBean, предусмотренный та роль, не существует
    
    RelationTypeNotFoundException - если неизвестный тип отношения
    
    См. Также:
    
    getRole(java.lang.String, java.lang.String)
  - setRoles
```
RoleResult setRoles(String relationId,
                    RoleList roleList)
             throws RelationServiceNotRegisteredException,
                    IllegalArgumentException,
                    RelationNotFoundException
```
    Устанавливает данные роли в данном отношении.
    Проверит роль согласно ее соответствующему ролевому определению, обеспеченному в типе отношения отношения
    Служба Отношения отслеживает изменения, чтобы сохранить непротиворечивость отношений, обрабатывая, сослался на нерегистрацию MBean.
    
    Параметры:
    
    relationId - идентификатор отношения
    
    roleList - список ролей, которые будут установлены
    
    Возвраты:
    
    объект RoleResult, включая RoleList (для ролей успешно набор) и RoleUnresolvedList (для ролей не набор).
    
    Броски:
    
    RelationServiceNotRegisteredException - если Служба Отношения не регистрируется в Сервере MBean
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение с данным идентификатором
    
    См. Также:
    
    getRoles(java.lang.String, java.lang.String[])
  - getReferencedMBeans
```
Map<ObjectName,List<String>> getReferencedMBeans(String relationId)
                                          throws IllegalArgumentException,
                                                 RelationNotFoundException
```
    Получает MBeans, на который ссылаются в различных ролях отношения.
    
    Параметры:
    
    relationId - идентификатор отношения
    
    Возвраты:
    
    отображение HashMap:
    ObjectName-> ArrayList Строки (ролевые имена)
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение для данного идентификатора отношения
  - getRelationTypeName
```
String getRelationTypeName(String relationId)
                    throws IllegalArgumentException,
                           RelationNotFoundException
```
    Имя возвратов связанного отношения вводит для данного отношения.
    
    Параметры:
    
    relationId - идентификатор отношения
    
    Возвраты:
    
    имя связанного типа отношения.
    
    Броски:
    
    IllegalArgumentException - если нулевой параметр
    
    RelationNotFoundException - если никакое отношение для данного идентификатора отношения

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

Интерфейс RelationServiceMBean

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

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

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