Информация о порте клиента веб-служб

Имя порта.

Время в секундах, в течение которого веб-служба ожидает обработки запроса, поступившего на этот порт. Значение тайм-аута запроса клиента по умолчанию составляет 300 секунд. Если указано нулевое значение (0), то в качестве тайм-аута применяется значение по умолчанию соответствующего транспортного протокола. Это поле поддерживается только для клиентов JAX-RPC.

Как правило, этот параметр применяется для дополнительной настройки клиентов, взаимодействующих с веб-службой с помощью транспортного протокола JMS, с целью увеличения времени ожидания обработки запроса. Точная настройка тайм-аута может потребоваться в зависимости от пропускной способности сети или особенностей реализации веб-службы.

Имя конечной точки для переопределения текущей конечной точки. Клиент, отправляющий запрос на этот порт, использует эту конечную точку вместо конечной точки, указанной в файле WSDL. Это поле поддерживается как для клиентов JAX-WS, так и для клиентов JAX-RPC.

Когда вызываются клиенты JAX-RPC или JAX-WS, запросы отправляются по URL-адресу, указанному в атрибуте расположения адреса SOAP порта в файле WSDL. Кроме того, обе модели программирования предоставляют клиентам возможность программно задавать URL-адрес конечной точки. Чтобы задать URL-адрес конечной точки клиент использует для JAX-RPC свойство javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY, а для JAX-WS - свойство javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY property.

Если в состав приложения входит статический клиент веб-службы, он может использовать только реализацию (конечную точку службы), указанную в файле WSDL во время разработки. Переопределение конечной точки - это альтернативный подход, который можно использовать вместо настройки атрибута развернутого файла WSDL.

Атрибут URI переопределенной конечной точки указывается для отдельного порта. При этом в состав модуля не должен входить дополнительный файл WSDL. URI переопределенной конечной точки обладает преимуществом по сравнению с атрибутом развернутого файла WSDL. Клиент использует это значения для URI конечной точки службы или адреса SOAP вместо значения в статических привязках клиента.

Предотвращение неполадок:

• Обычно это поле не влияет на неуправляемые клиенты JAX-WS, поскольку его невозможно редактировать при наличии только неуправляемых клиентов. Однако если имеются только управляемые клиенты или наряду с ними используются неуправляемые, это поле можно редактировать, и изменение свойства отразится на неуправляемых клиентах. Если требуется запретить отправку запросов службы неуправляемого клиента JAX-WS по URL-адресу конечной точки, указанному в этом поле, добавьте следующее пользовательское свойство в параметры JVM:

  com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri

  Добавление этого пользовательского свойства в параметры JVM для сервера приложений и присвоение ему значения true запрещает службам неуправляемых клиентов JAX-WS обращаться к URL-адресу конечной точки, который переопределяет конечную точку в файле WSDL.
• Переопределенные параметры URL конечной точки не сохраняются, когда модуль или приложение заменяется операцией обновления.

gotcha

URI пространства имен привязки файла WSDL, применяемый вместо пространства имен из файла WSDL. Эта привязка не должна существовать в файле WSDL. Клиент, отправляющий запрос на этот порт, использует эту привязку вместо привязки, указанной в файле WSDL. Пространство имен переопределенной привязки можно указать только вместе с переопределенной конечной точкой. Это поле поддерживается только для клиентов JAX-RPC.