co.mindus.ip2location.ui

Class AdminIP2LocationSettingsPanel

java.lang.Object

se.entra.phantom.server.VirtualPanelAdapter

se.entra.phantom.server.VirtualComponentAdapter

co.mindus.ip2location.ui.AdminIP2LocationSettingsPanel

All Implemented Interfaces:

VirtualComponentListener, VirtualPanelListener

public class AdminIP2LocationSettingsPanel
extends VirtualComponentAdapter

NetPhantom dialog controller for IP2Location recovery settings.

This dialog allows administrators to configure the recovery behavior of the IP2Location service, including error thresholds, automatic recovery settings, and notification options. It is opened from the main IP2Location administration panel via the "Settings" button or context menu.

Dialog Structure

The dialog is organized into four sections:

1. Recovery Behavior - Radio buttons to select the action taken when error thresholds are exceeded (Notify only, Automatic recovery, or Disable service)
2. Error Thresholds - Numeric fields defining how many consecutive failures trigger the recovery action
3. Auto-Recovery Settings - Configuration for automatic recovery attempts including max attempts, cooldown period, and recovery triggers
4. Current State - Read-only display of current error counters and recovery attempt status

Control ID Reference

The panel definition (IP2L_SET) must include controls with these IDs:

ID	Type	Description
MNOTIFY	RadioButton	Notify only mode
MAUTO	RadioButton	Automatic recovery mode
MOFF	RadioButton	Disable service mode
MDESC	Label	Mode description text
TINIT	TextField	Init failure threshold (1-100)
TLOOKUP	TextField	Lookup error threshold (1-1000)
MAXATT	TextField	Max auto-recovery attempts (1-10)
COOLDOWN	TextField	Cooldown minutes (5-1440)
ODLFAIL	CheckBox	Recover on download failure
OCORRUPT	CheckBox	Recover on corruption
CINIT	Label	Current init failures (read-only)
CLOOKUP	Label	Current lookup errors (read-only)
CATTEMPT	Label	Current recovery attempts (read-only)
OK	Button	Apply and close
CANCEL	Button	Close without saving

Usage Example

 // In AdminIP2LocationPanel.doShowSettings():
 controller = new AdminIP2LocationSettings(this, page);
 

Configuration Storage

Settings are persisted to the server.ini file in the [IP2Location] section. The following keys are used:

• recoveryAction - NOTIFY_ONLY, AUTOMATIC, or DISABLE_SERVICE
• initFailureThreshold - Integer (default: 2)
• lookupErrorThreshold - Integer (default: 10)
• maxAutoRecoveryAttempts - Integer (default: 3)
• recoveryCooldownMinutes - Integer (default: 60)
• recoverOnDownloadFailure - Boolean (default: false)
• recoverOnCorruption - Boolean (default: true)

Author:

Christopher Mindus

See Also:

AdminIP2LocationPanel, RecoveryConfig, IP2LocationManager.setRecoveryConfig(RecoveryConfig)

Field Summary

Fields inherited from interface se.entra.phantom.server.VirtualPanelListener

ICON_CRITICAL, ICON_INFORMATION, ICON_NOICON, ICON_QUERY, ICON_QUESTION, ICON_WARNING, MB_ABORTRETRYIGNORE, MB_CANCEL, MB_ENTER, MB_ENTERCANCEL, MB_OK, MB_OKCANCEL, MB_RETRYCANCEL, MB_YESNO, MB_YESNOCANCEL, MBID_CANCEL, MBID_DEFAULT, MBID_ENTER, MBID_IGNORE, MBID_NO, MBID_OK, MBID_RETRY, MBID_YES

Method Summary

Modifier and Type	Method and Description
void	onAction(VirtualPanel vp, String controlID) Handles button clicks (OK and Cancel).
void	onCheckedChange(VirtualPanel panel, VirtualControl control, String controlID, int state) Handles radio button selection changes for the recovery mode.

Methods inherited from class se.entra.phantom.server.VirtualComponentAdapter

onAction, onAction, onContentChanged, onContentChanged, onControlEvent, onFocusGained, onFocusLost, onMenuAction, onPropertyChange, onSelectionChanged

Methods inherited from class se.entra.phantom.server.VirtualPanelAdapter

onModalPanelCreate, onModalPanelProcessing, onPageActivated, onPanelClose, onPanelClosing, onPanelCreate, onPanelDestroy

Methods inherited from class java.lang.Object

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

Methods inherited from interface se.entra.phantom.server.VirtualPanelListener

onPageActivated, onPanelClose, onPanelClosing, onPanelCreate, onPanelDestroy

Method Detail

onCheckedChange

public void onCheckedChange(VirtualPanel panel,
                            VirtualControl control,
                            String controlID,
                            int state)

Handles radio button selection changes for the recovery mode.

Updates the mode description text and enables/disables the auto-recovery configuration fields based on the selected mode.

Specified by:

onCheckedChange in interface VirtualComponentListener

Overrides:

onCheckedChange in class VirtualComponentAdapter

Parameters:

panel - The panel (same as this.vp)

control - The control that changed

controlID - The control's ID string

state - 0=unchecked, 1=checked, 2=indeterminate

onAction

public void onAction(VirtualPanel vp,
                     String controlID)

Handles button clicks (OK and Cancel).

Overrides:

onAction in class VirtualComponentAdapter

Parameters:

vp - The panel (same as this.vp)

controlID - The button's ID string