GS2-SkillTree トランザクションアクション

アクションの組み合わせと同時実行

すべてのサービスに共通する前提は トランザクションアクションの組み合わせ にまとめています。先にそちらを読んでください。この節の残りは GS2-SkillTree 固有の内容です。

GS2-SkillTree のトランザクションアクションは、ネームスペース・ユーザー・プロパティの組で決まる 1 つのステータスを対象にします。ステータスはスキルツリーのどのノードを解放済みかを記録するもので、更新のたびに全体が書き換わります。

ノードの解放には、そのノードが必要とするものの支払いが伴い、抑制するとそれが返却されます。これらの支払いと返却は自身のトランザクションとして発行されるため、それらが属するサービスの制限を受けます。

返却は支払いから導出されます。解放の消費アクション 1 つ 1 つが、それを取り消す入手アクションに変換されます。リセットは解放済みのノードをまとめて処理するため、別々のノードから導出された返却が 1 つのトランザクションに集まります。たとえば 2 つのノードが同じミッショングループの別のタスクに対する Gs2Mission:ReceiveByUserId を必要としている場合、その返却どうしが衝突して抑制やリセットが失敗します。

前提関係のないノードを複数解放するだけなら、1 つのアクションの nodeModelNames に並べて指定しても、アクションを複数指定して統合させても、どちらでもかまいません。

前提関係があるノードを一緒に解放したい場合は、1 つのアクションにまとめる必要があります。ノードの解放は、その前提となるノードがすでに解放されていることを確認しますが、この判定はトランザクション開始時点のステータスに対して行われるためです。アクションを 2 つに分けると、前提ノードを解放したことがもう一方からは見えません。

解放と抑制は行が違い、境界が同じです。1 つのトランザクションで行うことはできません。トランザクションを分けてください。

プロパティが違えば別のステータスなので、複数のプロパティのノードを 1 つのトランザクションで解放するのは問題ありません。

入れ子になったトランザクションに注意

並べて書けば 1 件に統合されたはずの同じステータスへの解放どうしでも、片方が内側から届く場合はトランザクションが失敗します。

制限を回避したい場合

ノードの解放は入手アクション、抑制は消費アクションです。解放どうしの衝突は acquireActionUseJobQueue を有効にすれば解消できますが、解放と抑制の同居は enableAtomicCommit を無効にしないと解消しません。前提関係のあるノードを一緒に解放したい場合は、どちらの設定を使う場合でも 1 つのアクションにまとめるのが確実です。

同時実行とリトライ

同じステータスを複数のリクエストが同時に更新した場合、後から確定した側がコンフリクト (409) になります。リクエストの内容に問題があるわけではないので、リトライすれば成功します。リトライ時には最新のステータスに対して前提条件が確認し直されます。

異なるプロパティのノードを同時に解放する場合はコンフリクトしません。

Consume Action

消費アクション

Gs2SkillTree:MarkRestrainByUserId

ユーザーIDを指定してノードの解放状態を未解放化

指定されたノードが拘束可能であることを検証し（依存するノードが解放状態でないことが必要です）、未解放としてマークします。

数量指定可能なアクション：いいえ

反転可能なアクション：はい

• Format:
• JSON
• YAML
• GS2-Script

{
    "action": "Gs2SkillTree:MarkRestrainByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "propertyId": "[string]プロパティID",
        "nodeModelNames": [
            "[string]ノードモデル名"
        ],
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}

action: Gs2SkillTree:MarkRestrainByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  propertyId: "[string]プロパティID"
  nodeModelNames: 
    - "[string]ノードモデル名"
  timeOffsetToken: "[string]タイムオフセットトークン"

transaction.service("skillTree").consume.mark_restrain_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    propertyId="[string]プロパティID",
    nodeModelNames={
        "[string]ノードモデル名"
    },
    timeOffsetToken="[string]タイムオフセットトークン",
})

Acquire Action

入手アクション

Gs2SkillTree:MarkReleaseByUserId

ユーザーIDを指定して解放済みノードを記録

指定されたノードが解放可能であることを検証し（前提ノードが既に解放済みである必要があります）、解放済みとしてマークします。

数量指定可能なアクション：いいえ

反転可能なアクション：はい

• Format:
• JSON
• YAML
• GS2-Script

{
    "action": "Gs2SkillTree:MarkReleaseByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "propertyId": "[string]プロパティID",
        "nodeModelNames": [
            "[string]ノードモデル名"
        ],
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}

action: Gs2SkillTree:MarkReleaseByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  propertyId: "[string]プロパティID"
  nodeModelNames: 
    - "[string]ノードモデル名"
  timeOffsetToken: "[string]タイムオフセットトークン"

transaction.service("skillTree").acquire.mark_release_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    propertyId="[string]プロパティID",
    nodeModelNames={
        "[string]ノードモデル名"
    },
    timeOffsetToken="[string]タイムオフセットトークン",
})