AbstractPreferences Clase

Definición

Espacio de nombres:

Java.Util.Prefs

Ensamblado:

Mono.Android.dll

Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla.

[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

Herencia

Object

JavaObject

Object

Preferences

AbstractPreferences

Atributos

RegisterAttribute

Comentarios

Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla.

<strong>Esta clase es solo para Preferences los implementadores. Los usuarios normales de la Preferences instalación no deben tener necesidad de consultar esta documentación. La Preferences documentación debe ser suficiente.</strong>

Los implementadores deben invalidar los nueve métodos abstractos #getSpi(String)de interfaz de proveedor de servicios (SPI): , #putSpi(String,String), #removeSpi(String)#childSpi(String), #removeNodeSpi(), , #keysSpi(), y #childrenNamesSpi()#syncSpi()#flushSpi(). Todos los métodos concretos especifican exactamente cómo se implementan sobre estos métodos SPI. El implementador puede, a su discreción, invalidar uno o varios de los métodos concretos si la implementación predeterminada no es satisfactoria por cualquier motivo, como el rendimiento.

Los métodos SPI se dividen en tres grupos relacionados con el comportamiento de excepción. El getSpi método nunca debe iniciar excepciones, pero realmente no importa, ya que cualquier excepción producida por este método se interceptará mediante #get(String,String), que devolverá el valor predeterminado especificado al autor de la llamada. Los removeNodeSpi, keysSpi, childrenNamesSpi, syncSpi métodos y flushSpi se especifican para iniciar BackingStoreExceptiony la implementación es necesaria para iniciar esta excepción comprobada si no puede realizar la operación. La excepción se propaga hacia fuera, lo que provoca un error en el método de API correspondiente.

Los métodos #putSpi(String,String)#removeSpi(String) SPI restantes y #childSpi(String) tienen un comportamiento de excepción más complicado. No se especifican para iniciar BackingStoreException, ya que generalmente pueden obedecer sus contratos incluso si el almacén de respaldo no está disponible. Esto es cierto porque no devuelven información y sus efectos no son necesarios para convertirse en permanentes hasta una llamada posterior a Preferences#flush() o Preferences#sync(). Por lo general, estos métodos SPI no deben producir excepciones. En algunas implementaciones, puede haber circunstancias en las que estas llamadas ni siquiera pueden poner en cola la operación solicitada para su posterior procesamiento. Incluso en estas circunstancias, generalmente es mejor omitir simplemente la invocación y el retorno, en lugar de iniciar una excepción. Sin embargo, en estas circunstancias, todas las invocaciones posteriores de flush() y deben devolver sync, ya que devolver false implicaría que todas las operaciones anteriores se hubieran realizado correctamente true de forma permanente.

Hay una circunstancia en la que putSpi, removeSpi and childSpise debe producir una excepción: si el autor de la llamada carece de privilegios suficientes en el sistema operativo subyacente para realizar la operación solicitada. Esto, por ejemplo, se producirá en la mayoría de los sistemas si un usuario sin privilegios intenta modificar las preferencias del sistema. (Los privilegios necesarios variarán de la implementación a la implementación. En algunas implementaciones, son el derecho a modificar el contenido de algún directorio en el sistema de archivos; en otros, son el derecho a modificar el contenido de alguna clave en un registro). En cualquiera de estas circunstancias, por lo general no sería conveniente permitir que el programa continúe ejecutándose como si estas operaciones se convirtieran en permanentes más adelante. Aunque no es necesario que las implementaciones inicien una excepción en estas circunstancias, se recomienda que lo hagan. Sería SecurityException apropiado.

La mayoría de los métodos SPI requieren la implementación para leer o escribir información en un nodo de preferencias. El implementador debe tener cuidado del hecho de que otra máquina virtual puede haber eliminado simultáneamente este nodo del almacén de respaldo. Es responsabilidad de la implementación volver a crear el nodo si se ha eliminado.

Nota de implementación: en las implementaciones predeterminadas Preferences de Sun, la identidad del usuario se hereda del sistema operativo subyacente y no cambia durante la vigencia de la máquina virtual. Se reconoce que las implementaciones del lado Preferences servidor pueden tener el cambio de identidad del usuario de la solicitud a la solicitud, que se pasa implícitamente a Preferences los métodos mediante el uso de una instancia estática ThreadLocal . Se recomienda encarecidamente a los autores de estas implementaciones determinar el usuario en el momento en que se accede a las preferencias (por ejemplo, por el #get(String,String) método o #put(String,String) ) en lugar de asociar permanentemente a un usuario con cada Preferences instancia. Este último comportamiento entra en conflicto con el uso normal Preferences y provocaría una gran confusión.

Agregado en la versión 1.4.

Java documentación para java.util.prefs.AbstractPreferences.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Constructores

Nombre	Description
AbstractPreferences(AbstractPreferences, String)	Crea un nodo de preferencia con el elemento primario especificado y el nombre especificado en relación con su elemento primario.
AbstractPreferences(IntPtr, JniHandleOwnership)	Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución.

Campos

Nombre	Description
MaxKeyLength	Longitud máxima de cadena permitida como clave (80 caracteres). (Heredado de Preferences)
MaxNameLength	Longitud máxima de un nombre de nodo (80 caracteres). (Heredado de Preferences)
MaxValueLength	Longitud máxima de cadena permitida como un valor (8192 caracteres). (Heredado de Preferences)

Propiedades

Nombre	Description
Class	Devuelve la clase en tiempo de ejecución de este Objectobjeto . (Heredado de Object)
Handle	Identificador de la instancia de Android subyacente. (Heredado de Object)
IsRemoved	Devuelve true iff este nodo (o un antecesor) se ha quitado con el #removeNode() método .
IsUserNode	Implementa el isUserNode método según la especificación en Preferences#isUserNode().
JniIdentityHashCode	Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object)
JniManagedPeerState	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
JniPeerMembers	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
Lock	Objeto cuyo monitor se usa para bloquear este nodo.
NewNode	Este campo debe ser true si este nodo no existía en el almacén de respaldo antes de la creación de este objeto.
PeerReference	Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object)
ThresholdClass	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
ThresholdType	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.

Métodos

Nombre	Description
AbsolutePath()	Implementa el absolutePath método según la especificación en Preferences#absolutePath().
AddNodeChangeListener(INodeChangeListener)	Registra una NodeChangeListener instancia de para este nodo, que controlará NodeChangeEvents.
AddPreferenceChangeListener(IPreferenceChangeListener)	Registra una PreferenceChangeListener instancia de para este nodo, que controlará PreferenceChangeEvents.
CachedChildren()	Devuelve todos los elementos secundarios no devueltos conocidos de este nodo.
ChildrenNames()	Implementa el children método según la especificación en Preferences#childrenNames().
ChildrenNamesSpi()	Devuelve los nombres de los elementos secundarios de este nodo de preferencia.
ChildSpi(String)	Devuelve el elemento secundario con nombre de este nodo de preferencia, lo que lo crea si aún no existe.
Clear()	Implementa el clear método según la especificación en Preferences#clear().
Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
Dispose()	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
Dispose(Boolean)	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
DisposeUnlessReferenced()	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
Equals(Object)	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
Equals(Object)	Indica si algún otro objeto es "igual a" este. (Heredado de Object)
ExportNode(Stream)	Implementa el exportNode método según la especificación en Preferences#exportNode(OutputStream).
ExportNodeAsync(Stream)	Emite de forma asincrónica un documento XML que representa todas las preferencias contenidas en este nodo, pero no sus descendientes. (Heredado de Preferences)
ExportSubtree(Stream)	Implementa el exportSubtree método según la especificación en Preferences#exportSubtree(OutputStream).
ExportSubtreeAsync(Stream)	Emite de forma asincrónica un documento XML que representa todas las preferencias contenidas en este nodo y todos sus descendientes. (Heredado de Preferences)
Flush()	Implementa el flush método según la especificación en Preferences#flush().
FlushAsync()	Fuerza asincrónicamente los cambios en este nodo de preferencia y sus descendientes al almacén persistente. (Heredado de Preferences)
FlushSpi()	Este método se invoca con este nodo bloqueado.
Get(String, String)	Implementa el get método según la especificación en Preferences#get(String,String).
GetBoolean(String, Boolean)	Implementa el getBoolean método según la especificación en Preferences#getBoolean(String,boolean).
GetByteArray(String, Byte[])	Implementa el getByteArray método según la especificación en Preferences#getByteArray(String,byte[]).
GetChild(String)	Devuelve el elemento secundario con nombre si existe o null si no lo hace.
GetDouble(String, Double)	Implementa el getDouble método según la especificación en Preferences#getDouble(String,double).
GetFloat(String, Single)	Implementa el getFloat método según la especificación en Preferences#getFloat(String,float).
GetHashCode()	Devuelve un valor de código hash para el objeto . (Heredado de Object)
GetInt(String, Int32)	Implementa el getInt método según la especificación en Preferences#getInt(String,int).
GetLong(String, Int64)	Implementa el getLong método según la especificación en Preferences#getLong(String,long).
GetSpi(String)	Devuelve el valor asociado a la clave especificada en este nodo de preferencia, o null si no hay ninguna asociación para esta clave, o la asociación no se puede determinar en este momento.
JavaFinalize()	Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object)
Keys()	Implementa el keys método según la especificación en Preferences#keys().
KeysSpi()	Devuelve todas las claves que tienen un valor asociado en este nodo de preferencia.
Name()	Implementa el name método según la especificación en Preferences#name().
Node(String)	Implementa el node método según la especificación en Preferences#node(String).
NodeExists(String)	Implementa el nodeExists método según la especificación en Preferences#nodeExists(String).
Notify()	Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object)
NotifyAll()	Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object)
Parent()	Implementa el parent método según la especificación en Preferences#parent().
Put(String, String)	Implementa el put método según la especificación en Preferences#put(String,String).
PutBoolean(String, Boolean)	Implementa el putBoolean método según la especificación en Preferences#putBoolean(String,boolean).
PutByteArray(String, Byte[])	Implementa el putByteArray método según la especificación en Preferences#putByteArray(String,byte[]).
PutDouble(String, Double)	Implementa el putDouble método según la especificación en Preferences#putDouble(String,double).
PutFloat(String, Single)	Implementa el putFloat método según la especificación en Preferences#putFloat(String,float).
PutInt(String, Int32)	Implementa el putInt método según la especificación en Preferences#putInt(String,int).
PutLong(String, Int64)	Implementa el putLong método según la especificación en Preferences#putLong(String,long).
PutSpi(String, String)	Coloque la asociación clave-valor especificada en este nodo de preferencia.
Remove(String)	Implementa el remove(String) método según la especificación en Preferences#remove(String).
RemoveNode()	Implementa el removeNode() método según la especificación en Preferences#removeNode().
RemoveNodeChangeListener(INodeChangeListener)	Quita la instancia especificada NodeChangeListener de este nodo.
RemoveNodeSpi()	Quita este nodo de preferencia, lo invalida y las preferencias que contiene.
RemovePreferenceChangeListener(IPreferenceChangeListener)	Quita la instancia especificada PreferenceChangeListener de este nodo.
RemoveSpi(String)	Quite la asociación (si existe) de la clave especificada en este nodo de preferencia.
SetHandle(IntPtr, JniHandleOwnership)	Establece la propiedad Handle. (Heredado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
Sync()	Implementa el sync método según la especificación en Preferences#sync().
SyncAsync()	Sincroniza de forma asincrónica este nodo de preferencia y sus descendientes con el almacén persistente. (Heredado de Preferences)
SyncSpi()	Este método se invoca con este nodo bloqueado.
ToArray<T>()	Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object)
ToString()	Devuelve una representación de cadena de este nodo de preferencias.
UnregisterFromRuntime()	Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object)
Wait()	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object)
Wait(Int64, Int32)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
Wait(Int64)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
IJavaPeerable.Disposed()	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
IJavaPeerable.Finalized()	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla. (Heredado de JavaObject)

Métodos de extensión

Nombre	Description
GetJniTypeName(IJavaPeerable)	Obtiene el nombre JNI del tipo de la instancia self.
JavaAs<TResult>(IJavaPeerable)	Intente coerción self para escribir TResult, comprobando que la coerción es válida en el lado de Java.
JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Esta clase proporciona una implementación esquelética de la Preferences clase, lo que acelera considerablemente la tarea de implementarla.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Intente coerción self para escribir TResult, comprobando que la coerción es válida en el lado de Java.