|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.ibm.as400.util.html.HTMLTagAttributes
com.ibm.as400.util.html.HTMLForm
The HTMLForm class represents an HTML form.
HTMLForm objects generate the following events:
This examples creates an HTMLForm object and adds some form input types to it.
// Create a text input form element for the system. LabelFormElement sysPrompt = new LabelFormElement("System:"); TextFormInput system = new TextFormInput("System");
// Create a text input form element for the userId. LabelFormElement userPrompt = new LabelFormElement("User:"); TextFormInput user = new TextFormInput("User");
// Create a password input form element for the password. LabelFormElement passwordPrompt = new LabelFormElement("Password:"); PasswordFormInput password = new PasswordFormInput("Password");
// Create a properties object. Properties prop = new Properties();
// Add customer name and ID values to the properties object. prop.put("custName", "Mr. Toolbox"); prop.put("custID", "12345");
// Create the submit button to the form. SubmitFormInput logonButton = new SubmitFormInput("logon", "Logon");
// Create HTMLForm object and add the panel to it. HTMLForm form = new HTMLForm(servletURI); form.setHiddenParameterList(prop); form.addElement(sysPrompt); form.addElement(system); form.addElement(userPrompt); form.addElement(user); form.addElement(passwordPrompt); form.addElement(password); form.addElement(logonButton);
Here is an example of an HTMLForm tag:
<form action="servletURI" method="get"> System: <input type="text" name="System" /> User: <input type="text" name="User" /> Password: <input type="password" name="Password" /> <input type="submit" name="logon" value="Logon" /> <input type="hidden" name="custName" value="Mr. Toolbox" /> <input type="hidden" name="custID" value="12345" /> </form>
Field Summary | |
---|---|
static int |
METHOD_GET
HTTP GET Method for sending form contents to the server. |
static int |
METHOD_POST
HTTP POST Method for sending form contents to the server. |
Fields inherited from interface com.ibm.as400.util.html.HTMLConstants |
---|
ABSBOTTOM, ABSMIDDLE, BASELINE, BOTTOM, CAPITALS, CENTER, CIRCLE, DISC, JUSTIFY, LARGE_ROMAN, LEFT, LOWER_CASE, LTR, MIDDLE, NUMBERS, RIGHT, RTL, SMALL_ROMAN, SQUARE, TARGET_BLANK, TARGET_PARENT, TARGET_SELF, TARGET_TOP, TEXTTOP, TOP |
Constructor Summary | |
---|---|
HTMLForm()
Constructs a default HTMLForm object. |
|
HTMLForm(String url)
Constructs an HTMLForm object with the specified URL. |
Method Summary | |
---|---|
void |
addElement(HTMLTagElement element)
Adds a form element to the HTMLForm. |
void |
addElementListener(ElementListener listener)
Adds an ElementListener. |
void |
addVetoableChangeListener(VetoableChangeListener listener)
Adds the VetoableChangeListener. |
String |
getDirection()
Returns the direction of the text interpretation. |
String |
getFOTag()
Returns a comment tag. |
Properties |
getHiddenParameterList()
Returns the form's hidden parameter list. |
String |
getLanguage()
Returns the language of the input element. |
int |
getMethod()
Returns the HTTP method used for sending form contents to the server. |
String |
getTag()
Returns the HTML form tag. |
String |
getTarget()
Returns the target frame for the form response. |
String |
getURL()
Returns the ACTION URL address of the server-side form handler. |
boolean |
isUseGet()
Indicates if the GET method is used for sending the form contents to the server. |
boolean |
isUsePost()
Indicates if the POST method is used for sending the form contents to the server. |
void |
removeElement(HTMLTagElement element)
Removes a form element from the HTMLForm. |
void |
removeElementListener(ElementListener listener)
Removes this ElementListener from the internal list. |
void |
removeVetoableChangeListener(VetoableChangeListener listener)
Removes the VetoableChangeListener from the internal list. |
void |
setDirection(String dir)
Sets the direction of the text interpretation. |
void |
setHiddenParameterList(Properties parameterList)
Sets the form's hidden parameter list. |
void |
setLanguage(String lang)
Sets the language of the input tag. |
void |
setMethod(int method)
Sets the HTTP method used to send form contents to the server. |
void |
setTarget(String target)
Sets the target frame for the form response. |
void |
setURL(String url)
Sets the ACTION URL address of the server-side form handler. |
String |
toString()
Returns the HTMLForm tag as a String. |
Methods inherited from class com.ibm.as400.util.html.HTMLTagAttributes |
---|
addPropertyChangeListener, getAttributes, getAttributeString, removePropertyChangeListener, setAttributes |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
public static final int METHOD_GET
public static final int METHOD_POST
Constructor Detail |
public HTMLForm()
public HTMLForm(String url)
url
- The URL address.Method Detail |
public void addElement(HTMLTagElement element)
element
- The form element.public void addElementListener(ElementListener listener)
listener
- The ElementListener.removeElementListener(com.ibm.as400.util.html.ElementListener)
public void addVetoableChangeListener(VetoableChangeListener listener)
listener
- The VetoableChangeListener.removeVetoableChangeListener(java.beans.VetoableChangeListener)
public String getDirection()
public Properties getHiddenParameterList()
public String getLanguage()
public int getMethod()
public String getFOTag()
getFOTag
in interface HTMLTagElement
public String getTag()
getTag
in interface HTMLTagElement
public String getTarget()
HTMLConstants
public String getURL()
public boolean isUseGet()
public boolean isUsePost()
public void removeElement(HTMLTagElement element)
element
- The form element.public void removeElementListener(ElementListener listener)
listener
- The ElementListener.addElementListener(com.ibm.as400.util.html.ElementListener)
public void removeVetoableChangeListener(VetoableChangeListener listener)
listener
- The VetoableChangeListener.addVetoableChangeListener(java.beans.VetoableChangeListener)
public void setDirection(String dir) throws PropertyVetoException
dir
- The direction. One of the following constants
defined in HTMLConstants: LTR or RTL.
PropertyVetoException
- If a change is vetoed.HTMLConstants
public void setHiddenParameterList(Properties parameterList) throws PropertyVetoException
parameterList
- The parameter list.
PropertyVetoException
- If a change is vetoed.public void setLanguage(String lang) throws PropertyVetoException
lang
- The language. Example language tags include:
en and en-US.
PropertyVetoException
- If a change is vetoed.public void setMethod(int method) throws PropertyVetoException
method
- The method.
PropertyVetoException
- If a change is vetoed.public void setTarget(String target) throws PropertyVetoException
target
- The target frame. One of the following constants
defined in HTMLConstants: TARGET_BLANK, TARGET_PARENT,
TARGET_SELF, TARGET_TOP, or a user defined target.
PropertyVetoException
- If a change is vetoed.HTMLConstants
public void setURL(String url) throws PropertyVetoException
url
- The URL address.
PropertyVetoException
- If a change is vetoed.public String toString()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |