转载

在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

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

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典型的解决方案是使用 AsyncTaskAsyncTask 有一个 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 给出返回主线的机会。 asyncContext 的扩展函数实现,且使用它弱应用,所以不会阻止GC释放内存。

uiThread 优势的方面是它依据使用类,以用不同的方式来实现。如果我们从Activity中调用它,假设 actiivity.isFinishing() 返回 trueuiThread 代码是不会执行的,并且在此情况下不会崩溃。

假设你要用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。

正文到此结束
Loading...