Deprecating the VersionableDatabaseObject-system

The entire design is flawed as it is anything but flexible and forces copying of full table contents rather than being able to specify the columns which should actually be tracked. In addition it does not provide centralized access and management including comparisons.

The entire API is now deprecated and will be removed with WCF 2.2.

diff --git a/wcfsetup/install/files/lib/data/VersionableDatabaseObject.class.php b/wcfsetup/install/files/lib/data/VersionableDatabaseObject.class.php
index bcd8fca5ad90ca07f97cc4481fc4d8e8b20322c0..c5cf4434c4b09ae8b9f3de49fa8b278945d61ada 100644 (file)
--- a/wcfsetup/install/files/lib/data/VersionableDatabaseObject.class.php
+++ b/wcfsetup/install/files/lib/data/VersionableDatabaseObject.class.php
@@ -6,6 +6,8 @@ use wcf\system\version\VersionHandler;
 /**
  * Abstract class for all versionable data classes.
  * 
+ * @deprecated 2.1 - will be removed with WCF 2.2
+ * 
  * @author     Jeffrey Reichardt
  * @copyright  2001-2014 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>

diff --git a/wcfsetup/install/files/lib/data/VersionableDatabaseObjectAction.class.php b/wcfsetup/install/files/lib/data/VersionableDatabaseObjectAction.class.php
index cdb28e48a63a65e17c3d29fe63aefa9828db9180..fc109bc4cb20c7941e165be21fe574dc028d7540 100644 (file)
--- a/wcfsetup/install/files/lib/data/VersionableDatabaseObjectAction.class.php
+++ b/wcfsetup/install/files/lib/data/VersionableDatabaseObjectAction.class.php
@@ -5,6 +5,8 @@ use wcf\system\version\VersionHandler;
 /**
  * Abstract class for all versionable data actions.
  * 
+ * @deprecated 2.1 - will be removed with WCF 2.2
+ * 
  * @author     Jeffrey Reichardt
  * @copyright  2001-2014 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>

diff --git a/wcfsetup/install/files/lib/data/VersionableDatabaseObjectEditor.class.php b/wcfsetup/install/files/lib/data/VersionableDatabaseObjectEditor.class.php
index 130cf3b60728dea0295f832eeece77650ab935e3..8d310eb7b0d2eca0f5f668c949622ba3ad04d0e2 100644 (file)
--- a/wcfsetup/install/files/lib/data/VersionableDatabaseObjectEditor.class.php
+++ b/wcfsetup/install/files/lib/data/VersionableDatabaseObjectEditor.class.php
@@ -5,6 +5,8 @@ use wcf\system\WCF;
 /**
  * Abstract class for all versionable editor classes.
  * 
+ * @deprecated 2.1 - will be removed with WCF 2.2
+ * 
  * @author     Jeffrey Reichardt
  * @copyright  2001-2014 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>

diff --git a/wcfsetup/install/files/lib/system/cache/builder/VersionCacheBuilder.class.php b/wcfsetup/install/files/lib/system/cache/builder/VersionCacheBuilder.class.php
index 290b5e5a2b687035376cea5ca176dde0c22b170c..32e2a16c3b1bfbfd36790c10a2c97fd8eeacdc5c 100644 (file)
--- a/wcfsetup/install/files/lib/system/cache/builder/VersionCacheBuilder.class.php
+++ b/wcfsetup/install/files/lib/system/cache/builder/VersionCacheBuilder.class.php
@@ -6,6 +6,8 @@ use wcf\system\WCF;
 /**
  * Caches the versions for a certain package and object type.
  * 
+ * @deprecated 2.1 - will be removed with WCF 2.2
+ * 
  * @author     Jeffrey Reichardt
  * @copyright  2001-2014 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>

diff --git a/wcfsetup/install/files/lib/system/package/PackageInstallationDispatcher.class.php b/wcfsetup/install/files/lib/system/package/PackageInstallationDispatcher.class.php
index ddf6ab0ef697be3b965502336a1a3dc6ab9f8b15..24b3972c30f392255450f290b7c94e0c366f0696 100644 (file)
--- a/wcfsetup/install/files/lib/system/package/PackageInstallationDispatcher.class.php
+++ b/wcfsetup/install/files/lib/system/package/PackageInstallationDispatcher.class.php
@@ -1082,8 +1082,10 @@ class PackageInstallationDispatcher {
                }
        }
        
-       /*
+       /**
         * Restructure version tables.
+        * 
+        * @deprecated  2.1 - will be removed with WCF 2.2
         */
        protected function restructureVersionTables() {
                $objectTypes = ObjectTypeCache::getInstance()->getObjectTypes('com.woltlab.wcf.versionableObject');

diff --git a/wcfsetup/install/files/lib/system/version/VersionHandler.class.php b/wcfsetup/install/files/lib/system/version/VersionHandler.class.php
index 4b99994d2f59b663a94cfc1e252afbecfe171427..eaddfe19c2b565c32d6e366443dbb4654027afba 100644 (file)
--- a/wcfsetup/install/files/lib/system/version/VersionHandler.class.php
+++ b/wcfsetup/install/files/lib/system/version/VersionHandler.class.php
@@ -7,6 +7,8 @@ use wcf\system\SingletonFactory;
 /**
  * Handles versions of DatabaseObjects.
  * 
+ * @deprecated 2.1 - will be removed with WCF 2.2
+ * 
  * @author     Jeffrey Reichardt
  * @copyright  2001-2014 WoltLab GmbH
  * @license    GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>