Modelo de objetos de servicio

Artículo
09/24/2014

Última modificación: martes, 20 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Objeto SPFarm
Objeto SPServer
Objetos de servicio
Objetos de cliente (front-end)

Microsoft SharePoint Foundation 2010 ofrece un modelo de objetos del lado servidor altamente estructurado que puede usar para obtener acceso a objetos que representan los diversos aspectos de un sitio de SharePoint 2010. Desde los objetos de nivel superior, puede explorar en profundidad la jerarquía de objetos para obtener los objetos que contienen los miembros que debe usar en el código.

El siguiente diagrama muestra las relaciones entre las clases principales al implementar Service Application Framework de SharePoint 2010. Las flechas de línea continua apuntan desde una clase primaria al tipo de clase secundaria que se mantiene en la propiedad de colección de un objeto primario, mientras que la flecha de línea discontinua indica que la clase SPServiceInstance representa un proceso en ejecución (una instancia) del servicio de todo el conjunto o granja de servidores al que la clase SPService representa.

Figura 1. Relaciones de clases en el marco de la aplicación de servicio

Relaciones de clases en el marco de aplicación de servicio

Objeto SPFarm

El objeto SPFarm representa un conjunto o granja de servidores. SPFarm es el nivel superior de la jerarquía de almacén de configuración. Una granja de servidores es un clúster de equilibrio de carga de los servidores físicos. El software (o hardware) de equilibrio de carga dirige una conexión de red entrante desde un equipo cliente al equipo de la granja de servidores que esté menos ocupado en ese momento. Por lo tanto, la carga de trabajo de mantenimiento de las conexiones de cliente se distribuye a través de varios servidores, procesadores, discos duros y otros periféricos.

Un servidor físico está representado por el objeto SPServer. Además de los miembros que hereda de SPFarm, SPServer tiene una propiedad Address que conserva la dirección IP del servidor y una propiedad Role que identifica el rol del servidor en la granja de servidores. La propiedad ServiceInstances contiene referencias a todas las instancias de servicios de Windows y servicios web que se ejecutan en el servidor.

Objeto SPServer

Cuando un servidor se conecta a una granja de servidores de SharePoint, se crea un objeto SPServer; SPServer.Local es el objeto de configuración. Puede ver una lista de los servidores de la granja en Administración central. SPServer procede del objeto SPPersistedObject. Los objetos que crean una instancia de SPPersistedObject son persistentes en la base de datos de configuración de SharePoint 2010.

Un servidor físico de una granja de servidores de SharePoint 2010 está representado por el objeto SPServer, que tiene una propiedad Address que conserva la dirección IP del servidor y una propiedad Role que identifica el rol del servidor en la granja de servidores. La propiedad ServiceInstances contiene referencias a todas las instancias de servicios de Windows y servicios web que se ejecutan en el servidor.

Objetos de servicio

Los objetos de servicio, también conocidos como objetos de sistema back-end, proporcionan el servicio compartido a los objetos front-end de cliente. Entre estos objetos se incluyen los siguientes:

SPService

La clase SPService representa un servicio que está disponible o instalado en una granja de servidores.

Todos los objetos SPService tienen una propiedad Instances que conserva todas las instancias del servicio que estén en ejecución en varios servidores de la granja. Solo se ejecuta una instancia de cada servicio en un servidor, si bien algunos servicios tienen múltiples instancias, cada una en ejecución en un servidor distinto. Cada instancia se representa mediante un objeto de una clase derivada de SPServiceInstance.

SPServiceInstance

La clase SPServiceInstance representa una instancia de un servicio en un servidor de la granja de servidores. Las instancias de servicio proporcionan escalabilidad y tolerancia a errores. Además, son independientes del resto de instancias de servidor del mismo tipo, si bien su funcionalidad es exactamente la misma. Cuando se instala un servicio en un servidor de la granja de servidores, se crea un objeto SPServiceInstance. Para que se pueda usar, una instancia de servicio requiere una aplicación de servicio en ejecución. Cada equipo que ejecuta el servicio tiene su propia instancia de servicio, que se puede iniciar y detener. Si una instancia de servicio de un servicio determinado está en ejecución, el servicio es completamente funcional. La instancia de servicio proporciona el proceso de host para la aplicación de servicio. Un desarrollador puede iniciar o detener instancias de servicio mediante programación, mientras que un administrador de granja de servidores puede iniciar o detener instancias de servicio a través de Administración central en la sección Administrar servicios en el servidor en Configuración del sistema.

Use Provision() para iniciar (aprovisionar) la instancia de servicio. En Windows PowerShell, use get-SPServiceInstance para determinar la colección de servicios que están instalados en el servidor.

SPServiceApplication

Una instancia de servicio hospeda una aplicación de servicio. Sin una instancia de servicio, la aplicación de servicio no se puede usar. La aplicación de servicio contiene la configuración y datos específicos de la aplicación y proporciona la interfaz de servicio que contiene la configuración del administrador. Una aplicación de servicio puede controlar los datos de usuario.

Cada aplicación de servicio está aislada del resto de aplicaciones de servicio. Por ejemplo, la aplicación de servicio de búsqueda de finanzas está aislada de la aplicación de servicio de búsqueda de recursos humanos, aún cuando ambas se hospedan en la misma granja de servidores.

Normalmente, el administrador de la granja de servidores es quien suele crear una aplicación de servicio mediante SPServiceApplication. Así, puede crear un objeto SPServiceApplication usando cualquiera de estos elementos:

Asistente para la configuración del conjunto de servidores
Instalación en modo de evaluación (instalación independiente)
Administración central en la página Aplicación de servicio nueva
Windows PowerShell

SPServiceApplicationCollection es la colección de aplicaciones de servicio relativa a un servicio y se usa en Administración Central, en Administrar aplicaciones de servicio.

SPIisWebServiceApplication

La clase SPIisWebServiceApplication implementa la interfaz ISharedServiceApplication y permite que una aplicación de servicio se publique (anuncie) a través del servicio de topología.

Objetos de cliente (front-end)

Una aplicación de cliente se comunica con el servicio back-end. Los clientes son aplicaciones que inician la comunicación. Los servicios son aplicaciones que esperan a que los clientes se comuniquen con ellos y responden a esa comunicación. Entre los objetos de servicio de cliente se incluyen los siguientes:

SPServiceProxy

Un proxy de servicio representa un cliente de servicio que está instalado en una granja de servidores.

Un objeto SPServiceProxy es el elemento primario del objeto SPServiceApplicationProxy. Se trata del equivalente a un objeto SPService en el lado servidor, que es el elemento primario de SPServiceApplication. Estos objetos primarios también se pueden considerar como generadores de clases para los objetos secundarios.

SPServiceApplicationProxy

El objeto SPServiceApplicationProxy representa una conexión a una aplicación de servicio y proporciona la interfaz pública (front-end) a una aplicación de servicio. SPServiceApplicationProxy admite conexiones a granjas de servidores remotas y permite que el código de cliente use aplicaciones de servicio remotas. Las aplicaciones de servicio no se pueden instalar localmente y, por tanto, no se las puede llamar directamente desde el cliente.

SPServiceApplicationProxy se crea automáticamente con una aplicación de servicio. Como mínimo, los proxy de servicio reenvían llamadas a la aplicación de servicio remota. SPServiceApplicationProxy también puede ser una ubicación para implementar lógica adicional acerca de la conexión a la aplicación de servicio.

Los administradores de la granja de servidores pueden crear expresamente un SPServiceApplicationProxy en la sección defederación de servicios de Administración Central.