一部分Android開發(fā)者看到這個標題時可能有點疑惑，SpringMVC不是用來做JavaWeb開發(fā)的嗎？難道被移植到Android上來了？答案是否定的，因為SpringMVC是基于Servlet的，在Android上開發(fā)一個支持Servlet的容器（Tomcat、JBoss）可不簡單，所以我們是在Android上開發(fā)了一套全新的WebServer + WebFramework。

AndServer2.0基于編譯時注解實現(xiàn)了SpringMVC的大部分注解Api，其Request的分發(fā)流程也基本和SpringMVC一致，與SpringMVC最大的不同是SpringMVC基于運行時注解，并且SpringMVC提供的功能更多更強大。不過AndServer提供的功能在Android上來做服務端開發(fā)是完全足夠的。

看到這里讀者朋友應該知道了，AndServer2.0是使用注解開發(fā)Web程序的，為了有個更直觀的了解，我們先看一個模擬用戶登錄的Http Api：

@RestController
public class UserController {

    @PostMapping("/login")
    public String login(@RequestParam("account") String account,
        @RequestParam("password") String password) {

        if(...) {
            return "Successful";
        }
        return "Failed";
    }
}

假設(shè)服務端的Address是192.168.1.11，監(jiān)聽的端口是8080，那么通過http://192.168.1.11:8080/login就可以訪問該登錄Http Api了。

感興趣的讀者可以幫我們做一下Code Review：
https://github.com/yanzhenjie/AndServer

下文將依次介紹以下三點：

1. 系統(tǒng)層架構(gòu)
2. 應用層架構(gòu)
3. 使用示例

1. 系統(tǒng)層架構(gòu)

我們都知道Http是根據(jù)Http協(xié)議使用Socket做了連接屬性、數(shù)據(jù)格式、交互邏輯方面的包裝，我們來模擬一段服務端啟動Server的代碼：

public void startServer(String address, int port) {
    InetAddress inetAddress = InetAddress.getByName();
    ServerSocket serverSocket = new ServerSocket(8080, 512, inetAddress);
    while (true) {
        Socket socket = serverSocket.accept();

        HttpConnection connection = HttpParser.parse(socket);
        HttpThead thread = new HttpThread(connection);
        thread.start();
    }
}

ServerSocket監(jiān)聽了某個端口，當有Socket連接上來的時候去把這個Socket解析為HttpConnection，解析過程是按照Http協(xié)議擬定的格式，從Socket的InputStream讀取一些數(shù)據(jù)后，用Request和Response包裝Socket和未讀取的流（比如標記下次讀取流的起點），下文會再提到。

接著HttpParser用HttpConnection包裝了Request和Reponse返回，可想而知，作為服務端程序，HttpConnection至少包涵了Request和Response對象：

public class HttpConnection {
    private Request mRequest;
    private Response mResponse;

    ...
}

緊接著啟動了一個線程去處理當前連接，其實也就是處理當前Request，用Response寫出數(shù)據(jù)，怎么處理這個Request是一個WebFramework的核心，作為Http服務端程序，應該能提供Html文件、JS文件、Java Method（Http Api）等讓客戶端訪問，因此得有一個管理員來負責請求和資源的匹配，所以有一個叫做HttpDispatcher的類來決定這個Request應該發(fā)給哪個資源去處理：

public class HttpDispatcher {

    public void dispath(Request request, Response response) {
        ...
    }

}

在HttpThead里面，當線程被喚起時只需要負責調(diào)用HttpDispatcher#diaptch()即可，到這里就比較清晰了，只需要HttpDispatcher把當前Request派發(fā)到對應的Html File或者Java Method處理就可以了，具體的處理就屬于HttpFramework的事，我們下文再講。

這就是一個簡單的WebServer的藍圖，我們根據(jù)設(shè)想畫出了系統(tǒng)層架構(gòu)圖：

系統(tǒng)層運行時流程圖：

上圖中，Handler表示處理請求的操作手柄，可能是Html File或者Java Method。值得高興的一點是，在我們迭代了幾個版本后，發(fā)現(xiàn)Apache組織提供了上述藍圖中的HttpParser層，因此為了穩(wěn)定性和節(jié)省人力我們已經(jīng)替換該層為Apache的實現(xiàn)。

2. 應用層架構(gòu)

應用層就是上文中提到的WebFramework，也就是上一個小節(jié)流程圖的Framework層，包括了Session的處理、Cookie的處理、Cache的處理等。

接著上文，HttpDispatcher需要把當前Request派發(fā)到對應的Html File或者Java Method處理，而Handler代表了Html File或者Java Method，因為此二者區(qū)別極大，用一個類來表示它們顯然有些不合理，于是我們想到了使用Adapter模式，所以有了一個抽象類RequestHandler：

public abstract class RequestHandler {

    public abstract void handle(Request request, Response response);
}

RequestHandler可以表示任何文件或者Java Method，HttpDispatcher的作用是分發(fā)請求到各個資源，所以HttpDispatcher不應該來分析某個RequestHandler具體是什么東西，它應該直接調(diào)用RequestHandler來處理請求，因為Html File或者Java Method對應的RequestHandler在實現(xiàn)上顯然大有不同，所以這里適用Adapter模式，于是我們用HandlerAdapter去做RequestHandler的適配：

public class HandlerAdapter {

    public RequestHandler getHandler(Request request) {
        ...
    }

    ...
}

HandlerAdapter除了能獲取RequestHandler之外，還需要做一些描述性的工作，好讓HttpDispatcher知道當前適配的RequestHandler是可以處理正要分發(fā)的這個Request的。

因為Html File和Java Method的返回值又是大相徑庭，因為返回值是輸出到客戶端展示的，所以我們把返回值抽象為View：

public class View {

    public Object output() {
        ...
    }

    ...
}

如上所以，output()方法就是獲取Handler輸出的內(nèi)容，還有其他方法是對這個輸出的描述，這里不例舉。

因為View是返回值，沒有具體的交互了，所以不適用Adapter模式了，因此我們必須有一個處理返回值的機制，把處理返回值的機制叫做ViewResolver：

public class ViewResolver {

    public void resolver(View view, Request request, Response response) {
        ...
    }
}

在ViewResolver中根據(jù)輸出內(nèi)容的類型不同，處理方式也不同，最終把輸出內(nèi)容通過Response對象寫出去，底層是使用上文中提到的被Response包裝的Socket寫出。

這就是一個簡單的WebFramework的藍圖，我們根據(jù)設(shè)想畫出了應用層架構(gòu)圖：

應用層運行時流程圖：

上圖中，Interceptor表示對請求的攔截器，比如可以做一些不允許沒登錄或者沒權(quán)限的請求進入的工作。ExceptionResolver表示全局異常處理器，比如某個Api發(fā)生了異常，會轉(zhuǎn)到ExceptionResolver中處理，而不至于當前請求不響應或者響應了不想被客戶端看到的消息。

另外需要補充的是，上文中提到的都是粗略的設(shè)計，中間還有一些細節(jié)，例如Session的處理、Cookie的處理、緩存的處理等都未提到，其中任何一個知識點單獨拿出來都可以寫一篇文章，由于篇幅關(guān)系這里不做詳細介紹。

架構(gòu)設(shè)計和流程到此就都介紹完了，有興趣的開發(fā)者也可以自己實現(xiàn)一下。

3. 使用示例

AndServer對于方便使用的理念是：只需要添加注解即可，不需要再做額外的配置。所以除了像文章開頭那樣用注解寫好Api之外，只需要指定監(jiān)聽端口啟動服務器就可以了。

與讀者做個約定，下文中服務器Address都是192.168.1.11，監(jiān)聽的端口是8080。

3.1. 網(wǎng)站部署示例

我們先來部署一個位于Assets中/web下的網(wǎng)站：

@Website
public class InternalWebsite extends AssetsWebsite {

    public InternalWebsite() {
        super("/web");
    }
}

因此SD的文件可以刪除也可以增加，所以很方便做一些文件的熱插拔，部署SD卡的網(wǎng)站：

@Website
public class InternalWebsite extends StorageWebsite {

    public InternalWebsite() {
        super("/sdcard/AndServer/web");
    }
}

如上所示，開發(fā)者只需要將網(wǎng)站所在的路徑告訴AndServer，并添加Website注解即可，該網(wǎng)站的Html、CSS、JS、其它文件都可以被訪問，例如/web目錄下有一個index.html文件，那么訪問地址就是http://192.168.1.11:8080/或者http://192.168.1.11:8080/index.html。

3.2. Http Api開發(fā)示例

在文章開頭我們看了一個模擬用戶的Http Api，下面我們增加一個模擬獲取用戶信息的Api：

@RequestMapping("/user")
@RestController
public class UserController {

    @PostMapping("/login")
    public String login(@RequestParam("account") String account,
        @RequestParam("password") String password) {

        if(...) {
            return "Successful";
        }
        return "Failed";
    }

    @GetMapping("/info/{userId}")
    public User info(@PathVariable("userId") String userId) {
        User user = ...;
        return user;
    }
}

于是我們得到兩個地址：

POST http://192.168.1.11:8080/user/login
GET  http://192.168.1.11:8080/user/info/uid_001

接下來什么配置都不用做，只需要啟動服務器，這幾個地址就可以用了。

3.3. 啟動服務器

AndServer.serverBuilder()
    .inetAddress(NetUtils.getLocalIPAddress())
    .port(8080)
    .timeout(10, TimeUnit.SECONDS)
    .build()
    .start();

如上所示只需要指定要監(jiān)聽的服務端地址和端口，啟動服務器就可以訪問上面的所有地址了，不需要再做其他配置。

由于篇幅關(guān)系，本文到此結(jié)束，介紹的比較粗略，有興趣的開發(fā)者可以看看項目使用文檔：
https://www.yanzhenjie.com/AndServer