Files
Tor/TorWebClient/TorClient/Controller/Commands/CreateCircuitCommand.cs
2024-02-23 06:57:07 -05:00

120 lines
3.8 KiB
C#

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Tor.Helpers;
namespace Tor.Controller
{
/// <summary>
/// A class containing the command to create a new circuit.
/// </summary>
internal sealed class CreateCircuitCommand : Command<CreateCircuitResponse>
{
private readonly List<string> routers;
/// <summary>
/// Initializes a new instance of the <see cref="CreateCircuitCommand"/> class.
/// </summary>
public CreateCircuitCommand()
{
this.routers = new List<string>();
}
/// <summary>
/// Initializes a new instance of the <see cref="CreateCircuitCommand"/> class.
/// </summary>
/// <param name="routers">The collection of routers which should be part of this circuit.</param>
public CreateCircuitCommand(IEnumerable<string> routers)
{
this.routers = new List<string>(routers);
}
#region Properties
/// <summary>
/// Gets a collection containing the list of routers which should be comprise this circuit.
/// </summary>
public List<string> Routers
{
get { return routers; }
}
#endregion
#region Tor.Controller.Command<>
/// <summary>
/// Dispatches the command to the client control port and produces a <typeparamref name="T" /> response result.
/// </summary>
/// <param name="connection">The control connection where the command should be dispatched.</param>
/// <returns>
/// A <typeparamref name="T" /> object instance containing the response data.
/// </returns>
protected override CreateCircuitResponse Dispatch(Connection connection)
{
StringBuilder builder = new StringBuilder("extendcircuit 0");
foreach (string router in routers)
{
builder.Append(' ');
builder.Append(router);
}
if (connection.Write(builder.ToString()))
{
ConnectionResponse response = connection.Read();
if (!response.Success)
return new CreateCircuitResponse(false, -1);
string[] parts = StringHelper.GetAll(response.Responses[0], ' ');
if (parts.Length < 2 || !"extended".Equals(parts[0], StringComparison.CurrentCultureIgnoreCase))
return new CreateCircuitResponse(false, -1);
int circuitID;
if (!int.TryParse(parts[1], out circuitID))
return new CreateCircuitResponse(false, -1);
return new CreateCircuitResponse(true, circuitID);
}
return new CreateCircuitResponse(false, -1);
}
#endregion
}
/// <summary>
/// A class containing the response information from a <c>extendcircuit 0</c> command.
/// </summary>
internal sealed class CreateCircuitResponse : Response
{
private readonly int circuitID;
/// <summary>
/// Initializes a new instance of the <see cref="CreateCircuitResponse"/> class.
/// </summary>
/// <param name="success">A value indicating whether the command was received and processed successfully.</param>
/// <param name="circuitID">The unique circuit identifier within the tor service.</param>
public CreateCircuitResponse(bool success, int circuitID) : base(success)
{
this.circuitID = circuitID;
}
#region Properties
/// <summary>
/// Gets the unique circuit identifier.
/// </summary>
public int CircuitID
{
get { return circuitID; }
}
#endregion
}
}