[REF] - Deprecate & delegate BAO::retrieve
[civicrm-core.git] / CRM / Pledge / BAO / PledgeBlock.php
index 55d0f4c7f4ec6ee1806fc3d173681353adf1034c..4cea3ce74c791b830ab05122b74c962b8509bea6 100644 (file)
 class CRM_Pledge_BAO_PledgeBlock extends CRM_Pledge_DAO_PledgeBlock {
 
   /**
-   * Retrieve DB object based on input parameters.
-   *
-   * It also stores all the retrieved values in the default array.
+   * Retrieve DB object and copy to defaults array.
    *
    * @param array $params
-   *   (reference ) an assoc array of name/value pairs.
+   *   Array of criteria values.
    * @param array $defaults
-   *   (reference ) an assoc array to hold the flattened values.
+   *   Array to be populated with found values.
    *
-   * @return CRM_Pledge_BAO_PledgeBlock
+   * @return self|null
+   *   The DAO object, if found.
+   *
+   * @deprecated
    */
-  public static function retrieve(&$params, &$defaults) {
-    $pledgeBlock = new CRM_Pledge_DAO_PledgeBlock();
-    $pledgeBlock->copyValues($params);
-    if ($pledgeBlock->find(TRUE)) {
-      CRM_Core_DAO::storeValues($pledgeBlock, $defaults);
-      return $pledgeBlock;
-    }
-    return NULL;
+  public static function retrieve($params, &$defaults) {
+    return self::commonRetrieve(self::class, $params, $defaults);
   }
 
   /**