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

```
public interface GSSName
```
Этот интерфейс инкапсулирует единственный объект принципала GSS-API. Приложение получает реализацию этого интерфейса через один из createName методы, которые существуют в GSSManager класс. Концептуально GSSName содержит много представлений объекта или много примитивных элементов имени, один для каждого поддерживаемого базового механизма. В терминологии GSS GSSName, который содержит элемент только от одного механизма, вызывают Именем Механизма (MN)
Так как различные механизмы аутентификации могут использовать различные пространства имен для того, чтобы идентифицировать их принципалы, поддержка именования GSS-API обязательно сложна в средах мультимеханизма (или даже в некоторых средах единственного механизма, где базовый механизм поддерживает многократные пространства имен). Форматы другого имени и их определения идентифицируются с Oid's и некоторые стандартные типы являются defind в этом интерфейсе. Формат имен может быть получен основанный на уникальном Oid из его типа имени.
Включенный ниже примеры кода, использующие GSSName интерфейс. Код ниже создает a 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);

 
```
С тех пор:

1.4

См. Также:
export(), equals(GSSName), GSSManager.createName(String, Oid), GSSManager.createName(String, Oid, Oid), GSSManager.createName(byte[], Oid)

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static Oid`	`NT_ANONYMOUS` Тип имени для того, чтобы представить анонимный объект.
`static Oid`	`NT_EXPORT_NAME` Тип имени, используемый, чтобы указать на экспортируемое имя, произведенное методом экспорта.
`static Oid`	`NT_HOSTBASED_SERVICE` Oid, указывающий на основанную на узле службу, называет форму.
`static Oid`	`NT_MACHINE_UID_NAME` Тип имени, чтобы указать на числовой идентификатор пользователя, соответствующий пользователю на локальной системе.
`static Oid`	`NT_STRING_UID_NAME` Тип имени, чтобы указать на строку цифр, представляющих числовой идентификатор пользователя пользователя на локальной системе.
`static Oid`	`NT_USER_NAME` Тип имени, чтобы указать на именованного пользователя на локальной системе.

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

Методы
Модификатор и Тип	Метод и Описание
`GSSName`	`canonicalize(Oid mech)` Создает имя, которое канонизируется для некоторого механизма.
`boolean`	`equals(GSSName another)` Сравнивается два `GSSName` объекты определить, обращаются ли они к тому же самому объекту.
`boolean`	`equals(Object another)` Сравнивает это `GSSName` возразите против другого Объекта, который мог бы быть a `GSSName`.
`byte[]`	`export()` Возвращает каноническое непрерывное представление байта имени механизма (MN), подходящий для прямого, байта по сравнению байта функциями авторизации.
`Oid`	`getStringNameType()` Возвращает тип имени печатаемого представления этого имени, которое может быть получено из `toString` метод.
`int`	`hashCode()` Возвращает значение хэш-кода для этого GSSName.
`boolean`	`isAnonymous()` Тесты, если этот объект имени представляет анонимный объект.
`boolean`	`isMN()` Тесты, если этот объект имени представляет Имя Механизма (MN).
`Строка`	`toString()` Возвращает текстовое представление `GSSName` объект.

- Полевая Деталь
  - NT_HOSTBASED_SERVICE
```
static final Oid NT_HOSTBASED_SERVICE
```
    Oid, указывающий на основанную на узле службу, называет форму. Это используется, чтобы представить службы, связанные с главными компьютерами. Эта форма имени создается, используя два элемента, "службу" и "имя хоста", следующим образом: service@hostname.
    Это представляет следующее значение Oid:
    { iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) service_name(4) }
  - NT_USER_NAME
```
static final Oid NT_USER_NAME
```
    Тип имени, чтобы указать на именованного пользователя на локальной системе.
    Это представляет следующее значение Oid:
    { iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) user_name(1) }
  - NT_MACHINE_UID_NAME
```
static final Oid NT_MACHINE_UID_NAME
```
    Тип имени, чтобы указать на числовой идентификатор пользователя, соответствующий пользователю на локальной системе. (например. Uid).
    Это представляет следующее значение Oid:
    { iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) machine_uid_name(2) }
  - NT_STRING_UID_NAME
```
static final Oid NT_STRING_UID_NAME
```
    Тип имени, чтобы указать на строку цифр, представляющих числовой идентификатор пользователя пользователя на локальной системе.
    Это представляет следующее значение Oid:
    { iso(1) member-body(2) United States(840) mit(113554) infosys(1) gssapi(2) generic(1) string_uid_name(3) }
  - NT_ANONYMOUS
```
static final Oid NT_ANONYMOUS
```
    Тип имени для того, чтобы представить анонимный объект.
    Это представляет следующее значение Oid:
    { 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 3(gss-anonymous-name) }
  - NT_EXPORT_NAME
```
static final Oid NT_EXPORT_NAME
```
    Тип имени, используемый, чтобы указать на экспортируемое имя, произведенное методом экспорта.
    Это представляет следующее значение Oid:
    { 1(iso), 3(org), 6(dod), 1(internet), 5(security), 6(nametypes), 4(gss-api-exported-name) }
- Деталь метода
  - равняется
```
boolean equals(GSSName another)
               throws GSSException
```
    Сравнивается два GSSName объекты определить, обращаются ли они к тому же самому объекту.
    
    Параметры:
    another - GSSName сравнить это имя с
    
    Возвраты:
    истина, если два имени содержат по крайней мере один примитивный элемент вместе. Если любое из имен представит анонимный объект, то метод возвратит false.
    
    Броски:
    
    GSSException - когда имена не могут быть сравнены, содержа следующие главные коды ошибки: GSSException.BAD_NAMETYPE, GSSException.FAILURE
  - равняется
```
boolean equals(Object another)
```
    Сравнивает это GSSName возразите против другого Объекта, который мог бы быть a GSSName. Поведение является точно тем же самым как в equals за исключением того, что никакой GSSException не бросается; вместо этого, false будет возвращен в ситуации, где ошибка происходит.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    another - объект сравнить это имя к
    
    Возвраты:
    истина, если объект сравниться с также a GSSName и два имени обращаются к тому же самому объекту.
    См. Также:
    equals(GSSName)
  - хэш-код
```
int hashCode()
```
    Возвращает значение хэш-кода для этого GSSName.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    значение хэш-кода
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - канонизировать
```
GSSName canonicalize(Oid mech)
                     throws GSSException
```
    Создает имя, которое канонизируется для некоторого механизма.
    
    Параметры:
    mech - oid для механизма, на который требуют каноническую форму имени.
    
    Возвраты:
    a GSSName это содержит только один примитивный элемент, представляющий это имя в канонизировавшей форме для требуемого механизма.
    
    Броски:
    
    GSSException - содержа следующие главные коды ошибки: GSSException.BAD_MECH, GSSException.BAD_NAMETYPE, GSSException.BAD_NAME, GSSException.FAILURE
  - экспорт
```
byte[] export()
              throws GSSException
```
    Возвращает каноническое непрерывное представление байта имени механизма (MN), подходящий для прямого, байта по сравнению байта функциями авторизации. Если имя не является MN, реализации могут бросить GSSException с кодом состояния NAME_NOT_MN. Если реализация хочет не выдавать исключение, она должна использовать некоторую систему определенный механизм по умолчанию, чтобы канонизировать имя и затем экспортировать это. Структурно, экспортируемый объект имени состоит из заголовка, содержащего OID, идентифицирующий механизм, который аутентифицировал имя, и метку конца, содержащую имя непосредственно, где синтаксис метки конца определяется отдельной спецификацией механизма. Формат заголовка буфера вывода определяется в RFC 2743.
    Экспортируемое имя полезно когда использующийся в больших списках управления доступом где издержки создания a GSSName объект на каждом имени и вызове равняется методу на каждом имени от ACL, может быть препятствующим.
    Экспортируемые имена могут быть повторно импортированы при использовании метода фабрики байтового массива GSSManager.createName и определение NT_EXPORT_NAME как тип имени возражает идентификатору. Получающееся GSSName имя также будет MN.
    
    Возвраты:
    байт [] содержащий экспортируемое имя. RFC 2743 определяет "Независимый от механизма Экспортируемый Формат Объекта Имени" для этих байтов.
    
    Броски:
    
    GSSException - содержа следующие главные коды ошибки: GSSException.BAD_NAME, GSSException.BAD_NAMETYPE, GSSException.FAILURE
  - toString
```
String toString()
```
    Возвращает текстовое представление GSSName объект. Получать печатный формат имени, который определяет синтаксис возвращенной строки, использование getStringNameType метод.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    Строка, представляющая это имя в печатаемой форме.
  - getStringNameType
```
Oid getStringNameType()
                      throws GSSException
```
    Возвращает тип имени печатаемого представления этого имени, которое может быть получено из toString метод.
    
    Возвраты:
    Oid, представляющий пространство имен имени, возвратился из toString метода.
    
    Броски:
    
    GSSException - содержа следующие главные коды ошибки: GSSException.FAILURE
  - isAnonymous
```
boolean isAnonymous()
```
    Тесты, если этот объект имени представляет анонимный объект.
    
    Возвраты:
    истина, если это - анонимное имя, ложь иначе.
  - isMN
```
boolean isMN()
```
    Тесты, если этот объект имени представляет Имя Механизма (MN). MN является GSSName содержание точно примитивного элемента имени одного механизма.
    
    Возвраты:
    истина, если это - MN, ложь иначе.

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

Интерфейсный GSSName

Полевая Сводка

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

Полевая Деталь

NT_HOSTBASED_SERVICE

NT_USER_NAME

NT_MACHINE_UID_NAME

NT_STRING_UID_NAME

NT_ANONYMOUS

NT_EXPORT_NAME

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

равняется

равняется

хэш-код

канонизировать

экспорт

toString

getStringNameType

isAnonymous

isMN