在Android中，使用Kotlin的 API请求简易方法

原文标题：API request in Android the easy way using Kotlin

原文连接：http://antonioleiva.com/api-request-kotlin/

原文做者：Antonio Leiva（http://antonioleiva.com/about/）

原文发布：2015-07-21

 

Kotlin是功能很是强大的编程语言，其目标是利用较少的模板（boilerplate）编写更多的代码。尤为是在Android开发中。除了编程语言自身和它的类以外，Kotlin还为已有的Java类提供一组好用的扩展。这个例子是请求API和下载结果的方法。

 

我知道已经有许多不一样的库能够帮助咱们作这些工做，而且因Kotlin与Java的互用性，它也能使用这些库。可是，咱们有时候仅仅由于大的库更简单、不易出错，对于小需求也用大库。

 

API请求：Java 与 Kotlin对比

 

我总喜欢把这两种语言进行对比，看看坚持使用Java咱们会错过什么。从URL恢复JSON的典型代码是这样：

 

 1 try {
 2     URL url = new URL("<api call>");
 3  
 4     urlConnection = (HttpURLConnection) url.openConnection();
 5     urlConnection.setRequestMethod("GET");
 6     urlConnection.connect();
 7  
 8     InputStream inputStream = urlConnection.getInputStream();
 9     StringBuffer buffer = new StringBuffer();
10     if (inputStream == null) {
11         // Nothing to do.
12         return null;
13     }
14     reader = new BufferedReader(new InputStreamReader(inputStream));
15  
16     String line;
17     while ((line = reader.readLine()) != null) {
18         buffer.append(line + "\n");
19     }
20  
21     if (buffer.length() == 0) {
22         return null;
23     }
24     result = buffer.toString();
25 } catch (IOException e) {
26     Log.e("Request", "Error ", e);
27     return null;
28 } finally{
29     if (urlConnection != null) {
30         urlConnection.disconnect();
31     }
32     if (reader != null) {
33         try {
34             reader.close();
35         } catch (final IOException e) {
36             Log.e("Request", "Error closing stream", e);
37         }
38     }
39 }

 

Kotlin标准库为URL类提供了扩展函数，避免咱们编写全部代码。前面的代码能够转换为：

 

1 val result = URL("<api call>").readText()

 

对于大量的响应，不建议使用这个函数，可是在大多数状况下，它是足够了。若是不这样，还有许多其余有趣的扩展函数，如：BufferedReader.forEachLine()，它产生行Sequence，让咱们用它们中任何一个一块儿作些事。或是，你能够经过BufferedReader.lineSequence()获得原始的Sequence<String>。这时，你可以执行Sequence容许的不一样转换中的任何一种，如：过滤、排序、映射等等。

 

异步调用

 

如你所知，主线程是负责UI呈现和交互的，咱们不该该因其它运行时间长的任务阻塞它，这将会影响UI性能。在HTTP请求状况下， Android SDK甚至经过抛出一个异常来阻止咱们这么作。在Android典型的解决方案是使用AsyncTask。AsyncTask有一个doInBackground抽象方法，其在另个线程中执行。

 

除了让AsyncTask正常工做很难这一事实外，因为它自身带来了许多问题，使得经过它扩展建立一个新类、在onDestroy中终止它等等，都是很乏味。这个（你可能须要更多的检查以免崩溃）很是简单的版本将是：

 

 1 @Override protected void onCreate(Bundle savedInstanceState) {
 2     super.onCreate(savedInstanceState);
 3  
 4     task = new AsyncTask<Void, Void, String>() {
 5         @Override protected String doInBackground(Void... params) {
 6             return requestFromServer("<api call>");
 7         }
 8  
 9         @Override protected void onPostExecute(String s) {
10             if (!isFinishing() && !isCancelled()) {
11                 Log.d("Request", s);
12                 Toast.makeText(ExampleActivity.this, "Request performed", Toast.LENGTH_LONG).show();
13             }
14         }
15     };
16 }
17  
18 @Override protected void onDestroy() {
19     super.onDestroy();
20  
21     if (task != null) {
22         task.cancel(true);
23         task = null;
24     }
25 }

 

这实在不清晰也不直观。当咱们在Android中用Kotlin开发时，咱们不能忘记Anko库。它主要目的是提供DSL方式用代码来建立布局，而不是用XML。我实际使用过XML，因此我如今不使用它了，可是它仍是包括一整套很是有用的特性。特别对异步任务有些小的DSL。这样在Kotlin中，前面的代码可以减小为：

 

1 async {
2     val result = URL("<api call>").readText()
3     uiThread { 
4         Log.d("Request", result)
5         longToast("Request performed") 
6     }
7 }

 

实际上，你有async函数，它将在另外一个线程中执行代码，并由uiThread给出返回主线的机会。async是Context的扩展函数实现，且使用它弱应用，因此不会阻止GC释放内存。

 

uiThread优点的方面是它依据使用类，以用不一样的方式来实现。若是咱们从Activity中调用它，假设actiivity.isFinishing()返回true，uiThread代码是不会执行的，而且在此状况下不会崩溃。

 

假设你要用future，Async返回Java Future。若是你须要返回future结果，就能够用asyncResult。

 

你还可以用你本身的执行器：

 

1 val executor = Executors.newScheduledThreadPool(4)
2 async(executor) {
3     // Some task
4 }

 

总结

 

用几行代码，咱们从一个很是典型的操做获得相同（若是没有更好的话）的结果，如：调用一个API，以String变量获得结果。隐藏在这些扩展函数背后有许多有趣的代码，因此我建议去重读Kotlin和Anko源代码，看看在幕后都作了什么。

 

记住从我写的书《Android开发者的Kotlin》中，你可以学习到Kotlin的这点以及许多其它能力，你将经过从0开始建立Android APP学习Kotlin。