Modèle objet de service
Dernière modification : mardi 20 avril 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Objet SPFarm
Objet SPServer
Objets de service
Objets clients (frontaux)
Microsoft SharePoint Foundation 2010 offre un modèle objet côté serveur hautement structuré qui vous permet d’accéder facilement aux objets qui représentent les divers aspects d’un site SharePoint 2010. À partir d’objets de niveau supérieur, vous pouvez explorer la hiérarchie d’objets pour obtenir les objets qui contiennent les membres que vous avez besoin d’utiliser dans votre code.
Le diagramme suivant montre les relations entre les principales classes lorsque vous implémentez l’Infrastructure des applications de service de SharePoint 2010. Les flèches pleines pointent d’une classe parent vers la sorte de classe enfant contenue dans une propriété de collection de l’objet parent. Les flèches en pointillés indiquent que la classe SPServiceInstance représente un processus en cours d’exécution (une instance) du service à l’échelle de la batterie de serveurs, représenté par la classe SPService.
Figure 1. Relations des classes dans l’Infrastructure des applications de service
.gif "Relations de classes dans l’infrastructure des applications de service")
Objet SPFarm
L’objet SPFarm représente une batterie de serveurs. SPFarm est le niveau supérieur de la hiérarchie du magasin de configuration. Une batterie de serveurs est un cluster de serveurs physiques à charge équilibrée. Le logiciel d’équilibrage de charge (ou le matériel d’équilibrage de charge) redirige une connexion réseau entrante en provenance de l’ordinateur client vers l’ordinateur qui, au sein de la batterie de serveurs, est le moins occupé à ce moment-là. Par conséquent, la charge de travail liée au traitement des connexions clientes est répartie entre de nombreux serveurs, processeurs, disques durs et autres périphériques.
Un serveur physique est représenté par l’objet SPServer. Outre les membres qu’il hérite de SPFarm, SPServer possède une propriété Address qui contient l’adresse IP du serveur, ainsi qu’une propriété Role qui identifie le rôle du serveur dans la batterie de serveurs. La propriété ServiceInstances contient des références à toutes les instances de services Windows et de services Web en cours d’exécution sur le serveur.
Objet SPServer
Un objet SPServer est créé lorsqu’un serveur est joint à une batterie de serveurs SharePoint ; SPServer.Local est l’objet de configuration. Vous pouvez consulter la liste des serveurs de la batterie de serveurs dans l’Administration centrale. SPServer hérite de l’objet SPPersistedObject. Les objets qui instancient SPPersistedObject sont persistants dans la base de données de configuration SharePoint 2010.
Un serveur physique dans une batterie de serveurs SharePoint 2010 est représenté par l’objet SPServer. Il possède une propriété Address qui contient l’adresse IP du serveur, ainsi qu’une propriété Role qui identifie le rôle du serveur dans la batterie de serveurs. La propriété ServiceInstances contient des références à toutes les instances de services Windows et de services Web en cours d’exécution sur le serveur.
Objets de service
Les objets de service, également appelés objets système principaux, fournissent le service partagé aux objets frontaux clients. Ces objets sont les suivants :
SPService
La classe SPService représente un service disponible ou installé dans une batterie de serveurs.
Chaque objet SPService possède une propriété Instances contenant toutes les instances du service qui sont en cours d’exécution sur les différents serveurs de la batterie de serveurs. Une seule instance de chaque service s’exécute sur un serveur donné, mais certains services possèdent plusieurs instances, qui s’exécutent chacune sur un serveur différent. Chaque instance est représentée par un objet d’une classe dérivée de SPServiceInstance.
SPServiceInstance
La classe SPServiceInstance représente une instance d’un service sur un serveur de la batterie de serveurs. Les instances de service fournissent l’évolutivité et la tolérance de panne. Une instance de service est indépendante de toutes les autres instances de serveur de même type, mais identique à celles-ci en termes de fonctionnalités. Un objet SPServiceInstance est créé lorsqu’un service est installé sur un serveur de la batterie de serveurs. Pour être utilisable, une instance de service requiert une application de service en cours d’exécution. Chaque ordinateur exécutant le service possède sa propre instance de service, qui peut être démarrée et arrêtée. Si une instance de service d’un service donné est en cours d’exécution, le service est entièrement fonctionnel. L’instance de service fournit le processus hôte pour l’application de service. Un développeur peut démarrer ou arrêter des instances de service par programme, ou un administrateur de batterie peut démarrer ou arrêter des instances de service par le biais de l’Administration centrale dans la section Gérer les services sur le serveur des paramètres système.
Utilisez Provision() pour démarrer (mettre en service) l’instance de service. Dans Windows PowerShell, utilisez get-SPServiceInstance pour déterminer la collection de services installés sur le serveur.
SPServiceApplication
Une instance de service héberge une application de service. Sans instance de service, l’application de service n’est pas utilisable. L’application de service contient les données et les paramètres qui lui sont propres et fournit l’interface de service qui contient les paramètres administrateur. Une application de service peut contrôler les données utilisateur.
Chaque application de service est isolée de toutes les autres applications de service. Par exemple, l’application de service de recherche dédiée aux finances est isolée de l’application de service de recherche dédiée aux ressources humaines, même si les deux applications sont hébergées sur la même batterie de serveurs.
À l’aide de SPServiceApplication, c’est généralement un administrateur de batterie qui crée une application de service. L’administrateur de batterie peut créer un objet SPServiceApplication en utilisant l’un des procédés suivants :
Assistant Configuration de batterie de serveurs ;
installation en mode d’évaluation (installation autonome) ;
Administration centrale dans la page Nouvelle application de service ;
Windows PowerShell
SPServiceApplicationCollection représente la collection d’applications de service pour un service et est utilisé dans la page Gérer les applications de service de l’Administration centrale.
SPIisWebServiceApplication
La classe SPIisWebServiceApplication implémente l’interface ISharedServiceApplication et permet de publier une application de service via le service de topologie.
Objets clients (frontaux)
Une application cliente communique avec le service principal. Les clients sont des applications qui initient une communication. Les services sont des applications qui attendent que les clients communiquent avec elles et qui répondent à cette communication. Les objets de service clients sont les suivants :
SPServiceProxy
Un proxy de service représente un client de service installé dans une batterie de serveurs.
Un objet SPServiceProxy est le parent de l’objet SPServiceApplicationProxy. Il est l’équivalent d’un objet SPService côté serveur, qui est le parent d’un objet SPServiceApplication. Ces objets parents peuvent également être considérés comme des fabriques de classes pour les objets enfants.
SPServiceApplicationProxy
L’objet SPServiceApplicationProxy représente une connexion à une application de service et fournit l’interface publique (frontale) avec cette application de service. SPServiceApplicationProxy prend en charge les connexions aux batteries de serveurs distantes et permet au code client de consommer les applications de service distantes. Les applications de service ne peuvent pas être installées localement et, par conséquent, ne peuvent pas être appelées directement à partir du client.
Une classe SPServiceApplicationProxy est automatiquement créée avec une application de service. Au minimum, les proxys de service transfèrent les appels à l’application de service distante. La classe SPServiceApplicationProxy peut également servir de support pour l’implémentation d’une logique supplémentaire relative à la connexion à l’application de service.
Les administrateurs de batterie peuvent créer explicitement une classe SPServiceApplicationProxy dans la section Fédération de services de l’Administration centrale.
Voir aussi
Référence
Concepts
Serveur et architecture du site : vue d'ensemble du modèle objet