You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicemix.apache.org by ge...@apache.org on 2012/09/21 20:51:20 UTC
svn commit: r1388615 [7/29] - in /servicemix/site/production: ./ community/
community/board-reports/ css/ css/scalate/ developers/ developers/source/
downloads/ downloads/subprojects/ images/ mockup/ mockup/theme/ news/
overview/ site/
Added: servicemix/site/production/developers/building.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/developers/building.html?rev=1388615&view=auto
==============================================================================
--- servicemix/site/production/developers/building.html (added)
+++ servicemix/site/production/developers/building.html Fri Sep 21 18:51:14 2012
@@ -0,0 +1,160 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="Apache ServiceMix - An open-source integration container"/>
+ <meta name="keywords" content="business integration, enterprise service bus, enterprise application integration, ESB, EAI, SOA, Service Oriented Architecture, web services, SOAP, JBI, JMS, WSDL, business-to-business, b2b, XML, EDI, Electronic Data Interchange, standards support, integration standards, application integration, java message service, middleware, message broker, software, solutions, services, ActiveMQ, ServiceMix, open source, MQ, message queue, message bus,felix,karaf,camel"/>
+ <meta name="author" content="The Apache ServiceMix Team"/>
+ <link href="../css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/downloads.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Building
+ </title>
+ <script type='text/javascript'>
+ //<![CDATA[
+ var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-398545-1']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })();
+ //]]>
+ </script>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+ <a href="http://servicemix.apache.org/" title="Apache ServiceMix - open-source integration server">
+ <img border="0" src="../images/servicemix-logo.png" width="400px"/>
+ </a>
+ </td>
+ <td align="right">
+ <a href="http://www.apache.org/" Building="The Apache Sofware Foundation">
+ <img border="0" src="../images/asf-logo.png"/>
+ </a>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p><a href="../downloads.html">Downloads</a> | <a href="source.html">Source</a> | <a href="../community/discussion-forums.html">Forums</a> | <a href="../community/support.html">Support</a> | <a href="http://servicemix.apache.org/old/home.html">Old website</a></p>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Overviewindex"><a href="../index.html">Overview</a></h3><ul style="list-style: square"><li><a href="../index.html">Home</a></li><li><a href="../downloads.html">Downloads</a></li><li><a href="../overview/license.html">License</a></li></ul><h3 id="Documentation"><a href="../documentation.html">Documentation</a></h3><ul><li><a href="http://servicemix.apache.org/docs/4.4.x/quickstart/index.html" target="quickstart">Quickstart Guide</a></li><li><a href="http://servicemix.apache.org/docs/4.4.x/index.html" target="documentation">Documentation: 4.4.x</a></li></ul><h3 id="Search">Search</h3><DIV style="padding: 5px 5px 0px 25px;"><FORM action="http://www.google.com/search" method="get" style="font-size: 10px;"><INPUT name="ie" type="hidden" value="UTF-8"></INPUT><INPUT name="oe" type="hidden" value="UTF-8"></INPUT> <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT> <INPUT name="btnG" type="submit" value="Search"></INPUT> <INPUT nam
e="domains" type="hidden" value="servicemix.apache.org"></INPUT> <INPUT name="sitesearch" type="hidden" value="servicemix.apache.org"></INPUT></FORM></DIV><h3 id="Community"><a href="../community.html">Community</a></h3><ul style="list-style: square"><li><a href="../community/support.html">Support</a></li><li><a href="../community/discussion-forums.html">Discussion Forums</a></li><li><a href="../community/mailing-lists.html">Mailing Lists</a></li><li><a href="http://issues.apache.org/activemq/browse/SM">Issues</a></li><li><a href="../community/contributing.html">Contributing</a></li><li><a href="../community/users.html">Users</a></li><li><a href="../community/team.html">Team</a></li></ul><h3 id="Developers"><a href="../developers.html">Developers</a></h3><ul style="list-style: square"><li><a href="source.html">Source</a></li><li><a href="becoming-a-committer.html">Becoming a committer</a></li><li><a href="release-guide.html">Release Guide</a></li><li><a href="related-projec
ts.html">Related Projects</a></li><li><a href="tools.html">Tools</a></li></ul><h3 id="RelatedProjects">Related Projects</h3><ul style="list-style: square"><li><a href="http://karaf.apache.org/" title="OSGi Container">Apache Karaf</a></li><li><a href="http://activemq.apache.org/" title="The most popular and powerful open source Message Bus">Apache ActiveMQ</a></li><li><a href="http://activemq.apache.org/camel/" title="POJO based Enterprise Integration Patterns and routing framework">Apache Camel</a></li><li><a href="http://cxf.apache.org/" title="Service Enablement Framework based on SOAP and JAX-WS">Apache CXF</a></li><li><a href="http://ode.apache.org/" title="Orchestration Engine">Apache ODE</a></li><li><a href="http://jencks.codehaus.org/" title="Message Driven POJOs and pooling for JMS and JDBC">Jencks</a></li><li><a href="http://stomp.codehaus.org/" title="Simple cross language protocol for messaging">Stomp</a></li><li><a href="http://www.springframework.org/" title="Th
e well know framework">Spring</a></li><li><a href="http://geronimo.apache.org/" title="The Apache J2EE server">Geronimo</a></li></ul><h3 id="ApacheSoftwareFoundation">Apache Software Foundation</h3><ul style="list-style: square"><li><a href="http://www.apache.org/licenses/">License</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li><li><a href="http://www.apache.org/security/">Security</a></li></ul>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<div class="note" style="border: 1px solid #F0C000;background-color: #FFFFCE;margin: 20px;padding: 0px 6px 0px 6px;"><p>TODO: Update this page to reflect the multi-project build structure we have and to properly discriminate between ServiceMix 3.x, 4.x and 5.x builds</p></div><h1 id="BuildingServiceMixFromSource">Building ServiceMix From Source </h1><p>ServiceMix uses <a href="http://maven.apache.org/">Maven</a> as its build and management tool. We have tested the build with Maven 2.0.8 and it works fine, but Maven 2.0.9 is known to cause some issues that prevent a successful build for ServiceMix 3.2.1 and previous versions. This has been fixed for 3.2.2 and 3.3. Be sure to read the <a href="Build.html">FAQ</a></p><p>ServiceMix 4.x requires to use Maven 2.2.1 or better.</p><h2 id="Gettingstarted">Getting started</h2><ul><li>Download and <a href="http://maven.apache.org/download.html#Installation">install Maven</a>.</li><li>Get the latest code <a href="source.html">from SVN<
/a></li><li>Build the code with the following command</li></ul><pre>
+mvn -Dmaven.test.skip=true -Pstep1 install
+mvn -Dmaven.test.skip=true -Pstep2 install
+</pre><div class="tip" style="border: 1px solid #090;background-color: #dfd;margin: 20px;padding: 0px 6px 0px 6px;"><p><b>Useful Hints</b></p><ul><li>It may happen, that building step1 fails with an error message regarding PMD or checkstyle. In this case you can add a 'nochecks' to the line so it looks like this:</li></ul><p><tt>mvn -Dmaven.test.skip=true -Pstep1,nochecks install</tt></p><ul><li>Also, if an out of memory error is encountered during compilation, set the MAVEN_OPTS environment variable to a larger amount of memory. Below is an example: </li></ul><p><tt>MAVEN_OPTS=-Xmx768m</tt></p><ul><li>Some dependencies have POMs that specify repository URLs that are no longer valid. This can cause invalid artifacts to be downloaded to your local repository. You can add the following mirror to your maven settings.xml file to avoid this problem:<pre>
+<mirror>
+ <id>servicemix-repo</id>
+ <name>Apache ServiceMix Repository</name>
+ <url>http://svn.apache.org/repos/asf/servicemix/m2-repo/</url>
+ <mirrorOf>servicemix-repo,servicemix-m2-repo</mirrorOf>
+</mirror>
+</pre><div class="tip" style="border: 1px solid #090;background-color: #dfd;margin: 20px;padding: 0px 6px 0px 6px;"><div class="warning" style="border: 1px solid #c00;background-color: #fcc;margin: 20px;padding: 0px 6px 0px 6px;"><p><b>Please Note</b></p><p>There is an <a href="https://issues.apache.org/activemq/browse/SM-1079">issue</a> in building if you use the system property style of declaring the profiles (i.e., -Dprofile=step2) as the XFire Maven plugin thinks step2 is a profile name it should use. This is fixed in the ServiceMix trunk (3.3 or greater). To work around this issue, try the following items below: </p></div><li>Use the -Pstep2 style of declaring the profile as noted above </li><li>Comment out the <a href="http://fisheye6.atlassian.com/browse/servicemix/smx3/tags/servicemix-3.2.1/platforms/pom.xml?r=trunk#l36">Geronimo module in the platform POM</a> </li></div></li><p>Next time you build, you can just run</p><pre>
+mvn -Dmaven.test.skip=true install
+</pre><div class="tip" style="border: 1px solid #090;background-color: #dfd;margin: 20px;padding: 0px 6px 0px 6px;"><p><b>Building 3.1.1</b></p><p>If an out of memory error is encountered when building 3.1.1, <br/>setting the following environmental variable may help</p><p>MAVEN_OPTS=-Xmx768m</p></div><div class="tip" style="border: 1px solid #090;background-color: #dfd;margin: 20px;padding: 0px 6px 0px 6px;"><p><b>Building 3.0-M1 and 3.0-M2</b></p><p>Note that this only works for versions from 3.0-M3.<br/>To build previous versions, you need to run:</p><p>mvn \-N install<br/>cd tooling<br/>mvn install \-Dmaven.test.skip=true<br/>cd ..<br/>mvn install \-Dmaven.test.skip=true</p></div><h2 id="CodeConventions">Code Conventions </h2><p>Checkstyle and PMD rules are used to scour the ServiceMix source code when performing a build. If you are hacking code and it does not follow these conventions, the build will fail. To make things easier on folks who are using Eclipse, there is a
n <a href="http://svn.apache.org/viewvc/servicemix/smx3/branches/servicemix-3.2/build/src/main/resources/smx-eclipse-code-conventions.xml?view=markup">Eclipse code convention profile</a> that matches the Checkstyle conventions, making things a bit easier in this regard. Import this profile into Eclipse under Preferences->Java->Code Style->Formatter->Import. </p><h2 id="UsinganIDE">Using an IDE</h2><h3 id="UsingEclipse">Using Eclipse</h3><p>For <a href="http://www.eclipse.org/">Eclipse</a>, a detailed description is given at <a href="Importing ServiceMix into Eclipse.html">Importing ServiceMix into Eclipse</a>. In addition, this page also describes how to start ServiceMix inside Eclipse with all debugging possibilities.</p><h3 id="OtherIDEs">Other IDEs</h3><p>Any modern IDE with self respect can start a new project based on a Maven pom.xml file. </p><p>Note that you may need to build the whole ServiceMix project once using maven.</p><p>Please refer to the <a href="http://mave
n.apache.org/plugins/index.html">plugin reference</a> for more details on using them.</p></ul></div>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation -
+ <a href="../site/privacy-policy.page">Privacy Policy</a>
+ <br/>
+ Apache ServiceMix, ServiceMix, Apache, the Apache feather logo, and the Apache ServiceMix project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
Added: servicemix/site/production/developers/coding-standards.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/developers/coding-standards.html?rev=1388615&view=auto
==============================================================================
--- servicemix/site/production/developers/coding-standards.html (added)
+++ servicemix/site/production/developers/coding-standards.html Fri Sep 21 18:51:14 2012
@@ -0,0 +1,233 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="Apache ServiceMix - An open-source integration container"/>
+ <meta name="keywords" content="business integration, enterprise service bus, enterprise application integration, ESB, EAI, SOA, Service Oriented Architecture, web services, SOAP, JBI, JMS, WSDL, business-to-business, b2b, XML, EDI, Electronic Data Interchange, standards support, integration standards, application integration, java message service, middleware, message broker, software, solutions, services, ActiveMQ, ServiceMix, open source, MQ, message queue, message bus,felix,karaf,camel"/>
+ <meta name="author" content="The Apache ServiceMix Team"/>
+ <link href="../css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/downloads.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Coding standards
+ </title>
+ <script type='text/javascript'>
+ //<![CDATA[
+ var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-398545-1']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })();
+ //]]>
+ </script>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+ <a href="http://servicemix.apache.org/" title="Apache ServiceMix - open-source integration server">
+ <img border="0" src="../images/servicemix-logo.png" width="400px"/>
+ </a>
+ </td>
+ <td align="right">
+ <a href="http://www.apache.org/" Coding standards="The Apache Sofware Foundation">
+ <img border="0" src="../images/asf-logo.png"/>
+ </a>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p><a href="../downloads.html">Downloads</a> | <a href="source.html">Source</a> | <a href="../community/discussion-forums.html">Forums</a> | <a href="../community/support.html">Support</a> | <a href="http://servicemix.apache.org/old/home.html">Old website</a></p>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Overviewindex"><a href="../index.html">Overview</a></h3><ul style="list-style: square"><li><a href="../index.html">Home</a></li><li><a href="../downloads.html">Downloads</a></li><li><a href="../overview/license.html">License</a></li></ul><h3 id="Documentation"><a href="../documentation.html">Documentation</a></h3><ul><li><a href="http://servicemix.apache.org/docs/4.4.x/quickstart/index.html" target="quickstart">Quickstart Guide</a></li><li><a href="http://servicemix.apache.org/docs/4.4.x/index.html" target="documentation">Documentation: 4.4.x</a></li></ul><h3 id="Search">Search</h3><DIV style="padding: 5px 5px 0px 25px;"><FORM action="http://www.google.com/search" method="get" style="font-size: 10px;"><INPUT name="ie" type="hidden" value="UTF-8"></INPUT><INPUT name="oe" type="hidden" value="UTF-8"></INPUT> <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT> <INPUT name="btnG" type="submit" value="Search"></INPUT> <INPUT nam
e="domains" type="hidden" value="servicemix.apache.org"></INPUT> <INPUT name="sitesearch" type="hidden" value="servicemix.apache.org"></INPUT></FORM></DIV><h3 id="Community"><a href="../community.html">Community</a></h3><ul style="list-style: square"><li><a href="../community/support.html">Support</a></li><li><a href="../community/discussion-forums.html">Discussion Forums</a></li><li><a href="../community/mailing-lists.html">Mailing Lists</a></li><li><a href="http://issues.apache.org/activemq/browse/SM">Issues</a></li><li><a href="../community/contributing.html">Contributing</a></li><li><a href="../community/users.html">Users</a></li><li><a href="../community/team.html">Team</a></li></ul><h3 id="Developers"><a href="../developers.html">Developers</a></h3><ul style="list-style: square"><li><a href="source.html">Source</a></li><li><a href="becoming-a-committer.html">Becoming a committer</a></li><li><a href="release-guide.html">Release Guide</a></li><li><a href="related-projec
ts.html">Related Projects</a></li><li><a href="tools.html">Tools</a></li></ul><h3 id="RelatedProjects">Related Projects</h3><ul style="list-style: square"><li><a href="http://karaf.apache.org/" title="OSGi Container">Apache Karaf</a></li><li><a href="http://activemq.apache.org/" title="The most popular and powerful open source Message Bus">Apache ActiveMQ</a></li><li><a href="http://activemq.apache.org/camel/" title="POJO based Enterprise Integration Patterns and routing framework">Apache Camel</a></li><li><a href="http://cxf.apache.org/" title="Service Enablement Framework based on SOAP and JAX-WS">Apache CXF</a></li><li><a href="http://ode.apache.org/" title="Orchestration Engine">Apache ODE</a></li><li><a href="http://jencks.codehaus.org/" title="Message Driven POJOs and pooling for JMS and JDBC">Jencks</a></li><li><a href="http://stomp.codehaus.org/" title="Simple cross language protocol for messaging">Stomp</a></li><li><a href="http://www.springframework.org/" title="Th
e well know framework">Spring</a></li><li><a href="http://geronimo.apache.org/" title="The Apache J2EE server">Geronimo</a></li></ul><h3 id="ApacheSoftwareFoundation">Apache Software Foundation</h3><ul style="list-style: square"><li><a href="http://www.apache.org/licenses/">License</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li><li><a href="http://www.apache.org/security/">Security</a></li></ul>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<p>This page describes the standards used for Apache ServiceMix code (java, xml, whatever). Code is read by a human being more often than it is written by a human being, make the code a pleasure to read. If you're using Eclipse, configuration files for your IDE can be found at http://svn.apache.org/repos/asf/servicemix/smx3/trunk/etc/eclipse/</p><h1 id="Indentation">Indentation</h1><h2 id="Java">Java</h2><p>Lets follow Sun's coding standard rules which are pretty common in Java.</p><p>http://java.sun.com/docs/codeconv/</p><p>http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html</p><p> * 4 characters indentation<br/> * <strong>No tabs</strong> please!</p><p>Correct brace style:</p><pre class="java code-java">
+public class Foo {
+ public void foo(boolean a, int x, int y, int z) {
+ do {
+ try {
+ if (x > 0) {
+ int someVariable = a ? x : y;
+ } else if (x < 0) {
+ int someVariable = (y + z);
+ someVariable = x = x + y;
+ } else {
+ for (int i = 0; i < 5; i++) {
+ doSomething(i);
+ }
+ }
+
+ switch (a) {
+ case 0:
+ doCase0();
+ break;
+ default:
+ doDefault();
+ }
+ } catch (Exception e) {
+ processException(e.getMessage(), x + y, z, a);
+ } finally {
+ processFinally();
+ }
+ } while (true);
+
+ if (2 < 3) {
+ return;
+ }
+
+ if (3 < 4) {
+ return;
+ }
+
+ do {
+ x++
+ } while (x < 10000);
+
+ while (x < 50000) {
+ x++;
+ }
+
+ for (int i = 0; i < 5; i++) {
+ System.out.println(i);
+ }
+ }
+
+ private class InnerClass implements I1, I2 {
+ public void bar() throws E1, E2 {
+ }
+ }
+}
+</pre><h2 id="XML">XML</h2><p> * Use 4 characters. This is to allow IDEs such as Eclipse to use a unified formatting convention<br/> * <strong>No tabs</strong> please!</p><h1 id="Interfaces">Interfaces</h1><p>All methods of an interface are public abstract, therefore it is not necessary to specify public abstract modifiers. Similarly all fields are public static final.</p><p>However this behavior works best with most tools and IDEs and seems to be common practice so we see no reason to disallow this practice. e.g:</p><pre class="java code-java">
+public interface MyInterface {
+ public static final int MY_INTEGER = 0;
+
+ public abstract void doSomething();
+}
+</pre><p>This has the added advantage that the interface can be converted into an abstract class (and copy and paste individual definitions) without changing anything.</p><p>Preferably add public/static/final to constants, and public/abstract to methods, but it's not mandatory. However, if it's there, don't take it out.</p><h1 id="Exceptions">Exceptions</h1><p> * A situation is only exceptional, if the program can not handle it with reasonably effort. Wrong input data should be an expected situation of the regular code, that could be handled gracefully.<br/> * The intention of exception-handling is to separate real error-handling from the regular part of the code, so don't force the caller to mix it with unnecessary exceptions.<br/> * Only if your code really has a problem to continue e.g., when a parameter is invalid, feel free to throw an exception!<br/> * Do NOT throw an exception, if you only suppose the caller of your code could have a problem with a special result. Try
to return a special result value instead e.g., null, and let the caller decide with a regular if-else-statement. If the caller really has a problem, HE WILL throw an exception on his own.<br/> * But if your code throws an exception, even though it has no real problem and it could continue without an exception and return a special result value, you forestall the decision of the caller, whether the special result is really an error or not.<br/> * If you throw an exception, where the caller would decide that it is no error in the context of the caller, you force the caller to write an exception handler in his regular part or to abort i.e., you force the caller to mix regular code with exception handling. That is the opposite of the intentention of exception handling.<br/> * Bad example:<br/><strong><tt>java.lang.Class.forName(String) throws ClassNotFoundException</tt></strong><br/>In most programs/situations it is an error if this method does not find the class, therefore it t
hrows an exception and forestalls the decision of the caller.<br/>But maybe there is a program that should check a list of class names, whether the classes are present or not. Such a program is forced to mix its regular code with error handling of an exception, that is no error at all in that context. <br/>The method should return a special result value instead: null. Many callers of that method have expected that situation and therefore are not in an unexpected situation/exceptional state. They could decide the situation on their own.<br/> * Only throw checked exceptions (not derived from <tt>RuntimeException</tt>), if the caller has a chance to handle it. <br/> * Exceptions that signal programming errors or system failures usually cannot be handled/repaired at runtime -> unchecked exception. <br/> * If your code really has a problem to continue e.g., when a parameter is invalid, throw an unchecked exception (derived from <tt>RuntimeException</tt>) and do NOT throw a checke
d exception, because if not even your code can handle the problem, in the very most cases the caller has no chance to handle the problem, too. Instead there maybe somebody somewhere in the highest layers who catches all <tt>RuntimeException</tt>'s, logs them and continues the regular service.<br/> * Only if it is not possible to return special result values cleanly, use checked exceptions to force the caller to decide the situation. The caller should deescalate the situation by catching and handling one or more checked exceptions, e.g. with special result values(\?) or by escalating with an unchecked exception, because the situation is an error, that can not be handled.<br/> * Checked exceptions are an official part of the interface, therefore do not propagate checked exceptions from one abstraction layer to another, because usually this would break the lower abstraction. E.g. do not propagate SQLException to another layer, because SQLExceptions are an implementation detail,
that may change in the future and such changes should not affect the interfaces and their callers.<br/> * Never throw <tt>NullPointerException</tt> or <tt>RuntimeException</tt>. Use either <tt>IllegalArgumentException</tt>, or <tt>NullArgumentException</tt> (which is a subclass of <tt>IllegalArgumentException</tt> anyway). If there isn't a suitable subclass available for representing an exception, create your own.</p><h1 id="PackageNaming">Package Naming</h1><p> * Package names are lowercase.<br/> * Package names should only contain alpha-numberic characters.<br/> * Package names should be suffixed with the name of the module in which they are defined</p><p>For example, if the module name is <em>common</em>, then the base package name should be <tt>org.apache.geronimo.common</tt>.</p><p><strong>Note:</strong> This is more of a <em>guideline</em> than a <em>rule</em>, as some modules simply can not follow this convention, but where applicable they should.</p><h1 id="Imports"
>Imports</h1><p> * Should be fully qualified e.g. <tt>import java.util.Vector</tt> and not <tt>java.util.*</tt><br/> * Should be sorted alphabetically, with <em>java</em>, then <em>javax</em> packages listed first, and then other packages sorted by package name.</p><h2 id="IDEAutoFormatting">IDE Auto-Formatting</h2><p> * Eclipse users can <br/> * use <tt>Source -> Organise Imports</tt> to organize imports<br/> * use <tt>Source -> Format</tt> to format code (please use default Eclipse formatting conventions, which are as above)<br/> * IntelliJ users can <br/> * use <tt>Tools -> Organise Imports</tt> to organize imports<br/> * use <tt>Tools -> Reformat code</tt> to format code (uses the code style setting in IDE options)</p><p>The eclipse formater settings are available <a href="^eclipse-formater.xml">here</a>.</p><h1 id="JavaDocTags">JavaDoc Tags</h1><p> @version Should be: <tt>@version $Revision$ $Date$</tt></p><p> @author Should not be used in source code at all.</p><h1 i
d="UnitTestCases">Unit Test Cases</h1><p> * Use the naming scheme <tt>*Test.java</tt> for unit tests.<br/> * Do not define <tt>public static Test suite\()</tt> or constructor methods, the build system will automatically do the right thing without them.</p><h1 id="Logging">Logging</h1><p> * Log as much as necessary for someone to figure out what broke :-)<br/> * Use <tt>org.apache.commons.logging.Log</tt> rather than raw <em>Log4j</em><br/> * Do not log throwables that you throw - leave it to the caller<br/> * Use flags to avoid string concatenation for <em>debug</em> and <em>trace</em><br/> * Cache flags (especially for <em>trace</em>) to avoid excessive <tt>isTraceEnabled()</tt> calls</p><h2 id="Levels">Levels</h2><p> * Use <em>trace</em> level for detailed/diagnostic logging<br/> * Use <em>debug</em> level for things an application developer would need to know<br/> * Use <em>info</em> level for things an administrator would need to know<br/> * Use <em>warn</em> level for t
hings indicating an application or transient problem<br/> * Use <em>error</em> level for things indicating a problem with the server itself<br/> * Use <em>fatal</em> level for things that mean this instance is compromised</p><h2 id="Example">Example</h2><pre class="java code-java">
+private static final Log log = LogFactory.getLog(MyClass.class);
+
+public void doSomeStuff(Stuff stuff) throws StuffException {
+ boolean logTrace = log.isTraceEnabled();
+ try {
+ if (logTrace) {
+ log.trace("About to do stuff " + stuff);
+ }
+ stuff.doSomething();
+ if (logTrace) {
+ log.trace("Did some stuff ");
+ }
+ } catch (BadException e) {
+ // don't log - leave it to caller
+ throw new StuffException("Something bad happened", e);
+ } catch (IgnorableException e) {
+ // didn't cache this as we don't expect to come here a lot
+ if (log.isDebugEnabled()) {
+ log.debug("Ignoring problem doing stuff "+stuff, e);
+ }
+ }
+}
+</pre>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation -
+ <a href="../site/privacy-policy.page">Privacy Policy</a>
+ <br/>
+ Apache ServiceMix, ServiceMix, Apache, the Apache feather logo, and the Apache ServiceMix project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
Added: servicemix/site/production/developers/related-projects.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/developers/related-projects.html?rev=1388615&view=auto
==============================================================================
--- servicemix/site/production/developers/related-projects.html (added)
+++ servicemix/site/production/developers/related-projects.html Fri Sep 21 18:51:14 2012
@@ -0,0 +1,148 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="Apache ServiceMix - An open-source integration container"/>
+ <meta name="keywords" content="business integration, enterprise service bus, enterprise application integration, ESB, EAI, SOA, Service Oriented Architecture, web services, SOAP, JBI, JMS, WSDL, business-to-business, b2b, XML, EDI, Electronic Data Interchange, standards support, integration standards, application integration, java message service, middleware, message broker, software, solutions, services, ActiveMQ, ServiceMix, open source, MQ, message queue, message bus,felix,karaf,camel"/>
+ <meta name="author" content="The Apache ServiceMix Team"/>
+ <link href="../css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/downloads.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Related Projects
+ </title>
+ <script type='text/javascript'>
+ //<![CDATA[
+ var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-398545-1']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })();
+ //]]>
+ </script>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+ <a href="http://servicemix.apache.org/" title="Apache ServiceMix - open-source integration server">
+ <img border="0" src="../images/servicemix-logo.png" width="400px"/>
+ </a>
+ </td>
+ <td align="right">
+ <a href="http://www.apache.org/" Related Projects="The Apache Sofware Foundation">
+ <img border="0" src="../images/asf-logo.png"/>
+ </a>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p><a href="../downloads.html">Downloads</a> | <a href="source.html">Source</a> | <a href="../community/discussion-forums.html">Forums</a> | <a href="../community/support.html">Support</a> | <a href="http://servicemix.apache.org/old/home.html">Old website</a></p>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Overviewindex"><a href="../index.html">Overview</a></h3><ul style="list-style: square"><li><a href="../index.html">Home</a></li><li><a href="../downloads.html">Downloads</a></li><li><a href="../overview/license.html">License</a></li></ul><h3 id="Documentation"><a href="../documentation.html">Documentation</a></h3><ul><li><a href="http://servicemix.apache.org/docs/4.4.x/quickstart/index.html" target="quickstart">Quickstart Guide</a></li><li><a href="http://servicemix.apache.org/docs/4.4.x/index.html" target="documentation">Documentation: 4.4.x</a></li></ul><h3 id="Search">Search</h3><DIV style="padding: 5px 5px 0px 25px;"><FORM action="http://www.google.com/search" method="get" style="font-size: 10px;"><INPUT name="ie" type="hidden" value="UTF-8"></INPUT><INPUT name="oe" type="hidden" value="UTF-8"></INPUT> <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT> <INPUT name="btnG" type="submit" value="Search"></INPUT> <INPUT nam
e="domains" type="hidden" value="servicemix.apache.org"></INPUT> <INPUT name="sitesearch" type="hidden" value="servicemix.apache.org"></INPUT></FORM></DIV><h3 id="Community"><a href="../community.html">Community</a></h3><ul style="list-style: square"><li><a href="../community/support.html">Support</a></li><li><a href="../community/discussion-forums.html">Discussion Forums</a></li><li><a href="../community/mailing-lists.html">Mailing Lists</a></li><li><a href="http://issues.apache.org/activemq/browse/SM">Issues</a></li><li><a href="../community/contributing.html">Contributing</a></li><li><a href="../community/users.html">Users</a></li><li><a href="../community/team.html">Team</a></li></ul><h3 id="Developers"><a href="../developers.html">Developers</a></h3><ul style="list-style: square"><li><a href="source.html">Source</a></li><li><a href="becoming-a-committer.html">Becoming a committer</a></li><li><a href="release-guide.html">Release Guide</a></li><li><a href="related-projec
ts.html">Related Projects</a></li><li><a href="tools.html">Tools</a></li></ul><h3 id="RelatedProjects">Related Projects</h3><ul style="list-style: square"><li><a href="http://karaf.apache.org/" title="OSGi Container">Apache Karaf</a></li><li><a href="http://activemq.apache.org/" title="The most popular and powerful open source Message Bus">Apache ActiveMQ</a></li><li><a href="http://activemq.apache.org/camel/" title="POJO based Enterprise Integration Patterns and routing framework">Apache Camel</a></li><li><a href="http://cxf.apache.org/" title="Service Enablement Framework based on SOAP and JAX-WS">Apache CXF</a></li><li><a href="http://ode.apache.org/" title="Orchestration Engine">Apache ODE</a></li><li><a href="http://jencks.codehaus.org/" title="Message Driven POJOs and pooling for JMS and JDBC">Jencks</a></li><li><a href="http://stomp.codehaus.org/" title="Simple cross language protocol for messaging">Stomp</a></li><li><a href="http://www.springframework.org/" title="Th
e well know framework">Spring</a></li><li><a href="http://geronimo.apache.org/" title="The Apache J2EE server">Geronimo</a></li></ul><h3 id="ApacheSoftwareFoundation">Apache Software Foundation</h3><ul style="list-style: square"><li><a href="http://www.apache.org/licenses/">License</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li><li><a href="http://www.apache.org/security/">Security</a></li></ul>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<h3 id="RelatedProjects">Related Projects</h3><ul style="list-style: square"><li><a href="http://karaf.apache.org/" title="OSGi Container">Apache Karaf</a></li><li><a href="http://activemq.apache.org/" title="The most popular and powerful open source Message Bus">Apache ActiveMQ</a></li><li><a href="http://activemq.apache.org/camel/" title="POJO based Enterprise Integration Patterns and routing framework">Apache Camel</a></li><li><a href="http://cxf.apache.org/" title="Service Enablement Framework based on SOAP and JAX-WS">Apache CXF</a></li><li><a href="http://ode.apache.org/" title="Orchestration Engine">Apache ODE</a></li><li><a href="http://jencks.codehaus.org/" title="Message Driven POJOs and pooling for JMS and JDBC">Jencks</a></li><li><a href="http://stomp.codehaus.org/" title="Simple cross language protocol for messaging">Stomp</a></li><li><a href="http://www.springframework.org/" title="The well know framework">Spring</a></li><li><a href="http://geronimo.apache.org/
" title="The Apache J2EE server">Geronimo</a></li></ul>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation -
+ <a href="../site/privacy-policy.page">Privacy Policy</a>
+ <br/>
+ Apache ServiceMix, ServiceMix, Apache, the Apache feather logo, and the Apache ServiceMix project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
Added: servicemix/site/production/developers/release-guide.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/developers/release-guide.html?rev=1388615&view=auto
==============================================================================
--- servicemix/site/production/developers/release-guide.html (added)
+++ servicemix/site/production/developers/release-guide.html Fri Sep 21 18:51:14 2012
@@ -0,0 +1,251 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="Apache ServiceMix - An open-source integration container"/>
+ <meta name="keywords" content="business integration, enterprise service bus, enterprise application integration, ESB, EAI, SOA, Service Oriented Architecture, web services, SOAP, JBI, JMS, WSDL, business-to-business, b2b, XML, EDI, Electronic Data Interchange, standards support, integration standards, application integration, java message service, middleware, message broker, software, solutions, services, ActiveMQ, ServiceMix, open source, MQ, message queue, message bus,felix,karaf,camel"/>
+ <meta name="author" content="The Apache ServiceMix Team"/>
+ <link href="../css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/downloads.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Release Guide
+ </title>
+ <script type='text/javascript'>
+ //<![CDATA[
+ var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-398545-1']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })();
+ //]]>
+ </script>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+ <a href="http://servicemix.apache.org/" title="Apache ServiceMix - open-source integration server">
+ <img border="0" src="../images/servicemix-logo.png" width="400px"/>
+ </a>
+ </td>
+ <td align="right">
+ <a href="http://www.apache.org/" Release Guide="The Apache Sofware Foundation">
+ <img border="0" src="../images/asf-logo.png"/>
+ </a>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p><a href="../downloads.html">Downloads</a> | <a href="source.html">Source</a> | <a href="../community/discussion-forums.html">Forums</a> | <a href="../community/support.html">Support</a> | <a href="http://servicemix.apache.org/old/home.html">Old website</a></p>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Overviewindex"><a href="../index.html">Overview</a></h3><ul style="list-style: square"><li><a href="../index.html">Home</a></li><li><a href="../downloads.html">Downloads</a></li><li><a href="../overview/license.html">License</a></li></ul><h3 id="Documentation"><a href="../documentation.html">Documentation</a></h3><ul><li><a href="http://servicemix.apache.org/docs/4.4.x/quickstart/index.html" target="quickstart">Quickstart Guide</a></li><li><a href="http://servicemix.apache.org/docs/4.4.x/index.html" target="documentation">Documentation: 4.4.x</a></li></ul><h3 id="Search">Search</h3><DIV style="padding: 5px 5px 0px 25px;"><FORM action="http://www.google.com/search" method="get" style="font-size: 10px;"><INPUT name="ie" type="hidden" value="UTF-8"></INPUT><INPUT name="oe" type="hidden" value="UTF-8"></INPUT> <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT> <INPUT name="btnG" type="submit" value="Search"></INPUT> <INPUT nam
e="domains" type="hidden" value="servicemix.apache.org"></INPUT> <INPUT name="sitesearch" type="hidden" value="servicemix.apache.org"></INPUT></FORM></DIV><h3 id="Community"><a href="../community.html">Community</a></h3><ul style="list-style: square"><li><a href="../community/support.html">Support</a></li><li><a href="../community/discussion-forums.html">Discussion Forums</a></li><li><a href="../community/mailing-lists.html">Mailing Lists</a></li><li><a href="http://issues.apache.org/activemq/browse/SM">Issues</a></li><li><a href="../community/contributing.html">Contributing</a></li><li><a href="../community/users.html">Users</a></li><li><a href="../community/team.html">Team</a></li></ul><h3 id="Developers"><a href="../developers.html">Developers</a></h3><ul style="list-style: square"><li><a href="source.html">Source</a></li><li><a href="becoming-a-committer.html">Becoming a committer</a></li><li><a href="release-guide.html">Release Guide</a></li><li><a href="related-projec
ts.html">Related Projects</a></li><li><a href="tools.html">Tools</a></li></ul><h3 id="RelatedProjects">Related Projects</h3><ul style="list-style: square"><li><a href="http://karaf.apache.org/" title="OSGi Container">Apache Karaf</a></li><li><a href="http://activemq.apache.org/" title="The most popular and powerful open source Message Bus">Apache ActiveMQ</a></li><li><a href="http://activemq.apache.org/camel/" title="POJO based Enterprise Integration Patterns and routing framework">Apache Camel</a></li><li><a href="http://cxf.apache.org/" title="Service Enablement Framework based on SOAP and JAX-WS">Apache CXF</a></li><li><a href="http://ode.apache.org/" title="Orchestration Engine">Apache ODE</a></li><li><a href="http://jencks.codehaus.org/" title="Message Driven POJOs and pooling for JMS and JDBC">Jencks</a></li><li><a href="http://stomp.codehaus.org/" title="Simple cross language protocol for messaging">Stomp</a></li><li><a href="http://www.springframework.org/" title="Th
e well know framework">Spring</a></li><li><a href="http://geronimo.apache.org/" title="The Apache J2EE server">Geronimo</a></li></ul><h3 id="ApacheSoftwareFoundation">Apache Software Foundation</h3><ul style="list-style: square"><li><a href="http://www.apache.org/licenses/">License</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li><li><a href="http://www.apache.org/security/">Security</a></li></ul>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<p>How to create and announce a ServiceMix release.</p><h2 id="Prepare">Prepare</h2><p>To prepare and perform a release you must be at least at Apache ServiceMix Committer.</p><ul><li>each and every release must be <a href="http://www.apache.org/dev/release-signing.html">SIGNED</a></li><li>your public key should also be cross-signed by other Apache committers (not required, but suggested)</li><li>make sure you have all Apache servers defined in your <a href="http://maven.apache.org/developers/committer-settings.html">settings.xml</a></li><li>use Maven 2.0.x or 2.2..x</li></ul><p>Your settings.xml should look like:</p><pre class="xml code-xml">
+<settings>
+ ...
+ <profiles>
+ <profile>
+ <id>release</id>
+ <properties>
+ <gpg.passphrase> <!-- YOUR KEY PASSPHRASE --> </gpg.passphrase>
+ </properties>
+ </profile>
+ </profiles>
+ ...
+ <servers>
+ <!-- To publish a snapshot of some part of Maven -->
+ <server>
+ <id>apache.snapshots.https</id>
+ <username> <!-- YOUR APACHE SVN USERNAME --> </username>
+ <password> <!-- YOUR APACHE SVN PASSWORD --> </password>
+ </server>
+ <!-- To stage a release of some part of Maven -->
+ <server>
+ <id>apache.releases.https</id>
+ <username> <!-- YOUR APACHE SVN USERNAME --> </username>
+ <password> <!-- YOUR APACHE SVN PASSWORD --> </password>
+ </server>
+ ...
+ </servers>
+</settings>
+
+</pre><h2 id="StagingtheReleaseCandidate">Staging the Release Candidate</h2><ol><li>grab the latest <a href="source.html">Source</a><pre>
+svn co https://svn.apache.org/repos/asf/servicemix/$PART/trunk
+</pre><p>where $PART is what you want to release. For example, it can be:</p><ul><li>smx3</li><li>smx4</li><li>components</li><li>...</li></ul></li><li>prepare your POMs for release:<ol><li>make sure there is no snapshots in the POMs to be released</li><li>make sure everything builds fine</li><li>check that your POMs will not lose content when they are rewritten during the release process:<pre>
+mvn release:prepare -DdryRun
+</pre><p> <br/>and diff the original pom.xml with the one named pom.xml.tag to see if the license or any other info has been removed. This has been known to happen if the starting <project> tag is not a single line. The only things that should be different between these files are the <version> and <scm> elements. If there are any other changes, you must fix the original pom.xml file and commit before proceeding with the release. </p></li><li>publish a snapshot<pre>
+$ mvn deploy
+...
+[INFO] [deploy:deploy]
+[INFO] Retrieving previous build number from apache.snapshots.https
+...
+</pre></li></ol><ul><li>if you experience an error during deployment like a HTTP 401 check your settings for the required server entries as outlined in the <strong>Prerequisites</strong></li><li>be sure that the generated artifacts respect the Apache release <a href="http://www.apache.org/dev/release.html">rules</a>: NOTICE and LICENSE files should be present in the META-INF directory within the jar. For sources artifacts, be sure that your POM does not use the maven-source-plugin:2.0.3 which is broken. The recommended version at this time is 2.0.4 </li><li>you should verify the deployment under the <a href="https://repository.apache.org/content/groups/snapshots/org/apache/servicemix">snapshot</a> repository on Apache</li></ul></li><li>prepare the release<pre>
+mvn release:clean
+mvn release:prepare
+</pre></li><li>stage the release for a vote<p>Note: If you're on Mac OSX 10.5, for a known <a href="http://subversion.tigris.org/issues/show_bug.cgi?id=3059">issue</a>, you need provide your apache svn user/password <br/>mvn release:prepare -Dusername=ffang -Dpassword=*******</p><pre>
+mvn release:perform
+</pre><ul><li>the release will automatically be inserted into a temporary staging repository for you, see the Nexus <a href="http://www.sonatype.com/books/nexus-book/reference/staging.html">staging documentation</a> for full details</li><li>you can continue to use mvn release:prepare and mvn release:perform on other sub-projects as necessary on the same machine and they will be combined in the same staging repository</li></ul></li><li>close the staging repository<ul><li>login to <a href="https://repository.apache.org">https://repository.apache.org</a> using your Apache SVN credentials. Click on Staging on the left. Then click on org.apache.servicemix in the list of repositories. In the panel below you should see an open repository that is linked to your username and IP. Right click on this repository and select Close. This will close the repository from future deployments and make it available for others to view. If you are staging multiple releases together, skip this step
until you have staged everything<p><img border="0" src="release_01.png"/> <img border="0" src="release_02.png"/> <img border="0" src="release_03.png"/> <img border="0" src="release_04.png"/> <img border="0" src="release_05.png"/> <img border="0" src="release_06.png"/></p></li></ul></li><li>verify the staged artifacts<ul><li>if you click on your repository, a tree view will appear below. You can then browse the contents to ensure the artifacts are as you expect them. Pay particular attention to the existence of *.asc (signature) files. If you don't like the content of the repository, right click your repository and choose Drop. You can then rollback your release (see Canceling the Release) and repeat the process</li><li>note the staging repository URL (especially the number at the end of the URL) you will need this in your vote email</li></ul></li></ol><h2 id="Startingthevote">Starting the vote</h2><p>Propose a vote on the dev list with the closed issues, the issues left, and
the staging repository - for example:</p><pre>
+To: "ServiceMix Developers List" <dev@servicemix.apache.org>
+Subject: [VOTE] Release ServiceMix [Component] XXX version Y.Z
+
+Hi,
+
+We solved N issues in this release:
+http://issues.apache.org/jira/...
+
+There are still some outstanding issues:
+http://issues.apache.org/jira/...
+
+Staging repository:
+https://repository.apache.org/content/repositories/servicemix-staging-[YOUR REPOSITORY ID]/
+
+Please vote to approve this release:
+
+[ ] +1 Approve the release
+[ ] -1 Veto the release (please provide specific comments)
+
+This vote will be open for 72 hours.
+</pre><ul><li>to get the JIRA release notes link, browse to the ServiceMix <a href="http://issues.apache.org/jira/browse/ServiceMix">JIRA</a> page, select Release Notes and choose the relevant sub-project release and format (HTML)</li><li>to get the list of issues left in JIRA, select the Open Issues tab on the main ServiceMix page, and select the relevant sub-project.</li></ul><h2 id="WaitfortheResults">Wait for the Results</h2><p>From <a href="http://www.apache.org/foundation/voting.html">Votes on Package Releases</a>:</p><p> Votes on whether a package is ready to be released follow a format similar to majority approval - except that the decision is officially determined solely by whether at least three +1 votes were registered. Releases may not be vetoed. Generally the community will table the vote to release if anyone identifies serious problems, but in most cases the ultimate decision, once three or more positive votes have been garnered, lies with the individual ser
ving as release manager. The specifics of the process may vary from project to project, but the 'minimum of three +1 votes' rule is universal.</p><p>The list of binding voters is available at <a href="http://servicemix.apache.org/team.html">http://servicemix.apache.org/team.html</a>.</p><p>If the vote is successful, post the result to the dev list - for example:</p><pre>
+To: "ServiceMix Developers List" <dev@servicemix.apache.org>
+Subject: [RESULT] [VOTE] Release ServiceMix [Component] XXX version Y.Z
+
+Hi,
+
+The vote has passed with the following result :
+
+ +1 (binding): <<list of names>>
+ +1 (non binding): <<list of names>>
+
+I will copy this release to the ServiceMix dist directory and
+promote the artifacts to the central Maven repository.
+</pre><p>If the vote is unsuccessful, you need to fix the issues and restart the process - see <strong>Canceling the Release</strong>.<br/>If the vote is successful, you need to promote and distribute the release - see <strong>Promoting the Release</strong>.</p><h2 id="CancelingtheRelease">Canceling the Release</h2><p>If the vote fails, or you decide to redo the release:</p><ol><li>remove the release tag from Subversion (svn del ...)</li><li>login to https://repository.apache.org using your Apache SVN credentials. Click on Staging on the left. Then click on org.apache.servicemix in the list of repositories. In the panel below you should see a closed repository that is linked to your username and IP (if it's not yet closed you need to right click and select Close). Right click on this repository and select Drop.</li><li>rollback the version in the pom.xml and commit any fixes you need to make</li></ol><h2 id="PromotingtheRelease">Promoting the Release</h2><p>If the vote passe
s:</p><ol><li>copy the released artifacts to the ServiceMix dist directory (/x1/www/www.apache.org/dist/servicemix) on people.apache.org</li><li>delete the old release from the ServiceMix dist directory (it's archived)</li><li>login to https://repository.apache.org with your Apache SVN credentials. Click on Staging. Find your closed staging repository, right click on it and choose Promote. Select the Releases repository from the drop-down list and click Promote.</li><li>next click on Repositories, select the Releases repository and validate that your artifacts are all there</li><li>update the news section on the website at news</li><li>update the download page on the website at downloads to point to the new release.</li></ol><p>For the last two tasks, it's better to give the mirrors some time to distribute the uploaded artifacts (one day should be fine). This ensures that once the website (news and download page) is updated, people can actually download the artifacts.</p><h2
id="UpdateXMLschemas">Update XML schemas</h2><ul><li>Update the <a href="Xml schemas.html">Xml schemas</a> page with a link to the HTML and XSD</li></ul><h2 id="UpdateJIRA">Update JIRA</h2><p>Go to Admin section on the ServiceMix JIRA and mark the Component/Y.Z version as released - create version Y.Z+1, if that hasn't already been done.</p><h2 id="AnnouncingtheServiceMixRelease">Announcing the ServiceMix Release</h2><pre>
+To: "ServiceMix Developers List" <dev@servicemix.apache.org>
+Subject: [ANN] ServiceMix XXX version Y.Z Released
+
+The ServiceMix team is pleased to announce the release of ServiceMix XXX version Y.Z
+
+<<insert short description of the sub-project>>
+
+ http://servicemix.apache.org/XXX.html
+
+This release is available from http://servicemix.apache.org/downloads and Maven:
+
+ <dependency>
+ <groupId>org.apache.servicemix</groupId>
+ <artifactId>org.apache.servicemix.XXX</artifactId>
+ <version>Y.Z</version>
+ </dependency>
+
+Release Notes:
+
+<<insert release notes in text format from JIRA>>
+
+Enjoy!
+
+-The ServiceMix team
+</pre><p>Remember to forward this announcement to users@servicemix.apache.org - try not to cross-post (CC:) announcements to both user and dev lists.</p>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation -
+ <a href="../site/privacy-policy.page">Privacy Policy</a>
+ <br/>
+ Apache ServiceMix, ServiceMix, Apache, the Apache feather logo, and the Apache ServiceMix project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file
Added: servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html
URL: http://svn.apache.org/viewvc/servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html?rev=1388615&view=auto
==============================================================================
--- servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html (added)
+++ servicemix/site/production/developers/remote-debugging-servicemix-in-eclipse.html Fri Sep 21 18:51:14 2012
@@ -0,0 +1,166 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
+<html lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <meta name="description" content="Apache ServiceMix - An open-source integration container"/>
+ <meta name="keywords" content="business integration, enterprise service bus, enterprise application integration, ESB, EAI, SOA, Service Oriented Architecture, web services, SOAP, JBI, JMS, WSDL, business-to-business, b2b, XML, EDI, Electronic Data Interchange, standards support, integration standards, application integration, java message service, middleware, message broker, software, solutions, services, ActiveMQ, ServiceMix, open source, MQ, message queue, message bus,felix,karaf,camel"/>
+ <meta name="author" content="The Apache ServiceMix Team"/>
+ <link href="../css/style.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/pygmentize.css" rel="stylesheet" type="text/css"/>
+ <link href="../css/downloads.css" rel="stylesheet" type="text/css"/>
+ <title>
+ Remote-debugging ServiceMix in Eclipse
+ </title>
+ <script type='text/javascript'>
+ //<![CDATA[
+ var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-398545-1']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })();
+ //]]>
+ </script>
+ </head>
+ <body>
+ <table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2">
+
+ </td>
+ <td id="cell-0-1">
+
+ </td>
+ <td id="cell-0-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0">
+
+ </td>
+ <td id="cell-1-1">
+
+ </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+ <a href="http://servicemix.apache.org/" title="Apache ServiceMix - open-source integration server">
+ <img border="0" src="../images/servicemix-logo.png" width="400px"/>
+ </a>
+ </td>
+ <td align="right">
+ <a href="http://www.apache.org/" Remote-debugging ServiceMix in Eclipse="The Apache Sofware Foundation">
+ <img border="0" src="../images/asf-logo.png"/>
+ </a>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left"></div>
+ </td>
+ <td>
+ <div align="right">
+ <p><a href="../downloads.html">Downloads</a> | <a href="source.html">Source</a> | <a href="../community/discussion-forums.html">Forums</a> | <a href="../community/support.html">Support</a> | <a href="http://servicemix.apache.org/old/home.html">Old website</a></p>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </div>
+ </td>
+ <td id="cell-1-3">
+
+ </td>
+ <td id="cell-1-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2">
+
+ </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <h3 id="Overviewindex"><a href="../index.html">Overview</a></h3><ul style="list-style: square"><li><a href="../index.html">Home</a></li><li><a href="../downloads.html">Downloads</a></li><li><a href="../overview/license.html">License</a></li></ul><h3 id="Documentation"><a href="../documentation.html">Documentation</a></h3><ul><li><a href="http://servicemix.apache.org/docs/4.4.x/quickstart/index.html" target="quickstart">Quickstart Guide</a></li><li><a href="http://servicemix.apache.org/docs/4.4.x/index.html" target="documentation">Documentation: 4.4.x</a></li></ul><h3 id="Search">Search</h3><DIV style="padding: 5px 5px 0px 25px;"><FORM action="http://www.google.com/search" method="get" style="font-size: 10px;"><INPUT name="ie" type="hidden" value="UTF-8"></INPUT><INPUT name="oe" type="hidden" value="UTF-8"></INPUT> <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT> <INPUT name="btnG" type="submit" value="Search"></INPUT> <INPUT nam
e="domains" type="hidden" value="servicemix.apache.org"></INPUT> <INPUT name="sitesearch" type="hidden" value="servicemix.apache.org"></INPUT></FORM></DIV><h3 id="Community"><a href="../community.html">Community</a></h3><ul style="list-style: square"><li><a href="../community/support.html">Support</a></li><li><a href="../community/discussion-forums.html">Discussion Forums</a></li><li><a href="../community/mailing-lists.html">Mailing Lists</a></li><li><a href="http://issues.apache.org/activemq/browse/SM">Issues</a></li><li><a href="../community/contributing.html">Contributing</a></li><li><a href="../community/users.html">Users</a></li><li><a href="../community/team.html">Team</a></li></ul><h3 id="Developers"><a href="../developers.html">Developers</a></h3><ul style="list-style: square"><li><a href="source.html">Source</a></li><li><a href="becoming-a-committer.html">Becoming a committer</a></li><li><a href="release-guide.html">Release Guide</a></li><li><a href="related-projec
ts.html">Related Projects</a></li><li><a href="tools.html">Tools</a></li></ul><h3 id="RelatedProjects">Related Projects</h3><ul style="list-style: square"><li><a href="http://karaf.apache.org/" title="OSGi Container">Apache Karaf</a></li><li><a href="http://activemq.apache.org/" title="The most popular and powerful open source Message Bus">Apache ActiveMQ</a></li><li><a href="http://activemq.apache.org/camel/" title="POJO based Enterprise Integration Patterns and routing framework">Apache Camel</a></li><li><a href="http://cxf.apache.org/" title="Service Enablement Framework based on SOAP and JAX-WS">Apache CXF</a></li><li><a href="http://ode.apache.org/" title="Orchestration Engine">Apache ODE</a></li><li><a href="http://jencks.codehaus.org/" title="Message Driven POJOs and pooling for JMS and JDBC">Jencks</a></li><li><a href="http://stomp.codehaus.org/" title="Simple cross language protocol for messaging">Stomp</a></li><li><a href="http://www.springframework.org/" title="Th
e well know framework">Spring</a></li><li><a href="http://geronimo.apache.org/" title="The Apache J2EE server">Geronimo</a></li></ul><h3 id="ApacheSoftwareFoundation">Apache Software Foundation</h3><ul style="list-style: square"><li><a href="http://www.apache.org/licenses/">License</a></li><li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li><li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li><li><a href="http://www.apache.org/security/">Security</a></li></ul>
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <div class="wiki-content">
+<p>This page explains how to set up remote-debugging of ServiceMix using Eclipse.</p><p>Basically, you have to perform the following steps:</p><ol><li><a href="Remote-debugging ServiceMix in Eclipse#Enabling Remote Debugging in ServiceMix.html">Enable remote debugging in <tt>servicemix.bat</tt></a></li><li><a href="Remote-debugging ServiceMix in Eclipse#Specifying a Remote Debugging Launch Configuration.html">Specify a remote-debugging launch configuration</a> </li><li><a href="Remote-debugging ServiceMix in Eclipse#Performing Debugging.html">Start SM and switch to Debug-Perspective</a></li></ol><h2 id="EnableremotedebugginginServiceMix">Enable remote debugging in ServiceMix</h2><p>The following section in <tt>servicemix.bat</tt> is the one that matters:</p><pre>
+if "%SERVICEMIX_DEBUG%" == "" goto :SERVICEMIX_DEBUG_END
+ rem Use the defaults if JAVA_DEBUG_OPTS was not set
+ if "%JAVA_DEBUG_OPTS%" == "" set JAVA_DEBUG_OPTS=%DEFAULT_JAVA_DEBUG_OPTS%
+
+ set "JAVA_OPTS=%JAVA_DEBUG_OPTS% %JAVA_OPTS%"
+ call :warn Enabling Java debug options: %JAVA_DEBUG_OPTS%
+:SERVICEMIX_DEBUG_END
+</pre><p>In order to activate it, you need to set the environment variable <tt>SERVICEMIX_DEBUG</tt>.</p><p>For instance in Windows:</p><pre>
+SET SERVICEMIX_DEBUG=TRUE
+</pre><p>Or in Linux:</p><pre>
+export SERVICEMIX_DEBUG=TRUE
+</pre><p>ServiceMix runs in debugging mode if you can see the following output when running it:</p><pre>
+...
+servicemix.bat: Enabling Java debug options: -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005
+...
+</pre><p>The debugging options can be modified in <tt>servicemix.bat</tt> via the <tt>DEFAULT_JAVA_DEBUG_OPTS</tt>. The default values are:</p><pre>
+set DEFAULT_JAVA_DEBUG_OPTS=-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005
+</pre><h2 id="SpecifyingaRemoteDebuggingLaunchConfiguration">Specifying a Remote Debugging Launch Configuration</h2><p>Specify an Eclipse Remote Java Application debug launch configuration on the project you want to monitor. </p><ol><li>Open <tt>Run - Debug</tt></li><li>Mark <tt>Remote Java Application</tt></li><li>Create a <tt>New Launch Configuration</tt></li><li>Specify a name, the project you want to debug (e.g. <tt>servicemix-wsn2005</tt>) and the connection properties.</li><li><tt>Apply</tt>.</li></ol><p>See <a href="http://www.onjava.com/lpt/a/6174">http://www.onjava.com/lpt/a/6174</a> for details.</p><h2 id="PerformingDebugging">Performing Debugging</h2><ol><li>Add breakpoints/debug information to the relevant code inside Eclipse. </li><li>Start ServiceMix.</li><li>Start debugging with the previously created launch configuration.</li><li>Switch to debug perspective.</li><li>Exercise the error-causing behaviour.</li><li>Wait for Eclipse to be notified of the breakpoin
ts.</li></ol>
+ </div>
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0">
+
+ </td>
+ <td id="cell-3-1">
+
+ </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <div id="site-footer">
+ © 2008-2011 The Apache Software Foundation -
+ <a href="../site/privacy-policy.page">Privacy Policy</a>
+ <br/>
+ Apache ServiceMix, ServiceMix, Apache, the Apache feather logo, and the Apache ServiceMix project logo are trademarks of The Apache Software Foundation.
+ </div>
+ </div>
+ </td>
+ <td id="cell-3-3">
+
+ </td>
+ <td id="cell-3-4">
+
+ </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2">
+
+ </td>
+ <td id="cell-4-1">
+
+ </td>
+ <td id="cell-4-2" colspan="2">
+
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>
\ No newline at end of file