ISafeVarargs Schnittstelle

Definition

[Android.Runtime.Register("java/lang/SafeVarargs", "", "Java.Lang.ISafeVarargsInvoker")]
public interface ISafeVarargs : IDisposable, Java.Interop.IJavaPeerable, Java.Lang.Annotation.IAnnotation

[<Android.Runtime.Register("java/lang/SafeVarargs", "", "Java.Lang.ISafeVarargsInvoker")>]
type ISafeVarargs = interface
    interface IAnnotation
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable IAnnotation IDisposable

Hinweise

Eine Programmiererbehauptung, dass der Textkörper der kommentierten Methode oder des Konstruktors keine potenziell unsicheren Vorgänge für den Varargs-Parameter ausführt. Wenn Sie diese Anmerkung auf eine Methode oder einen Konstruktor anwenden, werden nicht überprüfte Warnungen bezüglich eines nicht reifizierbaren Variablenaritätstyps (vararg) unterdrückt und deaktivierte Warnungen zur parametrisierten Arrayerstellung an Aufrufstandorten unterdrückt.

Zusätzlich zu den von der Target @Target Metaanmerkung auferlegten Verwendungseinschränkungen sind Compiler erforderlich, um zusätzliche Verwendungseinschränkungen für diesen Anmerkungstyp zu implementieren. Es handelt sich um einen Kompilierungszeitfehler, wenn eine Methode oder Konstruktordeklaration mit einer @SafeVarargs Anmerkung kommentiert wird, und entweder: <ul><li> die Deklaration ist eine feste Arity-Methode oder ein Konstruktor.

<li> die Deklaration ist eine variable Arity-Methode, die weder static noch final nicht private.

</ul>

Compiler werden empfohlen, Warnungen auszugeben, wenn dieser Anmerkungstyp auf eine Methode oder Konstruktordeklaration angewendet wird, wobei:

<Ul>

<li> Der Parameter "Variable Arity" weist einen reifizierbaren Elementtyp auf, der primitive Typen enthält, Objectund String. (Die deaktivierten Warnungen, die dieser Anmerkungstyp unterdrückt, treten für einen reifizierbaren Elementtyp bereits nicht auf.)

<li> Der Textkörper der Methoden- oder Konstruktordeklaration führt potenziell unsichere Vorgänge aus, z. B. eine Zuordnung zu einem Element des Arrays des Variablenaritätsparameters, der eine nicht aktivierte Warnung generiert. Einige unsichere Vorgänge lösen keine deaktivierte Warnung aus. Beispiel: Aliasing in

<Blockquote>

@SafeVarargs // Not actually safe!
            static void m(List<String>... stringLists) {
              Object[] array = stringLists;
              List<Integer> tmpList = Arrays.asList(42);
              array[0] = tmpList; // Semantically invalid, but compiles without warnings
              String s = stringLists[0].get(0); // Oh no, ClassCastException at runtime!
            }

</blockquote>

führt zur ClassCastException Laufzeit.

Zukünftige Versionen der Plattform können Compilerfehler für solche unsicheren Vorgänge mandaten.

</ul>

In 1.7 hinzugefügt.

Java Dokumentation für java.lang.SafeVarargs.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.