IInstantSource Interface

Définition

[Android.Runtime.Register("java/time/InstantSource", "", "Java.Time.IInstantSourceInvoker", ApiSince=34)]
public interface IInstantSource : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/time/InstantSource", "", "Java.Time.IInstantSourceInvoker", ApiSince=34)>]
type IInstantSource = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Dérivé

Java.Time.Clock

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IDisposable

Remarques

Fournit l’accès à l’instant actuel.

Les instances de cette interface sont utilisées pour accéder à une représentation enfichable de l’instant actuel. Par exemple, InstantSource pouvez être utilisé au lieu de System#currentTimeMillis().

L’objectif principal de cette abstraction est de permettre à d’autres sources instantanées d’être branchées en tant que et quand nécessaire. Les applications utilisent un objet pour obtenir l’heure actuelle plutôt qu’une méthode statique. Cela peut simplifier les tests.

Par conséquent, cette interface ne garantit pas que le résultat représente réellement l’instant actuel sur la ligne de temps. Au lieu de cela, l’application permet à l’application de fournir une vue contrôlée quant à ce que l’instant actuel est.

La meilleure pratique pour les applications consiste à passer une InstantSource méthode qui nécessite l’instant actuel. Une infrastructure d’injection de dépendances est une façon d’y parvenir :

public class MyBean {
               private InstantSource source;  // dependency inject
               ...
               public void process(Instant endInstant) {
                 if (source.instant().isAfter(endInstant) {
                   ...
                 }
               }
             }

Cette approche permet d’utiliser une autre source, telle que #fixed(Instant) fixed ou #offset(InstantSource, Duration) offset à utiliser lors du test.

La system méthode de fabrique fournit une source basée sur la meilleure horloge système disponible. Cela peut utiliser System#currentTimeMillis(), ou une horloge de résolution supérieure si l’une d’elles est disponible.

Ajouté dans 17.

Java documentation pour java.time.InstantSource.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.