在 Android 和 Java 上复制 Swift 完成处理程序

Question

多年后，我正在尝试使用 Firebase Firestore 开发 Android 应用程序。我基本上是在尝试复制这个 Swift 函数：

func getCategories(onCompletion completionBlock: @escaping (_ categories: [Category]?, _ error: Error?) -> Void) {

  firestore.collection("cats").getDocuments { (snap, error) in
    guard let snap = snap else {
      completionBlock(nil, error ?? anUnknownError)
      return
    }

    var categories: [Category] = []
    for document in snap.documents {
        let cat = Category.init(data: document.data())
        categories.append(cat)
    }
    completionBlock(categories, nil)
  }
}

但是我不知道 swift 的块的等价物是什么，甚至不知道它是否存在。

我检查了 Firebase 源代码。Query.get()返回Task<QuerySnapshot>所以我试图返回一个Task<List<Category>>没有运气。

任何帮助？谢谢你。

编辑：添加了 Android 代码以阐明我正在尝试做什么。

public class FirestoreService {

    private static volatile FirestoreService singleton = new FirestoreService();

    public static FirestoreService getInstance() {
        return singleton;
    }

    private FirebaseFirestore firestore() {
        // default firestore instance
        FirebaseFirestore db = FirebaseFirestore.getInstance();

        // default firestore settings
        FirebaseFirestoreSettings settings = db.getFirestoreSettings();

        // firestore settings builder
        FirebaseFirestoreSettings.Builder builder = new FirebaseFirestoreSettings.Builder(settings);

        // enable timstamps
        builder.setTimestampsInSnapshotsEnabled(true);

        // set new settings to db instance
        db.setFirestoreSettings(builder.build());


        // return db with new settings.
        return db;
    }



    public void getProductCategories(Handler? handler) {

       Task<QuerySnapshot> task = firestore().collection("coll").get();
       task.addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() {
        @Override
        public void onComplete(@NonNull Task<QuerySnapshot> task) {
            try {
                if (task.isSuccessful()) {
                    List<Category> cats = new ArrayList<>();
                    for (QueryDocumentSnapshot doc : task.getResult()) {
                        String id = doc.getId();
                        Map<String, Object> data = doc.getData();
                        Category cat = new Category(id, data);
                        cats.add(cat);
                    }
                    // now I need completion handler
                } else {
                    Log.w("ERROR", "Error getting categories", task.getException());
                }
            } catch (Exception e) {
                Log.e("ERROR", e.getMessage());
            }
        }
    });
    }

}



public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        FirestoreService.getInstance().getCategories().addCompletionListener(
            // handle List<Category> and respresent in UI
        );
    }
}

Answer 1

非常感谢您的帮助和领导@Daniel-b。

我现在已经解决了我的问题。

首先，我创建了一个用于处理结果的接口；正如你所建议的。

public interface ResultHandler<T> {
    void onSuccess(T data);
    void onFailure(Exception e);
}

然后在服务类中，我将 ResultHandler 添加到函数的输入参数中：

public void getUserInfo(String id, ResultHandler<UserInfo> handler) {
    firestore().collection("userInfo").document(id).get().addOnCompleteListener(snap -> {
        if (snap.isSuccessful()) {
           try {
               // failable constructor. use try-catch
               UserInfo info = new UserInfo(snap.getResult().getId(), snap.getResult().getData());
               handler.onSuccess(info);
           } catch (Exception e) {
                handler.onFailure(e);
           }
        } else {
            handler.onFailure(snap.getException())
        }
    });
}

并在活动中调用服务

FirestoreService.getInstance().getUserInfo("ZsrAdsG5HVYLTZDBeZtkGDlIBW42", new ResultHandler<UserInfo>() {
    @Override
    public void onSuccess(UserInfo data) {
        Log.i("UserInfo", data.id);                    
    }

    @Override
    public void onFailure(Exception e) {
        // getting data failed for some reason
    }
});

Answer 2

使用异步任务

您可以使用AsyncTask. 它有 3 个步骤。

1.- onPreExecute()跑步前你想做的事情doInBackground()。这发生在UI 主线程中。

2. doInBackground() - AsyncTask，将在后台线程中执行操作（后台线程是由Android创建的，所以你不需要担心它）。

3.onPostExecute() - 在这里您可以从 doInBackground 方法接收任何数据。postExecute 方法在 UI 主线程中再次执行。

因此，您可以在 , 中执行任何 I/O 操作doInBackground()，并返回从服务器或任何其他数据源收到的值，并且onPostExecute(), 相当于 swift 中的完成块。

如何申报

要使用AsyncTask，您需要扩展Android AsyncTask。

所以你自己的 AsyncTask 声明将如下所示：

private class MyAsyncTask extends AsyncTask<Void, Void, Void> { ... }

您问的 3 个通用论点是什么？

1. Params - 执行时发送到任务的参数类型。

2. 进度-后台计算期间发布的进度单位的类型。（几乎总是Void，除非您关心操作的实际进度。请注意，这是Void大写字母，而不是 void返回类型）。

3. Result——后台计算结果的类型。

完整示例

private class LongOperation extends AsyncTask<String, Void, String> {

        @Override
        protected String doInBackground(String... params) {
            for (int i = 0; i < 5; i++) {
                try {
                    Thread.sleep(1000);
                } catch (InterruptedException e) {
                    Thread.interrupted();
                }
            }
            return "Executed";
        }

        @Override
        protected void onPostExecute(String result) {
            TextView txt = findViewById(R.id.output);
            txt.setText(result); 
        }
    }

在示例中，我创建了一个假的长操作，您无法在 UI 主线程上运行该操作（因为它是一个阻塞操作）。

当操作完成时，它返回一个String，并且在方法中接收到相同的值 （记住，再次在 UI 主线程上运行）。因此，您可以使用从长阻塞操作收到的字符串值更改您的 UI。StringonPostExecute()onPostExecute()

如果您想要文档，这里是：

https://developer.android.com/reference/android/os/AsyncTask

使用观察者模式

您还可以根据您的情况使用观察者模式。

创建一个具有方法的接口onSuccess().让一个对象实现该接口，并且无论何时需要它，都可以调用该onSuccess()方法。

例子：

public Interface SuccessInterface{
   void onSuccess()
}

public class SuccessHandler implements SuccessInterface{
   public void onSuccess(){
         //success code goes here
   }

}

然后在您的代码中进行SucessHandler实例化，并onSuccess()在需要时调用。