You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by ri...@apache.org on 2006/09/01 23:19:58 UTC
svn commit: r439484 [3/13] - in /incubator/tuscany/site: ./ image-sources/
site-author/ site-author/css/ site-author/images/ site-author/stylesheets/
site-publish/ site-publish/css/ site-publish/images/
Modified: incubator/tuscany/site/site-author/java-projects.xml
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/java-projects.xml?rev=439484&r1=439483&r2=439484&view=diff
==============================================================================
--- incubator/tuscany/site/site-author/java-projects.xml (original)
+++ incubator/tuscany/site/site-author/java-projects.xml Fri Sep 1 14:19:53 2006
@@ -10,13 +10,13 @@
<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="#Environment 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="#Running The 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="#Using Eclipse (optional)">Using Eclipse for IDE</a></li>
+ <li><a href="#Using IDEA style templates">Using IDEA style templates</a></li>
<li><a href="#Logging">Logging</a></li>
</ol>
</p>
Added: incubator/tuscany/site/site-author/java_das_overview.xml
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/java_das_overview.xml?rev=439484&view=auto
==============================================================================
--- incubator/tuscany/site/site-author/java_das_overview.xml (added)
+++ incubator/tuscany/site/site-author/java_das_overview.xml Fri Sep 1 14:19:53 2006
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+ <properties>
+ <title>Tuscany</title>
+ <bannertitle>Welcome to Tuscany</bannertitle>
+ </properties>
+ <body>
+ <section name="Tuscany DAS - Java">
+ <p>(TBD) Desciption of the Tuscany DAS implementation </p>
+ <br/>
+ <div align="center">
+ <img src ="./images/DAS-Java.png" alt="DAS Overview" usemap="#tuscany_overview" border="0" />
+ </div>
+
+ <map name="tuscany_overview">
+ <area shape="rect" coords="1,74,108,290" href="das_index.html" target=""/>
+ <area shape="rect" coords="111,74,206,287" href="sdo_index.html" target=""/>
+ <area shape="rect" coords="208,33,620,335" href="sca_index.html" target=""/>
+ <area shape="rect" coords="620,32,859,333" href="tools_index.html" target=""/>
+ </map>
+
+ </section>
+ </body>
+</document>
Propchange: incubator/tuscany/site/site-author/java_das_overview.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: incubator/tuscany/site/site-author/java_das_overview.xml
------------------------------------------------------------------------------
svn:keywords = Rev Date
Added: incubator/tuscany/site/site-author/java_sca_overview.xml
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/java_sca_overview.xml?rev=439484&view=auto
==============================================================================
--- incubator/tuscany/site/site-author/java_sca_overview.xml (added)
+++ incubator/tuscany/site/site-author/java_sca_overview.xml Fri Sep 1 14:19:53 2006
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+ <properties>
+ <title>Tuscany</title>
+ <bannertitle>Welcome to Tuscany</bannertitle>
+ </properties>
+ <body>
+ <section name="Tuscany Service Component Architecture - Java">
+ <p>(TBD) Desciption of SCA Java system. </p>
+ <br/>
+ <div align="center">
+ <img src ="./images/SCA-Java.png" alt="Tuscany Overview" usemap="#tuscany_overview" border="0" />
+ </div>
+
+ <map name="tuscany_overview">
+ <area shape="rect" coords="1,74,108,290" href="das_index.html" target=""/>
+ <area shape="rect" coords="111,74,206,287" href="sdo_index.html" target=""/>
+ <area shape="rect" coords="208,33,620,335" href="sca_index.html" target=""/>
+ <area shape="rect" coords="620,32,859,333" href="tools_index.html" target=""/>
+ </map>
+
+ </section>
+ </body>
+</document>
Propchange: incubator/tuscany/site/site-author/java_sca_overview.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: incubator/tuscany/site/site-author/java_sca_overview.xml
------------------------------------------------------------------------------
svn:keywords = Rev Date
Modified: incubator/tuscany/site/site-author/java_sdo_overview.xml
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/java_sdo_overview.xml?rev=439484&r1=439483&r2=439484&view=diff
==============================================================================
--- incubator/tuscany/site/site-author/java_sdo_overview.xml (original)
+++ incubator/tuscany/site/site-author/java_sdo_overview.xml Fri Sep 1 14:19:53 2006
@@ -6,13 +6,38 @@
<author email="kelvingoodson+tuscanysite@gmail.com">Kelvin Goodson</author>
</properties>
<body>
- <section name="Service Data Objects">
+
+ <section name="Tuscany Service Data Objects - Java">
<H2>The Tuscany SDO Java Project</H2>
<P>This document proves a high-level overview of the Java SDO (Service
Data Objects) subproject of the Apache Tuscany incubator project.</P>
-<H3>Overview</H3>
+</section>
+
+<section name="SDO Java Getting Started">
+ <p>
+ To get started with Java SDO, follow the downloads link and pick up either a binary or source distribution. If you
+ are working from a source distribution, you can follow the <a href="java-projects.html">general instructions</a> for building the whole of the Tuscany java projects, or you
+ can follow the intructions within the <A href="java_sdo_overview.html"> SDO Java overview </A> to build and explore just SDO java.
+ </p>
+ <h3>SDO Java Documents</h3>
+ <table>
+ <tr>
+ <td>
+ <a href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/specs/ws-sdo/SDO_Specification_Java_V2.01.pdf"> SDO Specification for Java V2.01</a>
+ </td>
+ <td>
+ The Service Data Objects specification for Java. Describes the data programming interfaces of SDO in the Java language.
+ </td>
+ </tr>
+ <tr>
+ <td><a href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/specs/ws-sdo/Next-Gen-Data-Programming-Whitepaper.pdf">SDO White Paper</a></td>
+ <td>A white paper that explains the SDO programming model</td>
+ </tr>
+ </table>
+ </section>
+<section name="SDO Java Overview">
<P>The SDO Java project is a subproject of <A class="external"
rel="nofollow" href="http://incubator.apache.org/tuscany/"> the Apache Tuscany incubator project</A>
@@ -56,7 +81,7 @@
of Tuscany, skip to the next section.</P>
<P>To build the whole Tuscany project follow <A class="external"
rel="nofollow"
- href="http://incubator.apache.org/tuscany/java-projects.html"> these instructions</A>.</P>
+ href="java-projects.html"> these instructions</A>.</P>
<H4 >SDO Java Build
Environment Setup</H4>
@@ -66,7 +91,7 @@
<OL type="1">
<LI>
<P>Set up your environment using the <A class="external" rel="nofollow"
- href="http://incubator.apache.org/tuscany/java-projects.html"> instructions for building the whole of Tuscany</A>,
+ href="java-projects.html"> instructions for building the whole of Tuscany</A>,
<STRONG>but</STRONG> only download and install Java 5, Maven and Svn
(note that only one file, Interface2JavaGenerator.java, has a Java 5
dependency, if you want to work with Java 1.4 then just delete this
Modified: incubator/tuscany/site/site-author/monitoring.htm
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/monitoring.htm?rev=439484&r1=439483&r2=439484&view=diff
==============================================================================
--- incubator/tuscany/site/site-author/monitoring.htm (original)
+++ incubator/tuscany/site/site-author/monitoring.htm Fri Sep 1 14:19:53 2006
@@ -1,7 +1,7 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><!-- Copyright (c) 2005 The Apache Software Foundation or its licensors, as applicable. 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. -->
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <meta http-equiv="Content-Style-Type" content="text/css">
-<title>Tuscany Monitoring</title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <meta http-equiv="Content-Style-Type" content="text/css">
+<title>Tuscany Monitoring</title>
<!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
<style type="text/css" media="all">
@import url("../../../../css/maven-base.css");
@@ -147,4 +147,4 @@
levels of the interface methods, a default Java logging
level that is used if none is found in the Properties, or through
introspection of the Interface LogLevel annotations, and the name
-of the resource bundle to be used.</body></html>
+of the resource bundle to be used.</body></html>
Modified: incubator/tuscany/site/site-author/sca_index.xml
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/sca_index.xml?rev=439484&r1=439483&r2=439484&view=diff
==============================================================================
--- incubator/tuscany/site/site-author/sca_index.xml (original)
+++ incubator/tuscany/site/site-author/sca_index.xml Fri Sep 1 14:19:53 2006
@@ -5,7 +5,7 @@
<bannertitle>Tuscany SCA</bannertitle>
</properties>
<body>
- <section name="Service Component Architecture">
+ <section name="Service Component Architecture - Overview">
<p> SCA provides developers with a simple, business-oriented, model for creating systems based on a service oriented
architecture. It manages infrastructure complexities such as transactions, security and reliable
messaging and frees the developer to focus on providing business function. The solutions developed
@@ -26,31 +26,36 @@
<p>* The Assembly of sets of components to build composite business applications that addresses specific
business requirements. This is performed by wiring together the service implementation components. </p>
-
- <img src ="/images/sca_composite.jpg" alt="SCA Composite" usemap ="#scaMap" border="0" width="100%" height="100%" />
+ <div align="center">
+ <br/>
+ Click on the diagram for more information.
+ <br/><br/>
+ <img src ="images/SCAComposite.png" alt="SCA Composite" usemap ="#scaMap" border="0" />
+
+ </div>
<map name="scaMap">
- <area shape ="rect" coords ="153,26,358,128" href ="sca-interface.html" alt="Interface" />
- <area shape ="rect" coords ="640,23,845,125" href ="sca-interface.html" alt="Interface" />
+ <area shape ="rect" coords ="75,0,170, 55" href ="sca-interface.html" alt="Interface" />
+ <area shape ="rect" coords ="410,0,505,55" href ="sca-interface.html" alt="Interface" />
- <area shape ="rect" coords ="140,539,317,684" href ="sca-binding.html" alt="Binding" />
- <area shape ="rect" coords ="684,540,863,684" href ="sca-binding.html" alt="Binding" />
+ <area shape ="rect" coords ="75,222,160,308" href ="sca-binding.html" alt="Binding" />
+ <area shape ="rect" coords ="425,222,511,308" href ="sca-binding.html" alt="Binding" />
- <area shape ="rect" coords ="434,540,596,686" href ="sca-implementation.html" alt="Implementation" />
+ <area shape ="rect" coords ="245,222,330,308" href ="sca-implementation.html" alt="Implementation" />
- <area shape ="rect" coords ="197,435,272,481" href ="sca-wire.html" alt="Wire" />
- <area shape ="rect" coords ="493,436,566,480" href ="sca-wire.html" alt="Wire" />
- <area shape ="rect" coords ="758,437,833,480" href ="sca-wire.html" alt="Wire" />
+ <area shape ="rect" coords ="108,178,130,187" href ="sca-wire.html" alt="Wire" />
+ <area shape ="rect" coords ="280,178,305,187" href ="sca-wire.html" alt="Wire" />
+ <area shape ="rect" coords ="455,178,480,187" href ="sca-wire.html" alt="Wire" />
- <area shape ="rect" coords ="301,287,464,392" href ="sca-component.html" alt="Component A" />
- <area shape ="rect" coords ="567,287,729,390" href ="sca-component.html" alt="Component B" />
+ <area shape ="rect" coords ="145,105,260,170" href ="sca-component.html" alt="Component A" />
+ <area shape ="rect" coords ="320,105,435,170" href ="sca-component.html" alt="Component B" />
- <area shape ="poly" coords ="21,287, 143,287, 183,332, 142,376, 22,376, 61,332" href ="sca-service.html" alt="Service" />
- <area shape ="poly" coords ="833,288, 954,288, 994,333, 954,376, 833,375, 871,331" href ="sca-reference.html" alt="Reference" />
+ <area shape ="rect" coords ="0,105,105,170" href ="sca-service.html" alt="Service" />
+ <area shape ="rect" coords ="475,105,580,170" href ="sca-reference.html" alt="Reference" />
- <area shape ="rect" coords ="457,52,580,95" href ="sca-property.html" alt="Property" />
+ <area shape ="rect" coords ="245,0,307,22" href ="sca-property.html" alt="Property" />
- <area shape ="rect" coords ="93,170,906,509" href ="sca-composite.html" alt="Composite" />
+ <area shape ="rect" coords ="60,60,525,215" href ="sca-composite.html" alt="Composite" />
</map>
</section>
Modified: incubator/tuscany/site/site-author/sdo_index.xml
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/sdo_index.xml?rev=439484&r1=439483&r2=439484&view=diff
==============================================================================
--- incubator/tuscany/site/site-author/sdo_index.xml (original)
+++ incubator/tuscany/site/site-author/sdo_index.xml Fri Sep 1 14:19:53 2006
@@ -6,7 +6,7 @@
<author email="kelvingoodson+tuscanysite@gmail.com">Kelvin Goodson</author>
</properties>
<body>
- <section name="Service Data Objects">
+ <section name="Service Data Objects - Overview">
<p>
Service Data Objects simplify and unify SOA data access architecture and code in a heterogeneous environment.
SDO is programming language neutral. Within Tuscany it is being implemented in Java and in C++. A
@@ -32,34 +32,5 @@
change summary to update the original data source.
</p>
</section>
- <section name="SDO Java">
- <h3>SDO Java Getting Started</h3>
- <p>
- To get started with Java SDO, follow the downloads link and pick up either a binary or source distribution. If you
- are working from a source distribution, you can follow the <a href="java-projects.html">general instructions</a> for building the whole of the Tuscany java projects, or you
- can follow the intructions within the <A href="java_sdo_overview.html"> SDO Java overview </A> to build and explore just SDO java.
- </p>
- <h3>SDO Java Documents</h3>h3>
- <table>
- <tr>
- <td>
- <a href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/specs/ws-sdo/SDO_Specification_Java_V2.01.pdf"> SDO Specification for Java V2.01</a>
- </td>
- <td>
- The Service Data Objects specification for Java. Describes the data programming interfaces of SDO in the Java language.
- </td>
- </tr>
- <tr>
- <td><a href="http://download.boulder.ibm.com/ibmdl/pub/software/dw/specs/ws-sdo/Next-Gen-Data-Programming-Whitepaper.pdf">SDO White Paper</a></td>
- <td>A white paper that explains the SDO programming model</td>
- </tr>
- </table>
- </section>
- <section name="SDO for C++">
- <p>
- TBD
- </p>
- </section>
-
</body>
</document>
Modified: incubator/tuscany/site/site-author/stylesheets/project.xml
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/stylesheets/project.xml?rev=439484&r1=439483&r2=439484&view=diff
==============================================================================
--- incubator/tuscany/site/site-author/stylesheets/project.xml (original)
+++ incubator/tuscany/site/site-author/stylesheets/project.xml Fri Sep 1 14:19:53 2006
@@ -5,8 +5,9 @@
<logo href="/images/tuscanylogo_candidate2.jpg">Tuscany</logo>
<body>
+
- <menu name="General">
+ <menu name="General" label="images/GeneralLabel.png">
<item name="Home" href="/index.html"/>
<item name="News" href="/news.html"/>
<item name="Documentation" href="/documentation.html"/>
@@ -18,7 +19,16 @@
-->
</menu>
- <menu name="Community">
+ <menu name="Getting Started" label="images/GettingStartedLabel.png">
+ <item name="SCA-Java" href="/java_sca_overview.html"/>
+ <item name="SCA-C++" href="/cpp_sca_overview.html"/>
+ <item name="SDO-Java" href="/java_sdo_overview.html"/>
+ <item name="SDO-C++" href="/cpp_sdo_overview.html"/>
+ <item name="DAS-Java" href="/java_das_overview.html"/>
+ </menu>
+
+
+ <menu name="Community" label="images/CommunityLabel.png">
<item name="Get Involved" href="/get-involved.html"/>
<!-- do we want this ?
<item name="Committers" href="/team-list.html"/>
@@ -30,7 +40,7 @@
<item name="Blog" href="http://apache-tuscany.blogspot.com"/>
</menu>
- <menu name="Development">
+ <menu name="Development" label="images/DevelopmentLabel.png">
<item name="Road Map / TODO" href="http://wiki.apache.org/ws/Tuscany/TuscanyJava/Roadmap" />
<item name="Source Code" href="/source-code.html" />
<item name="Java projects" href="/java-projects.html" />
Modified: incubator/tuscany/site/site-author/stylesheets/site.vsl
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/stylesheets/site.vsl?rev=439484&r1=439483&r2=439484&view=diff
==============================================================================
--- incubator/tuscany/site/site-author/stylesheets/site.vsl (original)
+++ incubator/tuscany/site/site-author/stylesheets/site.vsl Fri Sep 1 14:19:53 2006
@@ -98,6 +98,8 @@
#macro ( projectanchor $name $value )
#if ($value.startsWith("http://"))
<a href="$value" target="_blank">$name</a>
+#elseif($value.equals("#"))
+ <a href="$value">$name</a>
#else
<a href="$relativePath$value">$name</a>
#end
@@ -173,50 +175,72 @@
#end
#macro ( section $section)
- <table border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="$bannerbg">
- <font color="$bannerfg" face="arial,helvetica,sanserif">
- <a name="$section.getAttributeValue("name")"><strong>$section.getAttributeValue("name")</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- #foreach ( $items in $section.getChildren() )
- #if ($items.getName().equals("img"))
- #image ($items)
- #elseif ($items.getName().equals("source"))
- #source ($items)
- #elseif ($items.getName().equals("table"))
- #table ($items)
- #elseif ($items.getName().equals("subsection"))
- #subsection ($items)
- #else
- $items
- #end
- #end
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br/></td></tr>
- </table>
+ <table class="content" border="0" width="90%" cellspacing="0" cellpadding="0" align="center">
+ <tr class="title" height="17" background="images/TitleC.png">
+ <td align="left">
+ <img src="images/TitleL.png" width="15" height="17" alt=""></td>
+ <td align="center" height="17" id="title">
+ #projectanchor($section.getAttributeValue("name") "#")
+ </td>
+ <td align="right">
+ <img src="images/TitleR.png" width="14" height="17" alt=""></td>
+ </tr>
+ <tr>
+ <td background="images/WhiteL.png" width="15"></td>
+ <td width="100%">
+ <div id="content">
+ #foreach ( $items in $section.getChildren() )
+ $items
+ #end
+ </div>
+ </td>
+ <td background="images/WhiteR.png" width="14"></td>
+ </tr>
+
+ <tr>
+ <td background="images/WhiteBL.png" width="15" height="14"></td>
+ <td background="images/WhiteB.png" ></td>
+ <td background="images/WhiteBR.png" width="14"></td>
+ </tr>
+
+ </table>
#end
-#macro ( makeProject )
-
- <!-- ============================================================ -->
-
+#macro ( makeMenu )
#set ($menus = $project.getChild("body").getChildren("menu"))
#foreach ( $menu in $menus )
- <p><strong>$menu.getAttributeValue("name")</strong></p>
- <ul>
- #foreach ( $item in $menu.getChildren() )
- #set ($name = $item.getAttributeValue("name"))
- <li>#projectanchor($name $item.getAttributeValue("href"))</li>
- #end
- </ul>
+ <tr>
+ <td>
+ <img src='$menu.getAttributeValue("label")' width="137"height="18"alt=""></td>
+ </tr>
+ <tr>
+ <td width="137">
+ <table border="0" cellspacing="0" cellpadding="0"><tr>
+ <td background="images/leftSideGreyBorder.png" width="6"></td>
+ <td bgcolor="#FAFAFA" width="124">
+ #foreach ( $item in $menu.getChildren() )
+ #set ($name = $item.getAttributeValue("name"))
+ #projectanchor($name $item.getAttributeValue("href"))<br>
+ #end
+ </td>
+ <td background="images/rightSideGreyBorder.png" width="7"></td>
+ </tr></table>
+ </td>
+ </tr>
+ <tr><td>
+ <img src="images/greyBottom.png" width="137" height="10" alt=""></td>
+ </tr>
#end
#end
+#macro ( makeTab )
+ ##TODO Make this work!
+ #set ($tabs = $project.getChild("body").getChildren("tabs"))
+ #foreach ($tab in $tabs)
+ ##insert code for tabs here
+ #end
+#end
+
#macro (getProjectImage)
#set ( $logoString = $project.getChild("logo").getAttributeValue("href") )
<td align="left">
@@ -249,7 +273,8 @@
<!-- ====================================================================== -->
<html>
<head>
- <link rel="stylesheet" href="$relativePath/css/base.css"/>
+ <link rel="stylesheet" href="$relativePath/css/style.css"/>
+ <script src="DropMenu.js" type="text/javascript"></script>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
#set ($authors = $root.getChild("properties").getChildren("author"))
@@ -272,51 +297,122 @@
<title>$project.getChild("title").getText() - $root.getChild("properties").getChild("title").getText()</title>
</head>
-<body bgcolor="$bodybg" text="$bodyfg" link="$bodylink">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td align='LEFT'>#getProjectImage()</td>
- <td align='LEFT'>#getBannerTitle()</td>
- </tr>
- </table>
- <hr noshade="" size="1"/>
- <table border="0" cellspacing="0">
- <tr>
- <td>#projectanchor("Home" "/index.html")</td>
- <td>#projectanchor("SCA" "/sca_index.html")</td>
- <td>#projectanchor("SDO" "/sdo_index.html")</td>
- <td>#projectanchor("DAS" "/das_index.html")</td>
- </tr>
- </table>
+<body topmargin="0" leftmargin="0" marginwidth="0" marginheight="0">
+ <table class="topbar" id="topbar" border="0" width="100%" cellspacing="0" cellpadding="0" height="94" bgcolor="#FF0000" background="images/TopBarBG.png">
+ <tr>
+ <td width="244">
+ <img src="images/Logo.png" width="244" height="94" alt=""></td>
+
+ <td width="64">
+ <table width="64" border="0" cellspacing="0" cellpadding="0">
+ <tr height="59"><td>
+ <div style="width: 64px; height: 22px; position: absolute; left: 244px; top: 59px">
+ <a href="sca_index.html" onMouseover="return !showMenu(event, 'scaMenu');" class="History">
+ <img src="images/SCATab2.png" width="64" height="22" border="0"></a>
+ </div>
+ </td></tr>
+ <tr><td>
+ <div class="menu" id="scaMenu" style="width: 65px; position:absolute; left:243px; top: 81px; z-index:2 ; visibility:hidden; "
+ onmouseover="event.cancelBubble = true;">
+ <table border="0" cellspacing="0" cellpadding="0" height="39">
+ <tr><td>
+ <a href="sca_index.html"><img onMouseOver="this.src='images/genMenuItemDown.png';"
+ onMouseOut="this.src='images/genMenuItem.png';" src="images/genMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="java_sca_overview.html"><img vspace="0" onMouseOver="this.src='images/javaMenuItemDown.png';"
+ onMouseOut="this.src='images/javaMenuItem.png';" src="images/javaMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="cpp_sca_overview.html"><img vspace="0" onMouseOver="this.src='images/cppMenuItemDown.png';"
+ onMouseOut="this.src='images/cppMenuItem.png';" src="images/cppMenuItem.png" border="0"></a>
+ </td></tr>
+ </table>
+ </div>
+ </td></tr>
+ </table>
+ </td>
+
+ <td valign="bottom" width="64">
+ <table width="64" border="0" cellspacing="0" cellpadding="0">
+ <tr><td>
+ <div style="width: 64px; height: 22px; position: absolute; left: 308px; top: 59px">
+ <a href="sdo_index.html" onMouseover="return !showMenu(event, 'sdoMenu');" class="History">
+ <img src="images/SDOTab2.png" width="64" height="22" border="0"></a>
+ </div>
+ </td></tr>
+ <tr><td>
+ <div class="menu" id="sdoMenu" style="width: 65px; position:absolute; left:307px; top: 81px; z-index:2 ; visibility:hidden"
+ onmouseover="event.cancelBubble = true;">
+ <table border="0" cellspacing="0" cellpadding="0" height="39">
+ <tr><td>
+ <a href="sdo_index.html"><img onMouseOver="this.src='images/genMenuItemDown.png';"
+ onMouseOut="this.src='images/genMenuItem.png';" src="images/genMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="java_sdo_overview.html"><img vspace="0" onMouseOver="this.src='images/javaMenuItemDown.png';"
+ onMouseOut="this.src='images/javaMenuItem.png';" src="images/javaMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="cpp_sdo_overview.html"><img vspace="0" onMouseOver="this.src='images/cppMenuItemDown.png';"
+ onMouseOut="this.src='images/cppMenuItem.png';" src="images/cppMenuItem.png" border="0"></a>
+ </td></tr>
+ </table>
+ </div>
+ </td></tr>
+ </table>
+ </td>
+
+ <td valign="bottom" width="64">
+ <table width="64" border="0" cellspacing="0" cellpadding="0">
+ <tr><td>
+ <div style="width: 64px; height: 22px; position: absolute; left: 372px; top: 59px">
+ <a href="das_index.html" onMouseover="return !showMenu(event, 'dasMenu');" class="History">
+ <img src="images/DASTab2.png" width="64" height="22" border="0"></a>
+ </div>
+ </td></tr>
+ <tr><td>
+ <div class="menu" id="dasMenu" style="width: 65px; position:absolute; left:371px; top: 81px; z-index:2 ; visibility:hidden"
+ onmouseover="event.cancelBubble = true;">
+ <table border="0" cellspacing="0" cellpadding="0">
+ <tr><td>
+ <a href="das_index.html"><img onMouseOver="this.src='images/genMenuItemDown.png';"
+ onMouseOut="this.src='images/genMenuItem.png';" src="images/genMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="java_das_overview.html"><img vspace="0" onMouseOver="this.src='images/javaMenuItemDown.png';"
+ onMouseOut="this.src='images/javaMenuItem.png';" src="images/javaMenuItem.png" border="0"></a>
+ </td></tr>
+ </table>
+ </div>
+ </td></tr>
+ </table>
+ </td>
+
+ <td align="right">
+ <img src="http://incubator.apache.org/tuscany/images/apache-incubator-logo.png" style="padding: 5px;"> </td>
+ </tr>
+ </table>
<table border="0" width="100%" cellspacing="4">
<tr>
<!-- LEFT SIDE NAVIGATION -->
- <td width="20%" valign="top" nowrap="true">
- #makeProject()
- </td>
- <td width="80%" align="left" valign="top">
- #set ($allSections = $root.getChild("body").getChildren("section"))
- #foreach ( $section in $allSections )
- #section ($section)
- #end
+ <td width="137" valign="top" nowrap="true">
+ <table class="navbar" border="0" cellpadding="0" cellspacing="0" align="left" height="100%">
+ #makeMenu()
+ </table>
+ </td>
+ <!-- CONTENT! -->
+ <td width="100%" align="left" valign="top">
+ #set ($allSections = $root.getChild("body").getChildren("section"))
+ #foreach ( $section in $allSections )
+ #section ($section)
+ #end
</td>
- </tr>
- </table>
- <hr noshade="" size="1"/>
- <table border="0" width="100%" cellspacing="0">
- <tr>
- <td><img src="$relativePath/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>
+ </table>
+ <div class="copyright">
+ Copyright © 2006, The Apache Software Foundation
+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.
+ </div>
</body>
</html>
#end
Added: incubator/tuscany/site/site-author/tuscany.gif
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/tuscany.gif?rev=439484&view=auto
==============================================================================
Binary file - no diff available.
Propchange: incubator/tuscany/site/site-author/tuscany.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/tuscany/site/site-publish/DropMenu.js
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-publish/DropMenu.js?rev=439484&view=auto
==============================================================================
--- incubator/tuscany/site/site-publish/DropMenu.js (added)
+++ incubator/tuscany/site/site-publish/DropMenu.js Fri Sep 1 14:19:53 2006
@@ -0,0 +1,46 @@
+document.onmouseover = hideAllMenus;
+
+
+function showMenu(eventObj, menu) {
+ hideAllMenus();
+ eventObj.cancelBubble = true;
+ if(changeObjectVisibility(menu, 'visible')) {
+ return true;
+ } else {
+ return false;
+ }
+}
+
+function hideAllMenus() {
+ changeObjectVisibility('scaMenu', 'hidden');
+ changeObjectVisibility('sdoMenu', 'hidden');
+ changeObjectVisibility('dasMenu', 'hidden');
+}
+
+function getStyleObject(objectId) {
+ // cross-browser function to get an object's style object given its id
+ if(document.getElementById && document.getElementById(objectId)) {
+ // W3C DOM
+ return document.getElementById(objectId).style;
+ } else if (document.all && document.all(objectId)) {
+ // MSIE 4 DOM
+ return document.all(objectId).style;
+ } else if (document.layers && document.layers[objectId]) {
+ // NN 4 DOM.. note: this won't find nested layers
+ return document.layers[objectId];
+ } else {
+ return false;
+ }
+} // getStyleObject
+
+function changeObjectVisibility(objectId, newVisibility) {
+ // get a reference to the cross-browser style object and make sure the object exists
+ var styleObject = getStyleObject(objectId);
+ if(styleObject) {
+ styleObject.visibility = newVisibility;
+ return true;
+ } else {
+ //we couldn't find the object, so we can't change its visibility
+ return false;
+ }
+}
\ No newline at end of file
Modified: incubator/tuscany/site/site-publish/codeguidelines.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-publish/codeguidelines.html?rev=439484&r1=439483&r2=439484&view=diff
==============================================================================
--- incubator/tuscany/site/site-publish/codeguidelines.html (original)
+++ incubator/tuscany/site/site-publish/codeguidelines.html Fri Sep 1 14:19:53 2006
@@ -26,7 +26,8 @@
<!-- ====================================================================== -->
<html>
<head>
- <link rel="stylesheet" href="./css/base.css"/>
+ <link rel="stylesheet" href="./css/style.css"/>
+ <script src="DropMenu.js" type="text/javascript"></script>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
@@ -36,141 +37,309 @@
<title>Tuscany - Tuscany Java Coding Guidelines</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 Coding Guidelines</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>
+<body topmargin="0" leftmargin="0" marginwidth="0" marginheight="0">
+ <table class="topbar" id="topbar" border="0" width="100%" cellspacing="0" cellpadding="0" height="94" bgcolor="#FF0000" background="images/TopBarBG.png">
+ <tr>
+ <td width="244">
+ <img src="images/Logo.png" width="244" height="94" alt=""></td>
+
+ <td width="64">
+ <table width="64" border="0" cellspacing="0" cellpadding="0">
+ <tr height="59"><td>
+ <div style="width: 64px; height: 22px; position: absolute; left: 244px; top: 59px">
+ <a href="sca_index.html" onMouseover="return !showMenu(event, 'scaMenu');" class="History">
+ <img src="images/SCATab2.png" width="64" height="22" border="0"></a>
+ </div>
+ </td></tr>
+ <tr><td>
+ <div class="menu" id="scaMenu" style="width: 65px; position:absolute; left:243px; top: 81px; z-index:2 ; visibility:hidden; "
+ onmouseover="event.cancelBubble = true;">
+ <table border="0" cellspacing="0" cellpadding="0" height="39">
+ <tr><td>
+ <a href="sca_index.html"><img onMouseOver="this.src='images/genMenuItemDown.png';"
+ onMouseOut="this.src='images/genMenuItem.png';" src="images/genMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="java_sca_overview.html"><img vspace="0" onMouseOver="this.src='images/javaMenuItemDown.png';"
+ onMouseOut="this.src='images/javaMenuItem.png';" src="images/javaMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="cpp_sca_overview.html"><img vspace="0" onMouseOver="this.src='images/cppMenuItemDown.png';"
+ onMouseOut="this.src='images/cppMenuItem.png';" src="images/cppMenuItem.png" border="0"></a>
+ </td></tr>
+ </table>
+ </div>
+ </td></tr>
+ </table>
+ </td>
+
+ <td valign="bottom" width="64">
+ <table width="64" border="0" cellspacing="0" cellpadding="0">
+ <tr><td>
+ <div style="width: 64px; height: 22px; position: absolute; left: 308px; top: 59px">
+ <a href="sdo_index.html" onMouseover="return !showMenu(event, 'sdoMenu');" class="History">
+ <img src="images/SDOTab2.png" width="64" height="22" border="0"></a>
+ </div>
+ </td></tr>
+ <tr><td>
+ <div class="menu" id="sdoMenu" style="width: 65px; position:absolute; left:307px; top: 81px; z-index:2 ; visibility:hidden"
+ onmouseover="event.cancelBubble = true;">
+ <table border="0" cellspacing="0" cellpadding="0" height="39">
+ <tr><td>
+ <a href="sdo_index.html"><img onMouseOver="this.src='images/genMenuItemDown.png';"
+ onMouseOut="this.src='images/genMenuItem.png';" src="images/genMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="java_sdo_overview.html"><img vspace="0" onMouseOver="this.src='images/javaMenuItemDown.png';"
+ onMouseOut="this.src='images/javaMenuItem.png';" src="images/javaMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="cpp_sdo_overview.html"><img vspace="0" onMouseOver="this.src='images/cppMenuItemDown.png';"
+ onMouseOut="this.src='images/cppMenuItem.png';" src="images/cppMenuItem.png" border="0"></a>
+ </td></tr>
+ </table>
+ </div>
+ </td></tr>
+ </table>
+ </td>
+
+ <td valign="bottom" width="64">
+ <table width="64" border="0" cellspacing="0" cellpadding="0">
+ <tr><td>
+ <div style="width: 64px; height: 22px; position: absolute; left: 372px; top: 59px">
+ <a href="das_index.html" onMouseover="return !showMenu(event, 'dasMenu');" class="History">
+ <img src="images/DASTab2.png" width="64" height="22" border="0"></a>
+ </div>
+ </td></tr>
+ <tr><td>
+ <div class="menu" id="dasMenu" style="width: 65px; position:absolute; left:371px; top: 81px; z-index:2 ; visibility:hidden"
+ onmouseover="event.cancelBubble = true;">
+ <table border="0" cellspacing="0" cellpadding="0">
+ <tr><td>
+ <a href="das_index.html"><img onMouseOver="this.src='images/genMenuItemDown.png';"
+ onMouseOut="this.src='images/genMenuItem.png';" src="images/genMenuItem.png" border="0"></a>
+ </td></tr>
+ <tr><td>
+ <a href="java_das_overview.html"><img vspace="0" onMouseOver="this.src='images/javaMenuItemDown.png';"
+ onMouseOut="this.src='images/javaMenuItem.png';" src="images/javaMenuItem.png" border="0"></a>
+ </td></tr>
+ </table>
+ </div>
+ </td></tr>
+ </table>
+ </td>
+
+ <td align="right">
+ <img src="http://incubator.apache.org/tuscany/images/apache-incubator-logo.png" style="padding: 5px;"> </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 Coding Guidelines"><strong>Tuscany Java Coding Guidelines</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <ol>
+ <td width="137" valign="top" nowrap="true">
+ <table class="navbar" border="0" cellpadding="0" cellspacing="0" align="left" height="100%">
+ <tr>
+ <td>
+ <img src='images/GeneralLabel.png' width="137"height="18"alt=""></td>
+ </tr>
+ <tr>
+ <td width="137">
+ <table border="0" cellspacing="0" cellpadding="0"><tr>
+ <td background="images/leftSideGreyBorder.png" width="6"></td>
+ <td bgcolor="#FAFAFA" width="124">
+ <a href="./index.html">Home</a>
+<br>
+ <a href="./news.html">News</a>
+<br>
+ <a href="./documentation.html">Documentation</a>
+<br>
+ <a href="./license.html">License</a>
+<br>
+ <a href="http://www.apache.org/" target="_blank">ASF</a>
+<br>
+ <a href="./downloads.html">Downloads</a>
+<br>
+ </td>
+ <td background="images/rightSideGreyBorder.png" width="7"></td>
+ </tr></table>
+ </td>
+ </tr>
+ <tr><td>
+ <img src="images/greyBottom.png" width="137" height="10" alt=""></td>
+ </tr>
+ <tr>
+ <td>
+ <img src='images/GettingStartedLabel.png' width="137"height="18"alt=""></td>
+ </tr>
+ <tr>
+ <td width="137">
+ <table border="0" cellspacing="0" cellpadding="0"><tr>
+ <td background="images/leftSideGreyBorder.png" width="6"></td>
+ <td bgcolor="#FAFAFA" width="124">
+ <a href="./java_sca_overview.html">SCA-Java</a>
+<br>
+ <a href="./cpp_sca_overview.html">SCA-C++</a>
+<br>
+ <a href="./java_sdo_overview.html">SDO-Java</a>
+<br>
+ <a href="./cpp_sdo_overview.html">SDO-C++</a>
+<br>
+ <a href="./java_das_overview.html">DAS-Java</a>
+<br>
+ </td>
+ <td background="images/rightSideGreyBorder.png" width="7"></td>
+ </tr></table>
+ </td>
+ </tr>
+ <tr><td>
+ <img src="images/greyBottom.png" width="137" height="10" alt=""></td>
+ </tr>
+ <tr>
+ <td>
+ <img src='images/CommunityLabel.png' width="137"height="18"alt=""></td>
+ </tr>
+ <tr>
+ <td width="137">
+ <table border="0" cellspacing="0" cellpadding="0"><tr>
+ <td background="images/leftSideGreyBorder.png" width="6"></td>
+ <td bgcolor="#FAFAFA" width="124">
+ <a href="./get-involved.html">Get Involved</a>
+<br>
+ <a href="./mail-lists.html">Mailing Lists</a>
+<br>
+ <a href="./faq.html">FAQ</a>
+<br>
+ <a href="./issue-tracking.html">Issue Tracking</a>
+<br>
+ <a href="http://wiki.apache.org/ws/Tuscany" target="_blank">Wiki</a>
+<br>
+ <a href="http://apache-tuscany.blogspot.com" target="_blank">Blog</a>
+<br>
+ </td>
+ <td background="images/rightSideGreyBorder.png" width="7"></td>
+ </tr></table>
+ </td>
+ </tr>
+ <tr><td>
+ <img src="images/greyBottom.png" width="137" height="10" alt=""></td>
+ </tr>
+ <tr>
+ <td>
+ <img src='images/DevelopmentLabel.png' width="137"height="18"alt=""></td>
+ </tr>
+ <tr>
+ <td width="137">
+ <table border="0" cellspacing="0" cellpadding="0"><tr>
+ <td background="images/leftSideGreyBorder.png" width="6"></td>
+ <td bgcolor="#FAFAFA" width="124">
+ <a href="http://wiki.apache.org/ws/Tuscany/TuscanyJava/Roadmap" target="_blank">Road Map / TODO</a>
+<br>
+ <a href="./source-code.html">Source Code</a>
+<br>
+ <a href="./java-projects.html">Java projects</a>
+<br>
+ <a href="./cpp-projects.html">C++ projects</a>
+<br>
+ </td>
+ <td background="images/rightSideGreyBorder.png" width="7"></td>
+ </tr></table>
+ </td>
+ </tr>
+ <tr><td>
+ <img src="images/greyBottom.png" width="137" height="10" alt=""></td>
+ </tr>
+ </table>
+ </td>
+ <!-- CONTENT! -->
+ <td width="100%" align="left" valign="top">
+ <table class="content" border="0" width="90%" cellspacing="0" cellpadding="0" align="center">
+ <tr class="title" height="17" background="images/TitleC.png">
+ <td align="left">
+ <img src="images/TitleL.png" width="15" height="17" alt=""></td>
+ <td align="center" height="17" id="title">
+ <a href="#">Tuscany Java Coding Guidelines</a>
+ </td>
+ <td align="right">
+ <img src="images/TitleR.png" width="14" height="17" alt=""></td>
+ </tr>
+ <tr>
+ <td background="images/WhiteL.png" width="15"></td>
+ <td width="100%">
+ <div id="content">
+ <ol>
<li><a href="#Indentation">Indentation</a></li>
<li><a href="#Exception Handling">Exception Handling</a></li>
<li><a href="#Package Naming"> Package Naming</a></li>
<li><a href="#Logging">Logging</a></li>
</ol>
- </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="Indentation"><strong>Indentation</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ </td>
+ <td background="images/WhiteR.png" width="14"></td>
+ </tr>
+
+ <tr>
+ <td background="images/WhiteBL.png" width="15" height="14"></td>
+ <td background="images/WhiteB.png" ></td>
+ <td background="images/WhiteBR.png" width="14"></td>
+ </tr>
+
+ </table>
+ <table class="content" border="0" width="90%" cellspacing="0" cellpadding="0" align="center">
+ <tr class="title" height="17" background="images/TitleC.png">
+ <td align="left">
+ <img src="images/TitleL.png" width="15" height="17" alt=""></td>
+ <td align="center" height="17" id="title">
+ <a href="#">Indentation</a>
+ </td>
+ <td align="right">
+ <img src="images/TitleR.png" width="14" height="17" alt=""></td>
+ </tr>
+ <tr>
+ <td background="images/WhiteL.png" width="15"></td>
+ <td width="100%">
+ <div id="content">
+ <p>
We follow Sun's coding standard rules which are pretty common in Java. We have also discussed to adopt a tool that would scan the code to make sure it is in the right format. More information will be added once that discussion is final.
</p>
- <p>
+ <p>
<script type="text/javascript">linkNewWindow('http://java.sun.com/docs/codeconv/','http://java.sun.com/docs/codeconv/');</script>
</p>
- <p>
+ <p>
<script type="text/javascript">linkNewWindow('http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html','http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html');</script>
</p>
- <p>
+ <p>
Please use 4 characters indentation and do not use tabs.
</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="Exception Handling"><strong>Exception Handling</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ </td>
+ <td background="images/WhiteR.png" width="14"></td>
+ </tr>
+
+ <tr>
+ <td background="images/WhiteBL.png" width="15" height="14"></td>
+ <td background="images/WhiteB.png" ></td>
+ <td background="images/WhiteBR.png" width="14"></td>
+ </tr>
+
+ </table>
+ <table class="content" border="0" width="90%" cellspacing="0" cellpadding="0" align="center">
+ <tr class="title" height="17" background="images/TitleC.png">
+ <td align="left">
+ <img src="images/TitleL.png" width="15" height="17" alt=""></td>
+ <td align="center" height="17" id="title">
+ <a href="#">Exception Handling</a>
+ </td>
+ <td align="right">
+ <img src="images/TitleR.png" width="14" height="17" alt=""></td>
+ </tr>
+ <tr>
+ <td background="images/WhiteL.png" width="15"></td>
+ <td width="100%">
+ <div id="content">
+ <p>
In general Exceptions should be designed thinking what the catcher of exception would likely do with the exception. There are three types of exceptions.
</p>
- <ul>
+ <ul>
<li>
Code Exception: Can be handled at some level of the call stack.
</li>
@@ -181,33 +350,33 @@
Assertion Exception: Problem remedied by developer fixing a bug in the code
</li>
</ul>
- <p>
+ <p>
<span style="font-size: 14pt;">
Code Exceptions
</span>
</p>
- <p>
+ <p>
There are two types of code exceptions, checked and unchecked exceptions. A checked exception would be thrown when the code cannot handle a specific situation. In this case it is expected for the caller to handle this exception in one of the following ways: 1) handle the exception, 2) re-throw it to its caller, 3) change it to another exception that makes sense to its caller. In general, code exceptions should be checked exceptions. They should be named based on what happened, rather than based on who is throwing the exception. If the exception is well named, it should be possible for the exception to be present on signatures at several levels of a call stack and still make sense (e.g. ServiceUnavailableException).
</p>
- <p>
+ <p>
Throw unchecked exceptions if the exception is a programming error or system failure and cannot be handled by the caller (RuntimeException).
</p>
- <p>
+ <p>
<span style="font-size: 14pt;">
User Exceptions
</span>
</p>
- <p>
+ <p>
User Exceptions are exceptions that signal a problem that needs to be handled by the user of the system, for example an administrator. Text of the message that is carried with the exception needs to be clear in order to help the user to debug the problem. For example a stack trace is not useful information for a user. It is important to catch user type exceptions and add meaningful context to build a message that is useful.
</p>
- <p>
+ <p>
A base UserException class can have an array of messages, rather than just one message. For example, code that parses an SCA subsystem file might have a rethrow that just adds "While parsing the xyz subsystem file". This message could probably not be generated by the code that discovered the problem (say an XML parsing problem), so a combination of the original message (e.g. "Missing end tag") and the higher level message ("while parsing the xyz subsystem file") are both necessary to know what happened. Naturally it can be any number of levels deep.
</p>
- <p>
+ <p>
The handling code for a user exception will somehow notify a user of the message and then possibly go on.
In a server, user exceptions can often be divided according to the fault type.
</p>
- <ul>
+ <ul>
<li>
Client fault: This is typically generated by the client code that sends the incoming message (e.g. SOAP faults). In this case, the message needs to be reported back to the client code in a format appropriate to the client. ClientExecption should be used to relay exceptions that occur on the client side.
</li>
@@ -215,54 +384,54 @@
Code or configuration fault: In this case, only a vague "problem occured here" message should be sent to the client and the real exception message should be logged and/or sent to an administrator.
</li>
</ul>
- <p>
+ <p>
The remaining user exceptions are typically problems with configuration or the environment. Some of them will be severe enough that the entire application needs to be brought down, while others could be handled by just logging the problem and going on. This difference implies that there needs to be a different exception type. In the case of session-scoped services, the problem is likely to require that the instance of the service be put into an error state (like paused). This is because subsequent messages for the service have been sent on the assumption that the previous message actually gets processed. If some configuration error prevents a session-scoped service from handling a single message, all future (async) messages for that service instance should be queued up so they can be processed once the problem has been solved.
</p>
- <p>
+ <p>
<span style="font-size: 14pt;">
Assertion Exceptions
</span>
</p>
- <p>
+ <p>
Assertion exceptions are exceptions that result from a bug in Tuscany and as such are also intended to be solved by the developers. In these cases the message isn't nearly as important, since the stack trace provides valuable context. If an assertion exception occurs little can be known about the state of the server. If we wanted to be safe we would say that assertion exceptions always bring down the entire server. However, we could play it a little looser and say that assertion exceptions only bring down the application in which they are discovered.
</p>
- <p>
+ <p>
<span style="font-size: 14pt;">
Guidelines
</span>
</p>
- <p>
+ <p>
The following are a set of guidelines based on the above exception philosophy:
</p>
- <p>
+ <p>
1. Checked vs. unchecked exceptions
Unchecked exceptions should be used when an error condition is not recoverable. Checked exceptions thrown by third party libraries that are not recoverable should be wrapped in unchecked exceptions rather than being propagated up the call stack. For example, an IOException raised when reading a file might be wrapped in an unchecked LoadException containing the name of the file. Unchecked must always be Javadoced and declared in the throws clause of a method.
</p>
- <p>
+ <p>
2. Assertion exceptions should use the standard JDK assert facilities
</p>
- <p>
+ <p>
3. Any exception thrown to user code must extend the appropriate Exception as defined by the specification. This will typically be a runtime Exception.
</p>
- <p>
+ <p>
4. No other Exceptions should be thrown to user code. Each user API method should catch any internal exceptions and wrap them in the applicable Exception defined by the specification. Internal exceptions must ultimately extend either TuscanyException or TuscanyRuntimeException.
</p>
- <p>
+ <p>
4. When possible, create clear package exception hierarchies
In most cases, packages should have a clear exception hierarchy with abstract root checked and unchecked exceptions which more specific concrete exceptions extend. Declaring the root package exceptions abstract avoids code throwing exceptions which are too general. Creating an exception hierarchy allows client code using a particular package to choose the level of exception handling granularity (which in turn simplifies the client code by avoiding unwieldy try..catch clauses).
</p>
- <p>
+ <p>
5. Preserve all stack trace information and the original exception
Exceptions must always preserve the stack trace and original exception except under special circumstances. When wrapping exceptions to propagate, never modify the stack trace and always include the caught exception as the cause.
</p>
- <p>
+ <p>
6. Only include local information pertinent to the failure
For I18N, contextual information stored in the Exception should not be localized. It should comprise only data pertaining to the cause, such as the name of the artifact as above, or a key that can be used by the top level exception handler. This is needed because the locale used to render the exception may be completely different from the locale used by the code raising the exception. For example, an exception may be thrown on a system whose default locale is German, logged to the system log in English but displayed to the end user in French, Japanese, whatever their native language is.
</p>
- <p>
+ <p>
7. For exceptions that require contextual information from various code layers, either wrap exceptions or create exceptions that can accept additional context as they are propagated up the call stack.
</p>
- <p>
+ <p>
If a failure requires information from multiple levels, e.g. there was an error setting property X on component Y in module Zdo one of the following. If the initial exception should be wrapped as it is propagated (e.g. the exception occurs at a library boundary), add additional context information in the wrapping exception(s). If the initial exception can be propagated, include methods for adding additional context information as the exception is rethrown up the stack. For example, the previous failure scenario could result in the following exception handling strategy:
A component property is configured with an invalid integer type
@@ -273,75 +442,98 @@
The configuration loader then wraps the IPE in a ConfigLoadExeption and provides the source from which the configuration is being loaded.
The UI being used to load the configuration reports the error to the user and displays the appropriate contextual information
</p>
- <p>
+ <p>
8. getMessage() must return unformatted context info. If the Exception contains multiple context fields they should be surrounded in square brackets and separated by commas, e.g. "[ property X, component Y, module Z ]"
</p>
- <p>
+ <p>
9. Do not override the behaviour of Throwable.toString() and Throwable.printStackTrace()
</p>
- <p>
+ <p>
10. The java.lang.Exception base class is Serializable so all subclasses must provide a serial UID. Any context fields must be Serializable and should be defined in the base java namespace for JDK1.4.
</p>
- <p>
+ <p>
11. Exceptions that wrap other Exceptions should ensure that any wrapped Exception can be deserialized in a client environment. This may require providing a custom writeObject method to extract any context information from the wrapped Exception during serialization; at a minimum the message should be preserved.
</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="Package Naming"><strong>Package Naming</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ </td>
+ <td background="images/WhiteR.png" width="14"></td>
+ </tr>
+
+ <tr>
+ <td background="images/WhiteBL.png" width="15" height="14"></td>
+ <td background="images/WhiteB.png" ></td>
+ <td background="images/WhiteBR.png" width="14"></td>
+ </tr>
+
+ </table>
+ <table class="content" border="0" width="90%" cellspacing="0" cellpadding="0" align="center">
+ <tr class="title" height="17" background="images/TitleC.png">
+ <td align="left">
+ <img src="images/TitleL.png" width="15" height="17" alt=""></td>
+ <td align="center" height="17" id="title">
+ <a href="#">Package Naming</a>
+ </td>
+ <td align="right">
+ <img src="images/TitleR.png" width="14" height="17" alt=""></td>
+ </tr>
+ <tr>
+ <td background="images/WhiteL.png" width="15"></td>
+ <td width="100%">
+ <div id="content">
+ <p>
TBD
</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="Logging"><strong>Logging</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
+ </div>
+ </td>
+ <td background="images/WhiteR.png" width="14"></td>
+ </tr>
+
+ <tr>
+ <td background="images/WhiteBL.png" width="15" height="14"></td>
+ <td background="images/WhiteB.png" ></td>
+ <td background="images/WhiteBR.png" width="14"></td>
+ </tr>
+
+ </table>
+ <table class="content" border="0" width="90%" cellspacing="0" cellpadding="0" align="center">
+ <tr class="title" height="17" background="images/TitleC.png">
+ <td align="left">
+ <img src="images/TitleL.png" width="15" height="17" alt=""></td>
+ <td align="center" height="17" id="title">
+ <a href="#">Logging</a>
+ </td>
+ <td align="right">
+ <img src="images/TitleR.png" width="14" height="17" alt=""></td>
+ </tr>
+ <tr>
+ <td background="images/WhiteL.png" width="15"></td>
+ <td width="100%">
+ <div id="content">
+ <p>
TBD
</p>
- </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>
+ </div>
+ </td>
+ <td background="images/WhiteR.png" width="14"></td>
+ </tr>
+
+ <tr>
+ <td background="images/WhiteBL.png" width="15" height="14"></td>
+ <td background="images/WhiteB.png" ></td>
+ <td background="images/WhiteBR.png" width="14"></td>
+ </tr>
+
+ </table>
+ </td>
+ </table>
+ <div class="copyright">
+ Copyright © 2006, The Apache Software Foundation
+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.
+ </div>
</body>
</html>
<!-- end the processing -->
+
---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org