/*
* Copyright (c) 2002-2010 Gargoyle Software Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.gargoylesoftware.htmlunit.html;
import static com.gargoylesoftware.htmlunit.protocol.javascript.JavaScriptURLConnection.JAVASCRIPT_PREFIX;
import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.Map;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import com.gargoylesoftware.htmlunit.Page;
import com.gargoylesoftware.htmlunit.SgmlPage;
import com.gargoylesoftware.htmlunit.TextUtil;
import com.gargoylesoftware.htmlunit.WebRequestSettings;
import com.gargoylesoftware.htmlunit.WebWindow;
/**
* Wrapper for the HTML element "a".
*
* @version $Revision: 5373 $
* @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
* @author David K. Taylor
* @author <a href="mailto:cse@dynabean.de">Christian Sell</a>
* @author Ahmed Ashour
* @author Dmitri Zoubkov
*/
public class HtmlAnchor extends HtmlElement {
private static final long serialVersionUID = 7968778206454737178L;
private static final Log LOG = LogFactory.getLog(HtmlAnchor.class);
/** The HTML tag represented by this element. */
public static final String TAG_NAME = "a";
/**
* Creates a new instance.
*
* @param namespaceURI the URI that identifies an XML namespace
* @param qualifiedName the qualified name of the element type to instantiate
* @param page the page that contains this element
* @param attributes the initial attributes
*/
HtmlAnchor(final String namespaceURI, final String qualifiedName, final SgmlPage page,
final Map<String, DomAttr> attributes) {
super(namespaceURI, qualifiedName, page, attributes);
}
/**
* Same as {@link #doClickAction()}, except that it accepts an href suffix, needed when a click is
* performed on an image map to pass information on the click position.
*
* @param hrefSuffix the suffix to add to the anchor's href attribute (for instance coordinates from an image map)
* @throws IOException if an IO error occurs
*/
protected void doClickAction(final String hrefSuffix) throws IOException {
final String href = getHrefAttribute() + hrefSuffix;
if (LOG.isDebugEnabled()) {
final String w = getPage().getEnclosingWindow().getName();
LOG.debug("do click action in window '" + w + "', using href '" + href + "'");
}
if (href.length() == 0) {
return;
}
final HtmlPage page = (HtmlPage) getPage();
if (TextUtil.startsWithIgnoreCase(href, JAVASCRIPT_PREFIX)) {
final StringBuilder builder = new StringBuilder(href.length());
for (int i = 0; i < href.length(); i++) {
final char ch = href.charAt(i);
if (ch == '%' && i + 2 < href.length()) {
final char ch1 = Character.toUpperCase(href.charAt(i + 1));
final char ch2 = Character.toUpperCase(href.charAt(i + 2));
if ((Character.isDigit(ch1) || ch1 >= 'A' && ch1 <= 'F')
&& (Character.isDigit(ch2) || ch2 >= 'A' && ch2 <= 'F')) {
builder.append((char) Integer.parseInt(href.substring(i + 1, i + 3), 16));
i += 2;
continue;
}
}
builder.append(ch);
}
page.executeJavaScriptIfPossible(builder.toString(), "javascript url", getStartLineNumber());
return;
}
final URL url = page.getFullyQualifiedUrl(href);
final WebRequestSettings wrs = new WebRequestSettings(url);
wrs.setAdditionalHeader("Referer", page.getWebResponse().getRequestSettings().getUrl().toExternalForm());
if (LOG.isDebugEnabled()) {
LOG.debug(
"Getting page for " + url.toExternalForm()
+ ", derived from href '" + href
+ "', using the originating URL "
+ page.getWebResponse().getRequestSettings().getUrl());
}
page.getWebClient().download(page.getEnclosingWindow(),
page.getResolvedTarget(getTargetAttribute()),
wrs, "Link click");
}
/**
* This method will be called if there either wasn't an <tt>onclick</tt> handler, or
* there was but the result of that handler was <tt>true</tt>. This is the default
* behavior of clicking the element. For this anchor element, the default behavior is
* to open the HREF page, or execute the HREF if it is a <tt>javascript:</tt> URL.
*
* @throws IOException if an IO error occurs
*/
@Override
protected void doClickAction() throws IOException {
doClickAction("");
}
/**
* Returns the value of the attribute "charset". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "charset" or an empty string if that attribute isn't defined
*/
public final String getCharsetAttribute() {
return getAttribute("charset");
}
/**
* Returns the value of the attribute "type". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "type" or an empty string if that attribute isn't defined
*/
public final String getTypeAttribute() {
return getAttribute("type");
}
/**
* Returns the value of the attribute "name". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "name" or an empty string if that attribute isn't defined
*/
public final String getNameAttribute() {
return getAttribute("name");
}
/**
* Returns the value of the attribute "href". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "href" or an empty string if that attribute isn't defined
*/
public final String getHrefAttribute() {
return getAttribute("href").trim();
}
/**
* Returns the value of the attribute "hreflang". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "hreflang" or an empty string if that attribute isn't defined
*/
public final String getHrefLangAttribute() {
return getAttribute("hreflang");
}
/**
* Returns the value of the attribute "rel". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "rel" or an empty string if that attribute isn't defined
*/
public final String getRelAttribute() {
return getAttribute("rel");
}
/**
* Returns the value of the attribute "rev". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "rev" or an empty string if that attribute isn't defined
*/
public final String getRevAttribute() {
return getAttribute("rev");
}
/**
* Returns the value of the attribute "accesskey". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "accesskey" or an empty string if that attribute isn't defined
*/
public final String getAccessKeyAttribute() {
return getAttribute("accesskey");
}
/**
* Returns the value of the attribute "shape". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "shape" or an empty string if that attribute isn't defined
*/
public final String getShapeAttribute() {
return getAttribute("shape");
}
/**
* Returns the value of the attribute "coords". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "coords" or an empty string if that attribute isn't defined
*/
public final String getCoordsAttribute() {
return getAttribute("coords");
}
/**
* Returns the value of the attribute "tabindex". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "tabindex" or an empty string if that attribute isn't defined
*/
public final String getTabIndexAttribute() {
return getAttribute("tabindex");
}
/**
* Returns the value of the attribute "onfocus". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "onfocus" or an empty string if that attribute isn't defined
*/
public final String getOnFocusAttribute() {
return getAttribute("onfocus");
}
/**
* Returns the value of the attribute "onblur". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "onblur" or an empty string if that attribute isn't defined
*/
public final String getOnBlurAttribute() {
return getAttribute("onblur");
}
/**
* Returns the value of the attribute "target". Refer to the
* <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
* documentation for details on the use of this attribute.
*
* @return the value of the attribute "target" or an empty string if that attribute isn't defined
*/
public final String getTargetAttribute() {
return getAttribute("target");
}
/**
* Open this link in a new window, much as web browsers do when you shift-click a link or use the context
* menu to open in a new window.
*
* It should be noted that even web browsers will sometimes not give the expected result when using this
* method of following links. Links that have no real href and rely on JavaScript to do their work will
* fail.
*
* @return the page opened by this link, nested in a new {@link com.gargoylesoftware.htmlunit.TopLevelWindow}
* @throws MalformedURLException if the href could not be converted to a valid URL
*/
public final Page openLinkInNewWindow() throws MalformedURLException {
final URL target = ((HtmlPage) getPage()).getFullyQualifiedUrl(getHrefAttribute());
final String windowName = "HtmlAnchor.openLinkInNewWindow() target";
final WebWindow newWindow = getPage().getWebClient().openWindow(target, windowName);
return newWindow.getEnclosedPage();
}
}