Интерфейс GSSName

public interface GSSName

Этот интерфейс инкапсулирует единственный главный объект GSS-API. Приложение получает реализацию этого интерфейса через один из createName методов, существующих в классе GSSManager. Понятийно, GSSName содержит множество представлений объекта или множество примитивных элементов имени, по одному для каждого поддерживаемого базового механизма. В терминологии GSS, GSSName, содержащий элемент только одного механизма, называется именем механизма (MN).

Так как различные механизмы аутентификации могут использовать разные пространства имён для идентификации своих принципалов, поддержка именования GSS-API неизбежно сложна в многомеханических средах (или даже в некоторых одномеханических средах, где базовый механизм поддерживает несколько пространств имён). Разные форматы имён и их определения идентифицируются с помощью Oid's, и некоторые стандартные типы определены в этом интерфейсе. Формат имён может быть получен на основе уникального Oid типа имени.

Ниже приведены примеры кода, использующие интерфейс GSSName. Код ниже создаёт GSSName, преобразует его в MN, выполняет сравнение, получает печатное представление имени, экспортирует его в массив байтов и затем повторно импортирует, чтобы получить новое GSSName.

GSSManager manager = GSSManager.getInstance();

      // create a host based service name
      GSSName name = manager.createName("service@host",
                   GSSName.NT_HOSTBASED_SERVICE);

      Oid krb5 = new Oid("1.2.840.113554.1.2.2");

      GSSName mechName = name.canonicalize(krb5);

      // the above two steps are equivalent to the following
      GSSName mechName = manager.createName("service@host",
                      GSSName.NT_HOSTBASED_SERVICE, krb5);

      // perform name comparison
      if (name.equals(mechName))
              print("Names are equals.");

      // obtain textual representation of name and its printable
      // name type
      print(mechName.toString() +
                      mechName.getStringNameType().toString());

      // export and re-import the name
      byte [] exportName = mechName.export();

      // create a new name object from the exported buffer
      GSSName newName = manager.createName(exportName,
                      GSSName.NT_EXPORT_NAME);

Поля

NT_HOSTBASED_SERVICE

static final Oid NT_HOSTBASED_SERVICE

NT_USER_NAME

static final Oid NT_USER_NAME

NT_MACHINE_UID_NAME

static final Oid NT_MACHINE_UID_NAME

NT_STRING_UID_NAME

static final Oid NT_STRING_UID_NAME

NT_ANONYMOUS

static final Oid NT_ANONYMOUS

NT_EXPORT_NAME

static final Oid NT_EXPORT_NAME

Методы

equals

boolean equals(GSSName another)
        throws GSSException

Сравнивает два объекта GSSName для определения, ссылаются ли они на один и тот же объект.

Параметры:

another - объект GSSName для сравнения с этим именем

Возвращает:

true, если два имени содержат по крайней мере один общий примитивный элемент. Если какое-либо из имен представляет анонимный объект, метод вернёт false.

Выбрасывает:

GSSException - когда имена нельзя сравнить, содержащие следующие основные коды ошибок: GSSException.BAD_NAMETYPE, GSSException.FAILURE

equals

boolean equals(Object another)

Сравнивает этот объект GSSName с другим объектом Object, который может быть GSSName. Поведение точно такое же, как в equals, за исключением того, что не выбрасывается GSSException; вместо этого в ситуации возникновения ошибки будет возвращено false.

Переопределяет:

equals в классе Object

Параметры:

another - объект, с которым сравнивается это имя

Возвращает:

true, если сравниваемый объект также является GSSName и два имени ссылаются на один и тот же объект.

См. также:

equals(GSSName)

hashCode

int hashCode()

Возвращает значение хеш-кода для этого GSSName.

Переопределяет:

hashCode в классе Object

Возвращает:

значение hashCode

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

canonicalize

GSSName canonicalize(Oid mech)
              throws GSSException

Создаёт имя, канонизированное для некоторого механизма.

Параметры:

mech - oid для механизма, для которого запрашивается каноническая форма имени.

Возвращает:

объект GSSName, содержащий только один примитивный элемент, представляющий это имя в канонизированной форме для нужного механизма.

Выбрасывает:

GSSException - содержащие следующие основные коды ошибок: GSSException.BAD_MECH, GSSException.BAD_NAMETYPE, GSSException.BAD_NAME, GSSException.FAILURE

export

byte[] export()
       throws GSSException

Возвращает:

массив байтов byte[] содержащий экспортированное имя. RFC 2743 определяет "Формат объекта экспортированного механизма, независимого от механизма" для этих байтов.

Выбрасывает:

GSSException - содержащие следующие основные коды ошибок: GSSException.BAD_NAME, GSSException.BAD_NAMETYPE, GSSException.FAILURE

toString

String toString()

Возвращает текстовое представление объекта GSSName. Чтобы получить формат напечатанного имени, который определяет синтаксис возвращаемой строки, используйте метод getStringNameType.

Переопределяет:

toString в классе Object

Возвращает:

строку String, представляющую это имя в печатном виде.

getStringNameType

Oid getStringNameType()
               throws GSSException

Возвращает тип имени печатного представления этого имени, который можно получить из метода toString.

Возвращает:

OID, представляющий пространство имён имени, возвращённого методом toString.

Выбрасывает:

GSSException - содержащие следующий основной код ошибки: GSSException.FAILURE

isAnonymous

boolean isAnonymous()

Проверяет, представляет ли этот объект имени анонимный объект.

Возвращает:

true, если это анонимное имя, иначе false.

isMN

boolean isMN()

Проверяет, представляет ли этот объект имени имя механизма (MN). MN — это GSSName, который содержит ровно один примитивный элемент имени механизма.

Возвращает:

true, если это MN, иначе false.