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

java.lang. Объект
- javax.security.auth.kerberos. KeyTab

```
public final class KeyTab
extends Object
```
Этот class инкапсулирует keytab файл.
Kerberos модуль входа в систему JAAS, который получает долгосрочные секретные ключи из keytab файла, должен использовать этот class. Модуль входа в систему сохранит экземпляр этого class в частном учетном наборе a Subject во время фазы фиксации процесса аутентификации.
Если a KeyTab объект получается из getUnboundInstance() или getUnboundInstance(java.io.File), это является несвязанным и таким образом может использоваться любым принципалом службы. Иначе, если это получается из getInstance(KerberosPrincipal) или getInstance(KerberosPrincipal, java.io.File), это связывается с определенным принципалом службы и может только использоваться этим.
Пожалуйста, отметьте конструкторов getInstance() и getInstance(java.io.File) создавались, когда не было никакой поддержки несвязанного keytabs. Эти методы не должны использоваться больше. Объект, создаваемый с любым из этих методов, как полагают, связывается с неизвестным принципалом, что означает, isBound() возвращает true и getPrincipal() нуль возвратов.
Могло бы быть необходимо для приложения быть предоставленным a PrivateCredentialPermission если это должно получить доступ к экземпляру KeyTab от Предмета. Это разрешение не необходимо, когда приложение зависит от значения по умолчанию JGSS механизм Kerberos, чтобы получить доступ к KeyTab. В этом случае, однако, приложение будет нуждаться в соответствующем ServicePermission.
keytab формат файла описывается в http://www.ioplex.com/utilities/keytab.txt.

С тех пор:

1.7

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

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`boolean`	`equals(Object other)` Сравнивает указанный Объект с этим KeyTab для равенства.
`boolean`	`exists()` Проверки, если keytab файл существует.
`static KeyTab`	`getInstance()` Возвращает значение по умолчанию `KeyTab` экземпляр, который связывается с неизвестным принципалом службы.
`static KeyTab`	`getInstance(File file)` Возвраты a `KeyTab` экземпляр от a `File` объект, который связывается с неизвестным принципалом службы.
`static KeyTab`	`getInstance(KerberosPrincipal princ)` Возвращает значение по умолчанию `KeyTab` экземпляр, который связывается с указанным принципалом службы.
`static KeyTab`	`getInstance(KerberosPrincipal princ, File file)` Возвраты a `KeyTab` экземпляр от a `File` объект, который связывается с указанным принципалом службы.
`KerberosKey[]`	`getKeys(KerberosPrincipal principal)` Возвращает новые ключи для данного принципала Kerberos.
`KerberosPrincipal`	`getPrincipal()` Возвращает принципал службы это `KeyTab` объект связывается с.
`static KeyTab`	`getUnboundInstance()` Возвращает несвязанное значение по умолчанию `KeyTab` экземпляр.
`static KeyTab`	`getUnboundInstance(File file)` Возвращает несвязанное `KeyTab` экземпляр от a `File` объект.
`int`	`hashCode()` Возвращает хэш-код для этого KeyTab.
`boolean`	`isBound()` Возвраты, если keytab связывается с принципалом
`Строка`	`toString()` Возвращает строковое представление объекта.

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

- Деталь метода
  - getInstance
```
public static KeyTab getInstance(File file)
```
    Возвраты a KeyTab экземпляр от a File объект, который связывается с неизвестным принципалом службы.
    Результатом этого метода никогда не является нуль. Этот метод только связывает возвращенный KeyTab объект с файлом и не читает это.
    Разработчики должны вызвать getInstance(KerberosPrincipal,File) когда связанный принципал службы известен.
    
    Параметры:
    
    file - keytab File возразите, не должен быть нуль
    
    Возвраты:
    
    keytab экземпляр
    
    Броски:
    
    NullPointerException - если file параметром является нуль
  - getUnboundInstance
```
public static KeyTab getUnboundInstance(File file)
```
    Возвращает несвязанное KeyTab экземпляр от a File объект.
    Результатом этого метода никогда не является нуль. Этот метод только связывает возвращенный KeyTab объект с файлом и не читает это.
    
    Параметры:
    
    file - keytab File возразите, не должен быть нуль
    
    Возвраты:
    
    keytab экземпляр
    
    Броски:
    
    NullPointerException - если параметром файла является нуль
    
    С тех пор:
    
    1.8
  - getInstance
```
public static KeyTab getInstance(KerberosPrincipal princ,
                                 File file)
```
    Возвраты a KeyTab экземпляр от a File объект, который связывается с указанным принципалом службы.
    Результатом этого метода никогда не является нуль. Этот метод только связывает возвращенный KeyTab объект с файлом и не читает это.
    
    Параметры:
    
    princ - связанный принципал службы, не должен быть нуль
    
    file - keytab File возразите, не должен быть нуль
    
    Возвраты:
    
    keytab экземпляр
    
    Броски:
    
    NullPointerException - если любым из параметров является нуль
    
    С тех пор:
    
    1.8
  - getInstance
```
public static KeyTab getInstance()
```
    Возвращает значение по умолчанию KeyTab экземпляр, который связывается с неизвестным принципалом службы.
    Результатом этого метода никогда не является нуль. Этот метод только связывает возвращенный KeyTab объект со значением по умолчанию keytab файл и не читает это.
    Разработчики должны вызвать getInstance(KerberosPrincipal) когда связанный принципал службы известен.
    
    Возвраты:
    
    значение по умолчанию keytab экземпляр.
  - getUnboundInstance
```
public static KeyTab getUnboundInstance()
```
    Возвращает несвязанное значение по умолчанию KeyTab экземпляр.
    Результатом этого метода никогда не является нуль. Этот метод только связывает возвращенный KeyTab объект со значением по умолчанию keytab файл и не читает это.
    
    Возвраты:
    
    значение по умолчанию keytab экземпляр
    
    С тех пор:
    
    1.8
  - getInstance
```
public static KeyTab getInstance(KerberosPrincipal princ)
```
    Возвращает значение по умолчанию KeyTab экземпляр, который связывается с указанным принципалом службы.
    Результатом этого метода никогда не является нуль. Этот метод только связывает возвращенный KeyTab объект со значением по умолчанию keytab файл и не читает это.
    
    Параметры:
    
    princ - связанный принципал службы, не должен быть нуль
    
    Возвраты:
    
    значение по умолчанию keytab экземпляр
    
    Броски:
    
    NullPointerException - если princ нуль
    
    С тех пор:
    
    1.8
  - getKeys
```
public KerberosKey[] getKeys(KerberosPrincipal principal)
```
    Возвращает новые ключи для данного принципала Kerberos.
    Реализация этого метода должна удостовериться, что возвращенные ключи соответствуют последний контент keytab файла. Результатом является недавно создаваемая копия, которая может быть изменена вызывающей стороной, не изменяя объект keytab. Вызывающая сторона должна destroy ключи результата после того, как они используются.
    Пожалуйста, отметьте, что keytab файл может быть создан после KeyTab объект инстанцируют, и его контент может измениться в течение долгого времени. Поэтому, приложение должно вызвать этот метод только, когда это должно использовать ключи. Любое предыдущее следствие более раннего вызова могло потенциально истечься.
    Если есть ошибка (скажите, ошибка ввода-вывода или отформатируйте ошибку) во время процесса считывания файла KeyTab должен быть возвращен сохраненный результат. Если нет никакого сохраненного результата (скажите, это - первый раз, когда этот метод вызывают, или, все предыдущие отказавшие попытки чтения), пустой массив должен быть возвращен. Это может удостовериться, что результат решительно не изменяется во время (вероятно, медленный) обновление keytab файла.
    Каждый раз этот метод вызывают, и чтение файла успешно выполняется без исключения (скажите, ошибка ввода-вывода или ошибка формата файла), результат должен быть сохранен для principal. Реализация может также сохранить ключи для других принципалов, имеющих ключи в том же самом объекте keytab если удобный.
    Любое неподдерживаемое ключевое чтение от keytab игнорируется и не включается в результат.
    Если этот keytab будет связан с определенным принципалом, то вызывая этот метод на другом принципале возвратит пустой массив.
    
    Параметры:
    
    principal - принципал Kerberos, не должен быть нуль.
    
    Возвраты:
    
    ключи (никогда нуль, не может быть пустым),
    
    Броски:
    
    NullPointerException - если principal параметром является нуль
    
    SecurityException - если менеджер безопасности существует, и доступ для чтения к keytab файлу не разрешается
  - существует
```
public boolean exists()
```
    Проверки, если keytab файл существует. Реализация этого метода должна удостовериться, что результат соответствует последнее состояние keytab файла.
    Вызывающая сторона может использовать результат определить, должно ли это нейтрализация к другому механизму, чтобы считать ключи.
    
    Возвраты:
    
    истина, если keytab файл существует; ложь иначе.
    
    Броски:
    
    SecurityException - если менеджер безопасности существует, и доступ для чтения к keytab файлу не разрешается
  - toString
```
public String toString()
```
    Описание скопировало с class: Object
    Возвращает строковое представление объекта. Вообще, toString метод возвращает строку, которая "дословно представляет" этот объект. Результатом должно быть краткое, но информативное представление, которое легко для человека читать. Рекомендуется, чтобы все подклассы переопределили этот метод.
    toString метод для class Object возвращает строку, состоящую из имени class, которого объект является экземпляром, символ знака at-sign`@', и шестнадцатеричное представление без знака хэш-кода объекта. Другими словами этот метод возвращает строку, равную значению:
    getClass().getName() + '@' + Integer.toHexString(hashCode())
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    строковое представление объекта.
  - хэш-код
```
public int hashCode()
```
    Возвращает хэш-код для этого KeyTab.
    
    Переопределения:
    
    hashCode в class Object
    
    Возвраты:
    
    хэш-код () для KeyTab
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - равняется
```
public boolean equals(Object other)
```
    Сравнивает указанный Объект с этим KeyTab для равенства. Возвращает true, если данный объект также a KeyTab и два KeyTab экземпляры эквивалентны.
    
    Переопределения:
    
    equals в class Object
    
    Параметры:
    
    other - Объект сравниться с
    
    Возвраты:
    
    истина, если указанный объект равен этому KeyTab
    
    См. Также:
    
    Object.hashCode(), HashMap
  - getPrincipal
```
public KerberosPrincipal getPrincipal()
```
    Возвращает принципал службы это KeyTab объект связывается с. Возвраты null если это не связывается.
    Пожалуйста, отметьте, что осуждаемые конструкторы создают объект KeyTab, направляющийся в некоторый неизвестный принципал. В этом случае этот метод также возвращает нуль. Пользователь может вызвать isBound() проверять этот случай.
    
    Возвраты:
    
    принципал службы
    
    С тех пор:
    
    1.8
  - isBound
```
public boolean isBound()
```
    Возвраты, если keytab связывается с принципалом
    
    Возвраты:
    
    если keytab связывается с принципалом
    
    С тех пор:
    
    1.8

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

Класс KeyTab

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

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

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

getInstance

getUnboundInstance

getInstance

getInstance

getUnboundInstance

getInstance

getKeys

существует

toString

хэш-код

равняется

getPrincipal

isBound