1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
// Copyright 2020 Ant Group. All rights reserved.
//
// SPDX-License-Identifier: Apache-2.0

use std::collections::VecDeque;
use std::sync::Mutex;
use std::time::SystemTime;

use serde::Serialize;
use serde_json::Error as SerdeError;

/// Error codes for `ErrorHolder`.
#[derive(Debug)]
pub enum ErrorHolderError {
    TooLarge(usize),
    Serde(SerdeError),
}

/// `Result` specialized for `ErrorHolder`.
pub type Result<T> = std::result::Result<T, ErrorHolderError>;

/// Struct to record important or critical events or errors in circular buffer mode.
#[derive(Serialize, Default, Debug)]
pub struct ErrorHolder {
    max_errors: usize,
    total_errors: usize,
    max_size: usize,
    total_size: usize,
    errors: Mutex<VecDeque<String>>,
}

impl ErrorHolder {
    /// Create a `ErrorHolder` object.
    pub fn new(max_errors: usize, max_size: usize) -> Self {
        Self {
            max_errors,
            max_size,
            total_errors: 0,
            total_size: 0,
            errors: Mutex::new(VecDeque::with_capacity(max_errors)),
        }
    }

    /// Push an error into the circular buffer.
    pub fn push(&mut self, error: &str) -> Result<()> {
        let mut guard = self.errors.lock().unwrap();
        let formatted_error = format!("{} - {}", httpdate::fmt_http_date(SystemTime::now()), error);

        loop {
            if formatted_error.len() + self.total_size > self.max_size
                || self.total_errors >= self.max_errors
            {
                let victim = guard.pop_front();
                match victim {
                    Some(v) => {
                        self.total_size -= v.len();
                        self.total_errors -= 1;
                    }
                    None => return Err(ErrorHolderError::TooLarge(error.len())),
                }
            } else {
                break;
            }
        }

        self.total_size += formatted_error.len();
        self.total_errors += 1;
        guard.push_back(formatted_error);
        Ok(())
    }

    /// Export all errors in the circular buffer as an `JSON` string.
    pub fn export(&self) -> Result<String> {
        let _guard = self.errors.lock().unwrap();
        serde_json::to_string(self).map_err(ErrorHolderError::Serde)
    }
}

#[cfg(test)]
mod tests {
    use super::{ErrorHolder, ErrorHolderError};

    #[test]
    fn test_overflow() {
        let mut holder = ErrorHolder::new(10, 80);
        let error_msg = "123456789";
        let mut left = 16;
        while left >= 0 {
            let r = holder.push(error_msg);
            assert_eq!(r.is_ok(), true);
            left -= 1;
        }

        assert_eq!(holder.total_errors <= 10, true);
        assert_eq!(holder.total_size <= 80, true);

        let mut multi = 10;
        let mut error_msg_long = "".to_string();
        while multi >= 0 {
            multi -= 1;
            error_msg_long.push_str("123456789");
        }

        let r = holder.push(&error_msg_long);
        match r {
            Err(ErrorHolderError::TooLarge(len)) => assert_eq!(len, error_msg_long.len()),
            _ => panic!(),
        }
    }
}