| com.sun.rave.web.ui.component.FormBase
 com.sun.rave.web.ui.component.Form
| Form | | public class Form extends FormBase (Code) | | Component that represents an input form.
|
| Inner Class :public static class VirtualFormDescriptor implements Serializable | |
| ID_WILD_CHAR | | final public static char ID_WILD_CHAR(Code) | | |
| addInternalVirtualForm | | public void addInternalVirtualForm(VirtualFormDescriptor descriptor)(Code) | | Add a VirtualFormDescriptor to the internal virtual forms.
If an existing VirtualFormDescriptor object is found with the same name,
the object is replaced.
Parameters:
descriptor - The VirtualFormDescriptor to add. |
| discardSubmittedValue | | public void discardSubmittedValue(EditableValueHolder inputField)(Code) | | Ensure that the supplied EditableValueHolder component
will discard (rather than retain) its submitted value when a virtual
form is submitted in which the component does not participate.
Parameters:
inputField - An EditableValueHolder component that is not a participant in the virtual form that was submittedon this request.
throws:
IllegalArgumentException - if inputField is null.
throws:
IllegalArgumentException - if a virtual form has beensubmitted and the supplied inputField participates in it. |
| discardSubmittedValues | | public void discardSubmittedValues(String virtualFormName)(Code) | | Ensure that the participants in the supplied virtual form
will discard (rather than retain) their submitted values when a
different virtual form is submitted.
Parameters:
virtualFormName - The name of a virtual form on this page which has not been submitted.
throws:
IllegalArgumentException - if no virtual form exists with the supplied name.
throws:
IllegalArgumentException - if the supplied virtual form has been submitted on this request. |
| findComponentById | | public UIComponent findComponentById(String id)(Code) | | Given a bare, partially qualified, or fully qualified id, find the component.
Unlike the inherited findComponent method, this method does recursively
search NamingContainers.
|
| fullyQualifiedIdMatchesPattern | | public static boolean fullyQualifiedIdMatchesPattern(String fqId, String pattern)(Code) | | Determine if the fully qualified id provided matches the supplied pattern.
The pattern may be a bare, partially qualified, or fully qualified id.
The pattern may also end with the
NamingContainer.SEPARATOR_CHAR followed by the
Form.ID_WILD_CHAR, in which case the children of the component
indicated by the pattern will be considered a match.
|
| generateVirtualForms | | public static VirtualFormDescriptor[] generateVirtualForms(String configStr)(Code) | | Generate an
array of VirtualFormDescriptors based on a virtual form
configuration String.
|
| generateVirtualFormsConfig | | public static String generateVirtualFormsConfig(VirtualFormDescriptor[] descriptors)(Code) | | Generate a virtual form
configuration String based on an
array of VirtualFormDescriptors.
|
| getFullyQualifiedId | | public static String getFullyQualifiedId(UIComponent component)(Code) | | Obtain the virtual form compatible fully-qualified id for the supplied component.
A fully-qualified id begins with the NamingContainer.SEPARATOR_CHAR
(representing the Form itself), contains component ids of the
component's ancestors separated by NamingContainer.SEPARATOR_CHAR,
and ends with the component's id.
|
| getVirtualFormComponentSubmits | | public VirtualFormDescriptor getVirtualFormComponentSubmits(String id)(Code) | | Get the virtual form submitted by the component whose id is provided or null if the component does not submit a virtual form.
|
| isValidFullyQualifiedId | | public static boolean isValidFullyQualifiedId(String id)(Code) | | Determine if the id provided is non-null and exhibits the traits of a
fully qualified id. This includes beginning with
NamingContainer.SEPARATOR_CHAR, not ending with that
character unless it is the only character, not ending in
Form.ID_WILD_CHAR, and not containing spaces.
|
| processDecodes | | public void processDecodes(FacesContext context)(Code) | | Override UIForm.processDecodes(FacesContext) to ensure
correct virtual form processing.
Parameters:
context - FacesContext for the current request
exception:
NullPointerException - Thrown when context is null |
| queueEvent | | public void queueEvent(FacesEvent event)(Code) | | |
| restoreNonParticipatingSubmittedValues | | public void restoreNonParticipatingSubmittedValues()(Code) | | Restore the submitted values erased by the virtual form mechanism
where appropriate.
This method is called in FormRenderer.renderStart. It should
not be called by developer code.
Note: Restoring of submitted values works on
TableRowGroup components, but does not work on the
standard faces data table component. This is because in
UIData.encodeBegin, the table's per-row saved state is
typically discarded. The result is that upon
exiting FormRenderer.renderStart, the submitted values will
be restored; however, they will subsequently be discarded.
Nonetheless, we still cache and restore those submitted values, in case
a third-party component extends
UIData and, unlike UIData, does not discard
its saved state during rendering.
|
| setSubmittedVirtualForm | | public void setSubmittedVirtualForm(VirtualFormDescriptor vfd)(Code) | | |
| setVirtualForms | | public void setVirtualForms(VirtualFormDescriptor[] vfds)(Code) | | |
| setVirtualFormsConfig | | public void setVirtualFormsConfig(String configStr)(Code) | | |
|
|