Lock Service tegen race conditions

Waarom je de Lock Service nodig hebt

Wanneer meerdere gebruikers tegelijk een formulier indienen, een trigger afvuurt terwijl een vorige nog loopt, of meerdere tabbladen hetzelfde script uitvoeren, kunnen race conditions optreden. Twee uitvoeringen lezen dan dezelfde data, verwerken die parallel en schrijven overlappende resultaten terug. Het gevolg is verloren rijen, dubbele ID's of een teller die te laag uitkomt.

De Lock Service van Apps Script biedt drie typen locks:

• Script lock: blokkeert alle uitvoeringen van het script, voor alle gebruikers.
• Document lock: blokkeert toegang tot het huidige document (alleen beschikbaar in container-gebonden scripts).
• User lock: per-gebruiker lock; uitvoeringen van andere gebruikers worden niet geblokkeerd.

function welkLockType() {
  const scriptLock = LockService.getScriptLock();
  const docLock = LockService.getDocumentLock();
  const userLock = LockService.getUserLock();
}

Basis lock-patroon

function veiligSchrijven() {
  const lock = LockService.getScriptLock();

  try {
    lock.waitLock(30000);

    const blad = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Log');
    const volgendeRij = blad.getLastRow() + 1;
    blad.getRange(volgendeRij, 1).setValue(new Date());
    blad.getRange(volgendeRij, 2).setValue(Session.getActiveUser().getEmail());
    blad.getRange(volgendeRij, 3).setValue('Verwerkt');

  } catch (e) {
    Logger.log('Lock niet verkregen of fout: ' + e.message);
    throw e;
  } finally {
    lock.releaseLock();
  }
}

Niet-blokkerende locks met tryLock

Gebruik tryLock() wanneer je niet wilt wachten maar direct wilt afhaken als het script al draait, bijvoorbeeld bij een trigger die vaak afvuurt.

function probeerLock() {
  const lock = LockService.getScriptLock();

  if (!lock.tryLock(5000)) {
    Logger.log('Script wordt al uitgevoerd, probeer later opnieuw');
    return false;
  }

  try {
    Logger.log('Lock verkregen, bezig...');
    Utilities.sleep(2000);
    return true;
  } finally {
    lock.releaseLock();
  }
}

Teller-patroon zonder race condition

function verhoogTeller() {
  const lock = LockService.getScriptLock();

  try {
    lock.waitLock(10000);

    const props = PropertiesService.getScriptProperties();
    const huidig = parseInt(props.getProperty('teller') || '0', 10);
    props.setProperty('teller', String(huidig + 1));

    Logger.log(`Teller: ${huidig + 1}`);
  } finally {
    lock.releaseLock();
  }
}

Formulierverwerking met lock

function onFormSubmit(e) {
  const lock = LockService.getScriptLock();

  try {
    lock.waitLock(30000);

    const antwoord = e.response;
    const items = antwoord.getItemResponses();
    const naam = items[0].getResponse();
    const email = antwoord.getRespondentEmail();

    const blad = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Registraties');
    const volgendeRij = blad.getLastRow() + 1;

    blad.getRange(volgendeRij, 1, 1, 3).setValues([[
      new Date(),
      naam,
      email,
    ]]);

    GmailApp.sendEmail(email, 'Registratie bevestigd', `Beste ${naam}, je bent geregistreerd.`);

  } finally {
    lock.releaseLock();
  }
}

Lock-status controleren

function controleerLockStatus() {
  const lock = LockService.getScriptLock();

  Logger.log(`Lock vastgehouden: ${lock.hasLock()}`);

  if (!lock.hasLock()) {
    if (lock.tryLock(1000)) {
      Logger.log('Lock verkregen');
      lock.releaseLock();
    } else {
      Logger.log('Lock niet beschikbaar');
    }
  }
}

De Lock Service is essentieel voor elk Apps Script dat gedeelde state beheert. Zonder locks riskeer je data-corruptie in drukbezochte spreadsheets of formulierverwerkers; met een klein, zorgvuldig afgebakend kritiek gedeelte blijft de overhead minimaal.