Vue d’ensemble de StoClien

Objectif

Le principal objectif de l’exemple StoClien est la façon dont le client utilise le stockage structuré et comment il demande à un composant serveur d’utiliser ce stockage. L’exemple StoClien illustre un modèle de programmation de services de stockage structurés.

Fonctionnalités

La fonctionnalité StoClien est similaire aux exemples de « gribouillage » dans certaines versions de Microsoft Visual C++. La différence entre l’exemple StoClien et l’exemple StoServe est une architecture interne basée sur la technologie COM. Une distinction architecturale claire est conservée entre le client COM et le serveur COM.

StoClien charge et enregistre ses dessins dans le stockage structuré de fichiers COM composés.

L’exemple StoClien crée et utilise l’objet COM COPaper connectable fourni en tant que composant CLSID_DllPaper dans le serveur StoServe . Le client StoClien crée un objet COPaper et le contrôle via l’interface IPaper que l’objet expose. StoClien obtient des données de dessin de l’utilisateur et les représente graphiquement dans une fenêtre qu’il gère. StoClien utilise l’interface COPaper IPaper pour enregistrer les données de dessin dans COPaper et diriger les opérations de stockage de fichiers sur ces données.

Un objet COM COPaper encapsule uniquement le stockage basé sur le serveur des données de papier à dessin : aucun comportement d’interface utilisateur graphique n’est fourni côté serveur. Tout le comportement de l’interface utilisateur graphique est isolé dans le client. Les fonctionnalités de gestion et de stockage des données des objets COPaper sont disponibles uniquement via une interface personnalisée COM, IPaper.

StoClien collabore avec le COPaper pour charger et enregistrer les données de dessin COPaper. StoClien obtient une interface IStorage pour l’objet de stockage dans un fichier composé. Dans ses opérations de chargement et d’enregistrement, StoClien transmet un pointeur vers l’interface IStorage vers COPaper sur le serveur. COPaper utilise l’IStorage fourni pour créer des flux dans le stockage. COPaper peut ensuite utiliser l’interface IStream standard pour lire et écrire les données de dessin qu’il gère.

COPaper gère uniquement les données de dessin ; il n’effectue aucune action d’interface graphique graphique. StoClien fournit l’interface graphique graphique pour l’application de dessin. Il encapsule cela dans un objet CGuiPaper C++ central.

StoClien implémente également l’interface IPaperSink personnalisée dans un objet COM COPaperSink et connecte cette interface à un point de connexion approprié dans l’objet COPaper du serveur. COPaper utilise l’interface IPaperSink connectée pour renvoyer des notifications à StoClien. Le repeint normal des données de dessin COPaper est effectué dans StoClien à l’aide de la technologie d’objet connectable COPaper.

StoClien est une application que vous pouvez exécuter directement de manière normale ou à partir de la fenêtre d’invite de commandes. StoClien accepte un paramètre de nom de fichier facultatif sur la ligne de commande.

Dans l’exemple suivant, Drawing.pap est un fichier composé contenant un stockage structuré compatible DllPaper de données de dessin. Si aucun paramètre de nom de fichier de ligne de commande n’est spécifié, StoClien utilise le nom de fichier par défaut Stoclien.pap et tente de l’ouvrir dans le même répertoire que le Stoclien.exe en cours d’exécution.

StoClien c:\drawings\drawing.pap

Informations de support

Pour plus d’informations, des descriptions fonctionnelles et un didacticiel sur le code pour StoClien, consultez la section Code Tour dans Stoclien.htm. Pour plus d’informations sur l’opération utilisateur externe de StoClien, consultez les sections Utilisation et Opération dans Stoclien.htm. Pour lire Stoclient.htm, exécutez Tutorial.exe dans le répertoire du didacticiel main, puis cliquez sur la leçon StoClien dans le tableau des leçons. Vous pouvez également cliquer sur Stoclien.htm après avoir localisé le répertoire du didacticiel main dans Windows Explorer. Pour plus d’informations sur le fonctionnement de StoServe et expose ses services à StoClien, consultez Stoserve.htm dans le répertoire du didacticiel main. N’oubliez pas que vous devez générer le Stoserve.dll avant de générer StoClien. Le makefile pour StoServe inscrit ce serveur dans le registre système. Vous devez donc générer StoServe avant d’essayer d’exécuter StoClien.

Pour plus d’informations sur la configuration d’un système pour générer et tester les exemples de code de cette série de didacticiels COM, consultez Comment générer des exemples. Le makefile fourni (MAKEFILE) est compatible avec Microsoft NMAKE. Pour créer une build de débogage, exécutez la commande NMAKE dans la fenêtre d’invite de commandes.

Pour plus de commodité, un fichier projet est fourni pour chaque exemple à utiliser dans Microsoft Visual Studio. Pour charger le projet pour l’exemple StoClien , exécutez Visual Studio à l’invite de commandes dans l’exemple de répertoire comme suit :

MSDEV STOCLIEN. DSP

Vous pouvez également double-cliquer sur le fichier Stoclient.dsp dans Windows Explorer pour charger un exemple de projet dans Visual Studio. Dans Visual Studio, vous pouvez parcourir les classes C++ de l’exemple de source et généralement effectuer les autres opérations de modification-compilation-débogage. N’oubliez pas que, dans le cadre du Kit de développement logiciel (SDK) de serveur, la compilation de ces exemples à partir de Visual Studio nécessite le paramètre approprié des chemins d’accès de répertoire dans Visual Studio. Pour plus d’informations, consultez Comment générer des exemples.

Notes

L’exemple client et d’autres exemples associés doivent être compilés avant de pouvoir exécuter le client. Pour plus d’informations sur la création des exemples, consultez Comment générer des exemples. Si vous avez créé les exemples appropriés, Stoclien.exe est l’exécutable client à exécuter pour cet exemple.

L’application Stoclien.exe fournit l’interface utilisateur de ce didacticiel. Il exerce les Stoserve.dll associés, mais indépendants, pour illustrer l’utilisation du client et du serveur du stockage structuré COM dans des fichiers composés.