001: /*
002: * Copyright (c) 2002-2008 Gargoyle Software Inc. All rights reserved.
003: *
004: * Redistribution and use in source and binary forms, with or without
005: * modification, are permitted provided that the following conditions are met:
006: *
007: * 1. Redistributions of source code must retain the above copyright notice,
008: * this list of conditions and the following disclaimer.
009: * 2. Redistributions in binary form must reproduce the above copyright notice,
010: * this list of conditions and the following disclaimer in the documentation
011: * and/or other materials provided with the distribution.
012: * 3. The end-user documentation included with the redistribution, if any, must
013: * include the following acknowledgment:
014: *
015: * "This product includes software developed by Gargoyle Software Inc.
016: * (http://www.GargoyleSoftware.com/)."
017: *
018: * Alternately, this acknowledgment may appear in the software itself, if
019: * and wherever such third-party acknowledgments normally appear.
020: * 4. The name "Gargoyle Software" must not be used to endorse or promote
021: * products derived from this software without prior written permission.
022: * For written permission, please contact info@GargoyleSoftware.com.
023: * 5. Products derived from this software may not be called "HtmlUnit", nor may
024: * "HtmlUnit" appear in their name, without prior written permission of
025: * Gargoyle Software Inc.
026: *
027: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
028: * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
029: * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GARGOYLE
030: * SOFTWARE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
031: * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
032: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
033: * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
034: * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
035: * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
036: * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
037: */
038: package com.gargoylesoftware.htmlunit.html;
039:
040: import java.util.Map;
041:
042: /**
043: * Wrapper for the html element "link". <b>Note:</b> This is not a clickable link,
044: * that one is an HtmlAnchor
045: *
046: * @version $Revision: 2132 $
047: * @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
048: * @author David K. Taylor
049: * @author <a href="mailto:cse@dynabean.de">Christian Sell</a>
050: * @author Ahmed Ashour
051: */
052: public class HtmlLink extends ClickableElement {
053:
054: private static final long serialVersionUID = 323745155296983364L;
055:
056: /** the HTML tag represented by this element */
057: public static final String TAG_NAME = "link";
058:
059: /**
060: * Create an instance of HtmlLink
061: *
062: * @param page The HtmlPage that contains this element.
063: * @param attributes the initial attributes
064: * @deprecated You should not directly construct HtmlLink.
065: */
066: //TODO: to be removed, deprecated after 1.11
067: public HtmlLink(final HtmlPage page, final Map attributes) {
068: this (null, TAG_NAME, page, attributes);
069: }
070:
071: /**
072: * Create an instance of HtmlLink
073: *
074: * @param namespaceURI the URI that identifies an XML namespace.
075: * @param qualifiedName The qualified name of the element type to instantiate
076: * @param page The HtmlPage that contains this element.
077: * @param attributes the initial attributes
078: */
079: HtmlLink(final String namespaceURI, final String qualifiedName,
080: final HtmlPage page, final Map attributes) {
081: super (namespaceURI, qualifiedName, page, attributes);
082: }
083:
084: /**
085: * Return the value of the attribute "charset". Refer to the
086: * <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
087: * documentation for details on the use of this attribute.
088: *
089: * @return The value of the attribute "charset"
090: * or an empty string if that attribute isn't defined.
091: */
092: public final String getCharsetAttribute() {
093: return getAttributeValue("charset");
094: }
095:
096: /**
097: * Return the value of the attribute "href". Refer to the
098: * <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
099: * documentation for details on the use of this attribute.
100: *
101: * @return The value of the attribute "href"
102: * or an empty string if that attribute isn't defined.
103: */
104: public final String getHrefAttribute() {
105: return getAttributeValue("href");
106: }
107:
108: /**
109: * Return the value of the attribute "hreflang". Refer to the
110: * <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
111: * documentation for details on the use of this attribute.
112: *
113: * @return The value of the attribute "hreflang"
114: * or an empty string if that attribute isn't defined.
115: */
116: public final String getHrefLangAttribute() {
117: return getAttributeValue("hreflang");
118: }
119:
120: /**
121: * Return the value of the attribute "type". Refer to the
122: * <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
123: * documentation for details on the use of this attribute.
124: *
125: * @return The value of the attribute "type"
126: * or an empty string if that attribute isn't defined.
127: */
128: public final String getTypeAttribute() {
129: return getAttributeValue("type");
130: }
131:
132: /**
133: * Return the value of the attribute "rel". Refer to the
134: * <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
135: * documentation for details on the use of this attribute.
136: *
137: * @return The value of the attribute "rel"
138: * or an empty string if that attribute isn't defined.
139: */
140: public final String getRelAttribute() {
141: return getAttributeValue("rel");
142: }
143:
144: /**
145: * Return the value of the attribute "rev". Refer to the
146: * <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
147: * documentation for details on the use of this attribute.
148: *
149: * @return The value of the attribute "rev"
150: * or an empty string if that attribute isn't defined.
151: */
152: public final String getRevAttribute() {
153: return getAttributeValue("rev");
154: }
155:
156: /**
157: * Return the value of the attribute "media". Refer to the
158: * <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
159: * documentation for details on the use of this attribute.
160: *
161: * @return The value of the attribute "media"
162: * or an empty string if that attribute isn't defined.
163: */
164: public final String getMediaAttribute() {
165: return getAttributeValue("media");
166: }
167:
168: /**
169: * Return the value of the attribute "target". Refer to the
170: * <a href='http://www.w3.org/TR/html401/'>HTML 4.01</a>
171: * documentation for details on the use of this attribute.
172: *
173: * @return The value of the attribute "target"
174: * or an empty string if that attribute isn't defined.
175: */
176: public final String getTargetAttribute() {
177: return getAttributeValue("target");
178: }
179: }
|