com.sun.identity.liberty.ws.interaction
クラス InteractionManager

java.lang.Object
  com.sun.identity.liberty.ws.interaction.InteractionManager

public class InteractionManager
extends Object

This class provides the interface and implementation for supporting resource owner interaction. WSC and WSP would collaborate with the singleton object instance of this class to provide and use resource owner interaction.

フィールドの概要

static String	IDP Name of URL query parameter to be used by WSC to include providerID of IDP, that was used to authenticate user.
static String	INTERACTION_NAMESPACE Name space URI of interaction service
static String	REQUEST_ID Name of suggested URL query parameter to be used by WSC to include an ID to refer to request message that led to user agent redirect.
static String	RESEND_MESSAGE Name of URL query parameter to be used by WSP to include an ID to indicate that user agent is redirected back to WSC from WSP
static String	RETURN_TO_URL Name of URL query parameter to be used by WSC to include returnToURL, while redirecting user agent to WSP.

メソッドの概要

static InteractionManager	getInstance() Gets singleton object instance of InteractionManager
InteractionResponseElement	getInteractionResponseElement(Message requestMessage) Gets interaction response that was gathered from resource owner by InteractionManager
Message	handleInteraction(Message requestMessage, InquiryElement inquiryElement, String language) Handles resource owner interactions on behalf of WSP.
Message	resendRequest(String returnToURL, HttpServletRequest httpRequest, HttpServletResponse httpResponse) Resends a previously cached SOAP request message to WSP.
Message	resendRequest(String returnToURL, HttpServletRequest httpRequest, HttpServletResponse httpResponse, Message requestMessage) Resends a SOAP request message to WSP.
Message	sendRequest(Message requestMessage, String connectTo, String certAlias, String soapAction, String returnToURL, HttpServletRequest httpRequest, HttpServletResponse httpResponse) Sends SOAP request to WSP.

フィールドの詳細

RETURN_TO_URL

public static final String RETURN_TO_URL

Name of URL query parameter to be used by WSC to include returnToURL, while redirecting user agent to WSP.

関連項目:

定数フィールド値

REQUEST_ID

public static final String REQUEST_ID

Name of suggested URL query parameter to be used by WSC to include an ID to refer to request message that led to user agent redirect.

関連項目:

定数フィールド値

IDP

public static final String IDP

Name of URL query parameter to be used by WSC to include providerID of IDP, that was used to authenticate user.

関連項目:

定数フィールド値

RESEND_MESSAGE

public static final String RESEND_MESSAGE

Name of URL query parameter to be used by WSP to include an ID to indicate that user agent is redirected back to WSC from WSP

関連項目:

定数フィールド値

INTERACTION_NAMESPACE

public static final String INTERACTION_NAMESPACE

Name space URI of interaction service

関連項目:

定数フィールド値

メソッドの詳細

getInstance

public static InteractionManager getInstance()

Gets singleton object instance of InteractionManager

戻り値:

singleton object instance of InteractionManager

sendRequest

public Message sendRequest(Message requestMessage,
                           String connectTo,
                           String certAlias,
                           String soapAction,
                           String returnToURL,
                           HttpServletRequest httpRequest,
                           HttpServletResponse httpResponse)
                    throws InteractionException,
                           InteractionRedirectException,
                           SOAPBindingException,
                           SOAPFaultException

Sends SOAP request to WSP. This would be invoked at WSC side.

パラメータ:

requestMessage - request message.

connectTo - SOAP URL to which to send the SOAP request

certAlias - SOAP Client Certificate Alias

soapAction - SOAP Action Attribute

returnToURL - URL to which to redirect user agent after WSP - resource owner interactions

httpRequest - HTTP request object of current user agent request

httpResponse - HTTP response object of current user agent request

戻り値:

response SOAP response message sent by WSP.

例外:

InteractionException - for generic interaction error

InteractionRedirectException - if user agent is redirected to WSP for resource owner interactions

SOAPBindingException - for generic SOAP binding errors

SOAPFaultException - if the response message has SOAP fault

resendRequest

public Message resendRequest(String returnToURL,
                             HttpServletRequest httpRequest,
                             HttpServletResponse httpResponse)
                      throws InteractionRedirectException,
                             InteractionException,
                             SOAPBindingException,
                             SOAPFaultException

Resends a previously cached SOAP request message to WSP. This would be invoked at WSC side. Message ID for the cached message should be provided as value of REQUEST_ID query parameter in httpRequest.

パラメータ:

returnToURL - URL to which to redirect user agent after WSP - resource owner interactions

httpRequest - HTTP request object of current user agent request

httpResponse - HTTP response object of current user agent request

戻り値:

response SOAP message sent by WSP.

例外:

InteractionException - for generic interaction error

InteractionRedirectException - if user agent is redirected to WSP for resource owner interactions

SOAPBindingException - if there are generic SOAP errors

SOAPFaultException - if the response message has SOAP fault

関連項目:

InteractionManager.REQUEST_ID

resendRequest

public Message resendRequest(String returnToURL,
                             HttpServletRequest httpRequest,
                             HttpServletResponse httpResponse,
                             Message requestMessage)
                      throws InteractionRedirectException,
                             InteractionException,
                             SOAPBindingException,
                             SOAPFaultException

Resends a SOAP request message to WSP. This would be invoked at WSC side.

パラメータ:

returnToURL - URL to which to redirect user agent after WSP - resource owner interactions

httpRequest - HTTP request object of current user agent request

httpResponse - HTTP response object of current user agent request

requestMessage - SOAP message to be resent.

戻り値:

response SOAP message sent by WSP.

例外:

InteractionException - for generic interaction error

InteractionRedirectException - if user agent is redirected to WSP for resource owner interactions

SOAPBindingException - for generic SOAP errors

SOAPFaultException - if the response message has SOAP fault

handleInteraction

public Message handleInteraction(Message requestMessage,
                                 InquiryElement inquiryElement,
                                 String language)
                          throws InteractionException,
                                 InteractionSOAPFaultException,
                                 SOAPFaultException

Handles resource owner interactions on behalf of WSP. This is invoked at WSP side.

パラメータ:

requestMessage - SOAP request that requires resource owner interactions

inquiryElement - query that WSP wants to pose to resource owner

language - language in which the query page needs to be rendered

戻り値:

SOAP message that contains InteractionResponse, gathered by InteractionManager

例外:

InteractionException - for generic interaction error

InteractionSOAPFaultException - if a SOAP fault has to be returned to WSC

SOAPFaultException - if the response message has SOAP fault

getInteractionResponseElement

public InteractionResponseElement getInteractionResponseElement(Message requestMessage)
                                                         throws InteractionException

Gets interaction response that was gathered from resource owner by InteractionManager

パラメータ:

requestMessage - request message.

戻り値:

interaction response that was gathered by InteractionManager.

例外:

InteractionException - for interaction error