first commit

2026-04-03 11:32:07 +08:00
commit 003be19522
1142 changed files with 185854 additions and 0 deletions
--- a/include/QxDao/QxDateTimeNeutral.h
+++ b/include/QxDao/QxDateTimeNeutral.h
@@ -0,0 +1,153 @@
+/****************************************************************************
+**
+** https://www.qxorm.com/
+** Copyright (C) 2013 XDL Team (ic-east.com)
+**
+** This file is part of the QxOrm library
+**
+** This software is provided 'as-is', without any express or implied
+** warranty. In no event will the authors be held liable for any
+** damages arising from the use of this software
+**
+** Commercial Usage
+** Licensees holding valid commercial QxOrm licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and XDL Team
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file 'license.gpl3.txt' included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met : http://www.gnu.org/copyleft/gpl.html
+**
+** If you are unsure which license is appropriate for your use, or
+** if you have questions regarding the use of this file, please contact :
+** ic-east.com
+**
+****************************************************************************/
+
+#ifndef _QX_DATE_TIME_NEUTRAL_H_
+#define _QX_DATE_TIME_NEUTRAL_H_
+
+#ifdef _MSC_VER
+#pragma once
+#endif
+
+/*!
+ * \file QxDateTimeNeutral.h
+ * \author XDL Team
+ * \ingroup QxDao
+ * \brief Helper class to store a date-time value into database under neutral format (YYYYMMDDHHMMSS) => cross database compatibility
+ */
+
+#ifdef _QX_ENABLE_BOOST_SERIALIZATION
+#include <boost/serialization/serialization.hpp>
+#include <boost/serialization/nvp.hpp>
+#endif // _QX_ENABLE_BOOST_SERIALIZATION
+
+#include <QtCore/qdatetime.h>
+#include <QtCore/qdatastream.h>
+
+#include <QxSerialize/Qt/QxSerialize_QString.h>
+
+#include <QxTraits/get_class_name.h>
+
+namespace qx
+{
+   class QxDateTimeNeutral;
+} // namespace qx
+
+QX_DLL_EXPORT QDataStream &operator<<(QDataStream &stream, const qx::QxDateTimeNeutral &t) QX_USED;
+QX_DLL_EXPORT QDataStream &operator>>(QDataStream &stream, qx::QxDateTimeNeutral &t) QX_USED;
+
+namespace qx
+{
+
+   /*!
+    * \ingroup QxDao
+    * \brief qx::QxDateTimeNeutral : helper class to store a date-time value into database under neutral format (YYYYMMDDHHMMSS) => cross database compatibility
+    */
+   class QxDateTimeNeutral
+   {
+
+#ifdef _QX_ENABLE_BOOST_SERIALIZATION
+      friend class boost::serialization::access;
+#endif // _QX_ENABLE_BOOST_SERIALIZATION
+
+      friend QX_DLL_EXPORT QDataStream & ::operator<<(QDataStream &stream, const qx::QxDateTimeNeutral &t);
+      friend QX_DLL_EXPORT QDataStream & ::operator>>(QDataStream &stream, qx::QxDateTimeNeutral &t);
+
+   private:
+      QDateTime m_dt;    //!< Data value under QDateTime format from Qt library
+      QString m_neutral; //!< Data value under neutral format 'yyyyMMddhhmmss'
+
+   public:
+      QxDateTimeNeutral() { ; }
+      explicit QxDateTimeNeutral(const QDateTime &dt) : m_dt(dt) { update(); }
+      explicit QxDateTimeNeutral(const QString &neutral) : m_neutral(neutral) { update(); }
+      virtual ~QxDateTimeNeutral() { ; }
+
+      inline QDateTime toDateTime() const { return m_dt; }
+      inline QString toNeutral() const { return m_neutral; }
+      inline bool isValid() const { return m_dt.isValid(); }
+
+      inline void setDateTime(const QDateTime &dt)
+      {
+         m_neutral = "";
+         m_dt = dt;
+         update();
+      }
+      inline void setNeutral(const QString &neutral)
+      {
+         m_dt = QDateTime();
+         m_neutral = neutral;
+         update();
+      }
+
+      static QxDateTimeNeutral fromDateTime(const QDateTime &dt) { return QxDateTimeNeutral(dt); }
+      static QxDateTimeNeutral fromNeutral(const QString &neutral) { return QxDateTimeNeutral(neutral); }
+
+   private:
+      static inline const char *format() { return "yyyyMMddhhmmss"; }
+
+      void update()
+      {
+         if (m_neutral.isEmpty() && !m_dt.isValid())
+         {
+            return;
+         }
+         else if (m_dt.isValid())
+         {
+            m_neutral = m_dt.toString(format());
+         }
+         else
+         {
+            qAssert(m_neutral.size() == QString(format()).size());
+            m_dt = QDateTime::fromString(m_neutral, format());
+            qAssert(m_dt.isValid());
+         }
+      }
+
+#ifdef _QX_ENABLE_BOOST_SERIALIZATION
+      template <class Archive>
+      void serialize(Archive &ar, const unsigned int file_version)
+      {
+         Q_UNUSED(file_version);
+         ar &boost::serialization::make_nvp("dt_neutral", m_neutral);
+         if (Archive::is_loading::value)
+         {
+            m_dt = QDateTime();
+            update();
+         }
+      }
+#endif // _QX_ENABLE_BOOST_SERIALIZATION
+   };
+
+} // namespace qx
+
+QX_REGISTER_CLASS_NAME(qx::QxDateTimeNeutral)
+
+#endif // _QX_DATE_TIME_NEUTRAL_H_