Package sk.iway.iwcm.stat.rest

Class BrowserIdentifierMigrationService

java.lang.Object

sk.iway.iwcm.stat.rest.BrowserIdentifierMigrationService

All Implemented Interfaces:

org.springframework.beans.factory.DisposableBean

@Service
public class BrowserIdentifierMigrationService
extends Object
implements org.springframework.beans.factory.DisposableBean

Migrates versioned browser identifiers to canonical browser-family identifiers.

The migration runs on a single background worker, commits changes in bounded batches, and exposes a synchronized progress snapshot so an administrator can pause, resume, and monitor it. Finalization is a separate explicit step that merges browser counters, removes obsolete identifiers, creates the uniqueness constraint, and refreshes statistics caches across the cluster.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BrowserIdentifierMigrationService.FinalizationResult	Summarizes how many obsolete statistics keys were deleted or retained during finalization.
static class	BrowserIdentifierMigrationService.Mapping	Describes one source identifier that must be replaced by its canonical target.
static class	BrowserIdentifierMigrationService.Preview	Contains the read-only analysis shown before an administrator starts the migration.
static class	BrowserIdentifierMigrationService.State	Mutable migration progress transferred through the REST API as a detached snapshot.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	UPDATE_NOTE

Constructor Summary

Constructors

Constructor	Description
BrowserIdentifierMigrationService()	Creates the production service with one dedicated daemon worker thread.

Method Summary

Modifier and Type	Method	Description
void	destroy()	Stops the worker and interrupts any active background migration during bean destruction.
BrowserIdentifierMigrationService.State	finalizeCompletedMigration()	Starts asynchronous cleanup after all statistics references have been migrated.
BrowserIdentifierMigrationService.State	getStatus()	Returns the latest detached progress snapshot.
static boolean	isAllreadyUpdated()
BrowserIdentifierMigrationService.Preview	preview()	Analyzes the current database without creating identifiers or modifying statistics.
BrowserIdentifierMigrationService.State	start()	Starts or resumes migration on the background worker.
BrowserIdentifierMigrationService.State	stop()	Requests a cooperative pause after the currently executing database batch finishes.

Methods inherited from class java.lang.Object

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

Field Details

UPDATE_NOTE

public static final String UPDATE_NOTE

See Also:

• Constant Field Values

Constructor Details

BrowserIdentifierMigrationService

public BrowserIdentifierMigrationService()

Creates the production service with one dedicated daemon worker thread.

Method Details

preview

public BrowserIdentifierMigrationService.Preview preview()
                                                  throws SQLException

Analyzes the current database without creating identifiers or modifying statistics.

Returns:

actionable mappings, keys retained only for non-browser dimensions, statistics tables, and whether the unique bot-name index already exists

Throws:

SQLException - if identifiers or table metadata cannot be read

getStatus

public BrowserIdentifierMigrationService.State getStatus()

Returns the latest detached progress snapshot.

A newly created service also restores the completed flag from the persistent update marker before returning the snapshot.

Returns:

a copy of the current migration state

start

public BrowserIdentifierMigrationService.State start()

Starts or resumes migration on the background worker.

The request is ignored when a task is already running or the persistent migration marker reports completion. A paused migration reuses its prepared plan and cursor.

Returns:

the state immediately after the start request

stop

public BrowserIdentifierMigrationService.State stop()

Requests a cooperative pause after the currently executing database batch finishes.

Returns:

the state containing the stop-request flag when migration is active

finalizeCompletedMigration

public BrowserIdentifierMigrationService.State finalizeCompletedMigration()
                                                                   throws SQLException

Starts asynchronous cleanup after all statistics references have been migrated.

Returns:

the state immediately after the finalization request

Throws:

SQLException - if the migration has not been marked as completed

isAllreadyUpdated

public static boolean isAllreadyUpdated()

destroy

public void destroy()

Stops the worker and interrupts any active background migration during bean destruction.

Specified by:

destroy in interface org.springframework.beans.factory.DisposableBean