author Ryan VanderMeulen <>
Thu, 23 Oct 2014 11:32:35 -0400
changeset 236265 874815b0d42b7f60c701f9928fa218cd2fcb4564
parent 236260 87433694df019680550e698e2e9ddfbccba0e8ef
permissions -rw-r--r--
Backed out changeset 87433694df01 (bug 1082734) for Gaia unit test failures. CLOSED TREE

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 * vim: sw=2 ts=2 et :
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at */

 * This is the base class for all link classes.

#ifndef mozilla_dom_Link_h__
#define mozilla_dom_Link_h__

#include "mozilla/IHistory.h"
#include "mozilla/MemoryReporting.h"
#include "mozilla/dom/URLSearchParams.h"
#include "nsIContent.h" // for nsLinkState

namespace mozilla {

class EventStates;

namespace dom {

class Element;

{ 0xb25edee6, 0xdd35, 0x4f8b,                             \
  { 0xab, 0x90, 0x66, 0xd0, 0xbd, 0x3c, 0x22, 0xd5 } }

class Link : public URLSearchParamsObserver

   * aElement is the element pointer corresponding to this link.
  explicit Link(Element* aElement);
  virtual void SetLinkState(nsLinkState aState);

   * @return NS_EVENT_STATE_VISITED if this link is visited,
   *         NS_EVENT_STATE_UNVISTED if this link is not visited, or 0 if this
   *         link is not actually a link.
  EventStates LinkState() const;

   * @return the URI this link is for, if available.
  nsIURI* GetURI() const;
  virtual nsIURI* GetURIExternal() const {
    return GetURI();

   * Helper methods for modifying and obtaining parts of the URI of the Link.
  void SetProtocol(const nsAString &aProtocol, ErrorResult& aError);
  void SetUsername(const nsAString &aUsername, ErrorResult& aError);
  void SetPassword(const nsAString &aPassword, ErrorResult& aError);
  void SetHost(const nsAString &aHost, ErrorResult& aError);
  void SetHostname(const nsAString &aHostname, ErrorResult& aError);
  void SetPathname(const nsAString &aPathname, ErrorResult& aError);
  void SetSearch(const nsAString &aSearch, ErrorResult& aError);
  void SetSearchParams(mozilla::dom::URLSearchParams& aSearchParams);
  void SetPort(const nsAString &aPort, ErrorResult& aError);
  void SetHash(const nsAString &aHash, ErrorResult& aError);
  void GetOrigin(nsAString &aOrigin, ErrorResult& aError);
  void GetProtocol(nsAString &_protocol, ErrorResult& aError);
  void GetUsername(nsAString &aUsername, ErrorResult& aError);
  void GetPassword(nsAString &aPassword, ErrorResult& aError);
  void GetHost(nsAString &_host, ErrorResult& aError);
  void GetHostname(nsAString &_hostname, ErrorResult& aError);
  void GetPathname(nsAString &_pathname, ErrorResult& aError);
  void GetSearch(nsAString &_search, ErrorResult& aError);
  URLSearchParams* SearchParams();
  void GetPort(nsAString &_port, ErrorResult& aError);
  void GetHash(nsAString &_hash, ErrorResult& aError);

   * Invalidates any link caching, and resets the state to the default.
   * @param aNotify
   *        true if ResetLinkState should notify the owning document about style
   *        changes or false if it should not.
  void ResetLinkState(bool aNotify, bool aHasHref);
  // This method nevers returns a null element.
  Element* GetElement() const { return mElement; }

   * DNS prefetch has been deferred until later, e.g. page load complete.
  virtual void OnDNSPrefetchDeferred() { /*do nothing*/ }
   * DNS prefetch has been submitted to Host Resolver.
  virtual void OnDNSPrefetchRequested() { /*do nothing*/ }

   * Checks if DNS Prefetching is ok
   * @returns boolean
   *          Defaults to true; should be overridden for specialised cases
  virtual bool HasDeferredDNSPrefetchRequest() { return true; }

  virtual size_t
    SizeOfExcludingThis(mozilla::MallocSizeOf aMallocSizeOf) const;

  bool ElementHasHref() const;

  // URLSearchParamsObserver
  void URLSearchParamsUpdated(URLSearchParams* aSearchParams) MOZ_OVERRIDE;

  virtual ~Link();

   * Return true if the link has associated URI.
  bool HasURI() const
    if (HasCachedURI()) {
      return true;

    return !!GetURI();

  nsIURI* GetCachedURI() const { return mCachedURI; }
  bool HasCachedURI() const { return !!mCachedURI; }

  void UpdateURLSearchParams();

  // CC methods
  void Unlink();
  void Traverse(nsCycleCollectionTraversalCallback &cb);

   * Unregisters from History so this node no longer gets notifications about
   * changes to visitedness.
  void UnregisterFromHistory();

  already_AddRefed<nsIURI> GetURIToMutate();
  void SetHrefAttribute(nsIURI *aURI);

  void CreateSearchParamsIfNeeded();

  void SetSearchInternal(const nsAString& aSearch);

  mutable nsCOMPtr<nsIURI> mCachedURI;

  Element * const mElement;

  // Strong reference to History.  The link has to unregister before History
  // can disappear.
  nsCOMPtr<IHistory> mHistory;

  uint16_t mLinkState;

  bool mNeedsRegistration;

  bool mRegistered;

  nsRefPtr<URLSearchParams> mSearchParams;


} // namespace dom
} // namespace mozilla

#endif // mozilla_dom_Link_h__