Package org.robolectric.shadows

Class ShadowServiceManager

java.lang.Object

org.robolectric.shadows.ShadowServiceManager

@Implements(value=android.os.ServiceManager.class,
            isInAndroidSdk=false)
public class ShadowServiceManager
extends Object

Shadow for ServiceManager.

Field Summary

Fields

Modifier and Type	Field	Description
protected static final Map<String,org.robolectric.shadows.ShadowServiceManager.BinderService>	binderServices

Constructor Summary

Constructors

Constructor	Description
ShadowServiceManager()

Method Summary

Modifier and Type	Method	Description
static void	addBinderService(String name, Class<? extends IInterface> clazz, IInterface service)
protected static void	addBinderService(Map<String,org.robolectric.shadows.ShadowServiceManager.BinderService> binderServices, String name, Class<? extends IInterface> clazz)
protected static void	addService(String name, IBinder service)
protected static IBinder	checkService(String name)	Same as getService(java.lang.String).
protected static IBinder	getService(String name)	Returns the IBinder associated with the given system service.
protected static void	initServiceCache(Map<String,IBinder> cache)
protected static boolean	isDeclared(String name)	Returns whether the specified service is declared.
protected static String[]	listServices()
static void	reset()
static void	setServiceAvailability(String service, boolean available)	Sets the availability of the given system service.
static void	setServiceDeclaredOrNot(String name, boolean declared)	Sets the declared status of the given system service.
protected static IBinder	waitForDeclaredService(String name)	Returns the IBinder associated with the given declared system service.
protected static IBinder	waitForService(String name)	Returns the IBinder associated with the given system service.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

binderServices

protected static final Map<String,org.robolectric.shadows.ShadowServiceManager.BinderService> binderServices

Constructor Details

ShadowServiceManager

public ShadowServiceManager()

Method Details

addBinderService

protected static void addBinderService(Map<String,org.robolectric.shadows.ShadowServiceManager.BinderService> binderServices,
 String name,
 Class<? extends IInterface> clazz)

addBinderService

public static void addBinderService(String name,
 Class<? extends IInterface> clazz,
 IInterface service)

getService

@Implementation
protected static IBinder getService(String name)

Returns the IBinder associated with the given system service. If the given service is set to unavailable in setServiceAvailability(java.lang.String, boolean), null will be returned.

addService

@Implementation
protected static void addService(String name,
 IBinder service)

checkService

@Implementation
protected static IBinder checkService(String name)

Same as getService(java.lang.String).

The real implementation of checkService(java.lang.String) differs from getService(java.lang.String) in that it is not a blocking call; so it is more likely to return null in cases where the service isn't available (whereas getService(java.lang.String) will block until it becomes available, until a timeout or error happens).

waitForService

@Implementation(minSdk=30)
protected static IBinder waitForService(String name)
                                 throws InterruptedException

Returns the IBinder associated with the given system service. If the given service is set to unavailable in setServiceAvailability(java.lang.String, boolean), the method will block until the service becomes available or the thread is interrupted.

Throws:

InterruptedException

waitForDeclaredService

@Implementation(minSdk=30)
@Nullable
protected static IBinder waitForDeclaredService(String name)
                                         throws InterruptedException

Returns the IBinder associated with the given declared system service. If the given service is set to unavailable in setServiceAvailability(java.lang.String, boolean), the method will block until the service becomes available or the thread is interrupted.

If the given service is not declared, null will be returned immediately.

Throws:

InterruptedException

isDeclared

@Implementation(minSdk=30)
protected static boolean isDeclared(String name)

Returns whether the specified service is declared. Can use setServiceDeclaredOrNot(java.lang.String, boolean) to set the declared status of a service.

listServices

@Implementation
protected static String[] listServices()
                                throws RemoteException

Throws:

RemoteException

initServiceCache

@Implementation
protected static void initServiceCache(Map<String,IBinder> cache)

setServiceAvailability

public static void setServiceAvailability(String service,
 boolean available)

Sets the availability of the given system service. If the service is set as unavailable, subsequent calls to Context.getSystemService(java.lang.String) for that service will return null. When a service is set as available, any threads waiting for the service caused by waitForService(String) will be notified and woken up.

A service is considered available by default.

setServiceDeclaredOrNot

public static void setServiceDeclaredOrNot(String name,
 boolean declared)

Sets the declared status of the given system service. If the service is set as not declared, subsequent calls to isDeclared(java.lang.String) for that service will return false.

A service is considered not declared by default.

reset

@Resetter
public static void reset()