Google App Engine频道API

胡高朗

2023-03-14

问题内容：

我正在尝试学习GAE的通道API（使用Java），但是我不知道从哪里开始。

我经历了Channel API
Overview（Java），
但为简洁起见，此处发布的代码并不完整。

而且由于我是新手，如果可以使用完整的示例代码，这将非常有帮助。

谢谢，Shrey

问题答案：

您链接到的Channel API
Overview中的代码已经相当完整了，只是到处都是。我承认，一旦您理解了它，我觉得它比他们看上去的要简单得多，但是我很高兴他们犯了提供过多信息的错误。

在不增加多余信息的情况下，很难为此提供一个完整的解决方案，因为您使用Channel
API的某些方式有点取决于现有应用程序的基础结构。因此，我试图对AppEngine文档提供的内容进行详细说明，以期希望您能更好地理解。如有任何疑问，您可以通过注释提出具体问题。

首先，一些词汇：

频道消息： 您希望发送给客户端的消息（可能是您最初使用频道API的原因）。
通道密钥： 对于用户和用户试图发送消息的范围而言唯一的字符串。
通道令牌： 任何客户端唯一的字符串。每2小时每个客户1个渠道令牌。
频道服务： AppEngine服务器端类，提供了一种创建频道并通过其发送频道消息的方法。

在服务器上，您将需要执行以下操作：

ChannelService channelService = ChannelServiceFactory.getChannelService();

// The channelKey can be generated in any way that you want, as long as it remains
// unique to the user.
String channelKey = "xyz";
String token = channelService.createChannel(channelKey);

获得令牌后，您只需要一些方法即可将其获取到客户端代码。您链接到的AppEngine文档通过从Java
servlet提供HTML并调用来实现此目的index.replaceAll("\\{\\{ token \\}\\}", token)。

他们的工作方式是将文字字符串{{ token }}放入其JavaScript代码中（如下所示），因此，无论{{ token }}JavaScript代码中出现的什么地方，它将被上述channelService.createChannel(...)调用生成的实际令牌替换。请注意，您
不需要 将令牌注入以这种方式提供服务的客户端代码中，但这是一个很好的起点，因为这是他们的工作方式（并记录了下来）。

现在，您已经将令牌注入到JavaScript中，您需要将 带有通道令牌的代码获取到client 。
（请注意，如上所述，您也可以仅将令牌获得给客户端，并以此方式创建频道） 。他们拥有的代码是：

<body>
  <script>
    channel = new goog.appengine.Channel('{{ token }}');
    socket = channel.open();
    socket.onopen = onOpened;
    socket.onmessage = onMessage;
    socket.onerror = onError;
    socket.onclose = onClose;
  </script>
</body>

他们删节了有关如何从服务器上的文件读取此内容的详细信息，但是同样，您可以按照自己喜欢的任何方式进行操作。您还可以直接resp.getWriter().print(index)在JavaServlet中使用来打印String
，其中index是存储上面列出的HTML /
JavaScript内容的String。就像我最初说的那样，最适合您应用程序现有基础架构的还有很多事情要做。

他们打算为你定义自己的JavaScript函数onOpened，onMessage，onError，和onClose通道被打开时调用，收到一条消息，遇到错误，或分别关闭。您可能希望仅创建幼稚的实现以更好地了解发生了什么：

function onOpened() {
    alert("Channel opened!");
}

function onMessage(msg) {
    alert(msg.data);
}

function onError(err) {
    alert(err);
}

function onClose() {
    alert("Channel closed!");
}

我仍然建议将它们分离为单独的功能，以便您可以更轻松地扩展它们以进行试验和解决问题。有关JavaScript API的更多详细信息，请参见Channel
API JavaScript
Reference。

您需要建立一种机制来 获取要从客户端发送到服务器的数据
。再一次，您希望如何操作都无关紧要。AppEngine文档建议设置一个XMLHttpRequest以实现此目的。

sendMessage = function(path, opt_param) {
  path += '?g=' + state.game_key;
  if (opt_param) {
    path += '&' + opt_param;
  }
  var xhr = new XMLHttpRequest();
  xhr.open('POST', path, true);
  xhr.send();
};

在这里，opt_param只是一串可选参数，格式为x=1&y=2&z=3。这是他们为示例Tic-Tac-
Toe应用程序构建的所有基础结构，对Channel API的功能并不关键；就像我说的，您可以根据需要拨打此电话。

path 是您的Servlet的路径（您需要在web.xml文件中进行设置），该路径应该处理消息的发送和接收（请参阅以下部分）。

将消息从客户端发送到服务器后，您将需要一个servlet，该servlet可以 使用相同的通道密钥将更新发送到所有客户端 。

ChannelService channelService = ChannelServiceFactory.getChannelService();

// This channelKey needs to be the same as the one in the first section above.
String channelKey = "xyz"

// This is what actually sends the message.
channelService.sendMessage(new ChannelMessage(channelKey, "Hello World!"));

channelService.sendMessage(...)上面的调用实际上是发送消息的方法，因此onMessage上一节中定义的函数可以接收到该消息。

我希望这个答案足够完整（就此而言，是正确的），足以帮助您入门。他们放入文档中的大部分内容（以及我在此处的代码）都可以进行复制和粘贴，只需稍作调整即可。

Google App Engine频道API

相关阅读

相关文章

相关问答

相关工具

相关文档