chrome/browser/chromeos/version_loader.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 #ifndef CHROME_BROWSER_CHROMEOS_VERSION_LOADER_H_
   6 #define CHROME_BROWSER_CHROMEOS_VERSION_LOADER_H_
   7
   8 #include <string>
   9
  10 #include "base/callback.h"
  11 #include "base/gtest_prod_util.h"
  12 #include "chrome/common/cancelable_task_tracker.h"
  13
  14 namespace chromeos {
  15
  16 // ChromeOSVersionLoader loads the version of Chrome OS from the file system.
  17 // Loading is done asynchronously in the blocking thread pool. Once loaded,
  18 // ChromeOSVersionLoader callback to a method of your choice with the version
  19 // (or an empty string if the version couldn't be found).
  20 // To use ChromeOSVersionLoader do the following:
  21 //
  22 // . In your class define a member field of type chromeos::VersionLoader and
  23 //   CancelableTaskTracker.
  24 // . Define the callback method, something like:
  25 //   void OnGetChromeOSVersion(const std::string& version);
  26 // . When you want the version invoke:
  27 //   VersionLoader::GetVersion()
  28 //
  29 // This class also provides the ability to load the bios firmware using
  30 //   VersionLoader::GetFirmware()
  31 class VersionLoader {
  32  public:
  33   VersionLoader();
  34   virtual ~VersionLoader();
  35
  36   enum VersionFormat {
  37     VERSION_SHORT,
  38     VERSION_SHORT_WITH_DATE,
  39     VERSION_FULL,
  40   };
  41
  42   // Signature
  43   typedef base::Callback<void(const std::string&)> GetVersionCallback;
  44   typedef base::Callback<void(const std::string&)> GetFirmwareCallback;
  45
  46   // Asynchronously requests the version.
  47   // If |full_version| is true version string with extra info is extracted,
  48   // otherwise it's in short format x.x.xx.x.
  49   CancelableTaskTracker::TaskId GetVersion(VersionFormat format,
  50                                            const GetVersionCallback& callback,
  51                                            CancelableTaskTracker* tracker);
  52
  53   CancelableTaskTracker::TaskId GetFirmware(const GetFirmwareCallback& callback,
  54                                             CancelableTaskTracker* tracker);
  55
  56  private:
  57   FRIEND_TEST_ALL_PREFIXES(VersionLoaderTest, ParseFirmware);
  58
  59   // VersionLoader calls into the Backend in the blocking thread pool to load
  60   // and extract the version.
  61   class Backend : public base::RefCountedThreadSafe<Backend> {
  62    public:
  63     Backend() {}
  64
  65     // Gets the version number from base::SysInfo. This is invoked on the
  66     // blocking thread pool.
  67     void GetVersion(VersionFormat format, std::string* version);
  68
  69     // Calls ParseFirmware to get the firmware value. This is invoked on the
  70     // blocking thread pool.
  71     void GetFirmware(std::string* firmware);
  72
  73    private:
  74     friend class base::RefCountedThreadSafe<Backend>;
  75
  76     ~Backend() {}
  77
  78     DISALLOW_COPY_AND_ASSIGN(Backend);
  79   };
  80
  81   // Extracts the firmware from the file.
  82   static std::string ParseFirmware(const std::string& contents);
  83
  84   scoped_refptr<Backend> backend_;
  85
  86   DISALLOW_COPY_AND_ASSIGN(VersionLoader);
  87 };
  88
  89 }  // namespace chromeos
  90
  91 #endif  // CHROME_BROWSER_CHROMEOS_VERSION_LOADER_H_