关于这个问题,已经有很多很好的答案,但自从这些答案发布以来,已经有了很多很棒的图书馆。这是一种新手指南。
我将介绍几个用于执行网络操作的用例,并为每个用例提供一两个解决方案。
HTTP上的REST
通常是JSON,但也可以是XML或其他格式。
完全API访问
假设你正在编写一个应用程序,让用户跟踪股价、利率和货币汇率。您可以找到一个JSON API,它看起来像这样:
http://api.example.com/stocks // ResponseWrapper<String> object containing a
// list of strings with ticker symbols
http://api.example.com/stocks/$symbol // Stock object
http://api.example.com/stocks/$symbol/prices // PriceHistory<Stock> object
http://api.example.com/currencies // ResponseWrapper<String> object containing a
// list of currency abbreviation
http://api.example.com/currencies/$currency // Currency object
http://api.example.com/currencies/$id1/values/$id2 // PriceHistory<Currency> object comparing the prices
// of the first currency (id1) to the second (id2)
从广场改装
对于具有多个端点的API来说,这是一个很好的选择,它允许您声明REST端点,而不必像其他库(如AmazonIonJava或Volley(网站:改装))那样单独对它们进行编码。
如何将其与财务API一起使用?
文件build.gradle
将这些行添加到模块级build.gradle文件中:
implementation 'com.squareup.retrofit2:retrofit:2.3.0' // Retrofit library, current as of September 21, 2017
implementation 'com.squareup.retrofit2:converter-gson:2.3.0' // Gson serialization and deserialization support for retrofit, version must match retrofit version
文件Financeapi.java
public interface FinancesApi {
@GET("stocks")
Call<ResponseWrapper<String>> listStocks();
@GET("stocks/{symbol}")
Call<Stock> getStock(@Path("symbol")String tickerSymbol);
@GET("stocks/{symbol}/prices")
Call<PriceHistory<Stock>> getPriceHistory(@Path("symbol")String tickerSymbol);
@GET("currencies")
Call<ResponseWrapper<String>> listCurrencies();
@GET("currencies/{symbol}")
Call<Currency> getCurrency(@Path("symbol")String currencySymbol);
@GET("currencies/{symbol}/values/{compare_symbol}")
Call<PriceHistory<Currency>> getComparativeHistory(@Path("symbol")String currency, @Path("compare_symbol")String currencyToPriceAgainst);
}
类财务PiBuilder
public class FinancesApiBuilder {
public static FinancesApi build(String baseUrl){
return new Retrofit.Builder()
.baseUrl(baseUrl)
.addConverterFactory(GsonConverterFactory.create())
.build()
.create(FinancesApi.class);
}
}
类FinanceFragment代码段
FinancesApi api = FinancesApiBuilder.build("http://api.example.com/"); //trailing '/' required for predictable behavior
api.getStock("INTC").enqueue(new Callback<Stock>(){
@Override
public void onResponse(Call<Stock> stockCall, Response<Stock> stockResponse){
Stock stock = stockCall.body();
// Do something with the stock
}
@Override
public void onResponse(Call<Stock> stockCall, Throwable t){
// Something bad happened
}
}
如果您的API需要发送API密钥或其他标头(如用户令牌等),则“改装”会使此操作变得简单(有关详细信息,请参阅“改装”中添加标头参数的精彩答案)。
一次性REST API访问
假设你正在构建一个“情绪天气”应用程序,它可以查找用户的GPS位置,并检查该区域的当前温度,然后告诉他们情绪。这种类型的应用程序不需要声明API端点;它只需要能够访问一个API端点。
Ion
这是一个非常适合这种访问的库。
请阅读msysmilu对如何修复“android.os.NetworkOnMainThreadException”的精彩回答?。
通过HTTP加载图像
截击
Volley也可以用于RESTAPI,但由于需要更复杂的设置,我更喜欢使用如上所述的来自Square的改装。
假设您正在构建一个社交网络应用程序,并希望加载朋友的个人资料图片。
文件build.gradle
将此行添加到模块级build.gradle文件中:
implementation 'com.android.volley:volley:1.0.0'
文件ImageFetch.java
Volley需要比改装更多的设置。您需要创建一个这样的类来设置RequestQueue、ImageLoader和ImageCache,但这并不太糟糕:
public class ImageFetch {
private static ImageLoader imageLoader = null;
private static RequestQueue imageQueue = null;
public static ImageLoader getImageLoader(Context ctx){
if(imageLoader == null){
if(imageQueue == null){
imageQueue = Volley.newRequestQueue(ctx.getApplicationContext());
}
imageLoader = new ImageLoader(imageQueue, new ImageLoader.ImageCache() {
Map<String, Bitmap> cache = new HashMap<String, Bitmap>();
@Override
public Bitmap getBitmap(String url) {
return cache.get(url);
}
@Override
public void putBitmap(String url, Bitmap bitmap) {
cache.put(url, bitmap);
}
});
}
return imageLoader;
}
}
文件user_view_dialog.xml
将以下内容添加到布局XML文件中以添加图像:
<com.android.volley.toolbox.NetworkImageView
android:id="@+id/profile_picture"
android:layout_width="32dp"
android:layout_height="32dp"
android:layout_alignParentTop="true"
android:layout_centerHorizontal="true"
app:srcCompat="@android:drawable/spinner_background"/>
文件UserViewDialog.java
将以下代码添加到onCreate方法(Fragment,Activity)或构造函数(Dialog):
NetworkImageView profilePicture = view.findViewById(R.id.profile_picture);
profilePicture.setImageUrl("http://example.com/users/images/profile.jpg", ImageFetch.getImageLoader(getContext());
毕加索
毕加索是另一个来自广场的优秀图书馆。请查看网站以了解一些很棒的示例。