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

120 lines
4.0 KiB
C#

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Collections.ObjectModel;
namespace Tor.Controller
{
/// <summary>
/// A class containing the command to get network information from the tor service.
/// </summary>
internal sealed class GetInfoCommand : Command<GetInfoResponse>
{
private string request;
/// <summary>
/// Initializes a new instance of the <see cref="GetInfoCommand"/> class.
/// </summary>
public GetInfoCommand()
{
this.request = null;
}
/// <summary>
/// Initializes a new instance of the <see cref="GetInfoCommand"/> class.
/// </summary>
/// <param name="request">The request to send with the <c>getinfo</c> command.</param>
public GetInfoCommand(string request)
{
this.request = request;
}
#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 GetInfoResponse Dispatch(Connection connection)
{
if (request == null)
return new GetInfoResponse(false);
if (connection.Write("getinfo {0}", request))
{
ConnectionResponse response = connection.Read();
if (!response.Success || !response.Responses[0].StartsWith(request, StringComparison.CurrentCultureIgnoreCase))
return new GetInfoResponse(false);
List<string> values = new List<string>(response.Responses.Count);
if (response.Responses.Count == 1)
{
string[] parts = response.Responses[0].Split(new[] { '=' }, 2);
values.Add(parts.Length == 1 ? null : parts[1]);
}
else
{
for (int i = 1; i < response.Responses.Count; i++)
{
if (".".Equals(response.Responses[i]))
break;
values.Add(response.Responses[i]);
}
}
return new GetInfoResponse(true, values.AsReadOnly());
}
return new GetInfoResponse(false);
}
#endregion
}
/// <summary>
/// A class containing the response values for a <c>getinfo</c> command.
/// </summary>
internal sealed class GetInfoResponse : Response
{
private readonly ReadOnlyCollection<string> values;
/// <summary>
/// Initializes a new instance of the <see cref="GetInfoResponse"/> class.
/// </summary>
/// <param name="success">A value indicating whether the command was received and processed successfully.</param>
public GetInfoResponse(bool success) : base(success)
{
this.values = new List<string>().AsReadOnly();
}
/// <summary>
/// Initializes a new instance of the <see cref="GetInfoResponse"/> class.
/// </summary>
/// <param name="success">A value indicating whether the command was received and processed successfully.</param>
/// <param name="values">The values returned from the control connection.</param>
public GetInfoResponse(bool success, ReadOnlyCollection<string> values) : base(success)
{
this.values = values;
}
#region Properties
/// <summary>
/// Gets a read-only collection of the values returned from the control connection.
/// </summary>
public ReadOnlyCollection<string> Values
{
get { return values; }
}
#endregion
}
}