Procuration

// L’interface d’un service distant
interface ThirdPartyYouTubeLib is
    method listVideos()
    method getVideoInfo(id)
    method downloadVideo(id)

// La méthode d’implémentation concrète d’un connecteur de
// service. Les méthodes de cette classe peuvent demander des
// informations à YouTube. La vitesse de la demande dépend de la
// connexion Internet de l’utilisateur, ainsi que de celle de
// YouTube. L’application sera plus lente si plusieurs demandes
// sont envoyées en même temps, même si elles recherchent les
// mêmes informations.
class ThirdPartyYouTubeClass implements ThirdPartyYouTubeLib is
    method listVideos() is
        // Envoie une demande via une API à YouTube.

    method getVideoInfo(id) is
        // Récupère les métadonnées d’une vidéo.

    method downloadVideo(id) is
        // Télécharge un fichier vidéo sur YouTube.

// Pour économiser de la bande passante, nous pouvons mettre en
// cache les résultats des demandes et les mettre de côté
// temporairement. Mais vous n’allez pas forcément pouvoir
// écrire ce code directement dans la classe du service. Elle
// pourrait provenir d’une librairie externe ou avoir été
// définie comme `final`. Pour cette raison, nous écrivons le
// code de la mise en cache dans une nouvelle classe procuration
// qui implémente la même interface que la classe du service.
// Elle délègue les tâches à l’objet du service lorsque les
// demandes doivent vraiment être envoyées.
class CachedYouTubeClass implements ThirdPartyYouTubeLib is
    private field service: ThirdPartyYouTubeLib
    private field listCache, videoCache
    field needReset

    constructor CachedYouTubeClass(service: ThirdPartyYouTubeLib) is
        this.service = service

    method listVideos() is
        if (listCache == null || needReset)
            listCache = service.listVideos()
        return listCache

    method getVideoInfo(id) is
        if (videoCache == null || needReset)
            videoCache = service.getVideoInfo(id)
        return videoCache

    method downloadVideo(id) is
        if (!downloadExists(id) || needReset)
            service.downloadVideo(id)

// La classe GUI qui fonctionnait auparavant avec un objet
// Service n’a pas besoin d’être modifiée tant qu’elle interagit
// avec lui par le biais d’une interface. Nous pouvons passer en
// toute sécurité un objet procuration à la place d’un objet du
// service, car ils implémentent la même interface.
class YouTubeManager is
    protected field service: ThirdPartyYouTubeLib

    constructor YouTubeManager(service: ThirdPartyYouTubeLib) is
        this.service = service

    method renderVideoPage(id) is
        info = service.getVideoInfo(id)
        // Affiche la page de la vidéo.

    method renderListPanel() is
        list = service.listVideos()
        // Affiche la liste des miniatures des vidéos.

    method reactOnUserInput() is
        renderVideoPage()
        renderListPanel()

// L’application peut configurer les procurations à la volée.
class Application is
    method init() is
        aYouTubeService = new ThirdPartyYouTubeClass()
        aYouTubeProxy = new CachedYouTubeClass(aYouTubeService)
        manager = new YouTubeManager(aYouTubeProxy)
        manager.reactOnUserInput()