Класс RelationTypeSupport

public class RelationTypeSupport
extends Object
implements RelationType

Объект RelationTypeSupport реализует интерфейс RelationType.

Он представляет собой тип отношения, предоставляя информацию о роли для каждой роли, которая должна поддерживаться в каждом отношении данного типа.

Тип отношения включает имя типа отношения и список сведений о роли (представленных объектами RoleInfo).

Тип отношения должен быть объявлен в службе отношений:

- либо с помощью метода createRelationType(), где будет создан и сохранен объект RelationTypeSupport в службе отношений

- либо с помощью метода addRelationType(), где пользователь должен создать объект, реализующий интерфейс RelationType, и этот объект будет использоваться для представления типа отношения в службе отношений.

serialVersionUID этого класса равен 4611072955724144607L.

Конструкторы

RelationTypeSupport

public RelationTypeSupport(String relationTypeName,
                           RoleInfo[] roleInfoArray)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException

Конструктор, где все определения ролей динамически создаются и передаются в качестве параметра.

Параметры:

relationTypeName - Имя типа отношения

roleInfoArray - Список определений ролей (объекты RoleInfo)

Исключение:

IllegalArgumentException - если параметр null

InvalidRelationTypeException - если:

- одно и то же имя использовано для двух разных ролей

- информация о роли не предоставлена

- предоставлена одна нулевая информация о роли

RelationTypeSupport

protected RelationTypeSupport(String relationTypeName)

Конструктор, предназначенный для подклассов.

Параметры:

relationTypeName - Имя типа отношения.

Исключение:

IllegalArgumentException - если параметр null.

Методы

getRelationTypeName

public String getRelationTypeName()

Возвращает имя типа отношения.

Определено в:

getRelationTypeName в интерфейсе RelationType

Возвращает:

имя типа отношения.

getRoleInfos

public List<RoleInfo> getRoleInfos()

Возвращает список определений ролей (ArrayList объектов RoleInfo).

Определено в:

getRoleInfos в интерфейсе RelationType

Возвращает:

список ArrayList объектов RoleInfo.

getRoleInfo

public RoleInfo getRoleInfo(String roleInfoName)
                     throws IllegalArgumentException,
                            RoleInfoNotFoundException

Возвращает информацию о роли (объект RoleInfo) для данного имени информации о роли (null, если не найдено).

Определено в:

getRoleInfo в интерфейсе RelationType

Параметры:

roleInfoName - имя информации о роли

Возвращает:

объект RoleInfo, если определение роли не существует

Исключение:

IllegalArgumentException - если параметр null

RoleInfoNotFoundException - если информация о роли с этим именем отсутствует в типе отношения.

addRoleInfo

protected void addRoleInfo(RoleInfo roleInfo)
                    throws IllegalArgumentException,
                           InvalidRelationTypeException

Добавить информацию о роли. Этот метод, конечно, не следует использовать после создания типа отношения, потому что обновление его сделает недействительным то, что отношения, созданные в связи с этим типом, все еще соответствуют ему. Может выбросить исключение RuntimeException, если пытаться обновить тип отношения, объявленный в службе отношений.

Параметры:

roleInfo - добавляемая информация о роли.

Исключение:

IllegalArgumentException - если параметр null.

InvalidRelationTypeException - если в текущем типе отношения уже существует информация о роли с тем же именем.