1 files changed, 101 insertions, 15 deletions

diff --git a/src/gpg/GpgFunctionObject.h b/src/core/GpgFunctionObject.h
index 404b2f84..391b1585 100644
--- a/src/gpg/GpgFunctionObject.h
+++ b/src/core/GpgFunctionObject.h
@@ -1,4 +1,6 @@
 /**
+ * Copyright (C) 2021 Saturneric
+ *
  * This file is part of GpgFrontend.
  *
  * GpgFrontend is free software: you can redistribute it and/or modify
@@ -6,27 +8,27 @@
  * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * Foobar is distributed in the hope that it will be useful,
+ * GpgFrontend is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with Foobar.  If not, see <https://www.gnu.org/licenses/>.
+ * along with GpgFrontend. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The initial version of the source code is inherited from
+ * the gpg4usb project, which is under GPL-3.0-or-later.
  *
- * The initial version of the source code is inherited from gpg4usb-team.
- * Their source code version also complies with GNU General Public License.
+ * All the source code of GpgFrontend was modified and released by
+ * Saturneric<[email protected]> starting on May 12, 2021.
  *
- * The source code version of this software was modified and released
- * by Saturneric<[email protected]> starting on May 12, 2021.
+ * SPDX-License-Identifier: GPL-3.0-or-later
  *
  */
 
 #ifndef GPGFRONTEND_ZH_CN_TS_FUNCTIONOBJECT_H
 #define GPGFRONTEND_ZH_CN_TS_FUNCTIONOBJECT_H
 
-#include <easyloggingpp/easylogging++.h>
-
 #include <map>
 #include <memory>
 #include <mutex>
@@ -38,9 +40,20 @@
 
 namespace GpgFrontend {
 
+/**
+ * @brief
+ *
+ * @tparam T
+ */
 template <typename T>
 class SingletonFunctionObject {
  public:
+  /**
+   * @brief Get the Instance object
+   *
+   * @param channel
+   * @return T&
+   */
   static T& GetInstance(
       int channel = GpgFrontend::GPGFRONTEND_DEFAULT_CHANNEL) {
     static_assert(std::is_base_of<SingletonFunctionObject<T>, T>::value,
@@ -53,6 +66,13 @@ class SingletonFunctionObject {
       return *_p_pbj;
   }
 
+  /**
+   * @brief Create a Instance object
+   *
+   * @param channel
+   * @param factory
+   * @return T&
+   */
   static T& CreateInstance(int channel,
                            std::function<std::unique_ptr<T>(void)> factory) {
     static_assert(std::is_base_of<SingletonFunctionObject<T>, T>::value,
@@ -65,6 +85,13 @@ class SingletonFunctionObject {
       return *_p_pbj;
   }
 
+  /**
+   * @brief Create a Instance object
+   *
+   * @param channel
+   * @param p_obj
+   * @return T&
+   */
   static T& CreateInstance(int channel, std::unique_ptr<T> p_obj = nullptr) {
     static_assert(std::is_base_of<SingletonFunctionObject<T>, T>::value,
                   "T not derived from SingletonFunctionObject<T>");
@@ -76,6 +103,12 @@ class SingletonFunctionObject {
       return *_p_pbj;
   }
 
+  /**
+   * @brief
+   *
+   * @param channel
+   * @return T&
+   */
   static T& ReleaseChannel(int channel) {
     decltype(_instances_map.end()) _it;
     {
@@ -86,33 +119,79 @@ class SingletonFunctionObject {
     DLOG(INFO) << "channel" << channel << "released";
   }
 
+  /**
+   * @brief Get the Default Channel object
+   *
+   * @return int
+   */
   static int GetDefaultChannel() { return _default_channel; }
 
+  /**
+   * @brief Get the Channel object
+   *
+   * @return int
+   */
   [[nodiscard]] int GetChannel() const { return channel_; }
 
+  /**
+   * @brief Construct a new Singleton Function Object object
+   *
+   */
   SingletonFunctionObject(T&&) = delete;
 
+  /**
+   * @brief Construct a new Singleton Function Object object
+   *
+   */
   SingletonFunctionObject(const T&) = delete;
 
+  /**
+   * @brief
+   *
+   */
   void operator=(const T&) = delete;
 
  protected:
+  /**
+   * @brief Construct a new Singleton Function Object object
+   *
+   */
   SingletonFunctionObject() = default;
 
+  /**
+   * @brief Construct a new Singleton Function Object object
+   *
+   * @param channel
+   */
   explicit SingletonFunctionObject(int channel) : channel_(channel) {}
 
+  /**
+   * @brief Destroy the Singleton Function Object object
+   *
+   */
   virtual ~SingletonFunctionObject() = default;
 
+  /**
+   * @brief Set the Channel object
+   *
+   * @param channel
+   */
   void SetChannel(int channel) { this->channel_ = channel; }
 
  private:
-  int channel_ = _default_channel;
-  static int _default_channel;
-  static std::mutex _instance_mutex;
-  static std::shared_mutex _instances_mutex;
-  static std::unique_ptr<T> _instance;
-  static std::map<int, std::unique_ptr<T>> _instances_map;
-
+  int channel_ = _default_channel;                          ///<
+  static int _default_channel;                              ///<
+  static std::mutex _instance_mutex;                        ///<
+  static std::shared_mutex _instances_mutex;                ///<
+  static std::unique_ptr<T> _instance;                      ///<
+  static std::map<int, std::unique_ptr<T>> _instances_map;  ///<
+
+  /**
+   * @brief
+   *
+   * @param channel
+   * @return T*
+   */
   static T* find_object_in_channel(int channel) {
     // read _instances_map
     decltype(_instances_map.end()) _it;
@@ -126,6 +205,13 @@ class SingletonFunctionObject {
     }
   }
 
+  /**
+   * @brief Set the object in channel object
+   *
+   * @param channel
+   * @param p_obj
+   * @return T*
+   */
   static T* set_object_in_channel(int channel, std::unique_ptr<T> p_obj) {
     {
       if (p_obj == nullptr) p_obj = std::make_unique<T>();