ui/gfx/x/x11_atom_cache.h

// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef UI_GFX_X_X11_ATOM_CACHE_H_
#define UI_GFX_X_X11_ATOM_CACHE_H_

#include <map>
#include <string>

#include "base/macros.h"
#include "ui/gfx/gfx_export.h"
#include "ui/gfx/x/x11_types.h"

namespace base {
template <typename T>
struct DefaultSingletonTraits;
}

namespace x11 {
class Connection;
}

namespace gfx {

// Gets the X atom for default display corresponding to atom_name.
GFX_EXPORT x11::Atom GetAtom(const std::string& atom_name);

// Pre-caches all Atoms on first use to minimize roundtrips to the X11
// server. By default, GetAtom() will CHECK() that atoms accessed through
// GetAtom() were passed to the constructor, but this behaviour can be changed
// with allow_uncached_atoms().
class GFX_EXPORT X11AtomCache {
 public:
  static X11AtomCache* GetInstance();

 private:
  friend x11::Atom GetAtom(const std::string& atom_name);
  friend struct base::DefaultSingletonTraits<X11AtomCache>;

  X11AtomCache();
  ~X11AtomCache();

  // Returns the pre-interned Atom without having to go to the x server.
  // On failure, x11::None is returned.
  x11::Atom GetAtom(const std::string&) const;

  x11::Connection* connection_;

  // Using std::map, as it is possible for thousands of atoms to be registered.
  mutable std::map<std::string, x11::Atom> cached_atoms_;

  DISALLOW_COPY_AND_ASSIGN(X11AtomCache);
};

}  // namespace gfx

#endif  // UI_GFX_X_X11_ATOM_CACHE_H_