QuickServer开发指南(3)- 构建EchoServer
2008-09-03 15:48
323 查看
学习怎样使用QuickServer库的一个好的方法是学习它提供的例子。在QuickServer安装路径下的examples文件夹里有许多典型的例子。
下面的章节里我们模仿其中的一个例子EchoServer来构建一个服务器。EchoServer是一个简单的TCP服务器,主要功能是将用户发送的字符
串加上前缀"Echo
:"后返回。虽然这个例子可用性不强,但它是一个对QuickServer所有特点的一个很好的示范。我们从构建一个最基本的服务器开始,以后慢慢给它添
加新的功能。
1. 代码
首先实现EchoServer最基本的功能:将用户发送的字符串加上前缀"Echo :"后返回。
在本地创建一个文件夹存放需要的代码,如在c:\projects\中建立echoserver文件夹,然后创建一个类EchoServer.java:
在第10行和第11行定义了一个QuickServer对象myServer,通过一个String对象
"echoserver.EchoCommandHandler"声明了要加载的类,这个类面向所有客户端做命令处理器,实现了
org.quickserver.net.server.ClientCommandHandler接口,我们即将创建。
第12行设置了一个服务器端口用来做监听,然后设置整个应用的名字(第13行)。最后启动服务(第15行)。
接下来为EchoServer创建一个实现org.quickserver.net.server.ClientCommandHandler接口的类EchoCommandHandler.java,用来处理服务器发送的命令。
根据QuickServer的要求,这个类必须实现ClientCommandHandler接口。
当客户端建立一个连接(11行),gotConnected()方法被调用。在这个方法里面,我们给客户端发送欢迎文本(13-16行),这些文本使用通
过ClientHandler的sendClientMsg()方法发送给客户端。我们也会使用ClientHandler的
sendSystemMessage()方法显示客户端连接的InetAddress(20-21,25-26行)。
handlerCommand()方法是ClientCommandHandler接口的核心方法,因为服务器接收客户端发送的任何命令时都要调用该方
法。在我们对这个方法的实现中,我们会检查命令是否为"Quit"(31行),如果是,我们将发送一些提示文本表示服务器即将关闭连接,然后关闭连接
(33行)。否则,将命令加上前缀"Echo :"返回给用户。
2. 运行和测试
o 运行命令提示符程序(cmd.exe)
o 进入代码所在文件夹根目录,如c:\projects
o 编译代码 javac echoserver\*.java
o 若无编译错误,运行服务器:
set classpath=%classpath%;d:\QuickServer\dist\QuickServer.jar;.\(类所在文件夹)
java echoserver.EchoServer
o 您将会看到如下信息:
o 测试我们的服务器是否可以正常工作。再运行一个cmd程序,进入SocketTest.jar所在目录,键入java -jar
sockettest.jar命令,弹出一个窗口。在IP
Address中输入"127.0.0.1",在Port里输入"4123",点击"Connect"按钮,将看到窗口中显示如下图的信息。
若使用telnet,可键入命令:open localhost 4123
在Message中输入一些字符串,点击"Send"按钮,浏览器将会返回一个加了前缀"Echo :"的字符串。发送"Quit",服务器断开连接。
我们的EchoServer可能需要修改几个服务器配置参数,如超时消息、最多验证数、最大验证时间。QuickServer支持这些功能而无须改变代码。
下面的章节里我们模仿其中的一个例子EchoServer来构建一个服务器。EchoServer是一个简单的TCP服务器,主要功能是将用户发送的字符
串加上前缀"Echo
:"后返回。虽然这个例子可用性不强,但它是一个对QuickServer所有特点的一个很好的示范。我们从构建一个最基本的服务器开始,以后慢慢给它添
加新的功能。
1. 代码
首先实现EchoServer最基本的功能:将用户发送的字符串加上前缀"Echo :"后返回。
在本地创建一个文件夹存放需要的代码,如在c:\projects\中建立echoserver文件夹,然后创建一个类EchoServer.java:
[align=left]01 package echoserver;[/align] [align=left]02[/align] [align=left]03 import org.quickserver.net.*;[/align] [align=left]04 import org.quickserver.net.server.*;[/align] [align=left]05[/align] [align=left]06 import java.io.*; [/align] [align=left]07[/align] [align=left]08 public class EchoServer {[/align] [align=left]09 public static void main(String s[]) {[/align] [align=left]10 QuickServer myServer =[/align] [align=left]11 new QuickServer("echoserver.EchoCommandHandler");[/align] [align=left]12 myServer.setPort(4123);[/align] [align=left]13 myServer.setName("EchoServer v 1.0");[/align] [align=left]14 try {[/align] [align=left]15 myServer.startServer();[/align] [align=left]16 } catch(AppException e){[/align] [align=left]17 System.err.println("Error in server : "+e);[/align] [align=left]18 }[/align] [align=left]19 }[/align] [align=left]20 }[/align] |
"echoserver.EchoCommandHandler"声明了要加载的类,这个类面向所有客户端做命令处理器,实现了
org.quickserver.net.server.ClientCommandHandler接口,我们即将创建。
第12行设置了一个服务器端口用来做监听,然后设置整个应用的名字(第13行)。最后启动服务(第15行)。
接下来为EchoServer创建一个实现org.quickserver.net.server.ClientCommandHandler接口的类EchoCommandHandler.java,用来处理服务器发送的命令。
[align=left]01 // EchoCommandHandler.java[/align] [align=left]02 package echoserver;[/align] [align=left]03[/align] [align=left]04 import java.net.*;[/align] [align=left]05 import java.io.*;[/align] [align=left]06 import org.quickserver.net.server.ClientCommandHandler;[/align] [align=left]07 import org.quickserver.net.server.ClientHandler;[/align] [align=left]08[/align] [align=left]09 public class EchoCommandHandler implements ClientCommandHandler {[/align] [align=left]10[/align] [align=left]11 public void gotConnected(ClientHandler handler)[/align] [align=left]12 throws SocketTimeoutException, IOException {[/align] [align=left]13 handler.sendClientMsg("+++++++++++++++++++++++++++++++");[/align] [align=left]14 handler.sendClientMsg("| Welcome to EchoServer v 1.3 |");[/align] [align=left]15 handler.sendClientMsg("| Send 'Quit' to exit |");[/align] [align=left]16 handler.sendClientMsg("+++++++++++++++++++++++++++++++");[/align] [align=left]17 }[/align] [align=left]18 public void lostConnection(ClientHandler handler)[/align] [align=left]19 throws IOException {[/align] [align=left]20 handler.sendSystemMsg("Connection lost : " +[/align] [align=left]21 handler.getSocket().getInetAddress());[/align] [align=left]22 }[/align] [align=left]23 public void closingConnection(ClientHandler handler) [/align] [align=left]24 throws IOException {[/align] [align=left]25 handler.sendSystemMsg("Closing connection : " +[/align] [align=left]26 handler.getSocket().getInetAddress());[/align] [align=left]27 }[/align] [align=left]28[/align] [align=left]29 public void handleCommand(ClientHandler handler, String command)[/align] [align=left]30 throws SocketTimeoutException, IOException {[/align] [align=left]31 if(command.equals("Quit")) {[/align] [align=left]32 handler.sendClientMsg("Bye ;-)");[/align] [align=left]33 handler.closeConnection();[/align] [align=left]34 } else {[/align] [align=left]35 handler.sendClientMsg("Echo : "+command);[/align] [align=left]36 }[/align] [align=left]37 }[/align] [align=left]38 }[/align] |
当客户端建立一个连接(11行),gotConnected()方法被调用。在这个方法里面,我们给客户端发送欢迎文本(13-16行),这些文本使用通
过ClientHandler的sendClientMsg()方法发送给客户端。我们也会使用ClientHandler的
sendSystemMessage()方法显示客户端连接的InetAddress(20-21,25-26行)。
handlerCommand()方法是ClientCommandHandler接口的核心方法,因为服务器接收客户端发送的任何命令时都要调用该方
法。在我们对这个方法的实现中,我们会检查命令是否为"Quit"(31行),如果是,我们将发送一些提示文本表示服务器即将关闭连接,然后关闭连接
(33行)。否则,将命令加上前缀"Echo :"返回给用户。
2. 运行和测试
o 运行命令提示符程序(cmd.exe)
o 进入代码所在文件夹根目录,如c:\projects
o 编译代码 javac echoserver\*.java
o 若无编译错误,运行服务器:
set classpath=%classpath%;d:\QuickServer\dist\QuickServer.jar;.\(类所在文件夹)
java echoserver.EchoServer
o 您将会看到如下信息:
o 测试我们的服务器是否可以正常工作。再运行一个cmd程序,进入SocketTest.jar所在目录,键入java -jar
sockettest.jar命令,弹出一个窗口。在IP
Address中输入"127.0.0.1",在Port里输入"4123",点击"Connect"按钮,将看到窗口中显示如下图的信息。
若使用telnet,可键入命令:open localhost 4123
在Message中输入一些字符串,点击"Send"按钮,浏览器将会返回一个加了前缀"Echo :"的字符串。发送"Quit",服务器断开连接。
我们的EchoServer可能需要修改几个服务器配置参数,如超时消息、最多验证数、最大验证时间。QuickServer支持这些功能而无须改变代码。
相关文章推荐
- QuickServer开发指南(3)- 构建EchoServer
- 构建快捷开发IDE:VisualSVN+Sublime+Visual Studio 2013+QuickEasyFTPServer
- QuickServer开发指南(3)- 构建EchoServer
- QuickServer开发指南(6)- 远程管理支持
- QuickServer开发指南(7)- 使用和定制日志
- QuickServer开发指南(4)- 添加认证
- QuickServer开发指南(5)- 客户数据
- QuickServer开发指南(2)- 安装
- QuickServer开发指南(7)- 使用和定制日志
- QuickServer开发指南(9)- 数据模式和数据类型
- QuickServer开发指南(4)- 添加认证
- QuickServer开发指南(8)- XML配置
- QuickServer开发指南(8)- XML配置
- QuickServer开发指南(2)- 安装
- QuickServer开发指南目录
- QuickServer开发指南(5)- 客户数据
- QuickServer开发指南(9)- 数据模式和数据类型
- QuickServer开发指南(9)- 数据模式和数据类型
- QuickServer开发指南(1)- 介绍
- QuickServer开发指南(5)- 客户数据