components/network_hints/renderer/renderer_dns_prefetch.h

   1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // A RendererDnsPrefetch instance is maintained for each RenderThread.
   6 // URL strings are typically added to the embedded queue during rendering.
   7 // The first addition to the queue (transitioning from empty to having
   8 // some names) causes a processing task to be added to the Renderer Thread.
   9 // The processing task gathers all buffered names, and send them via IPC
  10 // to the browser, so that DNS lookups can be performed before the user attempts
  11 // to traverse a link.
  12 // This class removed some duplicates, and discards numeric IP addresss
  13 // (which wouldn't looked up in DNS anyway).
  14 // To limit the time during the processing task (and avoid stalling the Render
  15 // thread), several limits are placed on how much of the queue to process.
  16 // If the processing task is not able to completely empty the queue, it
  17 // schedules a future continuation of the task, and keeps the map of already
  18 // sent names.  If the entire queue is processed, then the list of "sent names"
  19 // is cleared so that future gatherings might again pass along the same names.
  20
  21 #ifndef COMPONENTS_NETWORK_HINTS_RENDERER_RENDERER_DNS_PREFETCH_H_
  22 #define COMPONENTS_NETWORK_HINTS_RENDERER_RENDERER_DNS_PREFETCH_H_
  23
  24 #include <map>
  25 #include <string>
  26
  27 #include "base/basictypes.h"
  28 #include "base/memory/weak_ptr.h"
  29 #include "components/network_hints/renderer/dns_prefetch_queue.h"
  30
  31 namespace network_hints {
  32
  33 // An internal interface to the network_hints component for efficiently sending
  34 // DNS prefetch requests to the net stack.
  35 class RendererDnsPrefetch {
  36  public:
  37   RendererDnsPrefetch();
  38   ~RendererDnsPrefetch();
  39
  40   // Push a name into the queue to be resolved.
  41   void Resolve(const char* name, size_t length);
  42
  43   // SubmitHosts processes the buffered names, and submits them for DNS
  44   // prefetching.
  45   // Note that browser process may decide which names should be looked up (to
  46   // pre-warm the cache) based on what has been (or not been) looked up
  47   // recently.
  48   // If sending for DNS lookup is incomplete (queue is not empty, or not all
  49   // names in map are sent, or ...) then a task to continue processing is
  50   // sent to our thread loop.
  51   void SubmitHostnames();
  52
  53   // The following is private, but exposed for testing purposes only.
  54   static bool is_numeric_ip(const char* name, size_t length);
  55
  56  private:
  57   // ExtractBufferedNames pulls names from queue into the map, reducing or
  58   // eliminating a waiting queue.
  59   // The size_goal argument can be used to reduce the amount of
  60   // processing done in this method, and can leave some data
  61   // in the buffer under some circumstances.
  62   // If size_goal is zero, then extraction proceeds until
  63   // the queue is empty.  If size goal is positive, then
  64   // extraction continues until the domain_map_ contains
  65   // at least the specified number of names, or the buffer is empty.
  66   void ExtractBufferedNames(size_t size_goal = 0);
  67
  68   // DnsPrefetchNames does not check the buffer, and just sends names
  69   // that are already collected in the domain_map_ for DNS lookup.
  70   // If max_count is zero, then all available names are sent; and
  71   // if positive, then at most max_count names will be sent.
  72   void DnsPrefetchNames(size_t max_count = 0);
  73
  74   // Reset() restores initial state provided after construction.
  75   // This discards ALL queue entries, and map entries.
  76   void Reset();
  77
  78   // We use c_string_queue_ to hold lists of names supplied typically) by the
  79   // renderer.  It queues the names, at minimal cost to the renderer's thread,
  80   // and allows this class to process them when time permits (in a later task).
  81   DnsQueue c_string_queue_;
  82
  83
  84   // domain_map_ contains (for each domain) one of the next two constants,
  85   // depending on whether we have asked the browser process to do the actual
  86   // DNS lookup.
  87   static const int kLookupRequested = 0x1;
  88   static const int kPending = 0x0;
  89   typedef std::map<std::string, int> DomainUseMap;
  90   DomainUseMap domain_map_;
  91
  92   // Cache a tally of the count of names that haven't yet been sent
  93   // for DNS pre-fetching.  Note that we *could* recalculate this
  94   // count by iterating over domain_map_, looking for even values.
  95   size_t new_name_count_;
  96
  97   // We have some metrics to examine performance.  We might use
  98   // these metrics to modify buffer counts etc. some day.
  99   int buffer_full_discard_count_;
 100   int numeric_ip_discard_count_;
 101
 102   base::WeakPtrFactory<RendererDnsPrefetch> weak_factory_;
 103
 104   DISALLOW_COPY_AND_ASSIGN(RendererDnsPrefetch);
 105 };  // class RendererDnsPrefetch
 106
 107 }  // namespace network_hints
 108
 109 #endif  // COMPONENTS_NETWORK_HINTS_RENDERER_RENDERER_DNS_PREFETCH_H_