You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by bu...@apache.org on 2013/01/07 11:47:59 UTC
svn commit: r845308 - in /websites/production/cxf/content:
cache/docs.pageCache cache/main.pageCache docs/server-http-transport.html
docs/servlet-transport.html dosgi-apache-karaf-feature.html
Author: buildbot
Date: Mon Jan 7 10:47:59 2013
New Revision: 845308
Log:
Production update by buildbot for cxf
Modified:
websites/production/cxf/content/cache/docs.pageCache
websites/production/cxf/content/cache/main.pageCache
websites/production/cxf/content/docs/server-http-transport.html
websites/production/cxf/content/docs/servlet-transport.html
websites/production/cxf/content/dosgi-apache-karaf-feature.html
Modified: websites/production/cxf/content/cache/docs.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/cache/main.pageCache
==============================================================================
Binary files - no diff available.
Modified: websites/production/cxf/content/docs/server-http-transport.html
==============================================================================
--- websites/production/cxf/content/docs/server-http-transport.html (original)
+++ websites/production/cxf/content/docs/server-http-transport.html Mon Jan 7 10:47:59 2013
@@ -143,7 +143,7 @@ Apache CXF -- Server HTTP Transport
xsi:schemaLocation="...
http:<span class="code-comment">//cxf.apache.org/transports/http/configuration
</span> http:<span class="code-comment">//cxf.apache.org/schemas/configuration/http-conf.xsd
-</span> ...>
+</span> ...">
</pre>
</div></div>
@@ -171,7 +171,7 @@ Apache CXF -- Server HTTP Transport
<h3><a shape="rect" name="ServerHTTPTransport-The%7B%7Bserver%7D%7Delement"></a>The <tt>server</tt> element</h3>
-<p>The <tt>http-conf:server</tt>} element is used to configure the properties of a server's HTTP connection. Its attributes, described below, specify the connection's properties.</p>
+<p>The <tt>http-conf:server</tt> element is used to configure the properties of a server's HTTP connection. Its attributes, described below, specify the connection's properties.</p>
<div class="table-wrap">
<table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh">Attribute</th><th colspan="1" rowspan="1" class="confluenceTh">Description</th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>ReceiveTimeout</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Sets the length of time, in milliseconds, the server tries to receive a request before the connection times out. The default is 30000. The specify that the server will not timeout use 0.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>SuppressClientSendErrors</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Specifies whether exceptions are to be thrown when an error is encountered on receiving a request. The default is <tt>false</tt>; exceptions are thrown on encountering errors.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>SuppressClientReceiveErrors</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Specifies whether ex
ceptions are to be thrown when an error is encountered on sending a response to a client. The default is <tt>false</tt>; exceptions are thrown on encountering errors.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>HonorKeepAlive</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Specifies whether the server honors requests for a connection to remain open after a response has been sent. The default is <tt>true</tt>; keep-alive requests are honored.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>RedirectURL</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Specifies the URL to which the client request should be redirected if the URL specified in the client request is no longer appropriate for the requested resource. In this case, if a status code is not automatically set in the first line of the server response, the status code is set to 302 and the status description is set to Object Moved. The value is used as the value of
the HTTP <tt>RedirectURL</tt> property.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>CacheControl</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Specifies directives about the behavior that must be adhered to by caches involved in the chain comprising a response from a server to a client.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>ContentLocation</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Sets the URL where the resource being sent in a response is located.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>ContentType</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Specifies the media type of the information being sent in a response. Media types are specified using multipurpose internet mail extensions (MIME) types. The value is used as the value of the HTTP <tt>ContentType</tt> location.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>ContentEncoding</tt></td><t
d colspan="1" rowspan="1" class="confluenceTd">Specifies any additional content encodings that have been applied to the information being sent by the service provider. Content encoding labels are regulated by the Internet Assigned Numbers Authority (IANA). Possible content encoding values include zip, gzip, compress, deflate, and identity. This value is used as the value of the HTTP <tt>ContentEncoding</tt> property.</td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><tt>ServerType</tt></td><td colspan="1" rowspan="1" class="confluenceTd">Specifies what type of server is sending the response. Values take the form program-name/version. For example, Apache/1.2.5.</td></tr></tbody></table>
Modified: websites/production/cxf/content/docs/servlet-transport.html
==============================================================================
--- websites/production/cxf/content/docs/servlet-transport.html (original)
+++ websites/production/cxf/content/docs/servlet-transport.html Mon Jan 7 10:47:59 2013
@@ -139,19 +139,18 @@ Apache CXF -- Servlet Transport
<span class="code-quote">"http://java.sun.com/dtd/web-app_2_3.dtd"</span>>
<span class="code-tag"><web-app></span>
<span class="code-tag"><context-param></span>
- <span class="code-tag"><param-name></span>contextConfigLocation<span class="code-tag"></param-name></span>
- <span class="code-tag"><param-value></span>
- classpath:com/acme/ws/services.xml
- <span class="code-tag"></param-value></span>
- <span class="code-tag"></context-param></span>
+ <span class="code-tag"><param-name></span>contextConfigLocation<span class="code-tag"></param-name></span>
+ <span class="code-tag"><param-value></span>
+ classpath:com/acme/ws/services.xml
+ <span class="code-tag"></param-value></span>
+ <span class="code-tag"></context-param></span>
<span class="code-tag"><listener></span>
- <span class="code-tag"><listener-class></span>
- org.springframework.web.context.ContextLoaderListener
- <span class="code-tag"></listener-class></span>
+ <span class="code-tag"><listener-class></span>
+ org.springframework.web.context.ContextLoaderListener
+ <span class="code-tag"></listener-class></span>
<span class="code-tag"></listener></span>
-
<span class="code-tag"><servlet></span>
<span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
<span class="code-tag"><display-name></span>CXF Servlet<span class="code-tag"></display-name></span>
@@ -165,6 +164,7 @@ Apache CXF -- Servlet Transport
<span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
<span class="code-tag"><url-pattern></span>/services/*<span class="code-tag"></url-pattern></span>
<span class="code-tag"></servlet-mapping></span>
+
<span class="code-tag"></web-app></span>
</pre>
</div></div>
@@ -197,13 +197,11 @@ Apache CXF -- Servlet Transport
<span class="code-tag"><url-pattern></span>/services/*<span class="code-tag"></url-pattern></span>
<span class="code-tag"></servlet-mapping></span>
-
<span class="code-tag"></web-app></span>
</pre>
</div></div>
-
<p>The next step is to actually write the configuration file:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">
@@ -242,7 +240,6 @@ Apache CXF -- Servlet Transport
<h2><a shape="rect" name="ServletTransport-Redirectingrequestsandservingthestaticcontent"></a>Redirecting requests and serving the static content</h2>
-
<p>Starting from CXF 2.2.5 it is possible to configure CXFServlet to redirect current requests to other servlets or serve the static resources.</p>
<p>"redirects-list" init parameter can be used to provide a space separated list of URI patterns; if a given request URI matches one of the patterns then CXFServlet will try to find a RequestDispatcher using the pathInfo of the current HTTP request and will redirect the request to it.</p>
@@ -269,84 +266,82 @@ Apache CXF -- Servlet Transport
<p>Starting from CXF 2.5.5 and 2.6.2 it is possible to configure CXFServlet to serve welcome pages in a number of ways.</p>
-<p>For example, lets assume we have a web application called "webapp" which has a root resource called "index.html".<br clear="none">
-For CXFServlet to support both "/webapp" and "/webapp/index.html" requests returning "index.html", while letting all other requests to proceed to the actual endpoints, the following can be done.</p>
+<p>For example, lets assume we have a web application called "webapp" which has a root resource called "index.html". For CXFServlet to support both "/webapp" and "/webapp/index.html" requests returning "index.html", while letting all other requests to proceed to the actual endpoints, the following can be done.</p>
<p>Option1. Delegating to Default Servlet</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">
<span class="code-tag"><servlet></span>
- <span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
- <span class="code-tag"><display-name></span>CXF Servlet<span class="code-tag"></display-name></span>
- <span class="code-tag"><servlet-class></span>
- org.apache.cxf.transport.servlet.CXFServlet
- <span class="code-tag"></servlet-class></span>
- <span class="code-tag"><init-param></span>
- <span class="code-tag"><param-name></span>redirects-list<span class="code-tag"></param-name></span>
- <span class="code-tag"><param-value></span>
- /
- /index.html
- <span class="code-tag"></param-value></span>
- <span class="code-tag"></init-param></span>
- <span class="code-tag"><init-param></span>
- <span class="code-tag"><param-name></span>redirect-attributes<span class="code-tag"></param-name></span>
- <span class="code-tag"><param-value></span>
- javax.servlet.include.request_uri
- <span class="code-tag"></param-value></span>
- <span class="code-tag"></init-param></span>
- <span class="code-tag"><init-param></span>
- <span class="code-tag"><param-name></span>redirect-servlet-name<span class="code-tag"></param-name></span>
- <span class="code-tag"><param-value></span>default<span class="code-tag"></param-value></span>
- <span class="code-tag"></init-param></span>
- <span class="code-tag"><load-on-startup></span>1<span class="code-tag"></load-on-startup></span>
- <span class="code-tag"></servlet></span>
- <span class="code-tag"><servlet-mapping></span>
- <span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
- <span class="code-tag"><url-pattern></span>/*<span class="code-tag"></url-pattern></span>
- <span class="code-tag"></servlet-mapping></span>
-
- <span class="code-tag"><welcome-file-list></span>
- <span class="code-tag"><welcome-file></span>index.html<span class="code-tag"></welcome-file></span>
- <span class="code-tag"></welcome-file-list></span>
+ <span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
+ <span class="code-tag"><display-name></span>CXF Servlet<span class="code-tag"></display-name></span>
+ <span class="code-tag"><servlet-class></span>
+ org.apache.cxf.transport.servlet.CXFServlet
+ <span class="code-tag"></servlet-class></span>
+ <span class="code-tag"><init-param></span>
+ <span class="code-tag"><param-name></span>redirects-list<span class="code-tag"></param-name></span>
+ <span class="code-tag"><param-value></span>
+ /
+ /index.html
+ <span class="code-tag"></param-value></span>
+ <span class="code-tag"></init-param></span>
+ <span class="code-tag"><init-param></span>
+ <span class="code-tag"><param-name></span>redirect-attributes<span class="code-tag"></param-name></span>
+ <span class="code-tag"><param-value></span>
+ javax.servlet.include.request_uri
+ <span class="code-tag"></param-value></span>
+ <span class="code-tag"></init-param></span>
+ <span class="code-tag"><init-param></span>
+ <span class="code-tag"><param-name></span>redirect-servlet-name<span class="code-tag"></param-name></span>
+ <span class="code-tag"><param-value></span>default<span class="code-tag"></param-value></span>
+ <span class="code-tag"></init-param></span>
+ <span class="code-tag"><load-on-startup></span>1<span class="code-tag"></load-on-startup></span>
+<span class="code-tag"></servlet></span>
+
+<span class="code-tag"><servlet-mapping></span>
+ <span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
+ <span class="code-tag"><url-pattern></span>/*<span class="code-tag"></url-pattern></span>
+<span class="code-tag"></servlet-mapping></span>
+
+<span class="code-tag"><welcome-file-list></span>
+ <span class="code-tag"><welcome-file></span>index.html<span class="code-tag"></welcome-file></span>
+<span class="code-tag"></welcome-file-list></span>
</pre>
</div></div>
-<p>Note that the redirects-list parameter has two space separated values, "/" and "index.html".<br clear="none">
-The request attribute 'javax.servlet.include.request_uri' might need to be set for the underlying container like Jetty to successfully read "index.html".</p>
+<p>Note that the redirects-list parameter has two space separated values, "/" and "index.html". The request attribute 'javax.servlet.include.request_uri' might need to be set for the underlying container like Jetty to successfully read "index.html".</p>
<p>Option2. Using CXFServlet itself to read index.html</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml">
<span class="code-tag"><servlet></span>
- <span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
- <span class="code-tag"><display-name></span>CXF Servlet<span class="code-tag"></display-name></span>
- <span class="code-tag"><servlet-class></span>
- org.apache.cxf.transport.servlet.CXFServlet
- <span class="code-tag"></servlet-class></span>
- <span class="code-tag"><init-param></span>
- <span class="code-tag"><param-name></span>static-welcome-file<span class="code-tag"></param-name></span>
- <span class="code-tag"><param-value></span>/index.html<span class="code-tag"></param-value></span>
- <span class="code-tag"></init-param></span>
- <span class="code-tag"><init-param></span>
- <span class="code-tag"><param-name></span>static-resources-list<span class="code-tag"></param-name></span>
- <span class="code-tag"><param-value></span>/index.html<span class="code-tag"></param-value></span>
- <span class="code-tag"></init-param></span>
- <span class="code-tag"><load-on-startup></span>1<span class="code-tag"></load-on-startup></span>
- <span class="code-tag"></servlet></span>
- <span class="code-tag"><servlet-mapping></span>
- <span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
- <span class="code-tag"><url-pattern></span>/*<span class="code-tag"></url-pattern></span>
- <span class="code-tag"></servlet-mapping></span>
+ <span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
+ <span class="code-tag"><display-name></span>CXF Servlet<span class="code-tag"></display-name></span>
+ <span class="code-tag"><servlet-class></span>
+ org.apache.cxf.transport.servlet.CXFServlet
+ <span class="code-tag"></servlet-class></span>
+ <span class="code-tag"><init-param></span>
+ <span class="code-tag"><param-name></span>static-welcome-file<span class="code-tag"></param-name></span>
+ <span class="code-tag"><param-value></span>/index.html<span class="code-tag"></param-value></span>
+ <span class="code-tag"></init-param></span>
+ <span class="code-tag"><init-param></span>
+ <span class="code-tag"><param-name></span>static-resources-list<span class="code-tag"></param-name></span>
+ <span class="code-tag"><param-value></span>/index.html<span class="code-tag"></param-value></span>
+ <span class="code-tag"></init-param></span>
+ <span class="code-tag"><load-on-startup></span>1<span class="code-tag"></load-on-startup></span>
+<span class="code-tag"></servlet></span>
+<span class="code-tag"><servlet-mapping></span>
+ <span class="code-tag"><servlet-name></span>CXFServlet<span class="code-tag"></servlet-name></span>
+ <span class="code-tag"><url-pattern></span>/*<span class="code-tag"></url-pattern></span>
+<span class="code-tag"></servlet-mapping></span>
</pre>
</div></div>
-
<h2><a shape="rect" name="ServletTransport-PublishinganendpointwiththeAPI"></a>Publishing an endpoint with the API</h2>
-<p>Once your Servlet is registered in your web.xml, you should set the default bus with CXFServlet's bus to make sure that CXF uses it as it's HTTP Transport. Simply publish with the related path "Greeter" and your service should appear at the address you specify:</p>
+<p>Once your Servlet is registered in your web.xml, you should set the default bus with CXFServlet's bus to make sure that CXF uses it as its HTTP Transport. Simply publish with the related path "Greeter" and your service should appear at the address you specify:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
<span class="code-keyword">import</span> javax.xml.ws.Endpoint;
@@ -365,14 +360,14 @@ Endpoint.publish(<span class="code-quote
<p><b>NOTE:</b> </p>
-<p>Endpoint.publish(...) is a JAX-WS API for publishing JAX-WS endpoints. Thus, it would require the JAX-WS module and API's to be present. If you are not using JAX-WS or want more control over the published endpoint properties, you should replace that call with the proper calls to the appropriate ServerFactory.</p>
+<p>Endpoint.publish(...) is a JAX-WS API for publishing JAX-WS endpoints. Thus, it would require the JAX-WS module and APIs to be present. If you are not using JAX-WS or want more control over the published endpoint properties, you should replace that call with the proper calls to the appropriate ServerFactory.</p>
-<p>Since CXFServlet know nothing about the web container listen port and the application context path, you need to specify the relate path instead of full http address.</p>
+<p>Since CXFServlet know nothing about the web container listening port and the application context path, you need to specify the relative path instead of the full http address.</p>
<h2><a shape="rect" name="ServletTransport-UsingtheservlettransportwithoutSpring"></a>Using the servlet transport without Spring</h2>
-<p>Some user who doesn't want to touch any Spring stuff could also publish the endpoint with CXF servlet transport. First you should extend the CXFNonSpringServlet and then override the method loadBus which below codes:</p>
+<p>A user who doesn't want to touch any Spring stuff could also publish the endpoint with CXF servlet transport. First you should extend the CXFNonSpringServlet and then override the method loadBus, e.g.:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
<span class="code-keyword">import</span> javax.xml.ws.Endpoint;
Modified: websites/production/cxf/content/dosgi-apache-karaf-feature.html
==============================================================================
--- websites/production/cxf/content/dosgi-apache-karaf-feature.html (original)
+++ websites/production/cxf/content/dosgi-apache-karaf-feature.html Mon Jan 7 10:47:59 2013
@@ -173,7 +173,36 @@ zookeeper.host:127.0.0.1
clientPort:2181
zookeeper.port:2181
</pre>
-</div></div></div>
+</div></div>
+
+<h2><a shape="rect" name="DOSGiApacheKarafFeature-Testinstallationwithgreeterdemo"></a>Test installation with greeter demo</h2>
+
+<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
+<pre class="code-java">
+install -s mvn:org.apache.cxf.dosgi.samples/cxf-dosgi-ri-samples-greeter-<span class="code-keyword">interface</span>/1.4-SNAPSHOT
+install -s mvn:org.apache.cxf.dosgi.samples/cxf-dosgi-ri-samples-greeter-impl/1.4-SNAPSHOT
+</pre>
+</div></div>
+
+
+<p>log:display should show the greeter service being exported:</p>
+<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
+<pre class="code-java">
+2013-01-07 10:50:52,108 | INFO | pool-13-thread-1 | TopologyManagerExport | r.exporter.TopologyManagerExport 257 | 114 - cxf-dosgi-ri-topology-manager - 1.4.0.SNAPSHOT | TopologyManager: export sucessful Endpoints: [Endpoint Desctiption <span class="code-keyword">for</span> ServiceReference [org.apache.cxf.dosgi.samples.greeter.GreeterService]
+*** EndpointDescription: ****
+endpoint.framework.uuid => 74455213-0926-4fa8-b3eb-0f9b4d15f119
+endpoint.id => http:<span class="code-comment">//localhost:9090/greeter
+</span>endpoint.<span class="code-keyword">package</span>.version.org.apache.cxf.dosgi.samples.greeter => 0.0.0
+endpoint.service.id => 252
+objectClass => [org.apache.cxf.dosgi.samples.greeter.GreeterService]
+org.apache.cxf.ws.address => http:<span class="code-comment">//localhost:9090/greeter
+</span>service.imported => <span class="code-keyword">true</span>
+service.imported.configs => [org.apache.cxf.ws]
+service.intents => [SOAP.1_1, HTTP, SOAP]
+]
+</pre>
+</div></div>
+</div>
</div>
<!-- Content -->
</td>