Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Headers extends Object implements Map<String,List<String>>
Map
< String
,List
<String
>>. Ключи являются нечувствительными к регистру Строками, представляющими имена заголовка, и значение, связанное с каждым ключом, является a List
<String
> с одним элементом для каждого происшествия заголовка называют в запросе или ответе. Например, если экземпляр заголовка ответа содержит один ключ "HeaderName" с двумя значениями "value1 и value2" тогда, этот объект выводится как две строки заголовка:
HeaderName: value1 HeaderName: value2
Все нормальное Map
методы обеспечиваются, но следующие дополнительные методы удобства, наиболее вероятно, будут использоваться:
getFirst(String)
возвращает единственный оцененный заголовок или первое значение многозначного заголовка.add(String,String)
добавляет, что данный заголовок оценивает списку для данного ключаset(String,String)
устанавливает данное поле заголовка в единственное значение, данное, перезаписывая любые существующие значения в списке значения. Все методы в этом классе принимают null
значения для ключей и значения. Однако, нулевые ключи никогда не будут присутствовать в заголовках запроса HTTP, и не будут выведены/отправлены в заголовках ответа. Нулевые значения могут быть представлены как любой нулевая запись для ключа (то есть список является нулем), или где у ключа есть список, но один (или больше) значений списка нуль. Нулевые значения выводятся как строка заголовка, содержащая ключ, но никакое присваиваемое значение.
Конструктор и Описание |
---|
Headers() |
Модификатор и Тип | Метод и Описание |
---|---|
void |
add(String key, String value)
добавляет данное значение к списку заголовков для данного ключа.
|
void |
clear()
Удаляет все отображения из этой карты (дополнительная работа).
|
boolean |
containsKey(Object key)
true возвратов, если эта карта содержит отображение для указанного ключа.
|
boolean |
containsValue(Object value)
true возвратов, если эта карта отображает один или более ключей на указанное значение.
|
Set<Map.Entry<String,List<String>>> |
entrySet()
Возвраты a
Set представление отображений содержится в этой карте. |
boolean |
equals(Object o)
Указывает, " ли некоторый другой объект равен" этому.
|
List<String> |
get(Object key)
Возвращает значение, на которое указанный ключ отображается, или
null если эта карта не содержит отображения для ключа. |
Строка |
getFirst(String key)
возвращает первое значение из Списка Строковых значений для данного ключа (если по крайней мере один существует).
|
int |
hashCode()
Возвращает значение хэш-кода для объекта.
|
boolean |
isEmpty()
true возвратов, если эта карта не содержит отображений значения ключа.
|
Set<String> |
keySet()
Возвраты a
Set представление ключей содержится в этой карте. |
List<String> |
put(String key, List<String> value)
Связывает указанное значение с указанным ключом в этой карте (дополнительная работа).
|
void |
putAll(Map<? extends String,? extends List<String>> t)
Копии все отображения от указанной карты до этой карты (дополнительная работа).
|
List<String> |
remove(Object key)
Удаляет отображение для ключа из этой карты, если это присутствует (дополнительная работа).
|
void |
set(String key, String value)
устанавливает данное значение как единственное значение заголовка для данного ключа.
|
int |
size()
Возвращает число отображений значения ключа в этой карте.
|
Collection<List<String>> |
values()
Возвраты a
Collection представление значений содержится в этой карте. |
public int size()
java.util.Map
public boolean isEmpty()
java.util.Map
public boolean containsKey(Object key)
java.util.Map
containsKey
в интерфейсе Map<String,List<String>>
key
- манипулируйте, чье присутствие в этой карте должно быть протестированоpublic boolean containsValue(Object value)
java.util.Map
containsValue
в интерфейсе Map<String,List<String>>
value
- оцените, чье присутствие в этой карте должно быть протестированоpublic List<String> get(Object key)
java.util.Map
null
если эта карта не содержит отображения для ключа. Более формально, если эта карта содержит отображение от ключа k
к значению v
так, что (key==null ? k==null : key.equals(k))
, тогда этот метод возвраты v
; иначе это возвращается null
. (Может быть самое большее одно такое отображение.)
Если эта карта разрешает нулевые значения, то возвращаемое значение null
не обязательно указывает, что карта не содержит отображения для ключа; также возможно, что карта явно отображает ключ на null
. containsKey
работа может использоваться, чтобы отличить эти два случая.
public String getFirst(String key)
key
- ключ, чтобы искатьpublic List<String> put(String key, List<String> value)
java.util.Map
m.containsKey(k)
возвратил бы true.)put
в интерфейсе Map<String,List<String>>
key
- ключ, с которым должно быть связано указанное значениеvalue
- значение, которое будет связано с указанным ключомpublic void add(String key, String value)
key
- имя заголовкаvalue
- значение заголовка, чтобы добавить к заголовкуpublic void set(String key, String value)
key
- имя заголовкаvalue
- значение заголовка, чтобы установить.public List<String> remove(Object key)
java.util.Map
(key==null ? k==null : key.equals(k))
, то отображение удаляется. (Карта может содержать самое большее одно такое отображение.) Возвращает значение который эта карта, ранее связанная ключ, или null если карта, содержавшая никакое отображение для ключа.
Если эта карта разрешает нулевые значения, то возвращаемое значение null не обязательно указывает что карта, содержавшая никакое отображение для ключа; также возможно что карта, явно отображенная ключ на null.
Карта не будет содержать отображение для указанного ключа, как только вызов возвращается.
public void putAll(Map<? extends String,? extends List<String>> t)
java.util.Map
put(k, v)
на этой карте однажды для каждого отображения от ключа k, чтобы оценить v в указанной карте. Поведение этой работы неопределено, если указанная карта изменяется, в то время как работа происходит.public void clear()
java.util.Map
public Set<String> keySet()
java.util.Map
Set
представление ключей содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственную работу remove iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и операции clear. Это не поддерживает операции addAll или add.public Collection<List<String>> values()
java.util.Map
Collection
представление значений содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственную работу remove iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Collection.remove, removeAll, retainAll и операции clear. Это не поддерживает операции addAll или add.public Set<Map.Entry<String,List<String>>> entrySet()
java.util.Map
Set
представление отображений содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Если карта изменяется, в то время как итерация по набору происходит (кроме через собственную работу remove iterator, или через работу setValue на записи карты, возвращенной iterator), результаты итерации неопределены. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll и операции clear. Это не поддерживает операции addAll или add.public boolean equals(Object o)
java.lang.Object
equals
метод реализует отношение эквивалентности на ненулевых ссылках на объект:
x
, x.equals(x)
должен возвратиться true
. x
и y
, x.equals(y)
должен возвратиться true
если и только если y.equals(x)
возвраты true
. x
, y
, и z
, если x.equals(y)
возвраты true
и y.equals(z)
возвраты true
, тогда x.equals(z)
должен возвратиться true
. x
и y
, многократные вызовы x.equals(y)
последовательно возвращайтесь true
или последовательно возвращайтесь false
, предоставленный никакая информация, используемая в equals
сравнения на объектах изменяются. x
, x.equals(null)
должен возвратиться false
. equals
метод для класса Object
реализует самое отличительное отношение эквивалентности на объектах; то есть, для любых ненулевых ссылочных значений x
и y
, этот метод возвраты true
если и только если x
и y
обратитесь к тому же самому объекту (x == y
имеет значение true
).
Отметьте, что обычно необходимо переопределить hashCode
метод всякий раз, когда этот метод переопределяется, чтобы поддержать общий контракт для hashCode
метод, который утверждает, что у равных объектов должны быть равные хэш-коды.
public int hashCode()
java.lang.Object
HashMap
. Общий контракт hashCode
:
hashCode
метод должен последовательно возвращать то же самое целое число, не предоставил информации, используемой в equals
сравнения на объекте изменяются. Эта целочисленная потребность не остается непротиворечивой от одного выполнения приложения к другому выполнению того же самого приложения. equals(Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к тому же самому целочисленному результату. Object.equals(java.lang.Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к отличным целочисленным результатам. Однако, программист должен знать, что приведение к отличным целочисленным результатам для неравных объектов может улучшить производительность хэш-таблиц. Столько, сколько разумно практично, метод хэш-кода, определенный классом Object
действительно возвращает отличные целые числа для отличных объектов. (Это обычно реализуется, преобразовывая внутренний адрес объекта в целое число, но этот метод реализации не требуется языком программирования JavaTM.)
hashCode
в интерфейсе Map<String,List<String>>
hashCode
в классе Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
Авторское право © 2005, 2011, Oracle и/или его филиалы. Все права защищены.