版权声明:转载请注明本文转自严振杰的博客: http://blog.csdn.net/yanzhenjie1003
本文中讲的AndServer已经全新升级,升级后可以直接部署动态网站、静态网站、像Servlet一样写Http接口,请读者移步到我另一篇博客:Android也可以做web开发了
很多开发者看到这个标题表示很怪异,Android怎么可能搭建服务器呢?根本用不到呀,这个项目毫无价值。我表示很理解这一类的开发者,毕竟每个人的经验经历都是有限的。
必须要说说我们的用处(需要用这个功能的人自然不用解释),比如在TV开发中,现在我们有一个电视盒子,上面跑着我们的一个apk,假如我们现在用微信网页或者QQ网络连接了我们的apk软件,我们需要把一个视频传到电视上播放,这个时候是不是需要我们的apk作为服务端来接受文件了?这只是一个例子,可能还有局限性,更多的用处大家自己去发挥噢。
在写博客之前我已经做了一个Android Http Server
的开源项目,我把它取名叫AndServer
,AndServer
源代码托管在Github:https://github.com/yanzhenjie/AndServer。AndServer
是Android Http Server
的简写,顾名思义AndServer是Android端Http服务器的一个项目。
目的在于在Android可以很方便的搭建Http服务器,这几天有人问我局域网Client和Client通信的时候有时候用什么技术比较好,其实我想到的是Socket和Http,我们知道Http是基于Socket的,所以它是一个非常成熟的Socket,所以我选择了用Http来实现,今天的博客内容也是主要讲Android端如何搭建一个Http服务器。
如果不想研究原理,只是想快速解决项目中的问题的同学,直接依赖AndServer
,具体用法往下看,或者从Github上下载AndServer的Demo。这里给出AndroidStudio和Eclipse的使用方式:
Eclipse使用Jar包,如果需要依赖源码,请自行下载。
下载Jar包
AndroidStudio使用Gradle构建添加依赖(推荐)
compile 'com.yanzhenjie:andserver:1.0.1'
ApacheHttpCore
是一个优秀的Http底层框架,支持构建服务器,支持构建客户端,所以我们第一个版本选择了Apache的HttpCore
,因为Android弃用了ApacheHttpClient
相关API,代码中会有弃用的警告,不过这一点大家不要担心,下面会给出解决方案。
Android6.0之后SDK中删除HttpClient
相关的API,我看了Google的官方文档后提示我们,如果还想继续使用HttpClient
的话:
android {
useLibrary ‘org.apache.http.legacy‘
}
如果提示编译不过的话,需要在android-sdk-windows\platforms\android-23\optional
下检查有没有以下两个文件:
optional.json
org.apache.http.legacy.jar
如果你的SDK下没有org.apache.http.legacy.jar
的话到这里下载。
拷贝android-sdk-windows\platforms\android-23\optional
下的org.apache.http.legacy.jar到你项目的libs下就完结。
从Apache官网下载HttpClient
和HttpCore
的jar包导入到项目。地址是:http://hc.apache.org/downloads.cgi。
但是我推荐方案一和方案二,因为AndroidSDK中删除了HttpClient
的api,但是手机系统里面还是有HttpClient
的api的。方案一和二的原理最终都是引用SDK下android-sdk-windows\platforms\android-23\optional
下的org.apache.http.legacy.jar
这个jar包到项目中,是Google处理过的jar,添加了AndroidHttpClient
等适合Android使用的api,体积相对从Apache官网下载的jar小的多。
这里先给大家看下AndServer怎么用,下一步详解如何一步步用HttpCore
实现一个简易的HttpServer
。
我们每写一个服务端接口,就要一个对应的类来处理,这里要实现AndServerRequestHandler
接口,相当于Java继承Servet一样,我们只需要处理Request,在Response中给出响应即可:
public class AndServerTestHandler implements AndServerRequestHandler {
@Override
public void handle(HttpRequest rq, HttpResponse rp, HttpContext ct) throws HttpException, IOException {
response.setEntity(new StringEntity("请求成功。", "utf-8"));
}
}
在启动AndServer
的时候最好放在Service中,这里给出启动的关键代码。指定服务器的端口号,并注册接口,再启动服务器:
AndServerBuild andServerBuild = AndServerBuild.create();
andServerBuild.setPort(4477);// 指定http端口号。
// 注册接口。
andServerBuild.add("test", new AndServerTestHandler());
// 这里还可以注册很多接口。
// 构建AndServer并启动服务器。
AndServer andServer = andServerBuild.build();
andServer.launch();
到这里就完成了一个Android WebServer的搭建,我们已经可以通过浏览器或者NoHttp来访问我们的WebServer
了。
如果是浏览器方法,和我们普通访问网站没有区别,比如访问我们上面的接口:
Android本机访问的地址:http://locahost:4477/test
局域网其他设备访问地址:http://192.168.1.116:4477/test
如果是其它Android系统的设备,推荐使用NoHttp来访问,NoHttp
是我的另一个Http客户端的项目,和AndWeb正好是相对的,一个做服务端,一个做客户端。
到这里怎么用AndServer和Android搭建服务端的教程就完了,如果想自己尝试利用HttpCore搭建一个Http服务端的话,请往下看。
其实里边的东西比较复杂个人感觉如果你不想自己写一个这样的框架的,没有太大必要看完,但是我推荐大家往下看噢,我相信你会有收获的。这里讲解下关键的代码,一共有六步:
我们知道Http是基于Socket的,那么服务端肯定是ServerSocket
了,所以我们这里也是需要一个ServerSocket
来接受客户端请求的:
ServerSocket mServerSocket = new ServerSocket();
mServerSocket.setReuseAddress(true);
mServerSocket.bind(new InetSocketAddress(mPort));// 绑定端口
这个就是添加Http协议拦截器,都是Http基本信息。
// HTTP协议拦截器。
BasicHttpProcessor httpProcessor = new BasicHttpProcessor();
httpProcessor.addInterceptor(new ResponseDate());
httpProcessor.addInterceptor(new ResponseServer());
httpProcessor.addInterceptor(new ResponseContent());
httpProcessor.addInterceptor(new ResponseConnControl());
初始化Http连接的信息,比如超时时间,缓存区大小,是否使用GZIP等。
// HTTP Attribute.
HttpParams httpParams = new BasicHttpParams();
httpParams.setIntParameter(CoreConnectionPNames.SO_TIMEOUT, 5000)
.setIntParameter(CoreConnectionPNames.SOCKET_BUFFER_SIZE, 8 * 1024)
.setBooleanParameter(CoreConnectionPNames.STALE_CONNECTION_CHECK, false)
.setBooleanParameter(CoreConnectionPNames.TCP_NODELAY, true)
.setParameter(CoreProtocolPNames.ORIGIN_SERVER, "WebServer/1.1");
这里要用HttpRequestHandlerRegistry把我们的RequestHandler
注册进来,这一步也是最重要的,就是我们的接口名称,相当于是注册Servlet到web.xml
中一样。
举个例子,假设访问严振杰的主页http://www.yanzhenjie.com,我的主页下假设有一个login的接口,那我们的地址是:http://www.yanzhenjie.com/login
,我们的Android Web Server
也要实现这样一个可以访问的地址,就要注册一个login的接口,所以这里是增加接口名称:
// 注册Http接口。
HttpRequestHandlerRegistry handlerRegistry = new HttpRequestHandlerRegistry();
handlerRegistry.register("/login", new RequestLoginHandle());// 增加登录接口
handlerRegistry.register("/download", new RequestTestHandle());// 增加下载接口
这里可以注册很多个接口,我们后面的接口对象是实现了HttpCore
中HttpRequestHandler
接口的自定义类,比如我们上面的RequestLoginHandle
的实现是:
public class RequestLoginHandle implements HttpRequestHandler {
@Override
public void handle(HttpRequest rq, HttpResponse rp, HttpContext c) {
// 只要在这里处理HttpRequest,如果要发出响应数据,用HttpResponse
}
}
前面准备的几步都是为这一步准备参数的,把我们前面准备好的httpProcessor
、httpParams
、handlerRegistry
都传到HttpService
,为下一步的Connection做好准备。
// 创建HTTP服务。
HttpService httpService = new HttpService(httpProcessor, new ConnectionReuseStrategy(), new HttpResponseFactory());
httpService.setParams(httpParams);
httpService.setHandlerResolver(handlerRegistry);
上面的工作都做完了,就用到我们最开始准备好的ServerSocket
来接受客户端的连接的socket了,接受到一个客户端的连接后,把刚才的httpParams和socket绑定到HttpServerConnection
中,开始处理请求,下面代码中有一个RequestHandleTask
类,这是一个单独的线程,因为每个请求都不能干涉服务器的主线程,所以这里新开一个非阻塞的线程去处理每一个请求:
while (isLoop) {
if (!mServerSocket.isClosed()) {
// 阻塞接受客户端。
Socket socket = mServerSocket.accept();
DefaultHttpServerConnection serverConnection = new DefaultHttpServerConnection();
// 接受到一个请求到,把请求和刚才的param绑定到connection中。
serverConnection.bind(socket, httpParams);
// 开启一个线程去处理这个请求,不阻塞当前线程。
RequestHandleTask requestTask = new RequestHandleTask(this, httpService, serverConnection);
requestTask.setDaemon(true);
AndWebUtil.executeRunnable(requestTask);
}
}
在RequestHandleTask
中的run方法中,我们只要判断HttpServerConnection
是连接的,就调用HttpService
的handleRequest
方法交给HttpCore
去分析请求,并自动分发到我们刚才注册的login接口中。
while (mServerConnection.isOpen()) {
mHttpService.handleRequest(mServerConnection, new BasicHttpContext());
}
当HttpCore
分析出来这个连接中的请求符合我们刚才注册的接口:
handlerRegistry.register("/login", new RequestLoginHandle());// 增加登录接口
它会自动调用RequestLoginHandle
的hande()
方法,因为我们实现了HttpRequestHandle
接口。
到这里,如何利用HttpCore
搭建一个Android Http Server
就完成了。
有的同学可能不会把上面的代码整合起来,这里给出完整的代码:
try {
ServerSocket mServerSocket = new ServerSocket();
mServerSocket.setReuseAddress(true);
mServerSocket.bind(new InetSocketAddress(mPort));
// HTTP协议拦截器。
BasicHttpProcessor httpProcessor = new BasicHttpProcessor();
httpProcessor.addInterceptor(new ResponseDate());
httpProcessor.addInterceptor(new ResponseServer());
httpProcessor.addInterceptor(new ResponseContent());
httpProcessor.addInterceptor(new ResponseConnControl());
// HTTP Attribute.
HttpParams httpParams = new BasicHttpParams();
httpParams.setIntParameter(CoreConnectionPNames.SO_TIMEOUT, timeout)
.setIntParameter(CoreConnectionPNames.SOCKET_BUFFER_SIZE, 8 * 1024)
.setBooleanParameter(CoreConnectionPNames.STALE_CONNECTION_CHECK, false)
.setBooleanParameter(CoreConnectionPNames.TCP_NODELAY, true)
.setParameter(CoreProtocolPNames.ORIGIN_SERVER, "WebServer/1.1");
// 注册Http接口。
HttpRequestHandlerRegistry handlerRegistry = new HttpRequestHandlerRegistry();
for (Map.Entry handlerEntry : mRequestHandlerMap.entrySet()) {
handlerRegistry.register("/" + handlerEntry.getKey(), new DefaultHttpRequestHandler(handlerEntry.getValue()));
}
// 创建HTTP服务。
HttpService httpService = new HttpService(httpProcessor, new DefaultConnectionReuseStrategy(), new DefaultHttpResponseFactory());
httpService.setParams(httpParams);
httpService.setHandlerResolver(handlerRegistry);
/**
* 开始接受客户端请求。
*/
while (isLoop) {
// 接收客户端套接字。
if (!mServerSocket.isClosed()) {
Socket socket = mServerSocket.accept();
DefaultHttpServerConnection serverConnection = new DefaultHttpServerConnection();
serverConnection.bind(socket, httpParams);
// Dispatch request handler.
RequestHandleTask requestTask = new RequestHandleTask(this, httpService, serverConnection);
requestTask.setDaemon(true);
AndWebUtil.executeRunnable(requestTask);
}
}
} catch (Exception e) {
} finally {
close();
}
RequestHandleTask
类的完整代码:
public class RequestHandleTask extends Thread {
private final HttpService mHttpService;
private final HttpServerConnection mServerConnection;
private DefaultAndServer mWebServerThread;
public RequestHandleTask(DefaultAndServer webServerThread, HttpService httpservice, HttpServerConnection conn) {
this.mWebServerThread = webServerThread;
this.mHttpService = httpservice;
this.mServerConnection = conn;
}
@Override
public void run() {
try {
while (mWebServerThread.isLooping() && mServerConnection.isOpen()) {
this.mHttpService.handleRequest(this.mServerConnection, new BasicHttpContext());
}
} catch (IOException e) {
} catch (HttpException e) {
} finally {
try {
this.mServerConnection.shutdown();
} catch (IOException e) {
}
}
}
}
好了咯,主要代码就是这些,剩下的自己去发挥吧!
版权声明:转载请注明本文转自严振杰的博客: http://blog.csdn.net/yanzhenjie1003