YsCommun

Введение:

YsCommun — это коммуникационный компонент, объединяющий WebSocket и Socket (TCP/IP). WebSocket реализован на основе Tomcat 7.0.52 и более поздних версий и совместим с IE8 и более ранними версиями (для более низких версий используется flash). Теоретически он совместим со всеми основными браузерами на рынке. Этот компонент также включает в себя связь через Socket, и WebSocket может напрямую связываться с Socket без необходимости преобразования. Достаточно организовать сообщение в соответствии с установленным протоколом. Это удобно для реализации функций мгновенного обмена сообщениями между веб-страницами, мобильными устройствами и клиентами на ПК.

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

1. Серверная часть:
   • а) Скачать jar-пакет. Зависимости включают три jar-пакета: fastjson-1.2.31.jar, YsCommun-1.0.jar и YsDevKit-1.12.jar.
   • б) Реализовать обработку сообщений. Необходимо создать собственный класс обработки сообщений (например, com.yisin.testyc.YsMessageHandle), который наследуется от класса com.yisin.commun.server.BaseMessageHandle. Переопределите соответствующие методы в классе BaseMessageHandle для обработки собственной бизнес-логики. Методы включают init, onMessage, onOpen, onClose, onError и filter. Можно зарегистрировать несколько классов обработки сообщений для удобства обработки различных бизнес-сценариев.
   • в) Настроить YsCommun в web.xml:

<servlet>
    <servlet-name>WebSocketServer</servlet-name>
    <servlet-class>com.yisin.commun.server.YSCommunicationServlet</servlet-class>
    <init-param>
        <param-name>handle</param-name>
        <param-value>com.yisin.testyc.YSMessageHandle</param-value>
    </init-param>
    <init-param>
        <description>Этот порт предназначен для совместимости с протоколом связи Socket (TCP / IP), по умолчанию 10000.</description>
        <param-name>port</param-name>
        <param-value>8090</param-value>
    </init-param>
    <init-param>
        <description>Включить ли режим совместимости (true для совместимости, false для несовместимости, по умолчанию несовместимо).</description>
        <param-name>compatible</param-name>
        <param-value>true</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

2. Веб-интерфейс:
   • а) Включите файл сценария.

<script type="text/javascript" src="yswebsocket-1.0.js"></script>

• б) Напишите код:

var socket = new YSWebSocket({
    url: 'ws://[ip]:[port]/[path]/ws',
    success: function(){
        // TODO
    },
    error: function(){
        // TODO
    },
    close: function(){
        // TODO
    },
    message: function(msg){
        // TODO
        var data = JSON.parse(msg);
        if(data.url == 'chat.group'){
            // Групповой чат
        } else {
            // Другое
        }
    }
});

// Отправить сообщение
function sendMsg(url, data){
    //socket.send('user.login', {account: "test", password: "123456"});
    socket.send(url, data);
}

3. Другие программы: например, программа на C# использует протокол TCP/IP для связи с веб-интерфейсом YsCommun. Исходный код программы на C# см. в приложении [1]. Программа используется для тестирования.

[1] Ссылка на приложение: https://gitee.com/yisin/cmm/attach_files.

Примечание: в тексте запроса присутствуют ссылки на изображения, которые не удалось загрузить из-за ограничений платформы. Если у вас есть доступ к этим изображениям, вы можете предоставить их для более точного перевода.