/*
    * Copyright (c) 2001 - 2005 ivata limited.
    * All rights reserved.
    * -----------------------------------------------------------------------------
    * ivata masks may be redistributed under the GNU General Public
    * License as published by the Free Software Foundation;
    * version 2 of the License.
    *
    * These programs are free software; you can redistribute them and/or
   * modify them under the terms of the GNU General Public License
   * as published by the Free Software Foundation; version 2 of the License.
   *
   * These programs are distributed in the hope that they will be useful,
   * but WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
   *
   * See the GNU General Public License in the file LICENSE.txt for more
   * details.
   *
   * If you would like a copy of the GNU General Public License write to
   *
   * Free Software Foundation, Inc.
   * 59 Temple Place - Suite 330
   * Boston, MA 02111-1307, USA.
   *
   *
   * To arrange commercial support and licensing, contact ivata at
   *                  http://www.ivata.com/contact.jsp
   * -----------------------------------------------------------------------------
   * $Log: IFrameTag.java,v $
   * Revision 1.4  2005/04/09 18:04:20  colinmacleod
   * Changed copyright text to GPL v2 explicitly.
   *
   * Revision 1.3  2005/03/10 10:45:38  colinmacleod
   * Fixes for tomcat4. Changed setters and getters
   * to both use the same types.
   *
   * Revision 1.2  2005/01/19 13:14:04  colinmacleod
   * Renamed CausedByException to SystemException.
   *
   * Revision 1.1  2005/01/06 23:10:06  colinmacleod
   * Moved up a version number.
   * Changed copyright notices to 2005.
   * Updated the documentation:
   *   - started working on multiproject:site docu.
   *   - changed the logo.
   * Added checkstyle and fixed LOADS of style issues.
   * Added separate thirdparty subproject.
   * Added struts (in web), util and webgui (in webtheme) from ivata op.
   *
   * Revision 1.4  2004/11/12 15:57:21  colinmacleod
   * Removed dependencies on SSLEXT.
   * Moved Persistence classes to ivata masks.
   *
   * Revision 1.3  2004/11/03 16:12:09  colinmacleod
   * Changed fieldPath to resourceFieldPath.
   *
   * Revision 1.2  2004/03/21 21:16:35  colinmacleod
   * Shortened name to ivata op.
   *
   * Revision 1.1.1.1  2004/01/27 20:59:39  colinmacleod
   * Moved ivata op to SourceForge.
   *
   * Revision 1.2  2003/10/16 15:43:03  jano
   * Fixes problems with building and some problems with splitting to subprojects
   *
   * Revision 1.1.1.1  2003/10/13 20:49:24  colin
   * Restructured portal into subprojects
   *
   * Revision 1.4  2003/06/02 23:47:13  colin
   * added multibox tag
   *
   * Revision 1.3  2003/03/03 18:46:06  colin
   * moved masking of some tags from MaskProperties to IFrameTag
   *
   * Revision 1.2  2003/03/03 16:57:12  colin
   * converted localization to automatic paths
   * added labels
   * added mandatory fieldName attribute
   *
   * Revision 1.1  2003/02/24 19:33:33  colin
   * Moved to new subproject.
   *
   * Revision 1.6  2003/02/19 10:32:17  peter
   * added checkbox handling
   *
   * Revision 1.5  2003/02/18 16:20:53  colin
   * cosmetic documentation changes
   *
   * Revision 1.4  2003/02/13 14:29:37  peter
   * updateParentField js method is noow prepended, not appended
   * to the onchange of mask fields
   *
   * Revision 1.3  2003/02/13 08:49:34  colin
   * added checking for child maskTags
   *
   * Revision 1.2  2003/01/30 07:52:44  colin
   * bugfixes in mandatory handling
   *
  * Revision 1.1  2003/01/27 08:26:48  colin
  * first version of iframe tag
  *
  * Revision 1.1  2003/01/18 20:32:08  colin
  * added html struts override tags and help
  * -----------------------------------------------------------------------------
  */
 package com.ivata.mask.web.tag.html;
 import java.io.BufferedInputStream;
 import java.io.IOException;
 import java.io.InputStreamReader;
 import java.net.MalformedURLException;
 import java.net.URL;
 import java.net.URLConnection;
 import java.util.HashMap;
 import java.util.Iterator;
 import java.util.Map;
 
 import javax.servlet.http.HttpSession;
 import javax.servlet.jsp.JspException;
 import javax.servlet.jsp.JspWriter;
 import javax.servlet.jsp.PageContext;
 import javax.servlet.jsp.tagext.BodyContent;
 
 import org.apache.struts.taglib.TagUtils;
 import org.apache.struts.taglib.html.BaseHandlerTag;
 import org.apache.struts.taglib.html.BaseInputTag;
 import org.apache.struts.taglib.html.LinkTag;
 
 import com.ivata.mask.util.StringHandling;
 import com.ivata.mask.web.browser.Browser;
 import com.ivata.mask.web.format.HTMLFormatter;
 /***
  * <p>
  * Provides the functionality of an <code>iframe</code> tag for those browsers
  * which support it, and displays the tag body, or the contents of the
  * <code>URL</code> referenced, for those which do not.
  * </p>
  *
  * <p>
  * If you specify a <code>URL</code> via one of the <code>SecureLinkTag</code>
  * attributes, this will be displayed as the contents of the iframe, otherwise
  * the tag body is used.
  * </p>
  *
  * <p>
  * <b>Note: </b> it is the tag body which appears in the resultant
  * <code>iframe</code>, unlike the <code>HTML</code> implementation (where
  * the tag body is a comment for older browsers)
  * </p>
  *
  * <p>
  * <b>Tag attributes: </b> <br/><table cellpadding='2' cellspacing='5'
  * border='0' align='center' width='85%'>
  * <tr class='TableHeadingColor'>
  * <th>attribute</th>
  * <th>reqd.</th>
  * <th>param. class</th>
  * <th width='100%'>description</th>
  * </tr>
  * <tr class='TableRowColor'>
  * <td>align</td>
  * <td>false</td>
  * <td><code>java.lang.String</code></td>
  * <td>Alignment of the iframe contents. If this has the value
  * <code>"block"</code>, indicates the contents should fill the entire
  * iframe.</td>
  * </tr>
  * <tr class='TableRowColor'>
  * <td>formAction</td>
  * <td>false</td>
  * <td><code>java.lang.String</code></td>
  * <td>Specify this tag attribute to define the action of a form which will
  * surround the iframe contents. The action should be specified relative to the
  * web application context path</td>
  * </tr>
  * <tr class='TableRowColor'>
  * <td>formName</td>
  * <td>false</td>
  * <td><code>java.lang.String</code></td>
  * <td>Specify this tag attribute to create a form with the given name. The
  * action can be specified using the <code>formAction</code> attribute and the
  * target using <code>formTarget</code>.</td>
  * </tr>
  * <tr class='TableRowColor'>
  * <td>formTarget</td>
  * <td>false</td>
  * <td><code>java.lang.String</code></td>
  * <td>Specify this tag attribute to define the target of a form which will
  * surround the iframe contents.</td>
  * </tr>
  * <tr class='TableRowColor'>
  * <td>frameName</td>
  * <td>false</td>
  * <td><code>java.lang.String</code></td>
  * <td>Specify this tag attribute to set the name of the iframe.</td>
  * </tr>
  * <tr class='TableRowColor'>
  * <td>height</td>
  * <td>false</td>
  * <td><code>java.lang.String</code></td>
  * <td>This attribute represents the height of this frame, though its actual
  * interpretation depends on the {@linkcom.ivata.mask.web.theme.Theme theme}
  * implementation..</td>
  * </tr>
  * <tr class='TableRowColor'>
  * <td>width</td>
  * <td>false</td>
  * <td><code>java.lang.String</code></td>
  * <td>This attribute represents the width of this frame, though its actual
  * interpretation depends on the {@linkcom.ivata.mask.web.theme.Theme theme}
  * implementation..</td>
  * </tr>
  * </table>
  * </p>
  *
  * @since ivata masks 0.4 (2003-01-25)
  * @author Colin MacLeod
  * <a href='mailto:colin.macleod@ivata.com'>colin.macleod@ivata.com</a>
  * @version $Revision: 1.4 $
  */
 public class IFrameTag extends LinkTag {
     /***
      * <p>
      * Include the output from another <code>URL</code> within the current
      * page.
      * </p>
      *
      * @param uRLParam
      *            the URL to include. All of the output from this
      *            <code>URL</code> is read in and sent to <code>out</code>.
      * @param out
      *            <code>JspWriter</code> to write output to.
      * @throws IOException
      *             if there is a problem either reading the input or writing the
      *             output.
      */
     private static void include(final String uRLParam,
             final JspWriter out) throws IOException {
         URLConnection connection = null;
         connection = (new URL(uRLParam.toString())).openConnection();
         connection.setAllowUserInteraction(false);
         connection.setDoInput(true);
         connection.setDoOutput(false);
         connection.connect();
         // go thro' the entire contents of the URL and copy it to
         // our out
         InputStreamReader reader = new InputStreamReader(
                 new BufferedInputStream(connection.getInputStream()));
         while (true) {
             int ch = reader.read();
             if (ch < 0) {
                 break;
             }
             out.write(ch);
         }
     }
     /***
      * <p>
      * Alignment of the iframe contents.
      * </p>
      *
      * <p>
      * Set to <code>"left"</code>,<code>"left"</code>, or
      * <code>"center"</code> to align the iframe contents in that way. Setting
      * this to <code>"block"</code> causes the contents to expand to the full
      * width of the iframe.
      * </p>
      */
     private String align = "center";
     /***
      * <p>
      * Specify this tag attribute to define the action of a form which will
      * surround the iframe contents. The action should be specified relative to
      * the web application context path.
      * </p>
      *
      * <p>
      * <b>Note: </b> the form will only be created if the <code>formName</code>
      * attribute is set and the browser supports <code>&lt;iframe&gt;</code>
      * tags.
      * </p>
      */
     private String formAction = null;
     /***
      * <p>
      * Specify this tag attribute to create a form with the given name. The
      * action can be specified using the <code>formAction</code> attribute and
      * the target using <code>formTarget</code>.
      * </p>
      */
     private String formName = null;
     /***
      * <p>
      * Specify this tag attribute to define the target of a form which will
      * surround the iframe contents.
      * </p>
      *
      * <p>
      * <b>Note: </b> the form will only be created if the <code>formName</code>
      * attribute is set and the browser supports <code>&lt;iframe&gt;</code>
      * tags.
      * </p>
      */
     private String formTarget = "_parent";
     /***
      * <p>
      * This tag attribute specified the height of the frame.
      * </p>
      */
     private String height = null;
     /***
      * <p>
      * Implementation attribute. Stores the names of contained mask tags,
      * indexed by the <code>styleId</code> attribute.
      * </p>
      *
      * <p>
      * This is used to dynamically create extra hidden fields in
      * <code>doEndTag</code> to let fields be contained within the iframe and
      * still have their values submitted with the main form.
      * </p>
      */
     private HashMap maskTagNames = new HashMap();
     /***
      * <p>
      * Vertical alignment of the iframe contents.
      * </p>
      *
      * <p>
      * Set to <code>"top"</code>,<code>"bottom"</code>, or
      * <code>"center"</code> to align the iframe contents in that way.
      * </p>
      */
     private String valign = "center";
     /***
      * <p>
      * This tag attribute specified the width of the frame.
      * </p>
      */
     private String width = null;
     /***
      * <p>
      * Implementation method. This method creates a hidden field matching the
      * passed field's name, id and value. It also adds
      * <strong>JavaScript</strong> to the original method's
      * <code>onchange</code> attribute so the value of the hidden field is
      * updated.
      * </p>
      *
      * <p>
      * This lets fields be transparently (well, fairly) contained within
      * iframes.
      * </p>
      *
      * @param maskTagParam tag to be added to the iframe, so it can be
      * automatically updated using JavaScript.
      * @param pageContext
      *            current page context for the tag .
      * @throws JspException if the mask tag type is not compatible with this
      * routine (Radio buttons are not implemented yet).
      */
     public final void addMaskTag(final BaseHandlerTag maskTagParam,
             final PageContext pageContext) throws JspException {
         // these types aren't interesting for us
         if (ButtonTag.class.isInstance(maskTagParam)
                 || LabelTag.class.isInstance(maskTagParam)
                 // TODO: handle submits
                 || SubmitTag.class.isInstance(maskTagParam)
                 || ResetTag.class.isInstance(maskTagParam)) {
             return;
         }
         // first check there is a browser and it can display iframes
         // if not, none of this is possible/necessary
         Browser browser = (Browser) pageContext.getSession().getAttribute(
                 "browser");
         // if it is null, must be a session timeout/reset - nothing we need
         // worry about
         if ((browser == null) || !browser.canDisplayIFrames()) {
             return;
         }
         String onChange = StringHandling.getNotNull(maskTagParam.getOnchange(),
                 "").trim();
         // if there is existing code which doesn't end with a semi, add one
         if ((onChange.length() > 0) && (!onChange.endsWith(";"))) {
             onChange += ";";
         }
         // if we'll use it to index, we _need_ a style id for the tag
         String styleId = maskTagParam.getStyleId();
         if (styleId == null) {
             // note there is no exception as we dont _want_ some of the tags
             return;
         }
         String key = null;
         String name = null;
         String value = null;
         // radios, check boxes and selects are handled a little differently
         if (RadioTag.class.isInstance(maskTagParam)) {
             RadioTag radio = (RadioTag) maskTagParam;
             name = radio.getProperty();
             // for radios the key is the name
             key = name;
             // TODO: this needs to be finished
             throw new JspException("ERROR: Radio buttons are not implemented "
                     + "when used within iframes.");
         } else if (CheckboxTag.class.isInstance(maskTagParam)) {
             CheckboxTag checkBox = (CheckboxTag) maskTagParam;
             name = checkBox.getProperty();
             value = checkBox.getValue();
             key = styleId;
         } else if (MultiboxTag.class.isInstance(maskTagParam)) {
             MultiboxTag multiBox = (MultiboxTag) maskTagParam;
             name = multiBox.getProperty();
             value = multiBox.getValue();
             key = styleId;
         } else if (SelectTag.class.isInstance(maskTagParam)) {
             SelectTag select = (SelectTag) maskTagParam;
             name = select.getProperty();
             value = select.getValue();
             key = styleId;
         } else {
             BaseInputTag inputTag = (BaseInputTag) maskTagParam;
             name = inputTag.getProperty();
             value = inputTag.getValue();
             key = styleId;
         }
         onChange = "updateParentField('" + styleId + "');" + onChange;
         maskTagParam.setOnchange(onChange);
         maskTagNames.put(key, name);
     }
     /***
      * <p>
      * Overriddent to analyze the tag body and use it as the body of the iframe
      * if present. This method is called after the JSP engine processes the body
      * content of the tag.
      * </p>
      *
      * @exception JspException
      *                encapsulates any exception when calling
      *                {@link #writeTagBodyContent writeTagBodyContent}.
      * @return <code>SKIP_BODY</code> since we only ever want to evaluate this
      *         tag once.
      * @see #writeTagBodyContent(JspWriter out, BodyContent bodyContent)
      */
     public int doAfterBody() throws JspException {
         // if there is a tag body, use it as a request parameter to the
         // util iframe
         BodyContent bodyContent = getBodyContent();
         if (bodyContent != null) {
             String bodyText = bodyContent.getString();
             if (!StringHandling.isNullOrEmpty(bodyText)) {
                 // add JavaScript to set the values of hidden fields on the
                 // main page
                 bodyText += "<script language='JavaScript'>\n";
                 bodyText += "  <!--\n";
                 for (Iterator i = maskTagNames.keySet().iterator();
                         i.hasNext();) {
                     bodyText += "updateParentField('" + i.next() + "');\n";
                 }
                 bodyText += "  //-->\n";
                 bodyText += "</script>\n";
                 // an iframe with a body needs to have a frame name parameter
                 String frameName = getLinkName();
                 if (StringHandling.isNullOrEmpty(frameName)) {
                     throw new JspException(
                             "ERROR in IFrameTag: you must specify a frame name "
                                     + "to use the body text.");
                 }
                 pageContext.getSession().setAttribute(frameName, bodyText);
                 HashMap map = new HashMap();
                 map.put("sessionAttribute", frameName);
                 if (formName != null) {
                     map.put("formName", formName);
                     if (formAction != null) {
                         map.put("formAction", formAction);
                     }
                     if (formTarget != null) {
                         map.put("formTarget", formTarget);
                     }
                 }
                 map.put("align", align);
                 map.put("valign", valign);
                 pageContext.setAttribute("iframeMap", map);
                 this.setName("iframeMap");
                 setPage("/util/iframeContent.jsp");
             }
         }
         // for this tag, we only want to evluate the body one time
         return SKIP_BODY;
     }
     /***
      * <p>
      * Overridden to actually output the <code>HTML</code> code on the basis
      * of the input parameters.
      * </p>
      *
      * @return <code>EVAL_PAGE</code> since we always want to evaluate the
      *         page after this tag.
      *
      * @throws JspException
      *             if there is an error writing to <code>out.print()</code>
      */
     public int doEndTag() throws JspException {
         HttpSession session = (HttpSession) pageContext.getSession();
         Browser browser = (Browser) session.getAttribute("browser");
         if (browser == null) {
             throw new JspException("ERROR in IFrameTag: browser is null in "
                     + "session.");
         }
         // see if the browser can display iframes - if not, we'll output
         // the results of the page we're told to
         String styleClass = this.getStyleClass();
         if (styleClass != null) {
             String mapName = getName();
             Map params;
             TagUtils tagUtils = TagUtils.getInstance();
             if (StringHandling.isNullOrEmpty(mapName)) {
                 mapName = "iframeMap";
                 setName(mapName);
                 params = new HashMap();
                 pageContext.setAttribute(mapName, params,
                         PageContext.REQUEST_SCOPE);
             } else {
                 params = (Map) tagUtils.lookup(pageContext, mapName, null);
             }
             params.put("class", styleClass);
         }
         String uRL = this.calculateURL();
         JspWriter out = pageContext.getOut();
         StringBuffer attributes = new StringBuffer(HTMLFormatter
                 .getAttributeNotNull("class", styleClass));
         attributes.append(HTMLFormatter.getAttributeNotNull("id", this
                 .getStyleId()));
         attributes.append(HTMLFormatter.getAttributeNotNull("name", this
                 .getLinkName()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onblur", this
                 .getOnblur()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onchange", this
                 .getOnchange()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onclick", this
                 .getOnclick()));
         attributes.append(HTMLFormatter.getAttributeNotNull("ondblclick", this
                 .getOndblclick()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onfocus", this
                 .getOnfocus()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onkeydown", this
                 .getOnkeydown()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onkeyup", this
                 .getOnkeyup()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onmousedown", this
                 .getOnmousedown()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onmousemove", this
                 .getOnmousemove()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onmouseout", this
                 .getOnmouseout()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onmouseover", this
                 .getOnmouseover()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onmouseup", this
                 .getOnmouseup()));
         attributes.append(HTMLFormatter.getAttributeNotNull("onselect", this
                 .getOnselect()));
         attributes.append(HTMLFormatter.getAttributeNotNull("style", this
                 .getStyle()));
         attributes.append(HTMLFormatter.getAttributeNotNull("target", this
                 .getTarget()));
         attributes.append(HTMLFormatter.getAttributeNotNull("title", this
                 .getTitle()));
         attributes.append(HTMLFormatter.getAttributeNotNull("width", width));
         attributes.append(HTMLFormatter.getAttributeNotNull("height", height));
         if (browser.canDisplayFrames()) {
             try {
                 out.print("<iframe src='");
                 out.print(uRL);
                 out.print("'");
                 out.print(attributes);
                 out.print("></iframe>");
             } catch (IOException e) {
                 throw new JspException(e);
             }
             try {
                 // put out hidden fields for the contained fields to write their
                 // values to
                 for (Iterator i = maskTagNames.keySet().iterator();
                         i.hasNext();) {
                     String key = (String) i.next();
                     out.print("<input type='hidden' id='");
                     out.print(key);
                     out.print("' name='");
                     out.print(maskTagNames.get(key));
                     out.print("'/>");
                 }
             } catch (IOException e) {
                 throw new JspException(e);
             }
         } else {
             try {
                 out.print("<span ");
                 out.print(attributes);
                 out.print(">");
                 include(uRL.toString(), out);
                 out.print("</span>");
             } catch (MalformedURLException e) {
                 throw new JspException(e);
             } catch (IOException e) {
                 throw new JspException(e);
             }
         }
         // we always want to evaluate the rest of the page after this tag...
         return EVAL_PAGE;
     }
     /***
      * <p>
      * Overridden to prevent the superclass implementation from executing.
      * </p>
      *
      * @return <code>EVAL_BODY_BUFFERED</code>.
      *
      * @throws JspException
      *             if either <code>valueKey</code> or <code>titleKey</code>
      *             have not been set, or as thrown by superclass method.
      */
     public int doStartTag() throws JspException {
         return EVAL_BODY_BUFFERED;
     }
     /***
      * <p>
      * Alignment of the iframe contents.
      * </p>
      *
      * <p>
      * Set to <code>"left"</code>,<code>"left"</code>, or
      * <code>"center"</code> to align the iframe contents in that way. Setting
      * this to <code>"block"</code> causes the contents to expand to the full
      * width of the iframe.
      * </p>
      *
      * @return the current value of align.
      */
     public String getAlign() {
         return align;
     }
     /***
      * <p>
      * Specify this tag attribute to define the action of a form which will
      * surround the iframe contents. The action should be specified relative to
      * the web application context path.
      * </p>
      *
      * <p>
      * <b>Note: </b> the form will only be created if the <code>formName</code>
      * attribute is set and the browser supports <code>&lt;iframe&gt;</code>
      * tags.
      * </p>
      *
      * @return the current value of formAction.
      */
     public String getFormAction() {
         return formAction;
     }
     /***
      * <p>
      * Specify this tag attribute to create a form with the given name. The
      * action can be specified using the <code>formAction</code> attribute and
      * the target using <code>formTarget</code>.
      * </p>
      *
      * @return the current value of formName.
      */
     public String getFormName() {
         return formName;
     }
     /***
      * <p>
      * Specify this tag attribute to define the target of a form which will
      * surround the iframe contents.
      * </p>
      *
      * <p>
      * <b>Note: </b> the form will only be created if the <code>formName</code>
      * attribute is set and the browser supports <code>&lt;iframe&gt;</code>
      * tags.
      * </p>
      *
      * @return the current value of formTarget.
      */
     public String getFormTarget() {
         return formTarget;
     }
     /***
      * <p>
      * This tag attribute specified the height of the frame.
      * </p>
      *
      * @return the current value of height.
      */
     public String getHeight() {
         return height;
     }
     /***
      * <p>
      * Vertical alignment of the iframe contents.
      * </p>
      *
      * <p>
      * Set to <code>"top"</code>,<code>"bottom"</code>, or
      * <code>"center"</code> to align the iframe contents in that way.
      * </p>
      *
      * @return the current value of valign.
      */
     public String getValign() {
         return valign;
     }
     /***
      * <p>
      * This tag attribute specified the width of the frame.
      * </p>
      *
      * @return the current value of width.
      */
     public String getWidth() {
         return width;
     }
     /***
      * <p>
      * Alignment of the iframe contents.
      * </p>
      *
      * <p>
      * Set to <code>"left"</code>,<code>"left"</code>, or
      * <code>"center"</code> to align the iframe contents in that way. Setting
      * this to <code>"block"</code> causes the contents to expand to the full
      * width of the iframe.
      * </p>
      *
      * @param alignParam
      *            the new value of align.
      */
     public void setAlign(final String alignParam) {
         this.align = alignParam;
     }
     /***
      * <p>
      * Specify this tag attribute to define the action of a form which will
      * surround the iframe contents. The action should be specified relative to
      * the web application context path.
      * </p>
      *
      * <p>
      * <b>Note: </b> the form will only be created if the <code>formName</code>
      * attribute is set and the browser supports <code>&lt;iframe&gt;</code>
      * tags.
      * </p>
      *
      * @param formActionParam
      *            the new value of formAction.
      */
     public void setFormAction(final String formActionParam) {
         this.formAction = formActionParam;
     }
     /***
      * <p>
      * Specify this tag attribute to create a form with the given name. The
      * action can be specified using the <code>formAction</code> attribute and
      * the target using <code>formTarget</code>.
      * </p>
      *
      * @param formNameParam
      *            the new value of formName.
      */
     public void setFormName(final String formNameParam) {
         this.formName = formNameParam;
     }
     /***
      * <p>
      * Specify this tag attribute to define the target of a form which will
      * surround the iframe contents.
      * </p>
      *
      * <p>
      * <b>Note: </b> the form will only be created if the <code>formName</code>
      * attribute is set and the browser supports <code>&lt;iframe&gt;</code>
      * tags.
      * </p>
      *
      * @param formTargetParam
      *            the new value of formTarget.
      */
     public void setFormTarget(final String formTargetParam) {
         this.formTarget = formTargetParam;
     }
     /***
      * <p>
      * Specify this tag attribute to set the name of the iframe created.
      * </p>
      *
      * @param frameName
      *            the new value of frameName.
      */
     public void setFrameName(final String frameName) {
         setLinkName(frameName);
     }
     /***
      * <p>
      * This tag attribute specified the height of the frame.
      * </p>
      *
      * @param heightParam
      *            the new value of height.
      */
     public void setHeight(final String heightParam) {
         this.height = heightParam;
     }
     /***
      * <p>
      * Vertical alignment of the iframe contents.
      * </p>
      *
      * <p>
      * Set to <code>"top"</code>,<code>"bottom"</code>, or
      * <code>"center"</code> to align the iframe contents in that way.
      * </p>
      *
      * @param valignParam
      *            the new value of valign.
      */
     public void setValign(final String valignParam) {
         this.valign = valignParam;
     }
     /***
      * <p>
      * This tag attribute specified the width of the frame.
      * </p>
      *
      * @param widthParam
      *            the new value of width.
      */
     public void setWidth(final String widthParam) {
         this.width = widthParam;
     }
 }