Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС |
ФРЕЙМЫ |
||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface HttpSession
Обеспечивает способ идентифицировать пользователя через запрос на больше чем одну страницу или посещение Веб-сайта и хранить информацию о том пользователе.
Контейнер сервлета использует этот интерфейс, чтобы создать сеанс между клиентом HTTP и сервером HTTP. Сеанс сохраняется в течение периода требуемого времени больше чем через одно соединение или запрос страницы от пользователя. Сеанс обычно соответствует одному пользователю, который может посетить сайт много раз. Сервер может поддержать сеанс разными способами, такой как использование cookie или перезапись URL.
Этот интерфейс позволяет сервлеты
Когда приложение хранит объект в или удаляет объект из сеанса, проверки сеанса, реализует ли объект HttpSessionBindingListener
. Если это делает, сервлет уведомляет объект, что это было связано с или несвязанное от сеанса. Уведомления отправляются после обязательных полных методов. Для сеанса, которые лишаются законной силы или истекают, отправляются уведомления после того, как сеанс был лишен законной силы или истек.
Когда контейнер перемещает сеанс между VMs в распределенной контейнерной установке, все атрибуты сеанса, реализовывая HttpSessionActivationListener
интерфейс уведомляется.
Сервлет должен быть в состоянии обработать случаи, в которых клиент не хочет присоединяться к сеансу, такой как тогда, когда cookie преднамеренно выключаются. Пока клиент не присоединяется к сеансу, isNew
возвраты true
. Если клиент хочет не присоединяться к сеансу, getSession
возвратит различный сеанс по каждому запросу, и isNew
будет всегда возвращаться true
.
Информация о сеансе является определяющей контекст только к текущему веб-приложению (ServletContext
), таким образом, информация, хранившая в одном контексте, не будет непосредственно видима в другом.
HttpSessionBindingListener
, HttpSessionContext
Сводка метода | |
---|---|
java.lang.Object |
getAttribute(java.lang.String name)
Возвращает объект, связанный с указанным именем в этом сеансе, или null если никакой объект не связывается под именем. |
java.util.Enumeration<java.lang.String> |
getAttributeNames()
Возвраты Enumeration из String объекты, содержащие имена всех объектов, связанных с этим сеансом. |
long |
getCreationTime()
Возвращает время, когда этот сеанс создавался, измеренный в миллисекундах с полуночи 1 января 1970 GMT. |
java.lang.String |
getId()
Возвращает строку, содержащую уникальный идентификатор, присвоенный этому сеансу. |
long |
getLastAccessedTime()
Возвращает в прошлый раз клиент, отправленный запрос, связанный с этим сеансом, как число миллисекунд с полуночи 1 января 1970 GMT, и отмеченный к этому времени контейнер, полученный запрос. |
int |
getMaxInactiveInterval()
Возвращает максимальный временной интервал, в секундах, что контейнер сервлета сохранит этот сеанс открытым между клиентскими доступами. |
ServletContext |
getServletContext()
Возвращает ServletContext, которому принадлежит этот сеанс. |
HttpSessionContext |
getSessionContext()
Осуждаемый. С Версии 2.1 этот метод осуждается и не имеет никакой замены. Это будет удалено в будущей версии API Сервлета Java. |
java.lang.Object |
getValue(java.lang.String name)
Осуждаемый. С Версии 2.2 этот метод заменяется getAttribute(java.lang.String) . |
java.lang.String[] |
getValueNames()
Осуждаемый. С Версии 2.2 этот метод заменяется getAttributeNames() |
void |
invalidate()
Лишает законной силы этот сеанс, тогда развязывает любые объекты, связанные с этим. |
boolean |
isNew()
Возвраты true если клиент еще не знает о сеансе или если клиент хочет не присоединяться к сеансу. |
void |
putValue(java.lang.String name, java.lang.Object value)
Осуждаемый. С Версии 2.2 этот метод заменяется setAttribute(java.lang.String, java.lang.Object) |
void |
removeAttribute(java.lang.String name)
Удаляет объект, связанный с указанным именем от этого сеанса. |
void |
removeValue(java.lang.String name)
Осуждаемый. С Версии 2.2 этот метод заменяется removeAttribute(java.lang.String) |
void |
setAttribute(java.lang.String name, java.lang.Object value)
Связывает объект с этим сеансом, используя определенное имя. |
void |
setMaxInactiveInterval(int interval)
Определяет время, в секундах, между клиентскими запросами прежде, чем контейнер сервлета лишит законной силы этот сеанс. |
Деталь метода |
---|
long getCreationTime()
long
определение, когда этот сеанс создавался, выражало в миллисекундах с тех пор 01.01.1970 GMT IllegalStateException
- если этот метод вызывают на лишенном законной силы сеансеjava.lang.String getId()
long getLastAccessedTime()
Меры, которые Ваше приложение предпринимает, такие как получение или установка значения, связанного с сеансом, не влияют на время доступа.
long
представление в прошлый раз клиент, отправленный запрос, связанный с этим сеансом, выраженным в миллисекундах с тех пор 01.01.1970 GMT IllegalStateException
- если этот метод вызывают на лишенном законной силы сеансеServletContext getServletContext()
void setMaxInactiveInterval(int interval)
Значение interval нуля или меньше указывает, что сеанс никогда не должен тайм-аут.
interval
- Целое число, определяющее число секундint getMaxInactiveInterval()
setMaxInactiveInterval
метод. Возвращаемое значение нуля или меньше указывает, что сеанс никогда не будет тайм-аут.
setMaxInactiveInterval(int)
HttpSessionContext getSessionContext()
java.lang.Object getAttribute(java.lang.String name)
null
если никакой объект не связывается под именем.
name
- строка, определяющая имя объекта IllegalStateException
- если этот метод вызывают на лишенном законной силы сеансеjava.lang.Object getValue(java.lang.String name)
getAttribute(java.lang.String)
.
name
- строка, определяющая имя объекта IllegalStateException
- если этот метод вызывают на лишенном законной силы сеансеjava.util.Enumeration<java.lang.String> getAttributeNames()
Enumeration
из String
объекты, содержащие имена всех объектов, связанных с этим сеансом.
Enumeration
из String
объекты, определяющие имена всех объектов, связанных с этим сеансом IllegalStateException
- если этот метод вызывают на лишенном законной силы сеансеjava.lang.String[] getValueNames()
getAttributeNames()
String
объекты, определяющие имена всех объектов, связанных с этим сеансом IllegalStateException
- если этот метод вызывают на лишенном законной силы сеансеvoid setAttribute(java.lang.String name, java.lang.Object value)
После того, как этот метод выполняется, и если новый объект реализует HttpSessionBindingListener
, контейнерные вызовы HttpSessionBindingListener.valueBound
. Контейнер тогда уведомляет любого HttpSessionAttributeListener
s в веб-приложении.
Если объект был уже связан с этим сеансом этого имени, которое реализует HttpSessionBindingListener
, HttpSessionBindingListener.valueUnbound
метод вызывают.
Если значение, которое передают в, является нулем, это имеет тот же самый эффект как вызов
removeAttribute()
.
name
- the name to which the object is bound; cannot be nullvalue
- the object to be bound IllegalStateException
- if this method is called on an invalidated session
void putValue(java.lang.String name, java.lang.Object value)
setAttribute(java.lang.String, java.lang.Object)
name
- the name to which the object is bound; cannot be nullvalue
- the object to be bound; cannot be null IllegalStateException
- if this method is called on an invalidated sessionvoid removeAttribute(java.lang.String name)
After this method executes, and if the object implements HttpSessionBindingListener
, the container calls HttpSessionBindingListener.valueUnbound
. The container then notifies any HttpSessionAttributeListener
s in the web application.
name
- the name of the object to remove from this session IllegalStateException
- if this method is called on an invalidated sessionvoid removeValue(java.lang.String name)
removeAttribute(java.lang.String)
name
- the name of the object to remove from this session IllegalStateException
- if this method is called on an invalidated sessionvoid invalidate()
IllegalStateException
- if this method is called on an already invalidated sessionboolean isNew()
true
if the client does not yet know about the session or if the client chooses not to join the session. For example, if the server used only cookie-based sessions, and the client had disabled the use of cookies, then a session would be new on each request.
true
if the server has created a session, but the client has not yet joined IllegalStateException
- if this method is called on an already invalidated session
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС |
ФРЕЙМЫ |
||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to
Generated on 10-February-2011 12:41