Package io.jenkins.plugins.batchcontrol.store


package io.jenkins.plugins.batchcontrol.store
  • Class
    Description
    Single source of time for the whole plugin.
    The single writer of the "an attempt was refused" audit records (ChangeType.MARKER_REUSE_BLOCKED, ChangeType.REMOTE_RUN_BLOCKED, ChangeType.TRIGGER_BLOCKED), with a bound on how often one repeated attempt may append (S-21).
    #34: the forced writes every store write goes through, as core's AtomicFileWriter does them.
    The only place where Batch Control uses the optional file-parameters plugin (stashedFile, base64File).
    File-based Store rooted at $JENKINS_HOME/batch-control/.
    Generates store identifiers.
    One line of the monthly incident index (incidents/index/YYYY-MM.jsonl).
    D-72: the one place where typed ParameterValues become the masked text that Batch Control displays or writes (the request's parameters map, run records, incidents, CSV).
    The single place where job full names are turned into store file names and where store file names are validated.
    The time range of a page query (security-10 S-03): only records inside it count toward the query's record cap.
    One page of a bounded record query: the rows to render plus what the pager needs.
    The few fields of a run request that listings filter and sort on, kept in memory by the store so a listing reads only the XML files of the rows it renders.
    What one retention pass over the XML entities deleted.
    Per-month run counters for the history summary, maintained incrementally from the append-only runs/YYYY-MM.jsonl bucket: a summary request only reads the bytes appended since the previous one.
    Masks secret material in config XML text BEFORE it is diffed or stored (SPEC item 9: "unified diff with secrets masked").
    Durable, build-independent plugin store under $JENKINS_HOME/batch-control/ (layout in docs/ARCHITECTURE.md section 5).
    D-72b (2), security-35 S-35-03: an entity could not be written (an I/O failure, or content the XML writer refused).
    Minimal unified-diff generator for config.xml change records (SPEC item 9).
    D-72b (2), security-35 S-35-03: the characters a stored text may contain.