RobustToolbox/Robust.Client/GameController/GameController.Redialler.cs

using System;
using System.Threading;
using Robust.LoaderApi;
using Robust.Shared;
using Robust.Shared.IoC;
using Robust.Shared.Log;
using Robust.Shared.Timing;
using Robust.Shared.Utility;

namespace Robust.Client;

internal partial class GameController
{
    // A little paranoia goes a long way.
    // This is static on purpose - the whole process shouldn't redial more than once, ever.
    private static int _hasRedialled = 0;

    public void Redial(string address, string? text = null)
    {
        // -- ATTENTION, YE WOULD-BE TRESPASSERS! --
        // This code is the least testable code ever (because it's in-engine code that requires the Launcher), so don't make it do too much.
        // This checks for some obvious requirements and then forwards to RedialApi which does the actual work.
        // Testing of RedialApi is doable in the SS14.Launcher project, this is why it has a fake RobustToolbox build.
        // -- THANK YE, NOW KINDLY MOVE ALONG! --

        // We don't ever want to successfully redial more than once, and we want to shutdown once we've redialled.
        // Otherwise abuse could happen.
        DebugTools.AssertNotNull(_mainLoop);

        _logger.Info($"Attempting redial of {address}: {text ?? "no reason given"}");

        if (!_mainLoop!.Running)
        {
            throw new Exception("Attempted a redial during shutdown, this is not acceptable - redial first and if you succeed it'll shutdown anyway.");
        }

        if (_loaderArgs == null)
        {
            throw new Exception("Attempted a redial when the game was not run from the launcher (_loaderArgs == null)");
        }

        if (_loaderArgs!.RedialApi == null)
        {
            throw new Exception("Attempted a redial when redialling was not supported by the loader (Outdated launcher?)");
        }

        if (Interlocked.Increment(ref _hasRedialled) != 1)
        {
            // Don't let it overflow or anything
            Interlocked.Decrement(ref _hasRedialled);
            throw new Exception("Attempted a redial after one already succeeded or while one is in progress, this is never acceptable");
        }

        try
        {
            _loaderArgs!.RedialApi!.Redial(new Uri(address), text ?? "");
        }
        catch (Exception)
        {
            Interlocked.Decrement(ref _hasRedialled);
            throw;
        }

        Shutdown("Redial");
    }
}