自增ID带前缀的实现方法

一分耕耘，一分收获！既然都打开这篇《数据库自增ID实现带前缀编号方法》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

本教程详细阐述了如何在Web应用中，特别是使用CodeIgniter等框架时，实现一种安全可靠的自动递增编号生成机制。通过利用数据库的自增主键ID，我们可以在用户提交表单后，生成带有特定前缀（如“LP”）和零填充格式（如“LP00001”）的唯一引用编号，有效避免了并发提交可能导致的编号冲突问题。

引言：自动递增编号的需求与挑战

在许多业务场景中，我们需要为新创建的记录生成一个具有特定格式的唯一引用编号，例如订单号、工单号或资产编号。这些编号通常包含一个固定前缀和一系列递增的数字，如LP00001。一个常见的需求是，这个编号必须在用户提交表单后才生成，并且必须是唯一的。直接在客户端或提交前预生成编号存在明显的风险：如果两个用户同时访问页面，他们可能会看到并提交相同的编号，从而导致数据冲突和业务逻辑错误。因此，确保编号在服务器端安全、唯一地生成，并处理好并发问题，是实现这一功能的关键。

现有代码分析

在典型的MVC（Model-View-Controller）框架（如CodeIgniter）中，表单提交的处理流程通常如下：

• 控制器 (Controller): 负责接收用户请求，进行表单验证。验证通过后，将数据传递给模型层进行处理。

  // 示例控制器代码片段
  if ($this->form_validation->run() == FALSE)
  {
      // 验证失败，重新加载表单
      $main['page'] = 'crm/listings/add';
      $this->load->view('crm/index', $main);
  } else {
      // 验证成功，准备数据并调用模型
      $maindata=array(
          'clients_id'=>$this->session->userdata('clientsessid'),
          'property_for'=>$this->security->xss_clean($this->input->post('property_for')),
          'property_type'=>$this->security->xss_clean($this->input->post('property_type'))
      );
      $insertid=$this->listings_model->insert_listing($maindata); // 调用模型方法
      if($insertid){
          $this->session->set_flashdata('message', '
  Successfully
  ');
          redirect('listings/sales');
      }
  }

• 模型 (Model): 负责与数据库交互，执行数据的插入、更新等操作。

  // 示例模型代码片段
  function insert_listing($maindata){
      $this->db->insert("crm_listings", $maindata); // 插入数据
      $prime = $this->db->insert_id(); // 获取新插入行的主键ID
      return $prime; // 返回主键ID
  }

  在上述现有代码中，数据已成功插入数据库，并且模型返回了新插入记录的数据库自增主键ID（通常是id字段）。然而，refno字段目前仍为空，我们需要在此基础上生成并填充它。

核心思路：利用数据库自增ID

要实现带前缀的自动递增编号，最安全且高效的方法是利用数据库自身的AUTO_INCREMENT主键。数据库的自增ID具有以下优点：

1. 唯一性保证： 数据库系统确保每个新插入的记录都会获得一个唯一的、递增的ID。
2. 并发安全： 数据库层处理并发插入时的ID分配，无需开发者额外处理复杂的锁定机制。

因此，我们的策略是：

1. 首先，正常插入除refno之外的所有数据，让数据库生成一个唯一的自增主键ID。
2. 然后，利用这个已生成的自增ID来构造我们所需的refno格式。
3. 最后，使用这个构造好的refno去更新刚刚插入的这条记录。

实现步骤与代码示例

我们将修改模型层中的insert_listing方法来完成这一逻辑。

1. 修改模型方法

/**
 * 插入新列表数据并生成自动递增的引用编号
 *
 * @param array $maindata 待插入的主要数据
 * @return int 新插入记录的自增主键ID
 */
function insert_listing($maindata){
    // 步骤1: 插入主要数据到数据库
    // 此时，数据库会为新记录生成一个唯一的自增主键ID
    $this->db->insert("crm_listings", $maindata);

    // 步骤2: 获取刚刚插入记录的自增主键ID
    // 这个ID是数据库保证唯一的，我们将基于它来生成refno
    $prime = $this->db->insert_id();

    // 步骤3: 构造引用编号 (refno)
    // 假设前缀是 "LP"，且数字部分需要5位零填充
    // 例如，如果prime是1，则refno是"LP00001"
    // 如果prime是123，则refno是"LP00123"
    $refno = "LP" . sprintf('%05d', $prime);

    // 步骤4: 更新刚刚插入的记录，设置其 refno 字段
    // 通过 WHERE 子句指定刚刚插入的记录（使用其自增ID）
    $this->db->set("refno", $refno);
    $this->db->where('id', $prime); // 假设自增主键字段名为 'id'
    $this->db->update("crm_listings");

    // 返回新插入记录的自增主键ID
    // 控制器可以根据此ID进行后续操作或确认插入成功
    return $prime;
}

代码解释：

• $this->db->insert("crm_listings", $maindata);：执行初始插入操作，将用户提交的数据存入crm_listings表。
• $prime = $this->db->insert_id();：这是关键一步。它获取了数据库为刚刚插入的行分配的AUTO_INCREMENT主键值。
• $refno = "LP" . sprintf('%05d', $prime);：
  • sprintf('%05d', $prime)：这是一个PHP函数，用于格式化字符串。%05d表示将一个整数（$prime）格式化为至少5位宽的十进制数，不足5位时在前面用零填充。例如，如果$prime是1，则输出00001；如果$prime是123，则输出00123。
  • 将格式化后的数字与前缀LP拼接，得到完整的refno。
• $this->db->set("refno", $refno);：指定要更新的字段及其新值。
• $this->db->where('id', $prime);：指定更新条件，确保只更新刚刚插入的那条记录。
• $this->db->update("crm_listings");：执行更新操作。

注意事项

1. 数据库字段类型： 确保crm_listings表中的refno字段的数据类型是VARCHAR或其他能存储字符串的类型，并且长度足够容纳生成的编号（例如VARCHAR(10)对于LP00001）。

2. 事务处理： 虽然上述方法在大多数情况下是可靠的，但在高并发或对数据一致性要求极高的场景下，建议将插入和更新操作封装在一个数据库事务中。这样可以确保这两个操作要么都成功，要么都失败，避免因更新失败而导致refno字段仍为空的情况。

   // 示例：使用事务
   function insert_listing_with_transaction($maindata){
       $this->db->trans_start(); // 开启事务
   
       $this->db->insert("crm_listings", $maindata);
       $prime = $this->db->insert_id();
   
       if ($prime) { // 确保插入成功
           $refno = "LP" . sprintf('%05d', $prime);
           $this->db->set("refno", $refno);
           $this->db->where('id', $prime);
           $this->db->update("crm_listings");
       }
   
       $this->db->trans_complete(); // 完成事务
   
       if ($this->db->trans_status() === FALSE) {
           // 事务失败，处理错误
           return false;
       } else {
           return $prime;
       }
   }

3. 前缀和格式的灵活性： 前缀LP和零填充位数05d可以根据实际需求进行修改。例如，如果需要ORD-0001，则前缀为ORD-，格式为%04d。

4. 初始值问题： 如果数据库的自增ID从1开始，那么第一个refno将是LP00001。如果需要从其他数字开始（例如LP10001），则需要调整sprintf的第二个参数，或者在数据库层面设置自增ID的起始值。

总结

通过巧妙地利用数据库的AUTO_INCREMENT主键，我们可以高效且安全地生成带有特定前缀和格式的自动递增编号。这种方法避免了手动维护序列号的复杂性，有效解决了并发提交带来的编号冲突问题，为Web应用提供了健壮的唯一标识符生成方案。在实际应用中，结合事务处理可以进一步增强数据的可靠性。

本篇关于《自增ID带前缀的实现方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！