001/*
002 * jPOS Project [http://jpos.org]
003 * Copyright (C) 2000-2026 jPOS Software SRL
004 *
005 * This program is free software: you can redistribute it and/or modify
006 * it under the terms of the GNU Affero General Public License as
007 * published by the Free Software Foundation, either version 3 of the
008 * License, or (at your option) any later version.
009 *
010 * This program is distributed in the hope that it will be useful,
011 * but WITHOUT ANY WARRANTY; without even the implied warranty of
012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
013 * GNU Affero General Public License for more details.
014 *
015 * You should have received a copy of the GNU Affero General Public License
016 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
017 */
018
019package org.jpos.log.evt;
020
021import com.fasterxml.jackson.annotation.JsonInclude;
022import com.fasterxml.jackson.annotation.JsonProperty;
023import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlElementWrapper;
024import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
025import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;
026import org.jpos.log.AuditLogEvent;
027import java.time.Instant;
028import java.util.List;
029import java.util.Map;
030
031/**
032 * Top-level structured log envelope serialised as the {@code <log>} element.
033 *
034 * @param ts       event timestamp
035 * @param kind     event kind/category
036 * @param lifespan lifespan in milliseconds, or {@code null} when not measured
037 * @param tags     optional tag map (omitted from output when empty)
038 * @param events   payload of structured audit events
039 */
040@JacksonXmlRootElement(localName = "log")
041public record LogEvt(
042  @JacksonXmlProperty(isAttribute = true) Instant ts,
043  @JacksonXmlProperty(isAttribute = true) String kind,
044  @JacksonXmlProperty(isAttribute = true) Long lifespan,
045  @JsonInclude(JsonInclude.Include.NON_EMPTY) Map<String,String> tags,
046  @JsonProperty("payload") @JacksonXmlElementWrapper(useWrapping = false) List<AuditLogEvent> events) { }