csharp websockets chat

Это небольшой проект, который использует CSHARP и библиотеку .NET (7.0). Эта программа позволяет создавать несколько веб -сокетов одновременно (Client -> Server и Server -> Client оба поддерживаются). Это предназначено для работы в операционных системах на основе Linux, которые поддерживают .NET 7.0 (например, с использованием пакета dotnet ). Возможно, это работает с Windows, но я не пробовал его тестировать. Этот проект также должен работать с .NET 8.0, но я тоже не проверил это.

Эта программа работает как очень простая чата один на один. При подключении клиент и сервер могут обмениваться основными текстовыми сообщениями UTF-8 друг с другом.

Я сделал этот проект, чтобы узнать больше о веб -розетках в CSHARP/.NET, а также о том, как управлять несколькими веб -сокетами, получающими/отправляют данные одновременно с помощью асинхронных методов.

Демо

Вот видео GIF, демонстрирующее функциональность программы. Мы не используем SSL в нашей демонстрации и устанавливаем клиент и сервер, оба локально, используя 127.0.0.1 (LocalHost).

Здание и установка

Предварительные условия

.NET 7.0

Библиотека .NET 7.0 должна запустить этот проект. Вы можете установить эту библиотеку вручную или через диспетчер пакетов, если ваш Linux Distro поддерживает ее.

В системах на основе Ubuntu/Debian вы можете установить Dotnet, используя приведенные ниже команды.

 # Typically this is only required for Debian.
wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt update

# Install .NET 7.0.
sudo apt install -y dotnet-sdk-7.0

Здание и бег

Если вы хотите создать и запустить проект. Вы можете использовать следующую команду.

dotnet run

Если вы хотите создать только проект, вы можете использовать следующую команду.

dotnet build

Убедитесь, что вы находитесь в том же каталоге, что и файл csharp-websockets.csproj при выполнении вышеуказанных команд.

Командная строка

Поддерживаются следующие аргументы командной строки.

• -z -cfg => Путь к файлу конфигурации. По умолчанию он ищет ./conf.json .
• -nolisten => предотвращает активацию сервера прослушивания.
• -Хост => Переопределяет адрес хоста, чтобы прослушать.
• -port => переопределяет порт, чтобы прослушать.
• -SSL => Переопределяет опцию прослушивания SSL.
• -l -list => перечисляет все значения конфигурации и выходов.

Конфигурация

Файл конфигурации в файловой системе считывается и анализируется через синтаксис JSON. Путь по умолчанию, который он проверяет, есть ./conf.json . Тем не менее, его можно изменить с помощью параметра командной строки Config Path, указанной выше.

Вот параметры конфигурации. Пожалуйста, имейте в виду, что вам нужно будет удалить комментарии ( // ) при копировании ниже. Я рекомендую взглянуть на файл conf.ex.json, если вы хотите скопировать конфигурацию без каких -либо ошибок.

 {
    // Whether to activate the listen server.
    "listen": true,

    // The host to listen on.
    "listenHost": "127.0.0.1",

    // The port to listen on.
    "listenPort": 2222,

    // Whether to listen with SSL.
    "listenSsl": false,

    // An array of startup client connections.
    "startupConnections": [
        {
            // The startup connection host.
            "host": "127.0.0.1",
            
            // The startup connection port.
            "port": 2223,

            // Whether to use SSL with the startup connection.
            "ssl": false
        }
    ]
}

Использование

При запуске программы вам будут предложены следующие команды, которые вы можете использовать.

• LS - Перечислите все соединения сервера. Число в начале представляет индекс, который следует использовать с другими командами.
• LC - Перечислите все клиентские подключения. Число в начале представляет индекс, который следует использовать с другими командами.
• Новый <ip> <port> <ssl> - установить новое клиентское соединение с <ip> : <port> . <ssl> необязательно и отключить SSL, используйте NO .
• CC <idx> - отправить/получать сообщения для клиентского подключения при индексе <idx> .
• CS <idx> - отправить/принять сообщения для сервера прослушивания при индексе <idx> .
• RC <idx> - Удалить клиент в индексе <idx> .
• rs <idx> - Удалить сервер при индексе <idx> .
• H - Печать топ/меню справки.
• Q - Программа выхода.

При подключении к сеансу чата через команды cc и cs вы можете отправить сообщение q чтобы отсоединить текущий сеанс чата и вернуться в главное меню.

Примечания

• Этот проект все еще находится в стадии разработки. Я еще не проверил SSL.
• В настоящее время поддерживается только одно соединение с сервером прослушивания. Новые соединения переопределят предыдущее соединение. Тем не менее, я могу добавить поддержку для нескольких соединений в будущем, когда у меня будет больше времени.
• Есть какой -то код, который определенно может быть улучшен/организован лучше.

Кредиты

• Кристиан Дьякон