AndServer，一个Android端的web服务器

开源地址：https://github.com/yanzhenjie/AndServer

AndServer是一个Android端的Web服务器，类似Apache或者Tomcat，但又有不同，它是一个普通的Android Library，Android项目Gradle远程依赖或者添加Jar包皆可引入该项目，然后就通过正常Android开发一样开发App了。

AndServer是用纯Android API写一个库，所以不用任何第三方的库或者什么硬件编译，打成Jar包后仅仅580kb。

特点
接受客户端文件上传、下载文件。
动态Http API，就像Java的Servlet一样写接口。
部署静态网站，例如纯Html，支持JS、CSS、Image分离。
部署动态网站，例如Html表单，当然可以结合上面的Android Http接口。
基本上和Java的Servlet一样的功能，如果你做过Java开发或者其它语言的Web开发应该就很熟悉了。

依赖
Gradle
compile 'com.yanzhenjie:andserver:1.0.2'

Maven
<dependency>
  <groupId>com.yanzhenjie</groupId>
  <artifactId>andserver</artifactId>
  <version>1.0.2</version>
  <type>pom</type>
</dependency>

ADT，可以去AndServer主页下载Jar包。

最好的教程是sample，建议到AndServer主页下载sample运行查看效果，然后结合README就更加清晰了。

创建服务器
AndServer andServer = new AndServer.Build()
    ...
    .build();

// 创建服务器。
Server mServer = andServer.createServer();
...

// 启动服务器。
mServer.start();
...

// 停止服务器。
mServer.stop();
...

// 服务器正在运行吗？
boolean running = mServer.isRunning();

端口号和响应超时设置
AndServer andServer = new AndServer.Build()
    .port(8080) // 默认是8080，Android平台允许的端口号都可以。
    .timeout(10 * 1000) // 默认10 * 1000毫秒。
    ...
    .build();
...

如果用上面两个实现注册你的网站，那么你的默认首页（index.html）是：

http://ip:port/
http://ip:port/youPath
http://ip:port/youPath/index.html

注册网站到AndServer
Wesite wesite = new AssetsWebsite(AssetManager, youPath);
// 或者
Wesite wesite = new StorageWebsite(youPath);

AndServer andServer = new AndServer.Build()
    ...
    .website(wesite);
    .build();

AssetsWebsite的使用
如果你的网站在assets下，那么你就用AssetsWebsite来部署你的网站。

使用方法是：

//AssetManager不能被关闭。
AssetManager mAssetManager = getAssets();

Wesite wesite = new AssetsWebsite(mAssetManager, youPath);

上面我们看到new AssetsWebsite时需要传一个AssetManager和一个path，path支持assets根目录和子目录，下面是这两种情况的举例。

如果你的网站在assets根目录下, 你的path就填""，比如：

Wesite wesite = new AssetsWebsite(mAssetManager, "");

那么你的默认首页访问地址就是：

http://ip:port
http://ip:port/index.html

那么你的其它页面访问地址是：

http://ip:port/login.html
http://ip:port/error.html

比如：

http://192.168.1.12:8080/index.html  
http://192.168.1.12:8080/login.html

如果你的网站根目录在assets的子目录下，那么你传入assets的相对目录地址就好了比如你的网站在assets下web目录，例如：

Wesite wesite = new AssetsWebsite(mAssetManager, "web");

那么你的默认首页访问地址就是：

http://ip:port
http://ip:port/web
http://ip:port/web/index.html

那么你的其它页面访问地址是：

http://ip:port/web/login.html 
http://ip:port/web/error.html

例如：

http://192.168.1.12:8080/
http://192.168.1.12:8080/index.html
http://192.168.1.12:8080/web/index.html
http://192.168.1.12:8080/web/index.html  
http://192.168.1.12:8080/web/login.html

StorageWebsite的使用
如果你的网站在内存设备下，只要以文件的形式可以读取到，那么你就用StorageWebsite来部署你的网站，比如你的网站在SD卡下时。

使用方法是：

Wesite wesite = new StorageWebsite(youPath);

它很简单，只要传入你的网站的存储目录地址即可，例如你的网站在SD卡下的www目录：

File file = new File(Environment.getExternalStorageDirectory(), "www");
String websiteDirectory = file.getAbsolutePath();

Wesite wesite = new StorageWebsite(websiteDirectory);

访问地址和AssetsWebsite的道理相同。

像Servlet一样写Http接口
Http API是通过RequestHandler接口来注册的，它是一个java interface，它和Java的Servlet一样。

你需要实现这个接口，然后在AndServer注册即可，例如：

public class RequestLoginHandler implements RequestHandler {

    @Override
    public void handle(HttpRequest req, HttpResponse res, HttpContext con) {
        Map<String, String> params = HttpRequestParser.parse(request);

        // Request params.        
        String userName = params.get("username");
        String password = params.get("password");

        if ("123".equals(userName) && "123".equals(password)) {
            StringEntity stringEntity = new StringEntity("Login Succeed", "utf-8");
            response.setEntity(stringEntity);
        } else {
            StringEntity stringEntity = new StringEntity("Login Failed", "utf-8");
            response.setEntity(stringEntity);
        }
    }
}

然后在AndServer中注册：

AndServer andServer = new AndServer.Build()
    ...
    .registerHandler("login", new RequestLoginHandler())
    .build();

现在你就得到了一个唯一的访问地址：http://ip:port/login, 例如：

http://192.168.1.12:8080/login?username=123&password=123

文件下载和文件上传的例子请下载sample查看。

提交Html表单到Android端
在Html的form的action中填入你注册RequestHandler时的key就可以了，然后在RequestHandler的

handle(HttpRequest, HttpResponse, HttpContext)

方法就可以获取form提交的参数了。

比如我们上面注册Login RequestHandler在form中这样使用:

<form id="form1" method="post" action="login">
...
</form>

监听服务器的状态
服务器一般情况下有三种状态：成功启动、启动时失败、成功停止服务器，失败时会返回一个异常，一般情况下是网络问题或者端口被占用。

private Server.Listener mListener = new Server.Listener() {
    @Override
    public void onStarted() {
        // 服务器启动成功.
    }

    @Override
    public void onStopped() {
        // 服务器停止了，一般是开发者调用server.stop()才会停止。
    }

    @Override
    public void onError(Exception e) {
        // 服务器启动发生错误，一般是端口被占用。
    }
};

AndServer andServer = new AndServer.Build()
    ...
    .listener(mListener)
    .build();