在开发应用程序的时候常会需要连到互联网上取得一些数据或是发送一些数据出去,而这当中最常使用的协定就是 HTTP 了!在 Java 中,若要使用 HTTP、HTTPS、FTP 等协定来进行连接,可以使用 java.net 套件下的 URLConnection。但是 URLConnection 过于底层,使用起来十分麻烦,因此许多人会改用 Apache HttpComponents 提供的 HttpClient,只不过 HttpClient 的功能实在是太多了,需要引用一大堆 Apache 的 Library,使用起来性能也似乎不如直接使用 URLConnection。这篇文章将提供一个较为简易的方式实作出 HTTP 和 HTTPS 的 GET 与 POST Request 方法,以及 FTP 文件下载的功能。

MagicURLNetwork 是以 URLConnection 为基础,支持 HTTP 和 HTTPS 协定的 GET、POST、PUT、HEAD、DELETE Request 方法,以及 FTP 文件下载的函数库。

取得 MagicURLNetwork

使用 MagicURLNetwork

GET

使用 MagicURLNetwork 发出 GET Request 的方法很简单,以 YouTube 搜索来举例,程序如下:

final String keyword = "magiclen"; //查找关键字
final MagicURLNetwork network = MagicURLNetwork.GET("https://www.youtube.com/results");
network.setParameter("search_query", keyword); //加入参数
network.open();
System.out.println(network.getResultAsString()); //传回HTML结果

如果要 GET 的数据不是文字,而是一个二进制(Binary)的文件的话,可以使用 setTargetFile 方法,将文件保存在磁盘中,如以下程序:

final MagicURLNetwork network = MagicURLNetwork.GET("https://wordpress.org/latest.zip");
network.setTargetFile(new File("/home/magiclen/wp.zip")); //下载的数据将会存到这个文件内
network.open(); //打开URL
System.out.println(network.getResultAsFile().length()); //下载后,显示出文件的大小

当然要将文字存到文件内也是可以的,只是通常不会特地这样做。

POST、SinglePOST、PUT、HEAD、DELETE

MagicURLNetwork 其余的 Request 方式,跟 GET 可以几乎是一模一样,看用途来使用。

加入 NetworkListener

如果要取得 MagicURLNetwork 目前的连接状况和发生错误时的错误消息,可以设置一个 NetworkListener 对象给 MagicURLNetwork,如以下程序:

final MagicURLNetwork network = MagicURLNetwork.GET("https://wordpress.org/latest.zip");
network.setTargetFile(new File("/home/magiclen/wp.zip"));
network.setNetworkListener(new MagicURLNetwork.NetworkListener() {

    @Override
    public void onStarted() {

    }

    @Override
    public void onRunning(final boolean receiving, final long currentBytes, final long totalBytes) {
	System.out.printf("%s: %d/%d%n", receiving ? "Receiving" : "Sending", currentBytes, totalBytes);
    }

    @Override
    public void onFailed(final String message, final boolean attemptDisconnect) {
	System.err.println(message);
    }

    @Override
    public void onFinished(final JSONObject resultHeader, final Object result) {
	System.out.println(result);
    }

});
new Thread(() -> network.open()).start();