Add two convenient utility methods for L new API

This CL adds two convenient utility methods for
InputConnection#requestCursorAnchorInfo to encapsulate
a bit complicated parameter construction.

BUG: 16382260
Change-Id: Ib11e3bd15a4edcb602c08ff830b2fb7b34ec00da

java/src/com/android/inputmethod/compat/InputConnectionCompatUtils.java

@@ -16,12 +16,15 @@
 
 package com.android.inputmethod.compat;
 
+import android.util.Log;
 import android.view.inputmethod.InputConnection;
 
 import java.lang.reflect.Constructor;
 import java.lang.reflect.Method;
 
 public final class InputConnectionCompatUtils {
+    private static final String TAG = InputConnectionCompatUtils.class.getSimpleName();
+
     // Note that CursorAnchorInfoRequest is supposed to be available in API level 21 and later.
     private static Class<?> getCursorAnchorInfoRequestClass() {
         try {
@@ -48,23 +51,84 @@ public final class InputConnectionCompatUtils {
     }
 
     /**
-     * A local copy of CursorAnchorInfoRequest.RESULT_NOT_HANDLED until the SDK becomes publicly
+     * Local copies of some constants in CursorAnchorInfoRequest until the SDK becomes publicly
      * available.
      */
-    private final static int CURSOR_ANCHOR_INFO_REQUEST_RESULT_NOT_HANDLED = 0;
+    private final static int RESULT_NOT_HANDLED = 0;
+    private final static int RESULT_SCHEDULED = 1;
+    private final static int TYPE_CURSOR_ANCHOR_INFO = 1;
+    private final static int FLAG_CURSOR_ANCHOR_INFO_MONITOR = 1;
+    private final static int FLAG_CURSOR_ANCHOR_INFO_IMMEDIATE = 2;
+    private final static int TYPE_CURSOR_RECT = 2;
+    private final static int FLAG_CURSOR_RECT_MONITOR = 1;
+    private final static int FLAG_CURSOR_RECT_IN_SCREEN_COORDINATES = 2;
+    private final static int FLAG_CURSOR_RECT_WITH_VIEW_MATRIX = 4;
 
-    public static int requestCursorAnchorInfo(final InputConnection inputConnection,
+    private static int requestCursorAnchorInfoImpl(final InputConnection inputConnection,
             final int type, final int flags) {
         if (!isRequestCursorAnchorInfoAvailable()) {
-             return CURSOR_ANCHOR_INFO_REQUEST_RESULT_NOT_HANDLED;
+             return RESULT_NOT_HANDLED;
         }
         final Object requestObject = CompatUtils.newInstance(
                 CONSTRUCTOR_CursorAnchorInfoRequest, type, flags);
         if (requestObject == null) {
-            return CURSOR_ANCHOR_INFO_REQUEST_RESULT_NOT_HANDLED;
+            return RESULT_NOT_HANDLED;
         }
         return (Integer) CompatUtils.invoke(inputConnection,
-                CURSOR_ANCHOR_INFO_REQUEST_RESULT_NOT_HANDLED /* defaultValue */,
+                RESULT_NOT_HANDLED /* defaultValue */,
                 METHOD_requestCursorAnchorInfo, requestObject);
     }
+
+    /**
+     * Requests the editor to call back {@link InputMethodManager#updateCursorAnchorInfo}.
+     * @param inputConnection the input connection to which the request is to be sent.
+     * @param enableMonitor {@code true} to request the editor to call back the method whenever the
+     * cursor/anchor position is changed.
+     * @param requestImmediateCallback {@code true} to request the editor to call back the method
+     * as soon as possible to notify the current cursor/anchor position to the input method.
+     * @return {@code false} if the request is not handled. Otherwise returns {@code true}.
+     */
+    public static boolean requestCursorAnchorInfo(final InputConnection inputConnection,
+            final boolean enableMonitor, final boolean requestImmediateCallback) {
+        final int requestFlags = (enableMonitor ? FLAG_CURSOR_ANCHOR_INFO_MONITOR : 0)
+                | (requestImmediateCallback ? FLAG_CURSOR_ANCHOR_INFO_IMMEDIATE : 0);
+        final int requestResult = requestCursorAnchorInfoImpl(inputConnection,
+                TYPE_CURSOR_ANCHOR_INFO, requestFlags);
+        switch (requestResult) {
+            case RESULT_NOT_HANDLED:
+                return false;
+            case RESULT_SCHEDULED:
+                return true;
+            default:
+                Log.w(TAG, "requestCursorAnchorInfo returned unknown result=" + requestResult
+                        + " for type=TYPE_CURSOR_ANCHOR_INFO flags=" + requestFlags);
+                return true;
+        }
+    }
+
+    /**
+     * Requests the editor to call back {@link InputMethodManager#updateCursor}.
+     * @param inputConnection the input connection to which the request is to be sent.
+     * @param enableMonitor {@code true} to request the editor to call back the method whenever the
+     * cursor position is changed.
+     * @return {@code false} if the request is not handled. Otherwise returns {@code true}.
+     */
+    public static boolean requestCursorRect(final InputConnection inputConnection,
+            final boolean enableMonitor) {
+        final int requestFlags = enableMonitor ?
+                FLAG_CURSOR_RECT_MONITOR | FLAG_CURSOR_RECT_IN_SCREEN_COORDINATES |
+                FLAG_CURSOR_RECT_WITH_VIEW_MATRIX : 0;
+        final int requestResult = requestCursorAnchorInfoImpl(inputConnection, TYPE_CURSOR_RECT,
+                requestFlags);
+        switch (requestResult) {
+            case RESULT_NOT_HANDLED:
+                return false;
+            case RESULT_SCHEDULED:
+                return true;
+            default:
+                Log.w(TAG, "requestCursorAnchorInfo returned unknown result=" + requestResult
+                        + " for type=TYPE_CURSOR_RECT flags=" + requestFlags);
+                return true;
+        }
+    }
 }