ComponentCallbacks.javaAPI DocAndroid 5.1 API3193Thu Mar 12 22:22:10 GMT 2015android.content


public interface ComponentCallbacks
The set of callback APIs that are common to all application components ({@link}, {@link}, {@link ContentProvider}, and {@link}).

Note: You should also implement the {@link ComponentCallbacks2} interface, which provides the {@link ComponentCallbacks2#onTrimMemory} callback to help your app manage its memory usage more effectively.

Fields Summary
Constructors Summary
Methods Summary
public voidonConfigurationChanged(android.content.res.Configuration newConfig)
Called by the system when the device configuration changes while your component is running. Note that, unlike activities, other components are never restarted when a configuration changes: they must always deal with the results of the change, such as by re-retrieving resources.

At the time that this function has been called, your Resources object will have been updated to return resource values matching the new configuration.

For more information, read Handling Runtime Changes.

newConfig The new device configuration.

public voidonLowMemory()
This is called when the overall system is running low on memory, and actively running processes should trim their memory usage. While the exact point at which this will be called is not defined, generally it will happen when all background process have been killed. That is, before reaching the point of killing processes hosting service and foreground UI that we would like to avoid killing.

You should implement this method to release any caches or other unnecessary resources you may be holding on to. The system will perform a garbage collection for you after returning from this method.

Preferably, you should implement {@link ComponentCallbacks2#onTrimMemory} from {@link ComponentCallbacks2} to incrementally unload your resources based on various levels of memory demands. That API is available for API level 14 and higher, so you should only use this {@link #onLowMemory} method as a fallback for older versions, which can be treated the same as {@link ComponentCallbacks2#onTrimMemory} with the {@link ComponentCallbacks2#TRIM_MEMORY_COMPLETE} level.