AbstractPreferences Класс

Определение

Пространство имен:

Java.Util.Prefs

Сборка:

Mono.Android.dll

Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации.

[Android.Runtime.Register("java/util/prefs/AbstractPreferences", DoNotGenerateAcw=true)]
public abstract class AbstractPreferences : Java.Util.Prefs.Preferences

[<Android.Runtime.Register("java/util/prefs/AbstractPreferences", DoNotGenerateAcw=true)>]
type AbstractPreferences = class
    inherit Preferences

Наследование

Object

JavaObject

Object

Preferences

AbstractPreferences

Атрибуты

RegisterAttribute

Комментарии

Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации.

<strong>Этот класс предназначен только для Preferences разработчиков. Обычные Preferences пользователи объекта не должны обращаться к этой документации. Документация должна быть достаточной Preferences .</strong>

Реализующие должны переопределить девять абстрактных методов интерфейса поставщика услуг: #getSpi(String), #putSpi(String,String), #removeSpi(String), #childSpi(String), #removeNodeSpi()#keysSpi(), и #childrenNamesSpi(). #syncSpi()#flushSpi() Все конкретные методы указывают точно, как они реализуются на основе этих методов SPI. Разработчик может переопределить один или несколько конкретных методов, если реализация по умолчанию не является неудовлетворительной по какой-либо причине, например производительность.

Методы SPI делятся на три группы, касающиеся поведения исключений. Метод getSpi никогда не должен вызывать исключения, но это не имеет значения, так как любое исключение, вызываемое этим методом, будет перехвачено #get(String,String), что вернет указанное значение по умолчанию вызывающему объекту. removeNodeSpi, keysSpi, childrenNamesSpi, syncSpi Методы flushSpi указываются для вызоваBackingStoreException, и реализация требуется для вызова этого проверенного исключения, если не удается выполнить операцию. Исключение распространяется наружу, что приводит к сбою соответствующего метода API.

Остальные методы #putSpi(String,String)#removeSpi(String) SPI и #childSpi(String) более сложное поведение исключений. Они не указываются, чтобы бросать BackingStoreException, так как они могут, как правило, подчиняться своим контрактам, даже если резервное хранилище недоступно. Это верно, поскольку они не возвращают информацию, и их последствия не требуются для того, чтобы стать постоянным до последующего вызова Preferences#flush() или Preferences#sync(). Как правило, эти методы SPI не должны вызывать исключения. В некоторых реализациях могут возникнуть обстоятельства, при которых эти вызовы даже не могут запросить запрошенную операцию для последующей обработки. Даже в этих обстоятельствах, как правило, лучше просто игнорировать вызов и возврат, а не вызывать исключение. Однако в этих обстоятельствах все последующие вызовы flush() и sync должны возвращаться false, так как возврат true будет означать, что все предыдущие операции успешно были созданы постоянно.

Существует одно из обстоятельств, при котором putSpi, removeSpi and childSpiследует вызвать исключение: если вызывающий не имеет достаточных привилегий в базовой операционной системе для выполнения запрошенной операции. Это, например, происходит в большинстве систем, если пользователь, не допускающий привилегий, пытается изменить системные предпочтения. (Требуемые привилегии будут отличаться от реализации к реализации. В некоторых реализациях они имеют право изменять содержимое определенного каталога в файловой системе; на других они имеют право изменять содержимое некоторых разделов в реестре.) В любом из этих обстоятельств, как правило, нежелательно позволить программе продолжать выполняться, как если бы эти операции стали постоянными в дальнейшем. Хотя реализации не требуются для создания исключения в этих обстоятельствах, им рекомендуется сделать это. Было SecurityException бы уместно.

Большинство методов SPI требуют реализации для чтения или записи сведений на узле параметров. Средство реализации должно помешать тому факту, что другая виртуальная машина может одновременно удалить этот узел из резервного хранилища. Реализация несет ответственность за повторное создание узла, если он был удален.

Примечание о реализации. В реализациях Sun по умолчанию Preferences удостоверение пользователя наследуется от базовой операционной системы и не изменяется на время существования виртуальной машины. Признается, что реализация на стороне Preferences сервера может изменить удостоверение пользователя от запроса к запросу, неявно передаваемое Preferences методам с помощью статического ThreadLocal экземпляра. Авторы таких реализаций настоятельно рекомендуется определить пользователя во время доступа к предпочтениям (например, по #get(String,String) методу), #put(String,String) а не постоянно связывать пользователя с каждым Preferences экземпляром. Последнее поведение конфликтует с обычным Preferences использованием и приведет к большой путанице.

Добавлено в версии 1.4.

Java документации по java.util.prefs.AbstractPreferences.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Конструкторы

Имя	Описание
AbstractPreferences(AbstractPreferences, String)	Создает узел предпочтения с указанным родительским и указанным именем относительно родительского элемента.
AbstractPreferences(IntPtr, JniHandleOwnership)	Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения.

Поля

Имя	Описание
MaxKeyLength	Максимальная длина строки, разрешенная в качестве ключа (80 символов). (Унаследовано от Preferences)
MaxNameLength	Максимальная длина имени узла (80 символов). (Унаследовано от Preferences)
MaxValueLength	Максимальная длина строки, разрешенная в качестве значения (8192 символов). (Унаследовано от Preferences)

Свойства

Имя	Описание
Class	Возвращает класс среды выполнения этого Objectобъекта. (Унаследовано от Object)
Handle	Дескриптор базового экземпляра Android. (Унаследовано от Object)
IsRemoved	Возвращает true iff этот узел (или предок) удален с #removeNode() помощью метода.
IsUserNode	isUserNode Реализует метод согласно спецификацииPreferences#isUserNode().
JniIdentityHashCode	Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object)
JniManagedPeerState	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
JniPeerMembers	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
Lock	Объект, монитор которого используется для блокировки этого узла.
NewNode	Это поле должно быть true , если этот узел не существовал в резервном хранилище до создания этого объекта.
PeerReference	Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object)
ThresholdClass	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.
ThresholdType	Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода.

Методы

Имя	Описание
AbsolutePath()	absolutePath Реализует метод согласно спецификацииPreferences#absolutePath().
AddNodeChangeListener(INodeChangeListener)	NodeChangeListener Регистрирует экземпляр для этого узла, который будет обрабатывать NodeChangeEvents.
AddPreferenceChangeListener(IPreferenceChangeListener)	PreferenceChangeListener Регистрирует экземпляр для этого узла, который будет обрабатывать PreferenceChangeEvents.
CachedChildren()	Возвращает все известные дочерние элементы этого узла.
ChildrenNames()	children Реализует метод согласно спецификацииPreferences#childrenNames().
ChildrenNamesSpi()	Возвращает имена дочерних элементов этого узла предпочтения.
ChildSpi(String)	Возвращает именованный дочерний узел этого предпочтительного узла, создав его, если он еще не существует.
Clear()	clear Реализует метод согласно спецификацииPreferences#clear().
Clone()	Создает и возвращает копию этого объекта. (Унаследовано от Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
Dispose()	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
Dispose(Boolean)	Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object)
DisposeUnlessReferenced()	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
Equals(Object)	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
Equals(Object)	Указывает, равен ли другой объект этому объекту. (Унаследовано от Object)
ExportNode(Stream)	exportNode Реализует метод согласно спецификацииPreferences#exportNode(OutputStream).
ExportNodeAsync(Stream)	Асинхронно выдает XML-документ, представляющий все предпочтения, содержащиеся в этом узле, но не его потомки. (Унаследовано от Preferences)
ExportSubtree(Stream)	exportSubtree Реализует метод согласно спецификацииPreferences#exportSubtree(OutputStream).
ExportSubtreeAsync(Stream)	Асинхронно выдает XML-документ, представляющий все предпочтения, содержащиеся в этом узле, и все его потомки. (Унаследовано от Preferences)
Flush()	flush Реализует метод согласно спецификацииPreferences#flush().
FlushAsync()	Асинхронно заставляет все изменения в этом узле предпочтения и его потомках в постоянное хранилище. (Унаследовано от Preferences)
FlushSpi()	Этот метод вызывается с заблокированным этим узлом.
Get(String, String)	get Реализует метод согласно спецификацииPreferences#get(String,String).
GetBoolean(String, Boolean)	getBoolean Реализует метод согласно спецификацииPreferences#getBoolean(String,boolean).
GetByteArray(String, Byte[])	getByteArray Реализует метод согласно спецификацииPreferences#getByteArray(String,byte[]).
GetChild(String)	Возвращает именованный дочерний элемент, если он существует, или null если он не существует.
GetDouble(String, Double)	getDouble Реализует метод согласно спецификацииPreferences#getDouble(String,double).
GetFloat(String, Single)	getFloat Реализует метод согласно спецификацииPreferences#getFloat(String,float).
GetHashCode()	Возвращает значение хэш-кода для объекта. (Унаследовано от Object)
GetInt(String, Int32)	getInt Реализует метод согласно спецификацииPreferences#getInt(String,int).
GetLong(String, Int64)	getLong Реализует метод согласно спецификацииPreferences#getLong(String,long).
GetSpi(String)	Возвращает значение, связанное с указанным ключом на этом узле предпочтения, или если для этого ключа нет связи, или null связь не может быть определена в данный момент.
JavaFinalize()	Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object)
Keys()	keys Реализует метод согласно спецификацииPreferences#keys().
KeysSpi()	Возвращает все ключи, имеющие связанное значение в этом узле предпочтения.
Name()	name Реализует метод согласно спецификацииPreferences#name().
Node(String)	node Реализует метод согласно спецификацииPreferences#node(String).
NodeExists(String)	nodeExists Реализует метод согласно спецификацииPreferences#nodeExists(String).
Notify()	Пробуждение одного потока, ожидающего монитора этого объекта. (Унаследовано от Object)
NotifyAll()	Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object)
Parent()	parent Реализует метод согласно спецификацииPreferences#parent().
Put(String, String)	put Реализует метод согласно спецификацииPreferences#put(String,String).
PutBoolean(String, Boolean)	putBoolean Реализует метод согласно спецификацииPreferences#putBoolean(String,boolean).
PutByteArray(String, Byte[])	putByteArray Реализует метод согласно спецификацииPreferences#putByteArray(String,byte[]).
PutDouble(String, Double)	putDouble Реализует метод согласно спецификацииPreferences#putDouble(String,double).
PutFloat(String, Single)	putFloat Реализует метод согласно спецификацииPreferences#putFloat(String,float).
PutInt(String, Int32)	putInt Реализует метод согласно спецификацииPreferences#putInt(String,int).
PutLong(String, Int64)	putLong Реализует метод согласно спецификацииPreferences#putLong(String,long).
PutSpi(String, String)	Поместите заданное сопоставление "ключ-значение" в этот узел предпочтения.
Remove(String)	remove(String) Реализует метод согласно спецификацииPreferences#remove(String).
RemoveNode()	removeNode() Реализует метод согласно спецификацииPreferences#removeNode().
RemoveNodeChangeListener(INodeChangeListener)	Удаляет заданный NodeChangeListener экземпляр из этого узла.
RemoveNodeSpi()	Удаляет этот узел предпочтения, недействив его и все параметры, содержащиеся в нем.
RemovePreferenceChangeListener(IPreferenceChangeListener)	Удаляет заданный PreferenceChangeListener экземпляр из этого узла.
RemoveSpi(String)	Удалите связь (при наличии) для указанного ключа на этом узле предпочтения.
SetHandle(IntPtr, JniHandleOwnership)	Задает свойство Handle. (Унаследовано от Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
Sync()	sync Реализует метод согласно спецификацииPreferences#sync().
SyncAsync()	Асинхронно синхронизирует этот узел предпочтения и его потомки с постоянным хранилищем. (Унаследовано от Preferences)
SyncSpi()	Этот метод вызывается с заблокированным этим узлом.
ToArray<T>()	Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object)
ToString()	Возвращает строковое представление этого узла параметров.
UnregisterFromRuntime()	Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object)
Wait()	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>помощи уведомления</em> или <эм>прерванного</em>. (Унаследовано от Object)
Wait(Int64, Int32)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)
Wait(Int64)	Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object)

Явные реализации интерфейса

Имя	Описание
IJavaPeerable.Disposed()	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
IJavaPeerable.Finalized()	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации. (Унаследовано от JavaObject)

Методы расширения

Имя	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра self.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типуself, проверяяTResult, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Этот класс обеспечивает скелетную реализацию Preferences класса, значительно упрощая задачу его реализации.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типуself, проверяяTResult, является ли приведение допустимым на стороне Java.