Activiti工作流學習筆記(三)——自動生成28張數據庫表的底層原理分析

語言: CN / TW / HK

原創/朱季謙

 

我接觸工作流引擎Activiti已有兩年之久,但一直都只限於熟悉其各類API的使用,對底層的實現,則存在較大的盲區。

Activiti這個開源框架在設計上,其實存在不少值得學習和思考的地方,例如,框架用到以命令模式、責任鏈模式、模板模式等優秀的設計模式來進行框架的設計。

故而,是值得好好研究下Activiti這個框架的底層實現。

我在工作當中現階段用的比較多是Activiti6.0版本,本文就以這個版本來展開分析。

在使用Activiti工作流引擎過程中,讓我比較好奇的一個地方,是框架自帶一套數據庫表結構,在首次啟動時,若設計了相應的建表策略時,將會自動生成28張表,而這些表都是以ACT_開頭。

那麼問題來了,您是否與我一樣,曾好奇過這些表都是怎麼自動生成的呢?

下面,就開始一點點深入研究——

在工作流Springboot+Activiti6.0集成框架,網上最常見的引擎啟動配置教程一般長這樣:

 1 @Configuration
 2 public class SpringBootActivitiConfig  {
 3 @Bean
 4 public ProcessEngine processEngine(){
 5      ProcessEngineConfiguration pro=ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
 6      pro.setJdbcDriver("com.mysql.jdbc.Driver");
 7      pro.setJdbcUrl("xxxx");
 8      pro.setJdbcUsername("xxxx");
 9      pro.setJdbcPassword("xxx");
10      //避免發佈的圖片和xml中文出現亂碼
11      pro.setActivityFontName("宋體");
12      pro.setLabelFontName("宋體");
13      pro.setAnnotationFontName("宋體");
14      //數據庫更更新策略
15      pro.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
16      return pro.buildProcessEngine();
17 }
18     
19      @Bean
20      public RepositoryService repositoryService(){
21          return processEngine().getRepositoryService();
22      }
23     
24      @Bean
25      public RuntimeService runtimeService(){
26          return processEngine().getRuntimeService();
27      }
28     
29      @Bean
30      public TaskService taskService(){
31          return processEngine().getTaskService();
32      }
33      ......
34     
35 }

其中,方法pro.setDatabaseSchemaUpdate()可對工作流引擎自帶的28張表進行不同策略的更新。

Activiti6.0版本總共有四種數據庫表更新策略。

查看這三種策略的靜態常量標識,分別如下:

 1 public abstract class ProcessEngineConfiguration {
 2      public static final String DB_SCHEMA_UPDATE_FALSE = "false";
 3      public static final String DB_SCHEMA_UPDATE_CREATE_DROP = "create-drop";
 4      public static final String DB_SCHEMA_UPDATE_TRUE = "true";
 5      ......
 6 }
 7 
 8 public abstract class ProcessEngineConfigurationImpl extends ProcessEngineConfiguration {
 9      public static final String DB_SCHEMA_UPDATE_DROP_CREATE = "drop-create";
10      ......
11 }
  • flase:默認值,引擎啟動時,自動檢查數據庫裏是否已有表,或者表版本是否匹配,如果無表或者表版本不對,則拋出異常。(常用在生產環境);

  • true:若表不存在,自動更新;若存在,而表有改動,則自動更新表,若表存在以及表無更新,則該策略不會做任何操作。(一般用在開發環境);

  • create_drop:啟動時自動建表,關閉時就刪除表,有一種臨時表的感覺。(需手動關閉,才會起作用);

  • drop-create:啟動時刪除舊錶,再重新建表。(無需手動關閉就能起作用);

 

整個啟動更新數據庫的過程都是圍繞這四種策略,接下來就以這四種策略為主題,擼一下自動更新據庫表的底層原理,這一步驟是在引擎啟動時所執行的buildProcessEngine()方法裏實現。

從該buildProcessEngine方法名上便可以看出,這是一個初始化工作流引擎框架的方法。

image-20210311223459139

從這裏開始,一步一步debug去分析源碼實現。

一.初始化工作流的buildProcessEngine()方法——

processEngineConfiguration.buildProcessEngine()是一個抽象方法,主要功能是初始化引擎,獲取到工作流的核心API接口:ProcessEngine。通過該API,可獲取到引擎所有的service服務。

進入processEngine接口,可以看到,其涵蓋了Activiti的所有服務接口:

 1 public interface ProcessEngine {
 2 
 3    public static String VERSION = "6.0.0.4"; 
 4 
 5    String getName();
 6 
 7   void close();
 8    //流程運行服務類,用於獲取流程執行相關信息
 9    RepositoryService getRepositoryService();
10    //流程運行服務類,用於獲取流程執行相關信息
11    RuntimeService getRuntimeService();
12    //內置表單,用於工作流自帶內置表單的設置
13    FormService getFormService();
14    //任務服務類,用户獲取任務信息
15    TaskService getTaskService();
16    //獲取正在運行或已經完成的流程實例歷史信息
17    HistoryService getHistoryService();
18    //創建、更新、刪除、查詢羣組和用户
19    IdentityService getIdentityService();
20    //流程引擎的管理與維護
21    ManagementService getManagementService();
22    //提供對流程定義和部署存儲庫的訪問的服務。
23    DynamicBpmnService getDynamicBpmnService();
24    //獲取配置類
25    ProcessEngineConfiguration getProcessEngineConfiguration();
26    //提供對內置表單存儲庫的訪問的服務。
27    FormRepositoryService getFormEngineRepositoryService();
28   
29    org.activiti.form.api.FormService getFormEngineFormService();
30 }

buildProcessEngine()有三個子類方法的重寫,默認是用ProcessEngineConfigurationImpl類繼承重寫buildProcessEngine初始化方法,如下圖所示:

image

該buildProcessEngine重寫方法如下:

 1 @Override
 2 public ProcessEngine buildProcessEngine() {
 3    //初始化的方法
 4    init();
 5    //創建ProcessEngine
 6    ProcessEngineImpl processEngine = new ProcessEngineImpl(this);
 7 
 8   // Activiti 5引擎的觸發裝置
 9    if (isActiviti5CompatibilityEnabled && activiti5CompatibilityHandler != null) {
10      Context.setProcessEngineConfiguration(processEngine.getProcessEngineConfiguration());
11      activiti5CompatibilityHandler.getRawProcessEngine();
12    }
13 
14   postProcessEngineInitialisation();
15 
16   return processEngine;
17 }

init()方法裏面包含各類需要初始化的方法,涉及到很多東西,這裏先暫不一一展開分析,主要先分析與數據庫連接初始化相關的邏輯。Activiti6.0底層是通過mybatis來操作數據庫的,下面主要涉及到mybatis的連接池與SqlSessionFactory 的創建。

1.initDataSource():實現動態配置數據庫DataSource源

1 protected boolean usingRelationalDatabase = true;
2 if (usingRelationalDatabase) {
3    initDataSource();
4 }

該數據庫連接模式初始化的意義如何理解,這就需要回到最初引擎配置分析,其中裏面有這樣一部分代碼:

1   pro.setJdbcDriver("com.mysql.jdbc.Driver");
2   pro.setJdbcUrl("xxxx");
3   pro.setJdbcUsername("xxxx");
4   pro.setJdbcPassword("xxx");

這部分設置的東西,都是數據庫相關的參數,它將傳到initDataSource方法裏,通過mybatis默認的連接池PooledDataSource進行設置,可以説,這個方法主要是用來創建mybatis連接數據庫的連接池,從而生成數據源連接。

 1 public void initDataSource() {
 2     //判斷數據源dataSource是否存在
 3    if (dataSource == null) {
 4        /
 5        //判斷是否使用JNDI方式連接數據源
 6      if (dataSourceJndiName != null) {
 7        try {
 8          dataSource = (DataSource) new InitialContext().lookup(dataSourceJndiName);
 9        } catch (Exception e) {
10          ......
11        }
12       //使用非JNDI方式且數據庫地址不為空,走下面的設置
13      } else if (jdbcUrl != null) {
14          //jdbc驅動為空或者jdbc連接賬户為空
15        if ((jdbcDriver == null) || (jdbcUsername == null)) {
16         ......
17        }
18 
19        //創建mybatis默認連接池PooledDataSource對象,這裏傳進來的,就是上面pro.setJdbcDriver("com.mysql.jdbc.Driver")配置的參數,
20        //debug到這裏,就可以清晰明白,配置類裏設置的JdbcDriver、JdbcUrl、JdbcUsername、JdbcPassword等,就是為了用來創建連接池需要用到的;
21        PooledDataSource pooledDataSource = new PooledDataSource(ReflectUtil.getClassLoader(), jdbcDriver, jdbcUrl, jdbcUsername, jdbcPassword);
22       
23        if (jdbcMaxActiveConnections > 0) {
24          //設置最大活躍連接數
25          pooledDataSource.setPoolMaximumActiveConnections(jdbcMaxActiveConnections);
26        }
27        if (jdbcMaxIdleConnections > 0) {
28          // 設置最大空閒連接數
29          pooledDataSource.setPoolMaximumIdleConnections(jdbcMaxIdleConnections);
30        }
31        if (jdbcMaxCheckoutTime > 0) {
32          // 最大checkout 時長
33          pooledDataSource.setPoolMaximumCheckoutTime(jdbcMaxCheckoutTime);
34        }
35        if (jdbcMaxWaitTime > 0) {
36          // 在無法獲取連接時,等待的時間
37          pooledDataSource.setPoolTimeToWait(jdbcMaxWaitTime);
38        }
39        if (jdbcPingEnabled == true) {
40          //是否允許發送測試SQL語句
41          pooledDataSource.setPoolPingEnabled(true);
42       
43         ......
44       
45        dataSource = pooledDataSource;
46      }
47 
48        ......
49    }
50    //設置數據庫類型
51    if (databaseType == null) {
52      initDatabaseType();
53    }
54 }

initDatabaseType()作用是設置工作流引擎的數據庫類型。在工作流引擎裏,自帶的28張表,其實有區分不同的數據庫,而不同數據庫其建表語句存在一定差異。

進入到 initDatabaseType()方法看看其是如何設置數據庫類型的——

 1 public void initDatabaseType() {
 2      Connection connection = null;
 3      try {
 4          connection = this.dataSource.getConnection();
 5          DatabaseMetaData databaseMetaData = connection.getMetaData();
 6          String databaseProductName = databaseMetaData.getDatabaseProductName();
 7          this.databaseType = databaseTypeMappings.getProperty(databaseProductName);
 8          ......
 9      } catch (SQLException var12) {
10       ......
11      } finally {
12       ...... 
13      }
14 }

進入到databaseMetaData.getDatabaseProductName()方法裏,可以看到這是一個接口定義的方法:

String getDatabaseProductName() throws SQLException;

 

這個方法在java.sql包中的DatabaseMetData接口裏被定義,其作用是搜索並獲取數據庫的名稱。這裏配置使用的是mysql驅動,那麼就會被mysql驅動中的jdbc中的DatabaseMetaData實現,如下代碼所示:

1 package com.mysql.cj.jdbc;
2 
3 public class DatabaseMetaData implements java.sql.DatabaseMetaData

在該實現類裏,其重寫的方法中,將會返回mysql驅動對應的類型字符串:

1 @Override
2 public String getDatabaseProductName() throws SQLException {
3      return "MySQL";
4 }

故而,就會返回“MySql”字符串,並賦值給字符串變量databaseProductName,再將databaseProductName當做參數傳給

databaseTypeMappings.getProperty(databaseProductName),最終會得到一個 this.databaseType =“MySQL”,也就是意味着,設置了數據庫類型databaseType的值為mysql。注意,這一步很重要,因為將在後面生成表過程中,會判斷該databaseType的值究竟是代表什麼數據庫類型。

1  String databaseProductName = databaseMetaData.getDatabaseProductName();
2  this.databaseType = databaseTypeMappings.getProperty(databaseProductName);
  1. 該方法對SqlSessionFactory進行 初始化創建:SqlSessionFactory是mybatis的核心類,簡單的講,創建這個類,接下來就可以進行增刪改查與事務操作了。

1 protected boolean usingRelationalDatabase = true;
2 if (usingRelationalDatabase) {
3   initSqlSessionFactory();
4 }

init()主要都是初始化引擎環境的相關操作,裏面涉及到很多東西,但在本篇文中主要了解到這裏面會創建線程池以及mybatis相關的初始創建即可。

二、開始進行processEngine 的創建

ProcessEngineImpl processEngine = new ProcessEngineImpl(this);

這部分代碼,就是創建Activiti的各服務類了:

 1 public ProcessEngineImpl(ProcessEngineConfigurationImpl processEngineConfiguration) {
 2   this.processEngineConfiguration = processEngineConfiguration;
 3   this.name = processEngineConfiguration.getProcessEngineName();
 4   this.repositoryService = processEngineConfiguration.getRepositoryService();
 5   this.runtimeService = processEngineConfiguration.getRuntimeService();
 6   this.historicDataService = processEngineConfiguration.getHistoryService();
 7   this.identityService = processEngineConfiguration.getIdentityService();
 8   this.taskService = processEngineConfiguration.getTaskService();
 9   this.formService = processEngineConfiguration.getFormService();
10   this.managementService = processEngineConfiguration.getManagementService();
11   this.dynamicBpmnService = processEngineConfiguration.getDynamicBpmnService();
12   this.asyncExecutor = processEngineConfiguration.getAsyncExecutor();
13   this.commandExecutor = processEngineConfiguration.getCommandExecutor();
14   this.sessionFactories = processEngineConfiguration.getSessionFactories();
15   this.transactionContextFactory = processEngineConfiguration.getTransactionContextFactory();
16   this.formEngineRepositoryService = processEngineConfiguration.getFormEngineRepositoryService();
17   this.formEngineFormService = processEngineConfiguration.getFormEngineFormService();
18 19   if (processEngineConfiguration.isUsingRelationalDatabase() && processEngineConfiguration.getDatabaseSchemaUpdate() != null) {
20     commandExecutor.execute(processEngineConfiguration.getSchemaCommandConfig(), new SchemaOperationsProcessEngineBuild());
21   }
22  ......
23 }

注意,這裏面有一段代碼,整個引擎更新數據庫的相應策略是具體實現,就在這裏面:

1 if (processEngineConfiguration.isUsingRelationalDatabase() && processEngineConfiguration.getDatabaseSchemaUpdate() != null) {
2     commandExecutor.execute(processEngineConfiguration.getSchemaCommandConfig(), new SchemaOperationsProcessEngineBuild());
3   }
  • processEngineConfiguration.isUsingRelationalDatabase()默認是true,即代表需要對數據庫模式做設置,例如前面初始化的dataSource數據源,創建SqlSessionFactory等,這些都算是對數據庫模式進行設置;若為false,則不會進行模式設置與驗證,需要額外手動操作,這就意味着,引擎不能驗證模式是否正確。

  • processEngineConfiguration.getDatabaseSchemaUpdate()是用户對數據庫更新策略的設置,如,前面配置類裏設置了pro.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE),若設置四種模式當中的任何一種,就意味着,需要對引擎的數據庫進行相應策略操作。

綜上,if()判斷為true,就意味着,將執行括號裏的代碼,這塊功能就是根據策略去對數據庫進行相應的增刪改查操作。

commandExecutor.execute()是一個典型的命令模式,先暫時不深入分析,直接點開new SchemaOperationsProcessEngineBuild()方法。

 1 public final class SchemaOperationsProcessEngineBuild implements Command<Object> {
 2  3   public Object execute(CommandContext commandContext) {
 4     DbSqlSession dbSqlSession = commandContext.getDbSqlSession();
 5     if (dbSqlSession != null) {
 6       dbSqlSession.performSchemaOperationsProcessEngineBuild();
 7    }
 8     return null;
 9   }
10 }

進入到dbSqlSession.performSchemaOperationsProcessEngineBuild()方法中,接下來,將會看到,在這個方法當中,將根據不同的if判斷,執行不同的方法——而這裏的不同判斷,正是基於四種數據庫更新策略來展開的,換句話説,這個performSchemaOperationsProcessEngineBuild方法,才是真正去判斷不同策略,從而根據不同策略來對數據庫進行對應操作:

 1 public void performSchemaOperationsProcessEngineBuild() {
 2     String databaseSchemaUpdate = Context.getProcessEngineConfiguration().getDatabaseSchemaUpdate();
 3     log.debug("Executing performSchemaOperationsProcessEngineBuild with setting " + databaseSchemaUpdate);
 4      //drop-create模式
 5     if ("drop-create".equals(databaseSchemaUpdate)) {
 6         try {
 7             this.dbSchemaDrop();
 8        } catch (RuntimeException var3) {
 9        }
10    }
11    
12     if (!"create-drop".equals(databaseSchemaUpdate) && !"drop-create".equals(databaseSchemaUpdate) && !"create".equals(databaseSchemaUpdate)) {
13          //false模式
14         if ("false".equals(databaseSchemaUpdate)) {
15             this.dbSchemaCheckVersion();
16        } else if ("true".equals(databaseSchemaUpdate)) {
17               //true模式
18             this.dbSchemaUpdate();
19        }
20    } else {
21         //create_drop模式
22         this.dbSchemaCreate();
23    }
24 25 }

這裏主要以true模式來講解,其他基本都類似的實現。

 1 public String dbSchemaUpdate() {
 2  3   String feedback = null;
 4   //判斷是否需要更新,默認是false
 5   boolean isUpgradeNeeded = false;
 6   int matchingVersionIndex = -1;
 7   //判斷是否需要更新或者創建引擎核心engine表,若isEngineTablePresent()為true,表示需要更新,若為false,則需要新創建
 8  if (isEngineTablePresent()) {
 9   ......
10   } else {
11      //創建表方法,稍後會詳細分析
12     dbSchemaCreateEngine();
13   }
14  
15  //判斷是否需要創建或更新歷史相關表
16  if (this.isHistoryTablePresent()) {
17       if (isUpgradeNeeded) {
18            this.dbSchemaUpgrade("history", matchingVersionIndex);
19        }
20   } else if (this.dbSqlSessionFactory.isDbHistoryUsed()) {
21        this.dbSchemaCreateHistory();
22   }
23   //判斷是否需要更新羣組和用户
24   if (this.isIdentityTablePresent()) {
25        if (isUpgradeNeeded) {
26          this.dbSchemaUpgrade("identity", matchingVersionIndex);
27        }
28   } else if (this.dbSqlSessionFactory.isDbIdentityUsed()) {
29          this.dbSchemaCreateIdentity();
30        }
31   return feedback;
32 }

這裏以判斷是否需要創建engine表為例,分析下isEngineTablePresent()裏面是如何做判斷的。其他如歷史表、用户表,其判斷是否需要創建的邏輯,是類型的。

點擊isEngineTablePresent()進去——

1 public boolean isEngineTablePresent() {
2   return isTablePresent("ACT_RU_EXECUTION");
3 }

進入到isTablePresent("ACT_RU_EXECUTION")方法裏,其中有一句最主要的代碼:

1 tables = databaseMetaData.getTables(catalog, schema, tableName, JDBC_METADATA_TABLE_TYPES);
2 return tables.next();

這兩行代碼大概意思是,通過"ACT_RU_EXECUTION"表名去數據庫中查詢該ACT_RU_EXECUTION表是否存在,若不存在,返回false,説明還沒有創建;若存在,返回true。

返回到該方法上層,當isEngineTablePresent()返回值是false時,説明還沒有創建Activiti表,故而,將執行 dbSchemaCreateEngine()方法來創建28表張工作流表。

1  if (isEngineTablePresent()) {
2   ......
3   } else {
4      //創建表方法
5     dbSchemaCreateEngine();
6   }
7

進入到dbSchemaCreateEngine()方法——裏面調用了executeMandatorySchemaResource方法,傳入"create"與 "engine",代表着創建引擎表的意思。

1 protected void dbSchemaCreateEngine() {
2     this.executeMandatorySchemaResource("create", "engine");
3 }

繼續進入到executeMandatorySchemaResource裏面——

1 public void executeMandatorySchemaResource(String operation, String component) {
2     this.executeSchemaResource(operation, component, this.getResourceForDbOperation(operation, operation, component), false);
3 }

跳轉到這裏時,有一個地方需要注意一下,即調用的this.getResourceForDbOperation(operation, operation, component)方法,這方法的作用,是為了獲取sql文件所存放的相對路徑,而這些sql,就是構建工作流28張表的數據庫sql。因此,我們先去executeSchemaResource()方法裏看下——

1 public String getResourceForDbOperation(String directory, String operation, String component) {
2     String databaseType = this.dbSqlSessionFactory.getDatabaseType();
3     return "org/activiti/db/" + directory + "/activiti." + databaseType + "." + operation + "." + component + ".sql";
4 }

這裏的directory即前邊傳進來的"create",databaseType的值就是前面獲取到的“mysql”,而component則是"engine",因此,這字符串拼接起來,就是:"org/activiti/db/create/activiti.mysql.create.engine.sql"。

根據這個路徑,我們去Activiti源碼裏查看,可以看到在org/activiti/db/路徑底下,總共有5個文件目錄。根據其名字,可以猜測出,create目錄下存放的,是生成表的sql語句;drop目錄下,存放的是刪除表是sql語句;mapping目錄下,是mybatis映射xml文件;properties是各類數據庫類型在分頁情況下的特殊處理;upgrade目錄下,則是更新數據庫表的sql語句。

image-20210313004622812

展開其中的create目錄,可以進一步發現,裏面根據名字區分了不同數據庫類型對應的執行sql文件,其中,有db2、h2、hsql、mssql、mysql、mysql55、oracle、postgres這八種類型,反過來看,同時説明了Activiti工作流引擎支持使用這八種數據庫。通常使用比較多的是mysql。根據剛剛的路徑org/activiti/db/create/activiti.mysql.create.engine.sql,可以在下面截圖中,找到該對應路徑下的engine.sql文件——

image-20210313005508035

點擊進去看,會發現,這不就是我們常見的mysql建表語句嗎!沒錯,工作流Activiti就是在源碼裏內置了一套sql文件,若要創建數據庫表,就直接去到對應數據庫文件目錄下,獲取到相應的建表文件,執行sql語句建表。這跟平常用sql語句構建表結構沒太大區別,區別只在於執行過程的方式而已,但兩者結果都是一樣的。

image-20210313005623292

到這裏,我們根據其拼接的sql存放路徑,找到了create表結構的sql文件,那麼讓我們回到原來代碼執行的方法裏:

1 public void executeMandatorySchemaResource(String operation, String component) {
2      this.executeSchemaResource(operation, component, this.getResourceForDbOperation(operation, operation, component), false);
3 }

這裏通過this.getResourceForDbOperation(operation, operation, component), false)拿到 了mysql文件路徑,接下來,將同其他幾個參數,一塊傳入到this.executeSchemaResource()方法裏,具體如下:

 1 public void executeSchemaResource(String operation, String component, String resourceName, boolean isOptional) {
 2      InputStream inputStream = null;
 3      try {
 4          //根據resourceName路徑字符串,獲取到對應engine.sql文件的輸入流inputStream,即讀取engine.sql文件
 5          inputStream = ReflectUtil.getResourceAsStream(resourceName);
 6          if (inputStream == null) {
 7          ......
 8          } else {
 9              //將得到的輸入流inputStream傳入該方法
10              this.executeSchemaResource(operation, component, resourceName, inputStream);
11          }
12      } finally {
13         ......
14      }
15 }

這一步主要通過輸入流InputStream讀取engine.sql文件的字節,然後再傳入到 this.executeSchemaResource(operation, component, resourceName, inputStream)方法當中,而這個方法,將是Activiti建表過程中的核心所在。

下面刪除多餘代碼,只留核心代碼來分析:

 1 private void executeSchemaResource(String operation, String component, String resourceName, InputStream inputStream) {
 2     //sql語句字符串
 3     String sqlStatement = null;
 4     
 5     try {
 6  //1、jdbc連接mysql數據庫
 7         Connection connection = this.sqlSession.getConnection();
 8  //2、分行讀取resourceName="org/activiti/db/create/activiti.mysql.create.engine.sql"目錄底下的文件數據
 9         byte[] bytes = IoUtil.readInputStream(inputStream, resourceName);
10  //3.將engine.sql文件裏的數據分行轉換成字符串,換行的地方,可以看到字符串用轉義符“\n”來代替
11         String ddlStatements = new String(bytes);
12         try {
13             
14             if (this.isMysql()) {
15                 DatabaseMetaData databaseMetaData = connection.getMetaData();
16                 int majorVersion = databaseMetaData.getDatabaseMajorVersion();
17                 int minorVersion = databaseMetaData.getDatabaseMinorVersion();
18                 if (majorVersion <= 5 && minorVersion < 6) {
19                     //若數據庫類型是在mysql 5.6版本以下,需要做一些替換,因為低於5.6版本的MySQL是不支持變體時間戳或毫秒級的日期,故而需要在這裏對sql語句的字符串做替換。(注意,這裏的majorVersion代表主版本,minorVersion代表主版本下的小版本)
20                     ddlStatements = this.updateDdlForMySqlVersionLowerThan56(ddlStatements);
21                }
22            }
23        } catch (Exception var26) {
24            ......
25        }
26         //4.以字符流形式讀取字符串數據
27         BufferedReader reader = new BufferedReader(new StringReader(ddlStatements));
28         //5.根據字符串中的轉義符“\n”分行讀取
29         String line = this.readNextTrimmedLine(reader);
30         //6.循環每一行
31         for(boolean inOraclePlsqlBlock = false; line != null; line = this.readNextTrimmedLine(reader)) {
32            
33             if (line.startsWith("# ")) {
34            ......
35            } 
36             //7.若下一行line還有數據,證明還沒有全部讀取,仍可執行讀取
37         else if (line.length() > 0) {
38                     if (this.isOracle() && line.startsWith("begin")) {
39                      .......
40                        
41                    } 
42             /**
43             8.在沒有拼接夠一個完整建表語句時,!line.endsWith(";")會為true,即一直循環進行拼接,當遇到";"就跳出該if語句
44             **/
45             else if ((!line.endsWith(";") || inOraclePlsqlBlock) && (!line.startsWith("/") || !inOraclePlsqlBlock)) {
46                         sqlStatement = this.addSqlStatementPiece(sqlStatement, line);
47                    } else {
48                 /**
49              9.循環拼接中若遇到符號";",就意味着,已經拼接形成一個完整的sql建表語句,例如
50             create table ACT_GE_PROPERTY ( 
51             NAME_ varchar(64), 
52             VALUE_ varchar(300), 
53             REV_ integer, 
54             primary key (NAME_) 
55             ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE utf8_bin
56             這樣,就可以先通過代碼來將該建表語句執行到數據庫中,實現如下:
57                 **/
58                         if (inOraclePlsqlBlock) {
59                             inOraclePlsqlBlock = false;
60                        } else {
61                    
62                             sqlStatement = this.addSqlStatementPiece(sqlStatement, line.substring(0, line.length() - 1));
63                        }
64                    //10.將建表語句字符串包裝成Statement對象
65                         Statement jdbcStatement = connection.createStatement();
66                         try {
67                    //11.最後,執行建表語句到數據庫中
68                             jdbcStatement.execute(sqlStatement);
69                             jdbcStatement.close();
70                        } catch (Exception var27) {
71                        ......
72                        } finally {
73                     //12.到這一步,意味着上一條sql建表語句已經執行結束,若沒有出現錯誤話,這時已經證明第一個數據庫表結構已經創建完成,可以開始拼接下一條建表語句,
74                             sqlStatement = null;
75                        }
76                    }
77                }
78            }
79 80            ......
81        } catch (Exception var29) {
82            ......
83        }
84    }

根據debug過程截圖,可以更為直觀地看到,這裏獲取到的ddlStatements字符串,涵蓋了sql文件裏的所有sql語句,同時,每一個完整的creat建表語句,都是以";"結尾的:

image-20210313020402762

每次執行到";"時,都會得到一個完整的create建表語句:

image-20210313020651548

執行完一個建表語句,就會在數據庫裏同步生成一張數據庫表,如上圖執行的是ACT_GE_PROPERTY表,數據庫裏便生成了這張表:

image

在執行完之後,看idea控制枱打印信息,可以看到,我的數據庫是5.7版本,引擎在啟動過程中分別執行了engine.sql、history.sql、identity.sql三個sql文件來進行數據庫表結構的構建。

image-20210313020945718

到這一步,引擎整個生成表的過程就結束了,以上主要是基於true策略模式,通過對engine.sql的執行,來説明工作流引擎生成表的底層邏輯,其餘模式基本都類似,這裏就不一一展開分析了。

最後,進入到數據庫,可以看到,已成功生成28張ACT開頭的工作流自帶表——

image-20210313070032185

本文同步分享在 博客“朱季謙”(CNBlog)。
如有侵權,請聯繫 [email protected] 刪除。
本文參與“OSC源創計劃”,歡迎正在閲讀的你也加入,一起分享。