Merge "Add a comment about ResultReceiver lifetime." into nyc-dev (b8a95d2c) · Commits · e / os / android_frameworks_base

core/java/android/view/inputmethod/InputMethodManager.java

+22 −2

Original line number	Diff line number	Diff line
		@@ -976,6 +976,16 @@ public final class InputMethodManager {
		* your view in such a way that they have expressed they would like to
		* start performing input into it.
		*
		* <p><strong>Caveat:</strong> {@link ResultReceiver} instance passed to
		* this method can be a long-lived object, because it may not be
		* garbage-collected until all the corresponding {@link ResultReceiver}
		* objects transferred to different processes get garbage-collected.
		* Follow the general patterns to avoid memory leaks in Android.
		* Consider to use {@link java.lang.ref.WeakReference} so that application
		* logic objects such as {@link android.app.Activity} and {@link Context}
		* can be garbage collected regardless of the lifetime of
		* {@link ResultReceiver}.
		*
		* @param view The currently focused view, which would like to receive
		* soft keyboard input.
		* @param flags Provides additional operating flags. Currently may be
		@@ -1045,6 +1055,16 @@ public final class InputMethodManager {
		* of the user doing some actually than fairly explicitly requests to
		* have the input window hidden.
		*
		* <p><strong>Caveat:</strong> {@link ResultReceiver} instance passed to
		* this method can be a long-lived object, because it may not be
		* garbage-collected until all the corresponding {@link ResultReceiver}
		* objects transferred to different processes get garbage-collected.
		* Follow the general patterns to avoid memory leaks in Android.
		* Consider to use {@link java.lang.ref.WeakReference} so that application
		* logic objects such as {@link android.app.Activity} and {@link Context}
		* can be garbage collected regardless of the lifetime of
		* {@link ResultReceiver}.
		*
		* @param windowToken The token of the window that is making the request,
		* as returned by {@link View#getWindowToken() View.getWindowToken()}.
		* @param flags Provides additional operating flags. Currently may be