Configurar propiedades

  • Artículo

La API del servidor HTTP versión 2.0 permite a las aplicaciones configurar manualmente colas de solicitudes, sesiones de servidor y grupos de direcciones URL. La sesión del servidor es el objeto de nivel superior que contiene información de configuración que se aplica a todos los grupos de direcciones URL creados en ellos. La aplicación crea una sesión de servidor con uno o varios grupos de direcciones URL en ella y, a continuación, asocia el grupo de direcciones URL a una cola de solicitudes.

Para obtener más información sobre objetos de configuración específicos en la API de HTTP Server versión 2.0, consulte:

Las propiedades de los objetos de configuración se establecen con HttpSetServerSessionProperty, HttpSetUrlGroupProperty y HttpSetRequestQueueProperty como se muestra en el diagrama siguiente. La asociación entre la cola de solicitudes y el grupo de direcciones URL se puede cambiar a petición, mientras que no se puede cambiar la asociación entre la sesión del servidor y los grupos de direcciones URL. Los grupos de direcciones URL deben estar asociados a una cola de solicitudes para recibir solicitudes.

propiedades para los objetos de configuración

En la tabla siguiente se enumeran las propiedades que se pueden establecer en cada objeto de configuración. En general, si la aplicación establece ninguna configuración de propiedad, se aplican las configuraciones predeterminadas de la API del servidor HTTP. Las propiedades de configuración establecidas por la aplicación en la sesión del servidor reemplazan las configuraciones para toda la API del servidor HTTP. Las configuraciones establecidas en el grupo de direcciones URL invalidan las configuraciones de sesión del servidor y las configuraciones de cola de solicitudes invalidan las configuraciones predeterminadas de la API del servidor HTTP.

Objeto Configuration Propiedad
Sesión del servidor HttpServerStateProperty HttpServerLoggingProperty HttpServerQosProperty HttpServerTimeoutsProperty HttpServerAuthenticationProperty
Grupo de direcciones URL HttpServerStateProperty HttpServerAuthenticationProperty HttpServerLoggingProperty HttpServerQosProperty HttpServerBindingProperty HttpServerTimeoutsProperty
Cola de solicitudes HttpServerStateProperty HttpServerQueueLengthProperty HttpServer503VerbosityProperty

 

Las propiedades de sesión del servidor se definen en la enumeración HTTP_SERVER_PROPERTY . En la tabla siguiente se enumeran las estructuras de propiedad que se establecen para cada tipo de propiedad y la API del servidor HTTP predeterminada cuando la aplicación no establece estas propiedades.

Propiedad Estructura Valor predeterminado de la API del servidor HTTP
HttpServerAuthenticatonProperty HTTP_SERVER_AUTHENTICATION_INFO Sin autenticación
HttpServerLoggingProperty HTTP_LOGGING_INFO Sin registro
HttpServerQosProperty-HttpQosSettingTypeConnectionLimit> HTTP_CONNECTION_LIMIT_INFO Ilimitado
HttpServerTimeoutsProperty HTTP_TIMEOUT_LIMIT_INFO 120 s.
HttpServerQosProperty-HttpQosSettingTypeBandwidth> HTTP_BANDWIDTH_LIMIT_INFO Ilimitado
HttpServerQueueLengthProperty ULONG 1000
HttpServerStateProperty HTTP_STATE_INFO habilitado
HttpServer503VerbosityProperty HTTP_503_RESPONSE_VERBOSITY HttpResponseVerbosityBasic
HttpServerBindingProperty HTTP_BINDING_INFO None

 

En la tabla siguiente se enumeran los valores mínimo y máximo para las configuraciones de la API de servidor HTTP.

Propiedad HTTP Server API Maximum and Minimum
HttpServerQosProperty-HttpQosSettingTypeBandwidth> Min = MIN_ALLOWED_BANDWIDTH_THROTTLING_RATE Max = none
HttpServerQueueLengthProperty Min = 0xA Max = 0xFFFF