chromium/content/browser/android/selection/smart_selection_client.h

// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CONTENT_BROWSER_ANDROID_SELECTION_SMART_SELECTION_CLIENT_H_
#define CONTENT_BROWSER_ANDROID_SELECTION_SMART_SELECTION_CLIENT_H_

#include <jni.h>

#include <string>

#include "base/android/jni_weak_ref.h"
#include "base/memory/raw_ptr.h"
#include "base/memory/weak_ptr.h"

namespace content {

class WebContents;

// The native portion of Java SmartSelectionClient.
// This class performs one operation: retrieves the selected text together with
// its surrounding context from WebContents. This surrounding text is obtained
// asynchronously from the current focused frame and passed back to Java layer.
class SmartSelectionClient {
 public:
  SmartSelectionClient(JNIEnv* env,
                       const base::android::JavaRef<jobject>& obj,
                       WebContents* web_contents);

  SmartSelectionClient(const SmartSelectionClient&) = delete;
  SmartSelectionClient& operator=(const SmartSelectionClient&) = delete;

  ~SmartSelectionClient();

  // Sends asynchronius request to retrieve the text.
  void RequestSurroundingText(JNIEnv* env,
                              const base::android::JavaParamRef<jobject>& obj,
                              int num_extra_characters,
                              int callback_data);

  // Cancels all pending requests.
  void CancelAllRequests(JNIEnv* env,
                         const base::android::JavaParamRef<jobject>& obj);

 private:
  void OnSurroundingTextReceived(int callback_data,
                                 const std::u16string& text,
                                 uint32_t start,
                                 uint32_t end);

  // A weak reference to the Java ContentSelectionClient object.
  JavaObjectWeakGlobalRef java_ref_;

  // WebContents is used to find the relevant RenderFrameHost that can send
  // the request for the text.
  raw_ptr<WebContents> web_contents_;

  base::WeakPtrFactory<SmartSelectionClient> weak_ptr_factory_{this};
};

}  // namespace content

#endif  // CONTENT_BROWSER_ANDROID_SELECTION_SMART_SELECTION_CLIENT_H_