Android Photo App

minio_ANDROID1

本示例将会指导你如何构建一个简单的Android Photo app。在这个app中，你将会学习一个Android client是如何访问Photo API Service并随机加载一张图片。你可以通过这里获取完整的代码，代码是以Apache 2.0 License发布的。

1. 依赖

我们将使用Android Studio进行开发。这个app也会访问我们发布的Photo API Service来随机获取一张图片的presigned url。

  • Android Studio

  • JDK 1.8

    2. 设置

  • 步骤1 - 启动Android Studio -> New Project -> Create a new Android Project。将你的工程命名为AndroidPhotoApp。
    minio_ANDROID2

  • 步骤2 - 选择Phone & Tablet。在本示例中，我们选择Marshmallow Android 6.0 SDK来编译和构建这个app。
    minio_ANDROID3

  • 步骤3 - 选择一个Blank或者Basic Activity模板，然后点击Next。
    minio_ANDROID4

  • 步骤4 - 不用修改Activity Name和Layout Name,直接点击Finish。
    minio_ANDROID5

  • 步骤5 - 你应该可以看见gradle进行build并创建了一个工程，现在我们可以开始敲代码了。
    minio_ANDROID6

3. App Layout

删除初始的Hello World TextView。

  • 拖拽一个Button widget到content_main.xml。
  • 从Layouts（在palette下面）里拖拽一个FrameLayout。
  • 然后从widgets中拖拽一个imageView到刚才的FrameLayout中。
    minio_ANDROID7

下面就是content_main.xml的完整xml。 

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
  3.     xmlns:app="http://schemas.android.com/apk/res-auto"
  4.     xmlns:tools="http://schemas.android.com/tools"
  5.     android:layout_width="match_parent"
  6.     android:layout_height="match_parent"
  7.     app:layout_behavior="@string/appbar_scrolling_view_behavior"
  8.     tools:context="examples.minio.com.androidphotoapp.MainActivity"
  9.     tools:showIn="@layout/activity_main">
  11.     <Button
  12.         android:id="@+id/button"
  13.         android:layout_width="wrap_content"
  14.         android:layout_height="wrap_content"
  15.         android:text="Button"
  16.         tools:layout_constraintTop_creator="1"
  17.         tools:layout_constraintRight_creator="1"
  18.         app:layout_constraintRight_toRightOf="parent"
  19.         android:layout_marginTop="16dp"
  20.         tools:layout_constraintLeft_creator="1"
  21.         app:layout_constraintLeft_toLeftOf="parent"
  22.         app:layout_constraintTop_toTopOf="parent" />
  24.     <FrameLayout
  25.         android:layout_width="0dp"
  26.         android:layout_height="308dp"
  27.         tools:layout_constraintTop_creator="1"
  28.         tools:layout_constraintRight_creator="1"
  29.         android:layout_marginStart="36dp"
  30.         android:layout_marginEnd="36dp"
  31.         app:layout_constraintRight_toRightOf="parent"
  32.         app:layout_constraintTop_toBottomOf="@+id/button"
  33.         tools:layout_constraintLeft_creator="1"
  34.         app:layout_constraintLeft_toLeftOf="parent">
  36.         <ImageView
  37.             android:id="@+id/imageView"
  38.             android:layout_width="wrap_content"
  39.             android:layout_height="wrap_content"
  40.             app:srcCompat="@android:color/background_light" />
  41.     </FrameLayout>
  43. </android.support.constraint.ConstraintLayout>

4. MainActivity.java

我们将会用到之前构建的Phtoto API Service来给我们的AndroidPhotoApp提供服务。为了简单起见，我们没有用到ListView或者是GridView来显示图片列表，我们只是从PhotoAPI Service返回的多个presigned URL中随机选一个进行加载。

  1. package examples.minio.com.androidphotoapp;
  3. import android.app.ProgressDialog;
  4. import android.graphics.Bitmap;
  5. import android.graphics.BitmapFactory;
  6. import android.os.AsyncTask;
  7. import android.os.Bundle;
  8. import android.support.design.widget.FloatingActionButton;
  9. import android.support.v7.app.AppCompatActivity;
  10. import android.support.v7.widget.Toolbar;
  11. import android.view.Menu;
  12. import android.view.MenuItem;
  13. import android.view.View;
  14. import android.widget.Button;
  15. import android.widget.ImageView;
  16. import android.widget.Toast;
  18. import org.json.JSONArray;
  19. import org.json.JSONObject;
  21. import java.io.BufferedReader;
  22. import java.io.IOException;
  23. import java.io.InputStream;
  24. import java.io.InputStreamReader;
  25. import java.net.HttpURLConnection;
  26. import java.net.URL;
  27. import java.util.Random;
  29. public class MainActivity extends AppCompatActivity {
  31.     Button refreshButton;
  32.     ProgressDialog pDialog;
  33.     private static final String PHOTOSERVICE_URL = "http://play.minio.io:8080/PhotoAPIService-0.0.1-SNAPSHOT/minio/photoservice/list";
  34.     ImageView imageView;
  36.     @Override
  37.     protected void onCreate(Bundle savedInstanceState) {
  38.         super.onCreate(savedInstanceState);
  39.         setContentView(R.layout.activity_main);
  40.         Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
  41.         setSupportActionBar(toolbar);
  43.         //For the sake of simplicity we use an array of images. We recommend using ListViews or GridViews in your real applications.
  44.         imageView = (ImageView) findViewById(R.id.imageView);
  46.         refreshButton = (Button) findViewById(R.id.button);
  48.         FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
  49.         refreshButton.setOnClickListener(new View.OnClickListener() {
  50.             @Override
  51.             public void onClick(View view) {
  52.                 // An async task fetches all the latest photo URLs from the PhotoAPIService.
  53.                 new LoadImage().execute(PHOTOSERVICE_URL);
  54.             }
  55.         });
  56.     }

我们会用一个AsyncTask在后台线程中来获取并处理这些url,而不是在UI线程中，这也是Android开发的惯用方式。

  1. private class LoadImage extends AsyncTask<String, String, Bitmap> {
  3.         @Override
  4.         protected void onPreExecute() {
  5.             super.onPreExecute();
  6.             pDialog = new ProgressDialog(MainActivity.this);
  7.             pDialog.setMessage("Fetching Image from Minio Server....");
  8.             pDialog.show();
  9.         }
  11.         protected Bitmap doInBackground(String... args) {
  12.             InputStream inputStream = null;
  13.             String result = "";
  15.             try {
  16.                 URL url = new URL(args[0]);
  18.                 HttpURLConnection httpCon =
  19.                         (HttpURLConnection) url.openConnection();
  21.                 if (httpCon.getResponseCode() != 200)
  22.                     throw new Exception("Failed to connect");
  24.                 // Fetch the content as an inputStream.
  25.                 inputStream = httpCon.getInputStream();
  27.                 // Convert the fetched inputstream to string.
  28.                 if (inputStream != null)
  29.                     result = convertInputStreamToString(inputStream);
  30.                 else
  31.                     result = "Did not work!";
  33.                 if (result != null) System.out.println(result);
  35.                 // convert String to JSONObject.
  36.                 JSONObject json = new JSONObject(result);
  38.                 // get the array of photos.
  39.                 JSONArray imageJSON = json.getJSONArray("Album");
  40.                 int index = imageJSON.length()-1;
  42.                 Random rand = new Random();
  44.                 // Let's get a randomly pic a picture to load.
  45.                 int rindex = rand.nextInt((index - 0) + 1) + 0;
  48.                 // Return the image.
  49.                 return BitmapFactory.decodeStream(new URL(imageJSON.getJSONObject(rindex).getString("url")).openStream());
  50.             } catch (Exception e) {
  52.                 System.out.println(e.getMessage());
  53.             }
  54.             return null;
  56.         }
  59.         protected void onPostExecute(Bitmap image) {
  60.             System.out.println("In Post Execute");
  61.             if (image != null) {
  62.                 pDialog.dismiss();
  63.                 // Place the image on the ImageView.
  64.                 imageView.setImageBitmap(image);
  66.             } else
  67.             {
  68.                 pDialog.dismiss();
  69.                 Toast.makeText(MainActivity.this, "Image Does Not exist or Network Error", Toast.LENGTH_SHORT).show();
  70.             }
  72.         }
  74.     }

我们用到一个简单的工具方法将InputStream转成String。

  1. private static String convertInputStreamToString(InputStream inputStream) throws IOException{
  3.         BufferedReader bufferedReader = new BufferedReader( new InputStreamReader(inputStream));
  4.         String line = "";
  5.         String result = "";
  7.         // Loop through the stream line by line and convert to a String.
  8.         while((line = bufferedReader.readLine()) != null)
  9.             result += line;
  11.         inputStream.close();
  12.         return result;
  14.     }

5. AndroidManifest.xml

我们需要在AndroidManifest.xml中加上<uses-permission android:name="android.permission.INTERNET" />，这样app才可以通过网络获取图片。

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
  3.     package="examples.minio.com.androidphotoapp">
  5.     <application
  6.         android:allowBackup="true"
  7.         android:icon="@mipmap/ic_launcher"
  8.         android:label="@string/app_name"
  9.         android:roundIcon="@mipmap/ic_launcher_round"
  10.         android:supportsRtl="true"
  11.         android:theme="@style/AppTheme">
  12.         <activity
  13.             android:name=".MainActivity"
  14.             android:label="@string/app_name"
  15.             android:theme="@style/AppTheme.NoActionBar">
  16.             <intent-filter>
  17.                 <action android:name="android.intent.action.MAIN" />
  19.                 <category android:name="android.intent.category.LAUNCHER" />
  20.             </intent-filter>
  21.         </activity>
  22.     </application>
  23.     <uses-permission android:name="android.permission.INTERNET" />
  24. </manifest>

6. 运行App

  • 启动一个Android模拟器或者连接一个Android设备到你的电脑。
  • 请确认你的模拟器/设备的Android版本是6.0+。
  • 点击这个绿色的play按钮部署并运行你的app。
  • 点击Load Random Image Button随机加载一张图片。
    minio_ANDROID8

7. 了解更多

原文: https://docs.minio.io/cn/android-photo-app.html