GoEasy推送实时消息到web端

前段时间用goeasy实现了实时推送功能，这里写个工作笔记方便以后查看，也希望可以帮到其他需要实时推送的朋友。
Goeasy是第三方推送服务。如果自己使用原生态的socket.io， websocket进行开发的话，需要花时间研究如何实现，且不说把这两种技术运用的好不好，单是测试就够我忙了，你要进行压力测试、性能测试、功能测试，总的来讲自己开发成本周期长、维护成本高，所以我选择了第三方推送服务。之后我对比了几个做推送的第三方产品，个人感觉goeasy推送更稳定，推送速度快，代码简单易懂上手快，所以最后我推荐了goeasy给我的领导。GoEasy官网：goeasy.io

推送的原理：GoEasy的实现原理很简单，就是推送消息的一端只负责推送，而需要接收的页面需要预先订阅。订阅什么呢？订阅channel。往某个channel上推送消息，客户端就订阅相同的channel,这样就可以确保准确接收。通过channel我们可以自己指定哪些页面或哪些用户可以接收到从这个channel上推送出来的消息。

如何实现web实时推送
开发语言：Java

1. 获取goeasy的appkey
Appkey是使用goeasy推送的“钥匙”。在goeasy官网上注册好之后创建一个free application, 创建好之后你就可以看到一个application有两个key.一个是supper key， 另一个是subscribe key。这个两个key的区别是：supper key既可以用于推送也可以用于订阅； 但subscribe key只可以用于订阅，它没有推送信息的权限。处于安全考虑，我用supper key来进行推送消息，用subscribe key来订阅消息。

2. web客户端订阅channel
1） 引入goeasy.js
<script type="text/javascript" src="https://cdn.goeasy.io/goeasy.js"></script>

2) 连接goeasy
<script type="text/javascript">
        if(typeof GoEasy !== 'undefined'){
            var goEasy = new GoEasy({
                appkey: 'appkey',
                onConnected:function(){
                    console.log("Connect to GoEasy success.");
                } ,
                onDisconnected:function(){
                    console.log("Disconnect to GoEasy server.");
                } ,
                onConnectFailed:function(error){
                    console.log("Connect to GoEasy failed, error code: "+ error.code+" Error message: "+ error.content);
                }
            });
        }
</script>

3) 订阅channel
function subscribe(){
  goEasy.subscribe({
            channel: 'demo_channel',
            onMessage: function(message){
                //当有消息推送到channel “demo_channel”时，控制台会自动打印出推送的消息
                console.log('Meessage received:'+message.content);
            },
            onSuccess:function(){
                console.log("Subscribe the Channel successfully.");
            },
            onFailed: function(error){
                console.log("Subscribe the Channel failed, error code: "+ error.code + " error message: "+ error.content);
            }

        });

}


3. 用JAVA SDK推送消息到channel

1）添加goeasy maven repository 到pom.xml
<repositories>
...
  <repository>
    <id>goeasy</id>
    <name>goeasy</name>
    <url>http://maven.goeasy.io/content/repositories/releases/</url>
  </repository>
</repositories>
                      
                     
<dependencies>
  ...
  <dependency>
    <groupId>io.goeasy</groupId>
     <artifactId>goeasy-sdk</artifactId>
      <version>0.3.1</version>
  </dependency>
</dependencies>

这里需要注意的是，使用java的sdk时需要依赖两个jar包,请加入到你的项目里。
gson.jar
slf4j-api.jar

2) 推送消息到channel
GoEasy goEasy = new GoEasy("your supper key");
goEasy.publish("demo_channel","Welcome xueting",new PublishListener(){
            @Override
            public void onFailed(GoEasyError error) {
                System.out.println("Error code:"+ error.getCode() +"; error content:"+error.getContent());
            }

            @Override
            public void onSuccess() {
                System.out.println("Publish success");
            }
        });


针对没有使用maven的朋友，你们可以手动下载java的sdk. 下载地址：http://maven.goeasy.io/service/local/artifact/maven/redirect?r=releases&g=io.goeasy&a=goeasy-sdk&v=LATEST&e=jar

如果你用的是其他开发语言， goeasy还提供了RestfulAPI在后台来推送消息。具体使用请参照goeasy 官网的参数使用及说明。

所有推送的消息以及接收情况，可以登录到goeasy后台进行查看。考虑到信息的安全性，大家可以根据自身需求来决定是否在推送前对信息加密。

感兴趣的朋友可以先到https://goeasy.io上先看看demo页面的效果。好了，希望这篇文章对大家有帮助。共勉……