co.mindus.ip2location

Class IP2LocationEventLog.LogEntry

java.lang.Object

co.mindus.ip2location.IP2LocationEventLog.LogEntry

Enclosing class:

IP2LocationEventLog

public static class IP2LocationEventLog.LogEntry
extends Object

Represents a single log entry.

Log entries are immutable and contain all information about a single event, including timestamp, severity, category, message, and optional detail (such as a stack trace for errors).

Constructor Summary

Constructors

Constructor and Description
LogEntry(Instant timestamp, IP2LocationEventLog.EventType type, IP2LocationEventLog.EventCategory category, String message, String detail) Creates a log entry.

Method Summary

Modifier and Type	Method and Description
static IP2LocationEventLog.LogEntry	fromJson(String json) Parses a log entry from a JSON string.
IP2LocationEventLog.EventCategory	getCategory() Returns the category/classification of this event.
String	getDetail() Returns optional detail text such as a stack trace.
String	getFormattedTimestamp() Returns a formatted timestamp string for display.
String	getMessage() Returns the human-readable message describing this event.
String	getSummary() Returns a single-line summary suitable for display in lists.
Instant	getTimestamp() Returns the timestamp when this event occurred.
IP2LocationEventLog.EventType	getType() Returns the severity level of this event.
String	toJson() Converts this entry to a JSON string for file persistence.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LogEntry

public LogEntry(Instant timestamp,
                IP2LocationEventLog.EventType type,
                IP2LocationEventLog.EventCategory category,
                String message,
                String detail)

Creates a log entry.

Parameters:

timestamp - The time when this event occurred

type - The severity level

category - The event category

message - The event message

detail - Optional detail text (may be null)

Method Detail

getTimestamp

public Instant getTimestamp()

Returns the timestamp when this event occurred.

Returns:

The event timestamp

getType

public IP2LocationEventLog.EventType getType()

Returns the severity level of this event.

Returns:

The event type (INFO, WARNING, or ERROR)

getCategory

public IP2LocationEventLog.EventCategory getCategory()

Returns the category/classification of this event.

Returns:

The event category

getMessage

public String getMessage()

Returns the human-readable message describing this event.

Returns:

The event message

getDetail

public String getDetail()

Returns optional detail text such as a stack trace.

Returns:

The detail text, or null if none

getFormattedTimestamp

public String getFormattedTimestamp()

Returns a formatted timestamp string for display.

Format: "yyyy-MM-dd HH:mm:ss" in the system's default timezone.

Returns:

The formatted timestamp string

getSummary

public String getSummary()

Returns a single-line summary suitable for display in lists.

Format: "[timestamp] TYPE: message"

Returns:

The summary string

toJson

public String toJson()

Converts this entry to a JSON string for file persistence.

The JSON format is a single line with no pretty-printing, suitable for JSON-lines file format.

Returns:

The JSON representation of this entry

fromJson

public static IP2LocationEventLog.LogEntry fromJson(String json)

Parses a log entry from a JSON string.

This is the inverse of toJson(). If the JSON is malformed or missing required fields, returns null.

Parameters:

json - The JSON string to parse

Returns:

The parsed LogEntry, or null if parsing failed