Author: veithen
Date: Fri Mar 9 10:03:42 2012
New Revision: 1298776
URL: http://svn.apache.org/viewvc?rev=1298776&view=rev
Log:
Added a file that was missing in r1298772.
Added:
axis/axis1/java/trunk/axis-rt-transports-http-javanet/src/site/apt/index.apt.vm
Added:
axis/axis1/java/trunk/axis-rt-transports-http-javanet/src/site/apt/index.apt.vm
URL:
http://svn.apache.org/viewvc/axis/axis1/java/trunk/axis-rt-transports-http-javanet/src/site/apt/index.apt.vm?rev=1298776&view=auto
==============================================================================
---
axis/axis1/java/trunk/axis-rt-transports-http-javanet/src/site/apt/index.apt.vm
(added)
+++
axis/axis1/java/trunk/axis-rt-transports-http-javanet/src/site/apt/index.apt.vm
Fri Mar 9 10:03:42 2012
@@ -0,0 +1,44 @@
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+
+ -----
+ About
+ -----
+
+ By default Axis uses <<<HTTPSender>>> as the client-side HTTP transport.
That implementation doesn't support
+ keep-alive connections (i.e. connection pooling). Axis also ships a HTTP
transport based on
+ {{{http://hc.apache.org/httpclient-3.x/}Commons HttpClient}}. This
implementation supports connection
+ pooling, but imposes additional requirements on application code, in
particular
+ that the service locator must be instantiated only once (for more
information, see
+ the
{{{http://wiki.apache.org/ws/FrontPage/Axis/AxisCommonsHTTP}AxisCommonsHTTP
how-to}}). This means that
+ it is not always possible to use it as a drop-in replacement for the default
<<<HTTPSender>>> and that
+ it may require changes to the application code.
+
+ To overcome this issue, Axis 1.4.1 introduces another client-side HTTP
transport which is based
+ on the <<<java.net.HttpURLConnection>>> API. This API built into the Java
runtime supports keep-alive
+ connections. Since there is a single connection pool managed by the JRE, all
Axis stubs can take advantage
+ of it, regardless of how service locators are instantiated. This means that
this transport doesn't impose
+ additional requirements on application code and can be used as a drop-in
replacement of the default
+ <<<HTTPSender>>>. However, it only works with Java 1.5 or higher because it
relies on features of
+ the <<<java.net.HttpURLConnection>>> API that were not available in earlier
Java versions.
+
+ To use the java.net based HTTP transport, add <<<$jarName>>> to the class
path and set up
+ <<<client-config.wsdd>>> with the right pivot handler for the <<<http>>>
transport, as shown in the following
+ sample:
+
+%{snippet|id=deployment|file=src/test/resources/client-config.wsdd}
+
\ No newline at end of file
