Mini Http Server for Java (Android)

MiniHttpServer

一：開發(fā)環(huán)境

Mac OS 10、Java 1.8、IDEA（Gradle工程）

二：介紹

一款基于Java Nio實(shí)現(xiàn)的Http解析框架，支持常見的請(qǐng)求解析和邏輯；采用單線程解析多線程業(yè)務(wù)處理方案，內(nèi)置線程池方便線程管理；支持靜態(tài)文件下載；支持表單參數(shù)和文件上傳，支持PUT文件上傳。解析成功后返回HttpRequest和HttpResponse。除常見的接口請(qǐng)求返回外，HttpResponse可以向客戶端發(fā)送跨域請(qǐng)求結(jié)果，也可以發(fā)送文件，支持區(qū)分附件模式。

三：特點(diǎn)

• 純Java API實(shí)現(xiàn)，性能好
• 基于Java Nio，異步機(jī)制，相比傳統(tǒng)IO，有更高的性能。
• 體積小，代碼少，支持Http部分協(xié)議，滿足絕大部分需求。
• 支持POST表單數(shù)據(jù)和多文件上傳。
• 支持PUT上傳文件，自動(dòng)保存到file目錄。
• 支持發(fā)送文件到客戶端。
• 支持發(fā)送重定向等基本http協(xié)議內(nèi)容。
• 支持反饋跨域請(qǐng)求。
• 支持自定義header。

四：引入(最新版本)

1. Maven

<dependency>
  <groupId>com.itgowo</groupId>
  <artifactId>MiniHttpServer</artifactId>
  <version>0.0.21</version>
  <type>pom</type>
</dependency>

2. Gradle

implementation 'com.itgowo:MiniHttpServer:0.0.21'

五：初始化(庫(kù)Jar中有Demo類，可以參考)

Demo.java

1. 創(chuàng)建MiniHttpServer
   MiniHttpServer 繼承自Thread，復(fù)寫了Thread.start()方法，與MiniHttpServer.startServer()方法作用相同，不會(huì)沖突。

MiniHttpServer miniHttpServer = new MiniHttpServer(); 

2. 設(shè)置初始信息

public void init(boolean isBlocking, InetSocketAddress inetSocketAddress, String webDir, onHttpListener onHttpListener)

3.設(shè)置文件存儲(chǔ)策略

當(dāng)有文件上傳到服務(wù)器時(shí)，默認(rèn)保存在webDir里的file目錄下，創(chuàng)建UUID命名的目錄，將上傳的文件放入其中，文件名已Http信息fileName命名，防止重名文件沖突。例 web/file/02e86423-d1bd-4218-8f70-a7c73c71bf62/test.png
默認(rèn)每次server初始化后執(zhí)行清理功能。需要手動(dòng)執(zhí)行使用這個(gè)方法miniHttpServer.getFileManager().cleanOldFile();

  httpServer.setFileLimit(long fileSize, long fileLastTime);

4. onHttpListener類

public void onError(Throwable throwable)`

public void onHandler(HttpRequest httpRequest, HttpResponse httpResponse) throws Exception`

六：情景

1. 獲取header

    Map<String, String> headers = httpRequest.getHeaders();
    boolean hasContentType = httpRequest.containsHeader(HttpHeaderNames.CONTENT_TYPE);
    String contentType = httpRequest.getHeaders().get(HttpHeaderNames.CONTENT_TYPE);

2. 獲取Parms，參數(shù)操作，來(lái)源一:url中"?"后面解析出來(lái)的參數(shù)鍵值對(duì);來(lái)源二:POST表單參數(shù)解析

    Map<String, String> parms = httpRequest.getParms();
    String userId = httpRequest.getParms().get("userId");

3. 客戶端GET請(qǐng)求資源

    if (HttpMethod.GET == httpRequest.getMethod()) {
        if (httpRequest.getUri().equalsIgnoreCase("/")) {
            httpRequest.setUri("/index.html");
        }
        //緩存策略，瀏覽器指定時(shí)間內(nèi)只獲取一次文件,如果sendFile()包含cacheControl參數(shù)，則不需要在設(shè)置，設(shè)置了以單獨(dú)設(shè)置為準(zhǔn)。沒有cacheControl的方法則默認(rèn)沒有此參數(shù)
        httpResponse.addHeader(HttpHeaderNames.CACHE_CONTROL, HttpHeaderValues.MAX_AGE + "=3600");

//      httpResponse.sendFile(httpNioServer.getFileManager().getFile(httpRequest.getUri()));
//      httpResponse.sendFile(httpNioServer.getFileManager().getFile(httpRequest.getUri()), true);
        //cacheControl參數(shù)添加了不一定起作用，如果單獨(dú)加了header，則此方法參數(shù)無(wú)效
        httpResponse.sendFile(httpNioServer.getFileManager().getFile(httpRequest.getUri()), HttpStatus.OK, 3600, true);
    }

4. 客戶端POST請(qǐng)求，POST請(qǐng)求，常見的Body傳Json文本或者表單上傳文件

    if (HttpMethod.POST == httpRequest.getMethod()) {
        if (httpRequest.isMultipart_formdata()) {
            Map<String, File> fileMap = httpRequest.getFileList();
          //  httpResponse.sendData(HttpStatus.OK);
            httpResponse.setData(Arrays.toString(fileMap.values().toArray())).sendData(HttpStatus.OK);
        } else {
            String requestBody = httpRequest.getBody();
            httpResponse.setData(requestBody).sendData(HttpStatus.OK);
        }
    }

5. 客戶端OPTIONS請(qǐng)求，OPTIONS請(qǐng)求，跨域請(qǐng)求最多的是ajax發(fā)出的，應(yīng)對(duì)web請(qǐng)求

    if (HttpMethod.OPTIONS == httpRequest.getMethod()) {
        httpResponse.sendOptionsResult();
    }

6. 客戶端PUT請(qǐng)求，跟POST表單上傳文件不同，Http中Body默認(rèn)為一個(gè)文件，臨時(shí)存在temp目錄，PUT如果需要傳遞文件名請(qǐng)?jiān)趆eaders中添加自定義數(shù)據(jù)。

    if (HttpMethod.PUT == httpRequest.getMethod()) {
        Map<String, File> fileMap = httpRequest.getFileList();
        httpResponse.sendData(HttpStatus.OK);
    }

7. 客戶端其他請(qǐng)求，HEAD、DELETE、TRACE、CONNECT、PATCH 等不常見，需要自己返回結(jié)果即可，無(wú)特殊需求。

8. 重定向

    httpResponse.sendRedirect("http://www.baidu.com");

七：關(guān)鍵類

HttpRequest

HttpResponse

八：小期待

以下項(xiàng)目都是我圍繞遠(yuǎn)程控制寫的項(xiàng)目和子項(xiàng)目。都給star一遍吧。??

我的小站：IT狗窩
技術(shù)聯(lián)系QQ:1264957104