Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 81e46d92 authored by Philip P. Moltmann's avatar Philip P. Moltmann
Browse files

Doc that SharedPreferences is IO-expensive 

Tried to find the right middle ground in between
- not exposing potentially changing implementation details
- being clear on what it is for and what not
- being too alarmist vs. being to weak

Test: compiled
Bug: 69177691
Change-Id: Ifb40e350a18bf72c113229f31e129b7e8fdacd2a
parent 6322e778

core/java/android/content/SharedPreferences.java

+5 −0
Original line number Diff line number Diff line
@@ -30,6 +30,11 @@ import java.util.Set; 
 * when they are committed to storage.  Objects that are returned from the

 * various <code>get</code> methods must be treated as immutable by the application.

 *

 * <p>Note: This class provides strong consistency guarantees. It is using expensive operations

 * which might slow down an app. Frequently changing properties or properties where loss can be

 * tolerated should use other mechanisms. For more details read the comments on

 * {@link Editor#commit()} and {@link Editor#apply()}.

 *

 * <p><em>Note: This class does not support use across multiple processes.</em>

 *

 * <div class="special reference">