Настройка свойств

  • Статья

API HTTP-сервера версии 2.0 позволяет приложениям вручную настраивать очереди запросов, сеансы сервера и группы URL-адресов. Сеанс сервера — это объект верхнего уровня, содержащий сведения о конфигурации, которые применяются ко всем созданным в них группам URL-адресов. Приложение создает сеанс сервера с одной или несколькими группами URL-адресов, а затем связывает группу URL-адресов с очередью запросов.

Дополнительные сведения о конкретных объектах конфигурации в API HTTP-сервера версии 2.0 см. в разделе:

Свойства для объектов конфигурации задаются с помощью HttpSetServerSessionProperty, HttpSetUrlGroupProperty и HttpSetRequestQueueProperty , как показано на схеме ниже. Связь между очередью запроса и группой URL-адресов может быть изменена по запросу, тогда как связь между сеансом сервера и группами URL-адресов изменить нельзя. Группы URL-адресов должны быть связаны с очередью запросов для получения запросов.

свойства для объектов конфигурации

В следующей таблице перечислены свойства, которые можно задать для каждого объекта конфигурации. Как правило, если приложение не задает конфигурацию свойств, применяются конфигурации API HTTP-сервера по умолчанию. Свойства конфигурации, заданные приложением в сеансе сервера, переопределяют конфигурации на уровне API HTTP-сервера. Конфигурации, заданные в группе URL-адресов, переопределяют конфигурации сеансов сервера, а конфигурации очереди запросов переопределяют конфигурации API HTTP-сервера по умолчанию.

Объект Configuration Свойство
Сеанс сервера HttpServerStateProperty HttpServerLoggingProperty HttpServerQosProperty HttpServerTimeoutsProperty HttpServerAuthenticationProperty
Группа URL-адресов HttpServerStateProperty HttpServerAuthenticationProperty HttpServerLoggingProperty HttpServerQosProperty HttpServerBindingProperty HttpServerTimeoutsProperty
Очередь запросов HttpServerStateProperty HttpServerQueueLengthProperty HttpServer503VerbosityProperty

 

Свойства сеанса сервера определяются в перечислении HTTP_SERVER_PROPERTY . В следующей таблице перечислены структуры свойств, которые задаются для каждого типа свойства, и API HTTP-сервера по умолчанию, если эти свойства не заданы приложением.

Свойство Структура API HTTP-сервера по умолчанию
HttpServerAuthenticatonProperty HTTP_SERVER_AUTHENTICATION_INFO Без аутентификации
HttpServerLoggingProperty HTTP_LOGGING_INFO Без ведения журнала
HttpServerQosProperty-HttpQosSettingTypeConnectionLimit> HTTP_CONNECTION_LIMIT_INFO Без ограничений
HttpServerTimeoutsProperty HTTP_TIMEOUT_LIMIT_INFO 120 сек.
HttpServerQosProperty-HttpQosSettingTypeBandwidth> HTTP_BANDWIDTH_LIMIT_INFO Без ограничений
HttpServerQueueLengthProperty ULONG 1000
HttpServerStateProperty HTTP_STATE_INFO Активировано
HttpServer503VerbosityProperty HTTP_503_RESPONSE_VERBOSITY HttpResponseVerbosityBasic
HttpServerBindingProperty HTTP_BINDING_INFO Нет

 

В следующей таблице перечислены минимальные и максимальные значения для конфигураций API HTTP-сервера.

Свойство Максимальное и минимальное значение API HTTP-сервера
HttpServerQosProperty-HttpQosSettingTypeBandwidth> Min = MIN_ALLOWED_BANDWIDTH_THROTTLING_RATE Max = none
HttpServerQueueLengthProperty Min = 0xA Max = 0xFFFF