FormRequestContext (FORMCYCLE: BOM 6.6.0 API)

java.lang.Object
- de.xima.fc.form.request.FormRequestContext

All Implemented Interfaces:

IFormRequestContext, Serializable

Direct Known Subclasses:

ExtendedFormRequestContext
```
public class FormRequestContext
extends Object
implements IFormRequestContext
```
Context of an form-request with all data for working with further contexts like IFormRenderContext, IFormPersistContext or IFormProcessContext

Author:

XIMA MEDIA GmbH

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected String`	`baseUrl`
`protected ProjectDOIData`	`doubleOptInData`
`protected IFormDataAdapter`	`formData`
`protected FormVersion`	`formVersion`
`protected FrontendServer`	`frontendServer`
`protected FRQSession`	`frqSession`
`protected boolean`	`isBenutzerZugriffAllowed`
`protected boolean`	`isCheckForm`
`protected boolean`	`isContinueProcessing`
`protected boolean`	`isFrontendServerAllowed`
`protected boolean`	`isOldVersion`
`protected boolean`	`isPreview`
`protected boolean`	`isResubmit`
`protected boolean`	`isReview`
`protected boolean`	`isRunWorkflow`
`protected boolean`	`isSaveOnly`
`protected boolean`	`isUseCurrentFv`
`protected Locale`	`locale`
`protected static org.slf4j.Logger`	`LOG`
`protected Mandant`	`mandant`
`protected ParameterWrapper`	`parameterWrapper`
`protected Projekt`	`projekt`
`protected EFormRequestType`	`requestType`
`protected Map<String,Serializable>`	`sessionAttributes`
`protected String`	`sessionId`
`protected UserContext`	`uc`
`protected Benutzer`	`user`
`protected List<BenutzerGruppe>`	`userGroups`
`protected List<Postfach>`	`userInboxes`
`protected org.pac4j.core.profile.CommonProfile`	`userProfile`
`protected Vorgang`	`vorgang`
`protected XfcSession`	`xfcSession`

Constructor Summary

Constructors
Modifier Constructor and Description

protected FormRequestContext(EFormRequestType requestType, UserContext uc)

Constructors
Modifier	Constructor and Description
`protected`	`FormRequestContext(EFormRequestType requestType, UserContext uc)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`com.alibaba.fastjson.JSONObject`	`createUserDataJSON()`
`String`	`getBaseUrl()`
`ProjectDOIData`	`getDoubleOptInData()`
`IFormDataAdapter`	`getFormData()`
`FormVersion`	`getFormVersion()`
`FrontendServer`	`getFrontendServer()`
`FRQSession`	`getFRQSession()`
`Locale`	`getLocale()`
`Mandant`	`getMandant()`
`ParameterWrapper`	`getParameterWrapper()` !
`Projekt`	`getProjekt()`
`EFormRequestType`	`getRequestType()`
`XfcSession`	`getSession()`
`Map<String,Serializable>`	`getSessionAttributeMap()`
`SessionAttributes`	`getSessionAttributes()` Deprecated. use `getSessionAttributeMap()`
`String`	`getSessionID()`
`UploadParameters`	`getUploadParameters()`
`Boolean`	`getUseCurrentFv()`
`Benutzer`	`getUser()`
`UserContext`	`getUserContext()`
`List<BenutzerGruppe>`	`getUserGroups()`
`List<Postfach>`	`getUserInboxes()`
`org.pac4j.core.profile.CommonProfile`	`getUserProfile()`
`ValueParameters`	`getValueParameters()`
`Vorgang`	`getVorgang()`
`void`	`initFormData(ParameterWrapper rp)`
`boolean`	`isAnonymize()`
`boolean`	`isBenutzerZugriffAllowed()`
`boolean`	`isCheckForm()`
`boolean`	`isContinueProcessing()`
`boolean`	`isFrontendServerAllowed()`
`boolean`	`isOldVersion()`
`boolean`	`isPreview()`
`boolean`	`isResubmit()`
`boolean`	`isReview()`
`boolean`	`isSaveOnly()`
`boolean`	`isUseCurrentFv()`
`void`	`loadUserData(FormUserRequestData userData)`
`void`	`setAnonymize(boolean anonymize)`
`void`	`setBaseUrl(String baseUrl)`
`void`	`setBenutzerZugriffAllowed(boolean isBenutzerZugriffAllowed)`
`void`	`setCheckForm(boolean checkForm)`
`void`	`setContinueProcessing(boolean isContinueProcessing)`
`void`	`setDoubleOptInData(ProjectDOIData doubleOptInData)`
`void`	`setFormData(IFormDataAdapter formData)`
`void`	`setFormVersion(FormVersion formVersion)`
`void`	`setFrontendServer(FrontendServer frontendServer)`
`void`	`setFrontenServerAllowed(boolean isFrontendServerAllowed)`
`void`	`setFRQSession(FRQSession frqSession)`
`void`	`setLocale(Locale locale)`
`void`	`setMandant(Mandant mandant)`
`void`	`setOldVersion(boolean isOldVersion)`
`void`	`setParameterWrapper(ParameterWrapper parameterWrapper)` Deprecated.
`void`	`setPreview(boolean isPreview)`
`void`	`setProjekt(Projekt projekt)`
`void`	`setRequestType(EFormRequestType requestType)`
`void`	`setResubmit(boolean isResubmit)`
`void`	`setReview(boolean isReview)`
`void`	`setSaveOnly(boolean saveOnly)`
`void`	`setSession(XfcSession xfcSession)`
`void`	`setSessionAttributeMap(Map<String,Serializable> sessionAttributes)`
`void`	`setSessionAttributes(SessionAttributes sessionAttributes)` Deprecated. use `setSessionAttributeMap(Map)`
`void`	`setSessionID(String sessionID)`
`void`	`setUseCurrentFv(boolean isUseCurrentFv)`
`void`	`setUser(Benutzer user)`
`void`	`setUserContext(UserContext uc)`
`void`	`setUserGroups(List<BenutzerGruppe> userGroups)`
`void`	`setUserInboxes(List<Postfach> userInboxes)`
`void`	`setUserProfile(org.pac4j.core.profile.CommonProfile userData)`
`void`	`setVorgang(Vorgang vorgang)`
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.xima.fc.interfaces.form.IFormRequestContext
getBenutzerGruppen, getBenutzerPostfaecher, getCurrentBenutzer, getRequestContext, setBenutzerGruppen, setBenutzerPostfaecher, setCurrentBenutzer, setRequestContest, setRequestContext

- Field Detail
  - LOG
```
protected static final org.slf4j.Logger LOG
```
  - xfcSession
```
protected XfcSession xfcSession
```
  - frqSession
```
protected FRQSession frqSession
```
  - sessionId
```
protected String sessionId
```
  - baseUrl
```
protected String baseUrl
```
  - locale
```
protected Locale locale
```
  - mandant
```
protected Mandant mandant
```
  - formVersion
```
protected FormVersion formVersion
```
  - vorgang
```
protected Vorgang vorgang
```
  - projekt
```
protected Projekt projekt
```
  - doubleOptInData
```
protected ProjectDOIData doubleOptInData
```
  - user
```
protected Benutzer user
```
  - userProfile
```
protected org.pac4j.core.profile.CommonProfile userProfile
```
  - userGroups
```
protected List<BenutzerGruppe> userGroups
```
  - userInboxes
```
protected List<Postfach> userInboxes
```
  - frontendServer
```
protected FrontendServer frontendServer
```
  - formData
```
protected IFormDataAdapter formData
```
  - uc
```
protected UserContext uc
```
  - parameterWrapper
```
protected ParameterWrapper parameterWrapper
```
  - requestType
```
protected EFormRequestType requestType
```
  - sessionAttributes
```
protected Map<String,Serializable> sessionAttributes
```
  - isSaveOnly
```
protected boolean isSaveOnly
```
  - isResubmit
```
protected boolean isResubmit
```
  - isPreview
```
protected boolean isPreview
```
  - isReview
```
protected boolean isReview
```
  - isOldVersion
```
protected boolean isOldVersion
```
  - isRunWorkflow
```
protected boolean isRunWorkflow
```
    See Also:
    
    IFormRequestContext#isRunWorkflow()
  - isCheckForm
```
protected boolean isCheckForm
```
  - isUseCurrentFv
```
protected boolean isUseCurrentFv
```
  - isFrontendServerAllowed
```
protected boolean isFrontendServerAllowed
```
  - isBenutzerZugriffAllowed
```
protected boolean isBenutzerZugriffAllowed
```
  - isContinueProcessing
```
protected boolean isContinueProcessing
```
- Constructor Detail
  - FormRequestContext
```
protected FormRequestContext(EFormRequestType requestType,
                             UserContext uc)
                      throws ContextBuilderException
```
    Throws:
    
    ContextBuilderException
- Method Detail
  - getFormData
```
public IFormDataAdapter getFormData()
```
    Specified by:
    
    getFormData in interface IFormRequestContext
    
    Returns:
    
    An IFormDataAdapter that can be used to access the current form data, ie. the submitted or already present values for each form field.
  - setFormData
```
public void setFormData(IFormDataAdapter formData)
```
    Specified by:
    
    setFormData in interface IFormRequestContext
  - getFormVersion
```
public FormVersion getFormVersion()
```
    Specified by:
    
    getFormVersion in interface IFormRequestContext
    
    Returns:
    
    The current FormVersion that was requested.
  - setFrontendServer
```
public void setFrontendServer(FrontendServer frontendServer)
```
    Specified by:
    
    setFrontendServer in interface IFormRequestContext
  - getFrontendServer
```
public FrontendServer getFrontendServer()
```
    Specified by:
    
    getFrontendServer in interface IFormRequestContext
    
    Returns:
    
    When the form request is made to a FrontendServer, that frontend server. Otherwise, when the form request is made directly to the master server, this return null.
  - getFRQSession
```
public FRQSession getFRQSession()
```
    Specified by:
    
    getFRQSession in interface IFormRequestContext
    
    Returns:
    
    The current form request session. A form request session is opened each time a form is requested. A single IFormRequestContext.getSession() may contain multiple FRQSessions.
  - getLocale
```
public Locale getLocale()
```
    Specified by:
    
    getLocale in interface IFormRequestContext
    
    Returns:
    
    The current locale that is to be used for locale-dependent operations.
  - getMandant
```
public Mandant getMandant()
```
    Specified by:
    
    getMandant in interface IFormRequestContext
    
    Returns:
    
    The Mandant to which the current form belongs to.
  - getParameterWrapper
```
public ParameterWrapper getParameterWrapper()
```
    Description copied from interface: IFormRequestContext
    
    !READ-ONLY model of the parsed request parameters. To initialize data user IFormRequestContext.initFormData(ParameterWrapper) or IFormRequestContext.getFormData() and IFormDataAdapter.init(Map) or IFormRequestContext.setFormData(IFormDataAdapter)
    
    Specified by:
    
    getParameterWrapper in interface IFormRequestContext
    
    Returns:
    
    ParameterWrapper
  - getProjekt
```
public Projekt getProjekt()
```
    Specified by:
    
    getProjekt in interface IFormRequestContext
    
    Returns:
    
    The Projekt which contains the form that was requested.
  - getBaseUrl
```
public String getBaseUrl()
```
    Specified by:
    
    getBaseUrl in interface IFormRequestContext
  - setBaseUrl
```
public void setBaseUrl(String baseUrl)
```
    Specified by:
    
    setBaseUrl in interface IFormRequestContext
  - getRequestType
```
public EFormRequestType getRequestType()
```
    Specified by:
    
    getRequestType in interface IFormRequestContext
    
    Returns:
    
    The type of request that was made, eg. whether a new form was requested or a form was submitted.
  - getSession
```
public XfcSession getSession()
```
    Specified by:
    
    getSession in interface IFormRequestContext
    
    Returns:
    
    The current FORMCYCLE session that contains additional information not contained in the HttpSession.
  - getSessionID
```
public String getSessionID()
```
    Specified by:
    
    getSessionID in interface IFormRequestContext
    
    Returns:
    
    The current HttpSession ID.
  - getUseCurrentFv
```
public Boolean getUseCurrentFv()
```
    Specified by:
    
    getUseCurrentFv in interface IFormRequestContext
  - getUserContext
```
public UserContext getUserContext()
```
    Specified by:
    
    getUserContext in interface IFormRequestContext
    
    Returns:
    
    The current user context that contains information about the user that is currently logged in. This context is also used when you would like to open a connection to the database.
  - setUserContext
```
public void setUserContext(UserContext uc)
```
    Specified by:
    
    setUserContext in interface IFormRequestContext
  - getVorgang
```
public Vorgang getVorgang()
```
    Specified by:
    
    getVorgang in interface IFormRequestContext
    
    Returns:
    
    The current Vorgang when the form was submitted; or null when a new empty form was just requested.
  - isBenutzerZugriffAllowed
```
public boolean isBenutzerZugriffAllowed()
```
    Specified by:
    
    isBenutzerZugriffAllowed in interface IFormRequestContext
    
    Returns:
    
    true to indicate that the current Benutzer is allowed access to the request form, or false otherwise.
  - setBenutzerZugriffAllowed
```
public void setBenutzerZugriffAllowed(boolean isBenutzerZugriffAllowed)
```
    Specified by:
    
    setBenutzerZugriffAllowed in interface IFormRequestContext
  - isFrontendServerAllowed
```
public boolean isFrontendServerAllowed()
```
    Specified by:
    
    isFrontendServerAllowed in interface IFormRequestContext
    
    Returns:
    
    true if the requested form may be served by the IFormRequestContext.getFrontendServer(), or false otherwise.
  - setFrontenServerAllowed
```
public void setFrontenServerAllowed(boolean isFrontendServerAllowed)
```
    Specified by:
    
    setFrontenServerAllowed in interface IFormRequestContext
  - getUserInboxes
```
public List<Postfach> getUserInboxes()
```
    Specified by:
    
    getUserInboxes in interface IFormRequestContext
    
    Returns:
    
    A List of Postfachs which the current Benutzer can access.
  - setUserInboxes
```
public void setUserInboxes(List<Postfach> userInboxes)
```
    Specified by:
    
    setUserInboxes in interface IFormRequestContext
  - getUserGroups
```
public List<BenutzerGruppe> getUserGroups()
```
    Specified by:
    
    getUserGroups in interface IFormRequestContext
    
    Returns:
    
    A List of BenutzerGruppes to which the current Benutzer belongs to.
  - setUserGroups
```
public void setUserGroups(List<BenutzerGruppe> userGroups)
```
    Specified by:
    
    setUserGroups in interface IFormRequestContext
  - createUserDataJSON
```
public com.alibaba.fastjson.JSONObject createUserDataJSON()
```
    Specified by:
    
    createUserDataJSON in interface IFormRequestContext
  - initFormData
```
public void initFormData(ParameterWrapper rp)
```
    Specified by:
    
    initFormData in interface IFormRequestContext
  - isAnonymize
```
public boolean isAnonymize()
```
    Specified by:
    
    isAnonymize in interface IFormRequestContext
    
    Returns:
    
    true to indicate the form submission should be made anonymously, or false otherwise. When the form is anonymized, no meta data is saved regarding the user who submitted the form.
  - isCheckForm
```
public boolean isCheckForm()
```
    Specified by:
    
    isCheckForm in interface IFormRequestContext
    
    Returns:
    
    true to indicate the form should be validated on the server, or false otherwise.
  - isContinueProcessing
```
public boolean isContinueProcessing()
```
    Specified by:
    
    isContinueProcessing in interface IFormRequestContext
    
    Returns:
    
    true if this form request should be processed further, or false to indicate that processing should be aborted.
  - isOldVersion
```
public boolean isOldVersion()
```
    Specified by:
    
    isOldVersion in interface IFormRequestContext
    
    Returns:
    
    true if an old version was requested, or false otherwise.
  - isResubmit
```
public boolean isResubmit()
```
    Specified by:
    
    isResubmit in interface IFormRequestContext
    
    Returns:
    
    true when the form was not submitted for the first time and a Vorgang exists already, false otherwise.
  - isReview
```
public boolean isReview()
```
    Specified by:
    
    isReview in interface IFormRequestContext
    
    Returns:
    
    true if a review was requested (when opening a form in the inbox), or false otherwise.
  - isSaveOnly
```
public boolean isSaveOnly()
```
    Specified by:
    
    isSaveOnly in interface IFormRequestContext
  - setSaveOnly
```
public void setSaveOnly(boolean saveOnly)
```
    Specified by:
    
    setSaveOnly in interface IFormRequestContext
  - isUseCurrentFv
```
public boolean isUseCurrentFv()
```
    Specified by:
    
    isUseCurrentFv in interface IFormRequestContext
    
    Returns:
    
    true if the latest version of the form is to be used, false if a specific form version was requested.
  - setAnonymize
```
public void setAnonymize(boolean anonymize)
```
    Specified by:
    
    setAnonymize in interface IFormRequestContext
  - setCheckForm
```
public void setCheckForm(boolean checkForm)
```
    Specified by:
    
    setCheckForm in interface IFormRequestContext
  - setContinueProcessing
```
public void setContinueProcessing(boolean isContinueProcessing)
```
    Specified by:
    
    setContinueProcessing in interface IFormRequestContext
  - getUser
```
public Benutzer getUser()
```
    Specified by:
    
    getUser in interface IFormRequestContext
    
    Returns:
    
    The user who is currently logged in and requested the form. In case the user is not logged in, this will be an anonymous user.
  - setUser
```
public void setUser(Benutzer user)
```
    Specified by:
    
    setUser in interface IFormRequestContext
  - setUserProfile
```
public void setUserProfile(org.pac4j.core.profile.CommonProfile userData)
```
    Specified by:
    
    setUserProfile in interface IFormRequestContext
  - getUserProfile
```
public org.pac4j.core.profile.CommonProfile getUserProfile()
```
    Specified by:
    
    getUserProfile in interface IFormRequestContext
  - setFormVersion
```
public void setFormVersion(FormVersion formVersion)
```
    Specified by:
    
    setFormVersion in interface IFormRequestContext
  - setFRQSession
```
public void setFRQSession(FRQSession frqSession)
```
    Specified by:
    
    setFRQSession in interface IFormRequestContext
  - setLocale
```
public void setLocale(Locale locale)
```
    Specified by:
    
    setLocale in interface IFormRequestContext
  - setMandant
```
public void setMandant(Mandant mandant)
```
    Specified by:
    
    setMandant in interface IFormRequestContext
  - setOldVersion
```
public void setOldVersion(boolean isOldVersion)
```
    Specified by:
    
    setOldVersion in interface IFormRequestContext
  - setProjekt
```
public void setProjekt(Projekt projekt)
```
    Specified by:
    
    setProjekt in interface IFormRequestContext
  - setRequestType
```
public void setRequestType(EFormRequestType requestType)
```
    Specified by:
    
    setRequestType in interface IFormRequestContext
  - setResubmit
```
public void setResubmit(boolean isResubmit)
```
    Specified by:
    
    setResubmit in interface IFormRequestContext
  - setReview
```
public void setReview(boolean isReview)
```
    Specified by:
    
    setReview in interface IFormRequestContext
  - isPreview
```
public boolean isPreview()
```
    Specified by:
    
    isPreview in interface IFormRequestContext
    
    Returns:
    
    true if a preview was requested, false otherwise.
  - setPreview
```
public void setPreview(boolean isPreview)
```
    Specified by:
    
    setPreview in interface IFormRequestContext
  - setSessionID
```
public void setSessionID(String sessionID)
```
    Specified by:
    
    setSessionID in interface IFormRequestContext
  - setUseCurrentFv
```
public void setUseCurrentFv(boolean isUseCurrentFv)
```
    Specified by:
    
    setUseCurrentFv in interface IFormRequestContext
  - getValueParameters
```
public ValueParameters getValueParameters()
```
    Specified by:
    
    getValueParameters in interface IFormRequestContext
    
    Returns:
    
    All values that were submitted with this form request, ie. the values of the individual form elements. This excludes uploaded files, see IFormRequestContext.getUploadParameters().
  - setVorgang
```
public void setVorgang(Vorgang vorgang)
```
    Specified by:
    
    setVorgang in interface IFormRequestContext
  - setSession
```
public void setSession(XfcSession xfcSession)
```
    Specified by:
    
    setSession in interface IFormRequestContext
  - getUploadParameters
```
public UploadParameters getUploadParameters()
```
    Specified by:
    
    getUploadParameters in interface IFormRequestContext
    
    Returns:
    
    All files that were uploaded with this form request, usually via upload form elements.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - getSessionAttributeMap
```
public Map<String,Serializable> getSessionAttributeMap()
```
    Specified by:
    
    getSessionAttributeMap in interface IFormRequestContext
    
    Returns:
    
    A Map of all key-value pairs in the current HttpSession. Please note that changes to this map will not affect the HttpSession.
  - setSessionAttributeMap
```
public void setSessionAttributeMap(Map<String,Serializable> sessionAttributes)
```
    Specified by:
    
    setSessionAttributeMap in interface IFormRequestContext
  - loadUserData
```
public void loadUserData(FormUserRequestData userData)
```
    Specified by:
    
    loadUserData in interface IFormRequestContext
  - getDoubleOptInData
```
public ProjectDOIData getDoubleOptInData()
```
    Specified by:
    
    getDoubleOptInData in interface IFormRequestContext
    
    Returns:
    
    The double opt-in settings for the current form.
  - setDoubleOptInData
```
public void setDoubleOptInData(ProjectDOIData doubleOptInData)
```
    Specified by:
    
    setDoubleOptInData in interface IFormRequestContext
  - setParameterWrapper
```
@Deprecated
public void setParameterWrapper(ParameterWrapper parameterWrapper)
```
    Deprecated.
    
    Specified by:
    
    setParameterWrapper in interface IFormRequestContext
  - getSessionAttributes
```
@Deprecated
public SessionAttributes getSessionAttributes()
```
    Deprecated. use getSessionAttributeMap()
    
    Specified by:
    
    getSessionAttributes in interface IFormRequestContext
  - setSessionAttributes
```
@Deprecated
public void setSessionAttributes(SessionAttributes sessionAttributes)
```
    Deprecated. use setSessionAttributeMap(Map)
    
    Specified by:
    
    setSessionAttributes in interface IFormRequestContext

Class FormRequestContext

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface de.xima.fc.interfaces.form.IFormRequestContext

Field Detail

LOG

xfcSession

frqSession

sessionId

baseUrl

locale

mandant

formVersion

vorgang

projekt

doubleOptInData

user

userProfile

userGroups

userInboxes

frontendServer

formData

uc

parameterWrapper

requestType

sessionAttributes

isSaveOnly

isResubmit

isPreview

isReview

isOldVersion

isRunWorkflow

isCheckForm

isUseCurrentFv

isFrontendServerAllowed

isBenutzerZugriffAllowed

isContinueProcessing

Constructor Detail

FormRequestContext

Method Detail

getFormData

setFormData

getFormVersion

setFrontendServer

getFrontendServer

getFRQSession

getLocale

getMandant

getParameterWrapper

getProjekt

getBaseUrl

setBaseUrl

getRequestType

getSession

getSessionID

getUseCurrentFv

getUserContext

setUserContext

getVorgang

isBenutzerZugriffAllowed

setBenutzerZugriffAllowed

isFrontendServerAllowed

setFrontenServerAllowed

getUserInboxes

setUserInboxes

getUserGroups

setUserGroups

createUserDataJSON

initFormData

isAnonymize

isCheckForm

isContinueProcessing

isOldVersion

isResubmit

isReview

isSaveOnly

setSaveOnly

isUseCurrentFv