Spec-Zone .ru спецификации, руководства, описания, API

javax.xml.rpc.server
Интерфейс ServletEndpointContext

public interface ServletEndpointContext

ServletEndpointContext обеспечивает контекст конечной точки, сохраняемый базовым контейнером сервлета базируемая система времени выполнения JAX-RPC. Для конечных точек службы, развернутых на контейнере сервлета базируемая система времени выполнения JAX-RPC, параметр контекста в ServiceLifecycle.init метод обязан иметь тип Java javax.xml.rpc.server.ServletEndpointContext.

Контейнер сервлета базируемая система времени выполнения JAX-RPC реализует ServletEndpointContext интерфейс. Система времени выполнения JAX-RPC обязана обеспечивать соответствующий сеанс, контекст сообщения, контекст сервлета и пользовательскую информацию о принципале на вызов метода на конечной точке class.

Версия:

1.1

Автор:

Рэхул Шарма, Роберто Чинници

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

HttpSession	getHttpSession() getHttpSession метод возвращает текущий сеанс HTTP (как a javax.servlet.http.HTTPSession).
MessageContext	getMessageContext() Метод getMessageContext возвраты MessageContext предназначенный для этого экземпляра конечной точки.
ServletContext	getServletContext() Метод getServletContext возвраты ServletContext связанный с веб-приложением, которые содержат эту конечную точку.
java.security.Principal	getUserPrincipal() Возвраты a java.security.Principal экземпляр, который содержит имя аутентифицируемого пользователя для текущего вызова метода на экземпляре конечной точки.
boolean	isUserInRole(java.lang.String role) Возвращает булево указание, включается ли аутентифицируемый пользователь для текущего вызова метода на экземпляре конечной точки в указанную логическую "роль".

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

getMessageContext

MessageContext getMessageContext()

Метод getMessageContext возвраты MessageContext предназначенный для этого экземпляра конечной точки. Это включает экземпляру конечной точки службы к acccess MessageContext распространенный запросом HandlerChain (и его содержавший Handler экземпляры) к целевому экземпляру конечной точки и совместно использовать любое сообщение SOAP, обрабатывающее связанный контекст. Экземпляр конечной точки может получить доступ и управлять MessageContext и совместно используйте сообщение SOAP, обрабатывающее связанный контекст с ответом HandlerChain.

Возвраты:

MessageContext; Если есть не связано MessageContext, этот метод возвраты null.

Броски:

java.lang.IllegalStateException - если этот метод вызывается вне удаленной реализации метода экземпляром конечной точки службы.

См. Также:

MessageContext, HandlerChain, Handler

getUserPrincipal

java.security.Principal getUserPrincipal()

Возвраты a java.security.Principal экземпляр, который содержит имя аутентифицируемого пользователя для текущего вызова метода на экземпляре конечной точки. Этот метод возвраты null если еще нет никакого связанного принципала. Базовая система времени выполнения JAX-RPC берет на себя ответственность обеспечения соответствующего аутентифицируемого принципала для удаленного вызова метода на экземпляре конечной точки службы.

Возвраты:

A java.security.Principal для аутентифицируемого принципала, связанного с текущим вызовом на экземпляре конечной точки сервлета; Возвраты null если там никакой аутентифицируемый пользователь не связался с вызовом метода.

См. Также:

Principal

getHttpSession

HttpSession getHttpSession()

getHttpSession метод возвращает текущий сеанс HTTP (как a javax.servlet.http.HTTPSession). Когда вызвано конечной точкой службы в пределах удаленной реализации метода, getHttpSession возвращает сеанс HTTP, связанный в настоящий момент с этим вызовом метода. Этот метод возвраты null если нет никакого сеанса HTTP, в настоящий момент активного и связанного с этой конечной точкой службы. Конечная точка class не должна положиться на активный сеанс HTTP, являющийся всегда там; базовая система времени выполнения JAX-RPC ответственна за управление, есть ли активный сеанс HTTP.

getHttpSession броски метода JAXRPCException если вызвано не HTTP связанная конечная точка.

Возвраты:

Сеанс HTTP, связанный с текущим вызовом или null если нет никакого активного сеанса.

Броски:

JAXRPCException - Если этот метод, вызванный любым не-HTTP связанная конечная точка

См. Также:

HttpSession

getServletContext

ServletContext getServletContext()

Метод getServletContext возвраты ServletContext связанный с веб-приложением, которые содержат эту конечную точку. Согласно спецификации Сервлета, есть один контекст на веб-приложение (установлен как ВОЙНА) на JVM. Сервлет базируемая конечная точка службы развертывается как часть веб-приложения.

Возвраты:

ServletContext

См. Также:

ServletContext

isUserInRole

boolean isUserInRole(java.lang.String role)

Возвращает булево указание, включается ли аутентифицируемый пользователь для текущего вызова метода на экземпляре конечной точки в указанную логическую "роль".

Параметры:

role - a String определение имени роли

Возвраты:

a boolean указание, связался ли аутентифицируемый пользователь с текущим вызовом метода, принадлежит данной роли; false если пользователь не аутентифицировался