diff options
Diffstat (limited to 'site/tags/site-090106-pre667/site-publish/java-projects.html')
| -rw-r--r-- | site/tags/site-090106-pre667/site-publish/java-projects.html | 639 |
1 files changed, 639 insertions, 0 deletions
diff --git a/site/tags/site-090106-pre667/site-publish/java-projects.html b/site/tags/site-090106-pre667/site-publish/java-projects.html new file mode 100644 index 0000000000..c1bf8c60c9 --- /dev/null +++ b/site/tags/site-090106-pre667/site-publish/java-projects.html @@ -0,0 +1,639 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+
+<!--
+Copyright 1999-2004 The Apache Software Foundation
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+
+<!-- Content Stylesheet for Site -->
+
+
+<!-- start the processing -->
+<!-- ====================================================================== -->
+<!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
+<!-- Main Page Section -->
+<!-- ====================================================================== -->
+<html>
+<head>
+ <link rel="stylesheet" href="./css/base.css"/>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+
+
+
+
+
+ <title>Tuscany - Tuscany Java projects</title>
+</head>
+
+<body bgcolor="#ffffff" text="#000000" link="#525D76">
+ <table border="0" width="100%" cellspacing="0">
+ <!-- TOP IMAGE -->
+ <tr>
+ <td align='LEFT'><td align="left">
+<a href="http://incubator.apache.org/tuscany/"><img src="./images/tuscanylogo_candidate2.jpg" alt="Tuscany" border="0" height="32" width="120"/></a>
+</td>
+</td>
+ <td align='LEFT'><td width="80%" align="left" valign="bottom" bgcolor="#ffffff">
+ <font color="#625972" size="+3" face="arial,helvetica,sanserif">
+ <b><bannertitle>Tuscany Java projects</bannertitle></b>
+</font>
+</td>
+</td>
+ </tr>
+ </table>
+ <hr noshade="" size="1"/>
+ <table border="0" cellspacing="0">
+ <tr>
+ <td> <a href="./index.html">Home</a>
+</td>
+ <td> <a href="./sca_index.html">SCA</a>
+</td>
+ <td> <a href="./sdo_index.html">SDO</a>
+</td>
+ <td> <a href="./das_index.html">DAS</a>
+</td>
+ </tr>
+ </table>
+ <table border="0" width="100%" cellspacing="4">
+ <tr>
+ <!-- LEFT SIDE NAVIGATION -->
+ <td width="20%" valign="top" nowrap="true">
+
+ <!-- ============================================================ -->
+
+ <p><strong>General</strong></p>
+ <ul>
+ <li> <a href="./index.html">Home</a>
+</li>
+ <li> <a href="./news.html">News</a>
+</li>
+ <li> <a href="./documentation.html">Documentation</a>
+</li>
+ <li> <a href="./license.html">License</a>
+</li>
+ <li> <a href="http://www.apache.org/" target="_blank">ASF</a>
+</li>
+ <li> <a href="./downloads.html">Downloads</a>
+</li>
+ </ul>
+ <p><strong>Community</strong></p>
+ <ul>
+ <li> <a href="./get-involved.html">Get Involved</a>
+</li>
+ <li> <a href="./mail-lists.html">Mailing Lists</a>
+</li>
+ <li> <a href="./faq.html">FAQ</a>
+</li>
+ <li> <a href="./issue-tracking.html">Issue Tracking</a>
+</li>
+ <li> <a href="http://wiki.apache.org/ws/Tuscany" target="_blank">Wiki</a>
+</li>
+ <li> <a href="http://apache-tuscany.blogspot.com" target="_blank">Blog</a>
+</li>
+ </ul>
+ <p><strong>Development</strong></p>
+ <ul>
+ <li> <a href="http://wiki.apache.org/ws/Tuscany/TuscanyJava/Roadmap" target="_blank">Road Map / TODO</a>
+</li>
+ <li> <a href="./source-code.html">Source Code</a>
+</li>
+ <li> <a href="./java-projects.html">Java projects</a>
+</li>
+ <li> <a href="./cpp-projects.html">C++ projects</a>
+</li>
+ </ul>
+ </td>
+ <td width="80%" align="left" valign="top">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Tuscany JAVA Project"><strong>Tuscany JAVA Project</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p> + <ol> + + <li><a href="#System requirements">System requirements</a></li> + <li><a href="#Enviroment scripts">Environment Scripts- <i>template scripts to setup your environment</i>.</a></li> + <li><a href="#checkout and build tuscany">Checkout and build Tuscany Java project</a></li> + <li><a href="#run samples">Running samples</a></li> + <li> <a href="patches.html">Create and submit a patch</a></li> + <li> <a href="codeguidelines.html">Java Coding Guidelines</a></li> + <li><a href="#using eclipse">Using Eclipse for IDE</a></li> + <li><a href="#using idea">Using IDEA style templates</a></li> + <li><a href="#Logging">Logging</a></li> + </ol> +</p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="System requirements"><strong>System requirements</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p> + Next, please download the following in order to get your machine ready for Java development. + <br /> + <table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2"> + <tbody> + <tr> <!-- heading --> + <td><b>Software</b></td> + <td><b>Download Link</b></td> + <td><b>Download Instructions</b></td> + </tr> + <tr> + <td>JDK 5.0 Update 6 or later</td> + <td> + <a href="http://java.sun.com/j2se/1.5.0/download.jsp" target="_blank">jdk 5.0</a> + </td> + <td>Steps for Java setup is <a href="#setup JDK 5.0">here</a>. </td> + </tr> + <tr> <!--mvn --> + <td> Apache Maven 2.0.4 or later</td> + <td><a href="http://maven.apache.org/download.html" target="_blank">Maven 2.04</a> </td> + <td> + <ul> + <li> + We are using Maven 2 to build Tuscany, plus a few Ant scripts. Steps for Maven setup is <a href="#setup maven">here</a>. + </li> + <li> + A quick reference on Maven is available <a href="maven.html" target="_blank">here</a> + </li> + </ul> + </td> + </tr> + <tr> <!--ant --> + <td> Apache Ant 1.6.5 or later</td> + <td><a href="http://ant.apache.org/bindownload.cgi" target="_blank">Ant</a> </td> + <td> Steps for Ant setup is <a href="#setup ant">here</a>. </td> + </tr> + <tr> <!--svn --> + <td>Subversion 1.3.0 or later </td> + <td> <a href="http://subversion.tigris.org/project_packages.html" target="_blank">Subversion</a></td> + <td> + <ul> + <li>Tuscany source code is stored in a Subversion (SVN) repository, you need Subversion to download it. Steps for svn setup is <a href="#setup subversion">here</a>. </li> + <li> A quick reference for subversion commands is <a href="quicksubversion.html" target="_blank">here</a></li> + <li><i>Note: Some linux distributions may already have a subversion client installed. try executing "svn --version"</i></li> + </ul> + </td> + </tr> + <tr><!--tomcat --> + <td> Apache Tomcat 5.5.17 </td> + <td> + <a href="http://tomcat.apache.org/" target="_blank">apache tomcat 5.5</a> + </td> + <td> + This is the Web container that we integrate with, to allow you to use the SCA programming + model in Web applications. + Steps for Tomcat setup is <a href="#setup tomcat">here</a>. + </td> + </tr> + </tbody> + </table> + <br /> + +</p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Creating a tuscany directory"><strong>Creating a tuscany directory</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Environment scripts"><strong>Environment scripts</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>There is a windows <a href="setenv.bat">setenv.bat</a> and a linux <a href="setenv.sh">setenv.sh</a> script that you can +download by right clicking and "selecting save as..." You can edit these scripts + with the below described environment variables to set up your environment any time by running them. On linux you invoke the shell script with + <pre> + . ./setenv.sh + </pre> +</p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Downloading and installing the Java JDK 5.0"><strong>Downloading and installing the Java JDK 5.0</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <ul> + <li> + Download and extract the appropriate JDK for your operating system from <a href="http://java.sun.com/j2se/1.5.0/download.jsp" target="_blank">http://java.sun.com/j2se/1.5.0/download.jsp</a>. + </li> + <li> + set the JAVA_HOME environment variable to point to the root directory of where you extracted java download. + </li> + <li> + Add to your PATH environment variable to include the full path to the <b>bin</b> subdirectory of the JDK download package. + </li> +</ul>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Downloading and installing Apache Maven"><strong>Downloading and installing Apache Maven</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <ul> + <li> + Download and extract Maven 2.0.4 or later from <a href="http://maven.apache.org/download.html" target="_blank">http://maven.apache.org/download.html</a>. + </li> + <li> + Add to your PATH environment variable to include the the full path to the <b>bin</b> subdirectory of the Maven download package. + </li> +</ul>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Downloading and installing Apache Ant"><strong>Downloading and installing Apache Ant</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <ul> + <li> + Download and extract Ant 1.6.5 or later from <a href="http://ant.apache.org/bindownload.cgi" target="_blank">http://ant.apache.org/bindownload.cgi</a>. + </li> + <li> + Add to your PATH environment variable to include the the full path to the <b>bin</b> subdirectory of the Ant download. + </li> +</ul>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Downloading and installing Subversion"><strong>Downloading and installing Subversion</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <ul> + <li> + Download and extract Subversion 1.3.1 or later from <a href="http://subversion.tigris.org/project_packages.html" target="_blank">http://subversion.tigris.org/project_packages.html</a>. + </li> + <li> + Modify your path statement to include the full path to the subversion <b>bin</b> directory. + </li> + <p><i>Note: For linux you may need to install subversion as root </i></p> +</ul>
+ <p> A quick reference for subversion commands is <a href="quicksubversion.html" target="_blank">here</a></p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Download and Setup Tomcat"><strong>Download and Setup Tomcat</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <ul> + <li> + Dowload apache-tomcat-5.5.17 <a href="http://mirrors.ibiblio.org/pub/mirrors/apache/tomcat/tomcat-5/v5.5.17/bin/apache-tomcat-5.5.17.zip" target="_blank">apache-tomcat-5.5.17.zip</a> for Windows or + <a href="http://mirrors.ibiblio.org/pub/mirrors/apache/tomcat/tomcat-5/v5.5.17/bin/apache-tomcat-5.5.17.tar.gz" target="_blank">apache-tomcat-5.5.17.tar.gz</a> for Linux + to the <B>tuscany\java\distribution\tomcat-overlay directory</B>. Do not unpack. + </li> + </ul>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Checkout and Build Tuscany"><strong>Checkout and Build Tuscany</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p> + <b>Check out Tuscany Java</b> + </p>
+ <p> + From the command prompt, in the <B>tuscany</B> directory do the following: + <br /> + <code> + svn co http://svn.apache.org/repos/asf/incubator/tuscany/java + </code> + <br /> + This should check out all the source code from the Tuscany SVN repository into java sub directory. +</p>
+ <p> +</p>
+ <p> + <b> Build Tuscany Java </b> +</p>
+ <p> + When the check out completes change to the <b>java</b> subdirectory. + From the command prompt do the following build tuscany using maven: + <pre> + mvn + </pre> +This will build the Tuscany runtime with Maven. Maven will download all the JAR dependencies, build all the Tuscany sub-projects and run the unit tests. +</p>
+ <p> +<i><b>Note:</b> Depending on the load of remote Mavan 2.0 repositories you may have to execute mvn several time until required + dependencies are all located in your local maven repository. After you have completed a full successful build you + can use "mvn -o" which is much faster.</i> +</p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Running The Samples"><strong>Running The Samples</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>Run the samples by building the distribution.</p>
+ <ul> + <li> + Change the directory to the tuscany\java\distribution + </li> + <li> + Run build-dist.bat (for win32 platforms), or build-dist.sh (for linux) + </li> + <li> + Change the directory tuscany\java\distribution\target\tuscany-dist + </li> + <li> + + Follow the directions in <a href="samples/java/GettingStarted.htm#Starting the Server" target="_blank">GettingStarted.htm</a>. + </li> + </ul>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Using Eclipse (optional)"><strong>Using Eclipse (optional)</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p> + <span style="font-size: 10pt;"> + Link to Eclipse download : + <span> + <a href="http://www.eclipse.org/downloads/index.php"> + http://www.eclipse.org/downloads/index.php + </a> + </span> + </span> + </p>
+ <p> + Getting Started documentation: + <a href="http://www.eclipse.org/downloads/index.php"> + http://www.eclipse.org/downloads/index.php + </a> + </p>
+ <p> + To create the eclipse projects to use for SCA development: + </p>
+ <p> + 1) When checking code out from subversion, checkout the + subversion trunk to a location outside your eclipse + workspace (it has to be outside because Eclipse will + not allow you to import projects from a location + overlapping with your workspace) + </p>
+ <p style="margin-left: 0.5in; text-indent: -0.25in;"><!--[if !supportLists]--> + 2) Go to Import / Existing projects into workspace. + <span style="" /> + Select either the runtime, spec, tools or samples + directory. + <span style="" /> + The wizard proposes the list of Eclipse projects + under that directory. Importing the projects does + not copy the files; it just makes the files at that + location visible under an Eclipse project. + </p>
+ <p> + 3) If you need to use Eclipse to edit files outside of + these projects (for example the etc directory, or + the maven files at the root of the trunk), then + delete the Eclipse projects, with the option to not + delete the files, and import the whole trunk as a + project. + </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Using Eclipse style templates"><strong>Using Eclipse style templates</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <a href="http://svn.apache.org/repos/asf/incubator/tuscany/java/etc/tuscany-eclipse-codestyle.xml">tuscany-eclipse-codestyle.xml</a>
+ <br />
+ <i>You may need to right click and save.</i>
+ <br />
+ <pre> + Window->Preferences->Java->Code-Style->Formatter->Import... + <i>(Specify path and file to the tuscany-eclipse-codestyle.xml just downloaded. </i> + </pre>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Using Subclipse (optional)"><strong>Using Subclipse (optional)</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p> + Install the Subversion Eclipse Plugin as described here: + <a href="http://subclipse.tigris.org/">http://subclipse.tigris.org/ + </a> + </p>
+ <ol> + <li> + Open the SVN Repository Exploring perspective + </li> + + <li> + Right click in the SVN Repository view. + + </li> + <li>Select "New" and "Repository Location" + + </li> + <li> + Url: + <a href="http://svn.apache.org/repos/asf/incubator/tuscany"> + http://svn.apache.org/repos/asf/incubator/tuscany + </a> + <p> + Use URL https://svn.apache.org/repos/asf/incubator/tuscany if you + have committer rights and need to commit changes back to the repository. + </p> + </li> + <li> + Select the "Finish" button and allow Subeclipse time to access the repository and + display its contents in the SVN Repository explorer. Once the repository is displayed + in the explorer, you will see a number of subfolders displayed. The ones that are + relevant are "java", "cpp" and "site" - which contain the Tuscany Java runtime, the + Tuscany C++ runtime and the Tuscany website material respectively. + </li> + <li> + Select the folder you want to check out as a project - one of java, cpp or site for example + Right click, select "Checkout" and "Checkout using new project wizard" - select the appropriate + options for your needs and then click "Finish" + </li> + </ol>
+ <p> + You can check in changes using the "Commit" item in the team submenu of the Java perspective. + </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Using IDEA style templates"><strong>Using IDEA style templates</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <a href="http://svn.apache.org/repos/asf/incubator/tuscany/java/etc/tuscany-idea-codestyle.xml">tuscany-idea-codestyle.xml</a>
+ <br />
+ <i>You may need to right click and save.</i>
+ <pre> + copy tuscany-idea-codestyle.xml to ~/.IntelliJIdea50/config/codestyles + File->Settings, Project Code Styles, Import + </pre>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#726982">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Logging"><strong>Logging</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <a href="monitoring.htm" target="_blank">Tuscany Monitoring</a>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ </td>
+ </tr>
+ </table>
+ <hr noshade="" size="1"/>
+ <table border="0" width="100%" cellspacing="0">
+ <tr>
+ <td><img src="./images/apache-incubator-logo.png" alt="Apache Incubator Logo"/></td>
+ <td class="disclaimer">
+ <em>Copyright © 2006, The Apache Software Foundation</em><br/>
+ Apache Tuscany is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Web Services PMC.
+ Incubation is required of all newly accepted projects until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a manner consistent with other successful ASF projects.
+ While incubation status is not necessarily a reflection of the completeness or stability of the code,
+ it does indicate that the project has yet to be fully endorsed by the ASF.
+ </td>
+ </tr>
+ </table>
+</body>
+</html>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
|