summaryrefslogtreecommitdiff
path: root/android/content/ServiceConnection.java
diff options
context:
space:
mode:
Diffstat (limited to 'android/content/ServiceConnection.java')
-rw-r--r--android/content/ServiceConnection.java17
1 files changed, 17 insertions, 0 deletions
diff --git a/android/content/ServiceConnection.java b/android/content/ServiceConnection.java
index 6ff49002..c16dbbe3 100644
--- a/android/content/ServiceConnection.java
+++ b/android/content/ServiceConnection.java
@@ -63,4 +63,21 @@ public interface ServiceConnection {
*/
default void onBindingDied(ComponentName name) {
}
+
+ /**
+ * Called when the service being bound has returned {@code null} from its
+ * {@link android.app.Service#onBind(Intent) onBind()} method. This indicates
+ * that the attempting service binding represented by this ServiceConnection
+ * will never become usable.
+ *
+ * <p class="note">The app which requested the binding must still call
+ * {@link Context#unbindService(ServiceConnection)} to release the tracking
+ * resources associated with this ServiceConnection even if this callback was
+ * invoked following {@link Context#bindService Context.bindService() bindService()}.
+ *
+ * @param name The concrete component name of the service whose binding
+ * has been rejected by the Service implementation.
+ */
+ default void onNullBinding(ComponentName name) {
+ }
}