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

java.lang. Объект
- javax.xml.ws.spi.http. HttpExchange

```
public abstract class HttpExchange
extends Object
```
Этот класс инкапсулирует полученный запрос HTTP и ответ, который будет сгенерирован в одном обмене. Это обеспечивает методы для того, чтобы они исследовали запрос от клиента, и для создания и отправки ответа.
A HttpExchange должен быть закрыт, чтобы освободить или снова использовать базовые ресурсы. Эффект того, чтобы быть не в состоянии закрыть обмен неопределен.

С тех пор:

JAX-WS 2.2

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

Поля
Модификатор и Тип	Поле и Описание
`static String`	`REQUEST_CIPHER_SUITE` Стандартное свойство: комплект шифра оценивает, когда запрос получается по HTTPS
`static String`	`REQUEST_KEY_SIZE` Стандартное свойство: диаметр долота алгоритма, когда запрос получается по HTTPS
`static String`	`REQUEST_X509CERTIFICATE` Стандартное свойство: сертификат SSL, если таковые вообще имеются, связался с запросом

Сводка конструктора

Конструкторы
Конструктор и Описание

HttpExchange()

Конструкторы
Конструктор и Описание
`HttpExchange()`

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

Методы
Модификатор и Тип	Метод и Описание
`abstract void`	`addResponseHeader(String name, String value)` Добавляет заголовок ответа с именем и значением.
`abstract void`	`close()` Это нужно вызвать, чтобы закончить обмен.
`abstract Object`	`getAttribute(String name)` Возвращает атрибут, который связывается с этим `HttpExchange`.
`abstract Set<String>`	`getAttributeNames()` Дает все названия атрибута, которые связываются с этим `HttpExchange`.
`abstract String`	`getContextPath()` Возвращает путь контекста всех конечных точек в приложении.
`abstract HttpContext`	`getHttpContext()` Возвраты a `HttpContext` для этого обмена.
`abstract InetSocketAddress`	`getLocalAddress()` Возвращает неразрешенный локальный адрес, на котором был получен запрос.
`abstract String`	`getPathInfo()` Возвращает дополнительную информацию о пути, которая следует за путем веб-сервиса, но предшествует строке запроса в URI запроса и запустится с "/" символ.
`abstract String`	`getProtocol()` Возвращает строку протокола из запроса в форме protocol/majorVersion.minorVersion.
`abstract String`	`getQueryString()` Возвращает строку запроса, которая содержится в URI запроса после пути.
`abstract InetSocketAddress`	`getRemoteAddress()` Возвращает неразрешенный адрес удаленного объекта, вызывающего этот запрос.
`abstract InputStream`	`getRequestBody()` Возвращает поток, из которого может быть считано тело запроса.
`abstract String`	`getRequestHeader(String name)` Возвращает значение указанного заголовка запроса.
`abstract Map<String,List<String>>`	`getRequestHeaders()` Возвращает неизменную Карту, содержащую HTTP-заголовки, которые были включены с этим запросом.
`abstract String`	`getRequestMethod()` Получите метод запроса HTTP
`abstract String`	`getRequestURI()` Возвращает часть URI запроса с имени протокола до строки запроса в первой строке запроса HTTP.
`abstract OutputStream`	`getResponseBody()` Возвращает поток, которому должно быть записано тело ответа.
`abstract Map<String,List<String>>`	`getResponseHeaders()` Возвращает изменчивую Карту, в которую могут быть сохранены заголовки ответа HTTP и который будет передан как часть этого ответа.
`abstract String`	`getScheme()` Возвращает имя схемы, используемой, чтобы обратиться с этой просьбой, например: http, или https.
`abstract Principal`	`getUserPrincipal()` Возвраты `Principal` это представляет аутентифицируемого пользователя для этого `HttpExchange`.
`abstract boolean`	`isUserInRole(String role)` Указывает, включается ли аутентифицируемый пользователь в указанную логическую "роль".
`abstract void`	`setStatus(int status)` Устанавливает код состояния HTTP для ответа.

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

- Полевая Деталь
  - REQUEST_CIPHER_SUITE
```
public static final String REQUEST_CIPHER_SUITE
```
    Стандартное свойство: комплект шифра оценивает, когда запрос получается по HTTPS
    Введите: Строка
    
    См. Также:
    Постоянные Значения полей
  - REQUEST_KEY_SIZE
```
public static final String REQUEST_KEY_SIZE
```
    Стандартное свойство: диаметр долота алгоритма, когда запрос получается по HTTPS
    Введите: Целое число
    
    См. Также:
    Постоянные Значения полей
  - REQUEST_X509CERTIFICATE
```
public static final String REQUEST_X509CERTIFICATE
```
    Стандартное свойство: сертификат SSL, если таковые вообще имеются, связался с запросом
    Введите: java.security.cert. X509Certificate [] порядок этого массива определяется как являющийся в порядке возрастания из доверия. Первый сертификат в цепочке является тем, установленным клиентом, следующим является то, используемое, чтобы аутентифицировать первое и так далее.
    
    См. Также:
    Постоянные Значения полей
- Деталь конструктора
  - HttpExchange
```
public HttpExchange()
```
- Деталь метода
  - getRequestHeaders
```
public abstract Map<String,List<String>> getRequestHeaders()
```
    Возвращает неизменную Карту, содержащую HTTP-заголовки, которые были включены с этим запросом. Ключи в этой Карте будут именами заголовка, в то время как значениями будет Список Строк, содержащих каждое значение, которое было включено (или для заголовка, который был перечислен несколько раз, или тот, который принимает разграниченный запятой список значений на одной строке). В любом из этих случаев значения для имени заголовка будут представлены в порядке, что они были включены в запрос.
    Ключи в Карте являются нечувствительными к регистру.
    
    Возвраты:
    неизменная Карта, которая может привыкнуть к заголовкам запроса доступа
  - getRequestHeader
```
public abstract String getRequestHeader(String name)
```
    Возвращает значение указанного заголовка запроса. Если запрос не включал заголовок указанного имени, этого нуля возвратов метода. Если есть многократные заголовки с тем же самым именем, этот метод возвращает первый заголовок в запросе. Имя заголовка является нечувствительным к регистру. Это - convienence метод, чтобы получить заголовок (вместо того, чтобы использовать getRequestHeaders()).
    
    Параметры:
    name - имя заголовка запроса
    
    Возвраты:
    возвращает значение требуемого заголовка, или нуль, если у запроса нет заголовка того имени
  - getResponseHeaders
```
public abstract Map<String,List<String>> getResponseHeaders()
```
    Возвращает изменчивую Карту, в которую могут быть сохранены заголовки ответа HTTP и который будет передан как часть этого ответа. Ключи в Карте будут именами заголовка, в то время как значениями должен быть Список Строк, содержащих каждое значение, которое должно быть включено многократно (в порядке, что они должны быть включены).
    Ключи в Карте являются нечувствительными к регистру.
    
    Возвраты:
    изменчивая Карта, которая может использоваться, чтобы установить заголовки ответа.
  - addResponseHeader
```
public abstract void addResponseHeader(String name,
                     String value)
```
    Добавляет заголовок ответа с именем и значением. Этот метод позволяет заголовку ответа иметь многократные значения. Это - метод удобства, чтобы добавить заголовок ответа (вместо того, чтобы использовать getResponseHeaders()).
    
    Параметры:
    name - имя заголовка
    value - дополнительное значение заголовка. Если это содержит строку октета, это должно быть закодировано согласно RFC 2047 (http://www.ietf.org/rfc/rfc2047.txt)
    См. Также:
    getResponseHeaders()
  - getRequestURI
```
public abstract String getRequestURI()
```
    Возвращает часть URI запроса с имени протокола до строки запроса в первой строке запроса HTTP. Контейнер не декодирует эту строку.
    
    Возвраты:
    URI запроса
  - getContextPath
```
public abstract String getContextPath()
```
    Возвращает путь контекста всех конечных точек в приложении. Этот путь является частью URI запроса, который указывает на контекст запроса. Путь контекста всегда на первом месте в URI запроса. Путь запускается с "/" символ, но не заканчивается "/" символ. Если этот метод возвращается"", запрос для контекста по умолчанию. Контейнер не декодирует эту строку.
    Путь контекста используется в вычислениях адреса конечной точки. См. HttpContext.getPath()
    
    Возвраты:
    путь контекста всех конечных точек в приложении
    См. Также:
    HttpContext.getPath()
  - getRequestMethod
```
public abstract String getRequestMethod()
```
    Получите метод запроса HTTP
    
    Возвраты:
    метод запроса
  - getHttpContext
```
public abstract HttpContext getHttpContext()
```
    Возвраты a HttpContext для этого обмена. Контейнер соответствует запрос с HttpContext связанной Конечной точки
    
    Возвраты:
    HttpContext для этого обмена
  - близко
```
public abstract void close()
                    throws IOException
```
    Это нужно вызвать, чтобы закончить обмен. Контейнер заботится о заключительном запросе и ответных потоках. Это нужно вызвать так, чтобы контейнер мог освободить или повторное использование базовые ресурсы.
    
    Броски:
    
    IOException - если любая i/o ошибка
  - getRequestBody
```
public abstract InputStream getRequestBody()
                                    throws IOException
```
    Возвращает поток, из которого может быть считано тело запроса. Множественные вызовы этого метода возвратят тот же самый поток.
    
    Возвраты:
    поток, из которого может быть считано тело запроса.
    
    Броски:
    
    IOException - если любая i/o ошибка во время обработки запросов
  - getResponseBody
```
public abstract OutputStream getResponseBody()
                                      throws IOException
```
    Возвращает поток, которому должно быть записано тело ответа. setStatus(int)) должен быть вызван до вызова этого метода. Множественные вызовы этого метода (для того же самого обмена) возвратят тот же самый поток.
    
    Возвраты:
    поток, которому пишется тело ответа
    
    Броски:
    
    IOException - если любая i/o ошибка во время обработки ответа
  - setStatus
```
public abstract void setStatus(int status)
```
    Устанавливает код состояния HTTP для ответа.
    Этот метод нужно вызвать до вызова getResponseBody().
    
    Параметры:
    status - код ответа, чтобы передаться
    См. Также:
    getResponseBody()
  - getRemoteAddress
```
public abstract InetSocketAddress getRemoteAddress()
```
    Возвращает неразрешенный адрес удаленного объекта, вызывающего этот запрос.
    
    Возвраты:
    InetSocketAddress вызывающей стороны
  - getLocalAddress
```
public abstract InetSocketAddress getLocalAddress()
```
    Возвращает неразрешенный локальный адрес, на котором был получен запрос.
    
    Возвраты:
    InetSocketAddress локального интерфейса
  - getProtocol
```
public abstract String getProtocol()
```
    Возвращает строку протокола из запроса в форме protocol/majorVersion.minorVersion. Например, "HTTP/1.1"
    
    Возвраты:
    строка протокола от запроса
  - getScheme
```
public abstract String getScheme()
```
    Возвращает имя схемы, используемой, чтобы обратиться с этой просьбой, например: http, или https.
    
    Возвраты:
    имя схемы, используемой, чтобы обратиться с этой просьбой
  - getPathInfo
```
public abstract String getPathInfo()
```
    Возвращает дополнительную информацию о пути, которая следует за путем веб-сервиса, но предшествует строке запроса в URI запроса и запустится с "/" символ.
    Это может использоваться для MessageContext.PATH_INFO
    
    Возвраты:
    декодируемая дополнительная информация о пути веб-сервиса. Это - путь, который прибывает после пути веб-сервиса, но перед строкой запроса в URI запроса null, если нет никакого дополнительного пути в URI запроса
  - getQueryString
```
public abstract String getQueryString()
```
    Возвращает строку запроса, которая содержится в URI запроса после пути.
    Это может использоваться для MessageContext.QUERY_STRING
    
    Возвраты:
    недекодируемая строка запроса URI запроса, или null, если у URI запроса нет того
  - getAttribute
```
public abstract Object getAttribute(String name)
```
    Возвращает атрибут, который связывается с этим HttpExchange. Обработчики JAX-WS и конечные точки могут тогда получить доступ к атрибуту через MessageContext.
    Контейнеры сервлета должны представить MessageContext.SERVLET_CONTEXT, MessageContext.SERVLET_REQUEST, и MessageContext.SERVLET_RESPONSE как атрибуты.
    Если запрос был получен контейнером, используя HTTPS, следующая информация должна быть представлена как атрибуты. Эти атрибуты REQUEST_CIPHER_SUITE, и REQUEST_KEY_SIZE. Если есть сертификат SSL, связанный с запросом, он должен быть представлен, используя REQUEST_X509CERTIFICATE
    
    Параметры:
    name - название атрибута
    
    Возвраты:
    значение атрибута, или null, если атрибут не существует
  - getAttributeNames
```
public abstract Set<String> getAttributeNames()
```
    Дает все названия атрибута, которые связываются с этим HttpExchange.
    
    Возвраты:
    набор всех названий атрибута
    См. Также:
    getAttribute(String)
  - getUserPrincipal
```
public abstract Principal getUserPrincipal()
```
    Возвраты Principal это представляет аутентифицируемого пользователя для этого HttpExchange.
    
    Возвраты:
    Принципал для аутентифицируемого пользователя, или null, если не аутентифицируемый
  - isUserInRole
```
public abstract boolean isUserInRole(String role)
```
    Указывает, включается ли аутентифицируемый пользователь в указанную логическую "роль".
    
    Параметры:
    role - определяет имя роли
    
    Возвраты:
    true, если пользователь, обращающийся с этой просьбой, принадлежит данной роли

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

Класс HttpExchange

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

Сводка конструктора

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

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

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

REQUEST_CIPHER_SUITE

REQUEST_KEY_SIZE

REQUEST_X509CERTIFICATE

Деталь конструктора

HttpExchange

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

getRequestHeaders

getRequestHeader

getResponseHeaders

addResponseHeader

getRequestURI

getContextPath

getRequestMethod

getHttpContext

близко

getRequestBody

getResponseBody

setStatus

getRemoteAddress

getLocalAddress

getProtocol

getScheme

getPathInfo

getQueryString

getAttribute

getAttributeNames

getUserPrincipal

isUserInRole