oracle.adf.view.faces.component.core
Class CoreSubform

java.lang.Object
  javax.faces.component.UIComponent
      oracle.adf.view.faces.component.UIXComponent
          oracle.adf.view.faces.component.UIXComponentBase
              oracle.adf.view.faces.component.UIXSubform
                  oracle.adf.view.faces.component.core.CoreSubform

All Implemented Interfaces:

NamingContainer, StateHolder

public class CoreSubform

extends UIXSubform

The CoreSubform represents an independently submittable region of a page. The contents of a subform will only be validated (or otherwise processed) if a component inside of the subform is responsible for submitting the page. This allows for comparatively fine-grained control of which components will be validated and pushed into the model without the compromises of using entirely separate form elements.

We strongly recommend the use of a single <af:form> per page, and using <af:subform> where you might otherwise be tempted to use multiple forms. Multiple forms require multiple copies of page state, and user edits in forms that aren't submitted are always lost. When a page using subforms is submitted, page state is only written once, and all user edits are preserved.

See the UIXSubform Javadoc for more details on how subforms work.

Example:

 <af:form>
   <af:subform>... search region ... </af:subform>
   <af:subform default="true"> ... main content ... </af:subform>
 </af:form>

Field Summary

static java.lang.String	COMPONENT_FAMILY
static java.lang.String	COMPONENT_TYPE
static FacesBean.Type	TYPE

Fields inherited from class oracle.adf.view.faces.component.UIXSubform

DEFAULT_KEY, SUBMITTED_KEY

Fields inherited from class oracle.adf.view.faces.component.UIXComponentBase

BINDING_KEY, ID_KEY, RENDERED_KEY, RENDERER_TYPE_KEY, TRANSIENT_KEY

Fields inherited from interface javax.faces.component.NamingContainer

SEPARATOR_CHAR

Constructor Summary

	CoreSubform() Construct an instance of the CoreSubform.
protected	CoreSubform(java.lang.String rendererType) Construct an instance of the CoreSubform.

Method Summary

protected FacesBean.Type	getBeanType()
java.lang.String	getFamily()

Methods inherited from class oracle.adf.view.faces.component.UIXSubform

isDefault, isSubmitted, processDecodes, processUpdates, processValidators, queueEvent, setDefault, setSubmitted

Methods inherited from class oracle.adf.view.faces.component.UIXComponentBase

addAttributeChange, addAttributeChange, addAttributeChangeListener, addFacesListener, broadcast, createFacesBean, decode, decodeChildren, decodeChildrenImpl, encodeAll, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributeChangeListener, getAttributeChangeListeners, getAttributes, getBooleanProperty, getChildCount, getChildren, getClientId, getFacesBean, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacetNames, getFacets, getFacetsAndChildren, getId, getIntProperty, getLifecycleRenderer, getLocalClientId, getParent, getProperty, getPropertyKey, getRenderer, getRendererType, getRendersChildren, getValueBinding, isRendered, isTransient, processRestoreState, processSaveState, removeAttributeChangeListener, removeFacesListener, restoreState, saveState, setAttributeChangeListener, setBooleanProperty, setId, setIntProperty, setParent, setProperty, setRendered, setRendererType, setTransient, setValueBinding, toString, updateChildren, updateChildrenImpl, validateChildren, validateChildrenImpl

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

TYPE

public static final FacesBean.Type TYPE

COMPONENT_FAMILY

public static final java.lang.String COMPONENT_FAMILY

See Also:

Constant Field Values

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE

See Also:

Constant Field Values

Constructor Detail

CoreSubform

public CoreSubform()

Construct an instance of the CoreSubform.

CoreSubform

protected CoreSubform(java.lang.String rendererType)

Construct an instance of the CoreSubform.

Method Detail

getFamily

public java.lang.String getFamily()

Overrides:

getFamily in class UIXSubform

getBeanType

protected FacesBean.Type getBeanType()

Overrides:

getBeanType in class UIXSubform