You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicemix.apache.org by js...@apache.org on 2006/06/23 21:34:36 UTC
svn commit: r416805 - /incubator/servicemix/site/servicemix-http.html
Author: jstrachan
Date: Fri Jun 23 12:34:36 2006
New Revision: 416805
URL: http://svn.apache.org/viewvc?rev=416805&view=rev
Log:
Latest export from confluence
Modified:
incubator/servicemix/site/servicemix-http.html
Modified: incubator/servicemix/site/servicemix-http.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/servicemix-http.html?rev=416805&r1=416804&r2=416805&view=diff
==============================================================================
--- incubator/servicemix/site/servicemix-http.html (original)
+++ incubator/servicemix/site/servicemix-http.html Fri Jun 23 12:34:36 2006
@@ -322,7 +322,13 @@
<P>A consumer endpoint is a server-side http endpoint that will consumer plain HTTP, or HTTP+SOAP requests and send them into the NMR to a given JBI endpoint, which is called the proxied endpoint.</P>
<P>Following is an example of an http consumer endpoint.</P>
-
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><http:endpoint service=<SPAN class="code-quote">"test:MyConsumerService"</SPAN>
+ endpoint=<SPAN class="code-quote">"myConsumer"</SPAN>
+ role=<SPAN class="code-quote">"consumer"</SPAN>
+ locationURI=<SPAN class="code-quote">"http://localhost:8192/Service/"</SPAN>
+ defaultMep=<SPAN class="code-quote">"http://www.w3.org/2004/08/wsdl/in-out"</SPAN> /></PRE>
+</DIV></DIV>
<TABLE cellpadding="5" width="85%" cellspacing="8px" class="infoMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Consumer endpoint attributes</B><BR>
<TABLE class="confluenceTable"><TBODY>
<TR>
@@ -417,7 +423,13 @@
<P>A provider endpoint is a client-side jbi endpoint which can receive requests from the NMR and send them to a given url where the service is provided.</P>
<P>Here is an example of an http provider endpoint:</P>
-
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><http:endpoint service=<SPAN class="code-quote">"test:MyProviderService"</SPAN>
+ endpoint=<SPAN class="code-quote">"myProvider"</SPAN>
+ role=<SPAN class="code-quote">"provider"</SPAN>
+ locationURI=<SPAN class="code-quote">"http://localhost:8192/Service/"</SPAN>
+ wsdlResource=<SPAN class="code-quote">"classpath:provider.wsdl"</SPAN> /></PRE>
+</DIV></DIV>
<TABLE cellpadding="5" width="85%" cellspacing="8px" class="infoMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Provider endpoint attributes</B><BR>
<TABLE class="confluenceTable"><TBODY>
<TR>
@@ -463,6 +475,12 @@
<TD class="confluenceTd"> no (defaults to false) </TD>
</TR>
<TR>
+<TD class="confluenceTd"> soapAction </TD>
+<TD class="confluenceTd"> String </TD>
+<TD class="confluenceTd"> the SOAPAction header to send when invoking the web service </TD>
+<TD class="confluenceTd"> no (defaults to "") </TD>
+</TR>
+<TR>
<TD class="confluenceTd"> wsdlResource </TD>
<TD class="confluenceTd"> <SPAN class="nobr"><A href="http://springframework.org/docs/api/org/springframework/core/io/Resource.html" title="Visit page outside Confluence" rel="nofollow">Spring resource<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> </TD>
<TD class="confluenceTd"> if set, the wsdl will be retrieved from the given Spring resource </TD>
@@ -475,7 +493,30 @@
<P>Both consumer and provider endpoints support SSL.</P>
<P>SSL parameters can be provided using the following syntax:</P>
-
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><http:endpoint service=<SPAN class="code-quote">"testSsl:MyConsumerService"</SPAN>
+ endpoint=<SPAN class="code-quote">"myConsumer"</SPAN>
+ role=<SPAN class="code-quote">"consumer"</SPAN>
+ locationURI=<SPAN class="code-quote">"https://localhost:8193/Service/"</SPAN>
+ defaultMep=<SPAN class="code-quote">"http://www.w3.org/2004/08/wsdl/in-out"</SPAN>>
+ <SPAN class="code-tag"><http:ssl></SPAN>
+ <http:sslParameters keyStore=<SPAN class="code-quote">"classpath:org/apache/servicemix/http/server.keystore"</SPAN>
+ keyStorePassword=<SPAN class="code-quote">"password"</SPAN>/>
+ <SPAN class="code-tag"></http:ssl></SPAN>
+<SPAN class="code-tag"></http:endpoint></SPAN>
+
+<http:endpoint service=<SPAN class="code-quote">"testSsl:MyProviderService"</SPAN>
+ endpoint=<SPAN class="code-quote">"myProvider"</SPAN>
+ role=<SPAN class="code-quote">"provider"</SPAN>
+ locationURI=<SPAN class="code-quote">"https://localhost:8193/Service/"</SPAN>>
+ <SPAN class="code-tag"><http:ssl></SPAN>
+ <http:sslParameters keyStore=<SPAN class="code-quote">"classpath:org/apache/servicemix/http/server.keystore"</SPAN>
+ keyStorePassword=<SPAN class="code-quote">"password"</SPAN>
+ trustStore=<SPAN class="code-quote">"classpath:org/apache/servicemix/http/client.keystore"</SPAN>
+ trustStorePassword=<SPAN class="code-quote">"password"</SPAN>/>
+ <SPAN class="code-tag"></http:ssl></SPAN>
+<SPAN class="code-tag"></http:endpoint></SPAN></PRE>
+</DIV></DIV>
<TABLE cellpadding="5" width="85%" cellspacing="8px" class="infoMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">SSL attributes</B><BR>
<TABLE class="confluenceTable"><TBODY>
<TR>
@@ -559,13 +600,68 @@
To retrieve the necessary informations from the wsdl, the component can recognize a jbi extension, in addition to the standard http and soap bindings, which specified the role of the component and the default MEP to use for JBI exchanges.</P>
<P>Here is an example of a WSDL:</P>
-
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><definitions name='Consumer'
+ targetNamespace='http://http.servicemix.org/Test'
+ <SPAN class="code-keyword">xmlns:tns</SPAN>='http://http.servicemix.org/Test'
+ <SPAN class="code-keyword">xmlns:http</SPAN>='http://schemas.xmlsoap.org/wsdl/http/'
+ <SPAN class="code-keyword">xmlns:soap</SPAN>='http://schemas.xmlsoap.org/wsdl/soap/'
+ xmlns='http://schemas.xmlsoap.org/wsdl/'
+ <SPAN class="code-keyword">xmlns:jbi</SPAN>='http://servicemix.org/wsdl/jbi/'>
+
+ <SPAN class="code-tag"><portType name='ConsumerInterface'></SPAN>
+ <SPAN class="code-tag"></portType></SPAN>
+
+ <SPAN class="code-tag"><binding name='ConsumerSoapBinding' type='tns:ConsumerInterface'></SPAN>
+ <SPAN class="code-tag"><soap:binding transport=<SPAN class="code-quote">"http"</SPAN>/></SPAN>
+ <SPAN class="code-tag"></binding></SPAN>
+
+ <SPAN class="code-tag"><binding name='ConsumerHttpBinding' type='tns:ConsumerInterface'></SPAN>
+ <SPAN class="code-tag"><http:binding verb=<SPAN class="code-quote">"POST"</SPAN>></SPAN><SPAN class="code-tag"></http:binding></SPAN>
+ <SPAN class="code-tag"></binding></SPAN>
+
+ <SPAN class="code-tag"><service name='ConsumerInOnly'></SPAN>
+ <SPAN class="code-tag"><port name='TestEndpoint' binding='tns:ConsumerSoapBinding'></SPAN>
+ <SPAN class="code-tag"><soap:address location=<SPAN class="code-quote">"http://localhost:8192/InOnly"</SPAN>/></SPAN>
+ <SPAN class="code-tag"><jbi:endpoint role=<SPAN class="code-quote">"consumer"</SPAN> defaultMep='in-only'/></SPAN>
+ <SPAN class="code-tag"></port></SPAN>
+ <SPAN class="code-tag"></service></SPAN>
+
+ <SPAN class="code-tag"><service name='ConsumerInOut'></SPAN>
+ <SPAN class="code-tag"><port name='TestEndpoint' binding='tns:ConsumerHttpBinding'></SPAN>
+ <SPAN class="code-tag"><http:address location=<SPAN class="code-quote">"http://localhost:8192/InOut"</SPAN>/></SPAN>
+ <SPAN class="code-tag"><jbi:endpoint role=<SPAN class="code-quote">"consumer"</SPAN> defaultMep='in-out'/></SPAN>
+ <SPAN class="code-tag"></port></SPAN>
+ <SPAN class="code-tag"></service></SPAN>
+
+<SPAN class="code-tag"></definitions></SPAN></PRE>
+</DIV></DIV>
<H2><A name="servicemix-http-Lightweightmode"></A>Lightweight mode</H2>
<P>The servicemix-http component can also be configured in a spring/xbean configuration file, for use in an embedded ServiceMix.<BR>
Here is an example of such a configuration:</P>
-
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><SPAN class="code-tag"><sm:activationSpec></SPAN>
+ <SPAN class="code-tag"><sm:component></SPAN>
+ <SPAN class="code-tag"><http:component></SPAN>
+ <SPAN class="code-tag"><http:endpoints></SPAN>
+ <http:endpoint service=<SPAN class="code-quote">"test:dummy"</SPAN>
+ endpoint=<SPAN class="code-quote">"dummy"</SPAN>
+ role=<SPAN class="code-quote">"consumer"</SPAN>
+ soap=<SPAN class="code-quote">"true"</SPAN>
+ locationURI=<SPAN class="code-quote">"http://localhost:8192/Service/"</SPAN>
+ defaultMep=<SPAN class="code-quote">"http://www.w3.org/2004/08/wsdl/in-out"</SPAN> />
+
+ <http:endpoint service=<SPAN class="code-quote">"test:MyProviderService"</SPAN>
+ endpoint=<SPAN class="code-quote">"myProvider"</SPAN>
+ role=<SPAN class="code-quote">"provider"</SPAN>
+ locationURI=<SPAN class="code-quote">"http://localhost:8192/Service/"</SPAN> />
+ <SPAN class="code-tag"></http:endpoints></SPAN>
+ <SPAN class="code-tag"></http:component></SPAN>
+ <SPAN class="code-tag"></sm:component></SPAN>
+<SPAN class="code-tag"></sm:activationSpec></SPAN></PRE>
+</DIV></DIV>
<TABLE cellpadding="5" width="85%" cellspacing="8px" class="warningMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Classpath issues when embedding servicemix-http component</B><BR>
<P>When using the servicemix.xml configuration file to create http endpoints, you must include the servicemix-http-xxx.jar in your classpath.<BR>
You will find this file inside the component installer (./components/servicemix-http-xxx.zip).<BR>
@@ -660,8 +756,8 @@
</DIV>
<DIV id="site-footer">
Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnt">gnt</A>,
- last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on May 31, 2006
- (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=1928&originalId=8494">view change</A>)
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Jun 23, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=1928&originalId=8875">view change</A>)
(<A href="http://goopen.org/confluence/pages/editpage.action?pageId=1928">edit page</A>)
</DIV>