Класс MessageProp

java.lang.Object
- org.ietf.jgss.MessageProp

public class MessageProp
extends Object

Это вспомогательный класс, используемый внутри методов GSSContext для каждого сообщения, чтобы передавать свойства, относящиеся к каждому сообщению.

При использовании с методами wrap и getMIC интерфейса GSSContext, экземпляр этого класса используется для указания желаемого качества защиты (QOP) и для запроса применения сервисов конфиденциальности к данным, предоставленным вызывающей стороной (только для wrap). Для запроса значения QOP по умолчанию должно использоваться значение 0 для QOP.

При использовании с методами unwrap и verifyMIC интерфейса GSSContext, экземпляр этого класса будет использоваться для указания применённого QOP и сервисов конфиденциальности над предоставленным сообщением. В случае с verifyMIC состояние конфиденциальности всегда будет false. После возвращения из этих методов этот объект также будет содержать любые дополнительные статусы, применимые к обработанному токену. Дополнительные статусы могут указывать на старые токены, токены с нарушением последовательности, пропущенные токены или дублированные токены.

Since:: 1.4
См. также:: GSSContext.wrap(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.unwrap(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.getMIC(byte[], int, int, org.ietf.jgss.MessageProp), GSSContext.verifyMIC(byte[], int, int, byte[], int, int, org.ietf.jgss.MessageProp)

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

Конструктор	Описание
`MessageProp(boolean privState)`	Конструктор, устанавливающий желаемое состояние конфиденциальности.
`MessageProp(int qop, boolean privState)`	Конструктор, устанавливающий значения qop и состояния конфиденциальности.

Методы

Модификатор и тип	Метод	Описание
`int`	`getMinorStatus()`	Возвращает код дополнительного статуса, который, возможно, установил базовый механизм для данной операции над сообщением.
`String`	`getMinorString()`	Возвращает строку, объясняющую код дополнительного статуса.
`boolean`	`getPrivacy()`	Возвращает состояние конфиденциальности.
`int`	`getQOP()`	Возвращает значение QOP.
`boolean`	`isDuplicateToken()`	Проверяет, является ли это дубликатом предыдущего токена.
`boolean`	`isGapToken()`	Проверяет, не был ли ожидаемый токен получен, т.е. один или несколько предшествующих токенов ещё не были успешно обработаны.
`boolean`	`isOldToken()`	Проверяет, истек ли срок действия токена, т.е. токен слишком стар, чтобы проверять его на дублирование.
`boolean`	`isUnseqToken()`	Проверяет, был ли обработан более поздний токен.
`void`	`setPrivacy(boolean privState)`	Устанавливает состояние конфиденциальности.
`void`	`setQOP(int qop)`	Устанавливает значение QOP.
`void`	`setSupplementaryStates(boolean duplicate, boolean old, boolean unseq, boolean gap, int minorStatus, String minorString)`	Этот метод устанавливает состояние для флагов дополнительной информации и дополнительного статуса в MessageProp. Он не используется приложением, но используется реализацией GSS для возвращения этой информации вызывающей стороне метода контекста по сообщению.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

MessageProp

public MessageProp(boolean privState)

Конструктор, устанавливающий желаемое состояние конфиденциальности. Значение QOP, используемое, равно 0.

Параметры:: privState - состояние конфиденциальности

MessageProp

public MessageProp(int qop,
                   boolean privState)

Конструктор, устанавливающий значения qop и состояния конфиденциальности.

Параметры:: qop - значение QOP; privState - состояние конфиденциальности

Методы

getQOP

public int getQOP()

Возвращает значение QOP.

Возвращает:: целое число, представляющее значение QOP
См. также:: setQOP(int)

getPrivacy

public boolean getPrivacy()

Возвращает состояние конфиденциальности.

Возвращает:: true, если состояние конфиденциальности (т.е. конфиденциальности) истинно, иначе false.
См. также:: setPrivacy(boolean)

setQOP

public void setQOP(int qop)

Устанавливает значение QOP.

Параметры:: qop - целое значение, для установки QOP
См. также:: getQOP()

setPrivacy

public void setPrivacy(boolean privState)

Устанавливает состояние конфиденциальности.

Параметры:: privState - true, если состояние конфиденциальности (т.е. конфиденциальности) истинно, иначе false.
См. также:: getPrivacy()

isDuplicateToken

public boolean isDuplicateToken()

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

Возвращает:: true, если это дубликат, иначе false.

isOldToken

public boolean isOldToken()

Проверяет, истек ли срок действия токена, т.е. токен слишком стар, чтобы проверять его на дублирование.

Возвращает:: true, если срок действия токена истек, иначе false.

isUnseqToken

public boolean isUnseqToken()

Проверяет, был ли обработан более поздний токен.

Возвращает:: true, если более поздний токен был обработан, иначе false.

isGapToken

public boolean isGapToken()

Проверяет, не был ли ожидаемый токен получен, т.е. один или несколько предшествующих токенов ещё не были успешно обработаны.

Возвращает:: true, если ожидаемый токен по сообщению не был получен, иначе false.

getMinorStatus

public int getMinorStatus()

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

Возвращает:: дополнительный статус

getMinorString

public String getMinorString()

Возвращает строку, объясняющую код дополнительного статуса.

Возвращает:: строка, соответствующая коду дополнительного статуса. null будет возвращено, когда код дополнительного статуса не был установлен.

setSupplementaryStates

public void setSupplementaryStates(boolean duplicate,
                                   boolean old,
                                   boolean unseq,
                                   boolean gap,
                                   int minorStatus,
                                   String minorString)

Этот метод устанавливает состояние для флагов дополнительной информации и дополнительного статуса в MessageProp. Он не используется приложением, но используется реализацией GSS для возвращения этой информации вызывающей стороне метода контекста по сообщению.

Параметры:: duplicate - true, если токен был дубликатом предыдущего токена, иначе false; old - true, если срок действия токена истек, иначе false; unseq - true, если более поздний токен уже был обработан, иначе false; gap - true, если один или несколько предшествующих токенов ещё не были успешно обработаны, иначе false; minorStatus - код дополнительного статуса для операции над сообщением; minorString - текстовое представление значения minorStatus