最近项目用到了Electroserver服务器,一开始挺兴奋感觉终于接触到新的东西了。结果真正干起来傻眼了,因为在网上不管国内还是国外几乎没有Electroserver的任何资料,因为用的人实在是太少了。没办法,找个原来用过的大神给咱笨鸟科普一下,然后弄来了一份英文文档。耐心看完后感觉终于对其有了更好的认识。那么今天在这里就讲一下与Electroserver有关的技术吧。
首先,如果你用了Electroserver,你会发现这个服务器很挑剔,他只识别.zip类型的包,你得自己手动放到他的ElectroServer_5_4_1\server\extensions下面。然后重新启动服务器,这里我建议大家用一下ES5Admin这个软件,因为他对Electroserver有非常好的支持。能够以视图的方式控制服务器。我们先从最基本的说起:
如上所说如果涉及到打包,最理想的方式是把他转化为maven格式如下所示项目上带有一个小m的:
项目中应该包含三个配置文件:pom.xml:具体介绍应该依赖哪些包,还有版本、groupid等如下:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>HelloWorld</groupId>
<artifactId>HelloWorld</artifactId>
<version>0.0.1-SNAPSHOT</version>
<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<version>2.2.1</version>
<configuration>
<descriptors>
<descriptor>assembly.xml</descriptor>
</descriptors>
</configuration>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
<dependencies>
<dependency>
<groupId>com.electrotank</groupId>
<artifactId>electroserver</artifactId>
<version>5.4.1</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.9</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
接着是assembly.xml,该文件定义了打包后的格式,还有打包后应该包括什么,放在那个包下,代码如下图:
<assembly>
<id>bin</id>
<includeBaseDirectory>false</includeBaseDirectory>
<formats>
<format>zip</format>
</formats>
<dependencySets>
<dependencySet>
<useProjectArtifact>true</useProjectArtifact>
<outputDirectory>lib</outputDirectory>
</dependencySet>
</dependencySets>
<fileSets>
<fileSet>
<outputDirectory>/</outputDirectory>
<includes>
<include>Extension.xml</include>
</includes>
</fileSet>
<fileSet>
<directory>target/classes</directory>
<outputDirectory>classes</outputDirectory>
</fileSet>
</fileSets>
</assembly>
最后是Extension.xml文件,该文件介绍了打包后服务区识别该包的名称、和plugin(我习惯称他为功能块)如下图:
<?xml version="1.0" encoding="utf-8" ?>
<Extension>
<Name>HelloWorld</Name>
<Plugins>
<Plugin>
<Handle>HelloWorld</Handle>
<Type>Java</Type>
<Path>com.electrotank.electroserver5.examples.helloworld.HelloWorld</Path>
</Plugin>
</Plugins>
</Extension>
可能有很多人对着plugin感到疑惑,我简要说一下。你可以把它理解成一个功能模块,但是不要单纯把他理解成一个方法或者类,他可以包含很多类、方法不过他能实现的功能或者说我们想让他实现的功能所在的类,我们把它叫做一个plugin。至于它是否调用了别的类我们不管。这也是上面的path的值。
然后我们说一下maven工程的框架。首先我们得把默认的src文件夹删除。加入一个src/main/java或者src/main/test也可以两个都加上(Source Folder)。前者表示要编写的主要代码、后者表示测试的代码(很智能对吧)。我们在src/main/java建立包然后建立class文件,这里我要提一嘴。你要知道我们在干什么,我们要打包的目的是要把他发到服务器上面,发到服务器上面的意思是要把它当作服务端。要做服务端就得做好对客户端对接的准备是吧。
ok 不要着急,我们一步一步来,在服务端有两个非常重要的方法,就是init(EsObjectRO ignored)和request(String userNames, EsObjectRO requestParameters)。前者当在服务器部署(不是单纯放到extension文件夹下面,后面详细说)开启服务器瞬间就会执行。后者是我们刚才提到的,与客户端进行对接的方法,也就是所谓的响应的方法。那么这里问题来了,客户端用什么方法进行对接,这个问题问得好,哥看英文api用了两天才找到这个方法,记住 是:EsPluginRequest 。
这里还有个问题,就是关于room和zone。简单来说,他们二者都是在服务器上的。一个zone可以包含许多room,一个room又可以包含许多user,就是这么个简单的关系。至于客户端创建房间还是什么就是自己设置的问题了,我不做过多介绍。
服务端在request里面就可以为接收到的数据进行加工实现业务了。当代码编写并测试通过后,可以用run as --》maven build....在Goals中输入package执行打包功能。然后放到ElectroServer_5_4_1\server\extensions下,启动服务器然后启动admin,在Server Extension中加入我们需要的plugin。然后客户端就可以访问了。在其Server monitoring中可以对日志、zone、room、user进行管理。在Server Management中可以对端口进行设置。
那么到这里你已经对Electroserver有了初步的了解和基础的操作。我写这篇博客就是希望看到的人能够少走些弯路,我当时看文档真的很费劲。如有不对的地方欢迎指出 笨鸟细心听教