Class SubmitButton

java.lang.Object
com.meterware.httpunit.FormControl
com.meterware.httpunit.Button
com.meterware.httpunit.SubmitButton
All Implemented Interfaces:
HTMLElement, ScriptingEventHandler
public class SubmitButton extends Button
This class represents a submit button in an HTML form.

  • Method Details

    • getType

      public String getType()
      Description copied from class: FormControl
      Return the type of the control, as seen from JavaScript.
      Overrides:
      getType in class Button

    • isImageButton

      public boolean isImageButton()
      Returns true if this submit button is an image map.

    • click

      public void click(int x, int y) throws IOException, SAXException
      Performs the action associated with clicking this button after running any 'onClick' script. For a submit button this typically submits the form.
      Throws:
      IOException
      SAXException
      Since:
      1.6

    • doButtonAction

      protected void doButtonAction(int x, int y) throws IOException, SAXException
      do the button Action
      Overrides:
      doButtonAction in class Button
      Parameters:
      x - - x coordinate
      y - - y coordinate
      Throws:
      IOException
      SAXException

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • isFake

      public boolean isFake()
      getter for the fake flag Returns true for synthetic submit buttons, created by HttpUnit in forms that contain no submit buttons, or used during WebForm.submitNoButton() call.
      Returns:
      - whether this button is a faked button inserted by httpunit

    • getValues

      protected String[] getValues()
      Returns the current value(s) associated with this control. These values will be transmitted to the server if the control is 'successful'.
      Overrides:
      getValues in class Button

    • isAllowUnnamedImageButton

      public static boolean isAllowUnnamedImageButton()
      Returns:
      the allowUnnamedImageButton

    • setAllowUnnamedImageButton

      public static void setAllowUnnamedImageButton(boolean allowUnnamedImageButton)
      Parameters:
      allowUnnamedImageButton - the allowUnnamedImageButton to set

    • isValidImageButton

      public boolean isValidImageButton()
      return whether this is a validImageButton
      Returns:
      true if it is an image Button

    • positionParameterName

      public String positionParameterName(String direction)
      return the name of the positionParameter for this button (if this is an image Button)
      Parameters:
      direction - e.g. "x" or "y"
      Returns:
      the name e.g. "image.x" or just "x"

    • addValues

      protected void addValues(com.meterware.httpunit.protocol.ParameterProcessor processor, String characterSet) throws IOException
      addValues if not disabled and pressed
      Overrides:
      addValues in class Button
      Parameters:
      processor - - the ParameterProcessor used
      characterSet - - the active character set
      Throws:
      IOException - if addValues fails

    • throwDisabledException

      public void throwDisabledException()
      Description copied from class: Button
      throw an exception that I'm disbled
      Overrides:
      throwDisabledException in class Button

    • getID

      public String getID()
      Description copied from interface: HTMLElement
      Returns the ID associated with this element. IDs are unique throughout the HTML document.
      Specified by:
      getID in interface HTMLElement

    • getClassName

      public String getClassName()
      Description copied from interface: HTMLElement
      Returns the class associated with this element.
      Specified by:
      getClassName in interface HTMLElement

    • getTitle

      public String getTitle()
      Description copied from interface: HTMLElement
      Returns the title associated with this element.
      Specified by:
      getTitle in interface HTMLElement

    • getName

      public String getName()
      Description copied from interface: HTMLElement
      Returns the name associated with this element.
      Specified by:
      getName in interface HTMLElement

    • getScriptingHandler

      public ScriptingHandler getScriptingHandler()
      Returns a scriptable object which can act as a proxy for this control.
      Specified by:
      getScriptingHandler in interface HTMLElement

    • doEvent

      public boolean doEvent(String eventScript)
      Deprecated.
      since 1.7 - use doEventScript instead
      handle the event that has the given script attached by compiling the eventScript as a function and executing it
      Specified by:
      doEvent in interface ScriptingEventHandler
      Parameters:
      eventScript - - the script to use
      Returns:
      true if the script is empty or the result of the script

    • doEventScript

      public boolean doEventScript(String eventScript)
      optional do the event if it's defined
      Specified by:
      doEventScript in interface ScriptingEventHandler
      Parameters:
      eventScript -
      Returns:
      true if the script is empty or the result of the script

    • handleEvent

      public boolean handleEvent(String eventName)
      Description copied from interface: ScriptingEventHandler
      handle the event with the given name by getting the attribute and then executing the eventScript for it
      Specified by:
      handleEvent in interface ScriptingEventHandler
      Parameters:
      eventName -
      Returns:
      the result of doEventScript

    • getText

      public String getText()
      Returns the text value of this block.
      Specified by:
      getText in interface HTMLElement

    • getTagName

      public String getTagName()
      Description copied from interface: HTMLElement
      Returns the tag name of this node.
      Specified by:
      getTagName in interface HTMLElement

    • getAttribute

      public String getAttribute(String name)
      get the Attribute with the given name - by delegating to NodeUtils
      Specified by:
      getAttribute in interface HTMLElement
      Parameters:
      name - - the name of the attribute to get
      Returns:
      the attribute

    • setAttribute

      public void setAttribute(String name, Object value)
      set the Attribute with the given name - by delegating to NodeUtils
      Specified by:
      setAttribute in interface HTMLElement
      Parameters:
      name - - the name of the attribute to set
      value - - the value to set

    • removeAttribute

      public void removeAttribute(String name)
      remove the Attribute with the given name - by delegating to NodeUtils
      Specified by:
      removeAttribute in interface HTMLElement
      Parameters:
      name - - the name of the attribute to remove

    • isSupportedAttribute

      public boolean isSupportedAttribute(String name)
      Description copied from interface: HTMLElement
      Returns true if this element may have an attribute with the specified name.
      Specified by:
      isSupportedAttribute in interface HTMLElement

    • getAttribute

      protected String getAttribute(String name, String defaultValue)

    • getNode

      public Node getNode()
      Description copied from interface: HTMLElement
      Returns the DOM node underlying this element.
      Specified by:
      getNode in interface HTMLElement

    • supportAttribute

      protected void supportAttribute(String name)