Updated RootContext

src/Core/Context/RootContext.php

@@ -68,11 +68,15 @@ public static function bind(string $xid): void
     {
         if (! $xid) {
             static::log('debug', 'xid is blank, switch to unbind operation!');
+            self::unbind();
         }
         static::log('debug', 'Bind xid: ' . $xid);
         static::set(static::KEY_XID, $xid);
     }
 
+    /**
+     * Unbind xid.
+     */
     public static function unbind(): ?string
     {
         $xid = static::getXID();
@@ -94,21 +98,34 @@ public static function unbindGlobalLockFlag(): void
         static::set(static::KEY_GLOBAL_LOCK_FLAG, null);
     }
 
+    /**
+     * In global transaction boolean.
+     */
     public static function inGlobalTransaction(): bool
     {
         return static::getXID() !== null;
     }
 
+    /**
+     * In tcc branch boolean.
+     */
     public static function inTccBranch(): bool
     {
         return static::getBranchType() === BranchType::TCC;
     }
 
+
+    /**
+     * In saga branch boolean.
+     */
     public static function inSagaBranch(): bool
     {
         return static::getBranchType() === BranchType::SAGA;
     }
 
+    /**
+     * get the branch type
+     */
     public static function getBranchType(): ?int
     {
         $branchType = null;
@@ -118,12 +135,22 @@ public static function getBranchType(): ?int
         return $branchType;
     }
 
+    /**
+     * bind branch type
+     */
     public static function bindBranchType(int $branchType)
     {
+        if (empty($branchType)) {
+            throw new IllegalArgumentException('branchType must be not null');
+        }
+
         static::log('debug', 'Bind branch type %d', $branchType);
         static::set(static::KEY_BRANCH_TYPE, $branchType);
     }
 
+    /**
+     * unbind branch type
+     */
     public static function unbindBranchType(): null|int
     {
         $prevBranchType = static::get(static::KEY_BRANCH_TYPE, null);
@@ -132,6 +159,9 @@ public static function unbindBranchType(): null|int
         return $prevBranchType;
     }
 
+    /**
+     * requires global lock check
+     */
     public static function requireGlobalLock(): bool
     {
         return static::get(static::KEY_GLOBAL_LOCK_FLAG) !== null;
@@ -147,6 +177,14 @@ public static function assertNotInGlobalTransaction(): void
         }
     }
 
+    /**
+     * entry map
+     */
+    public static function entries(): array
+    {
+       return Context::getContainer();
+    }
+
     private static function log($level = 'debug', ...$content)
     {
         if (! static::$logger instanceof LoggerInterface && ApplicationContext::hasContainer()) {