sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r871152 - /websites/staging/sis/trunk/content/
Date Thu, 25 Jul 2013 13:09:19 GMT
Author: buildbot
Date: Thu Jul 25 13:09:19 2013
New Revision: 871152

Log:
Staging update by buildbot for sis

Added:
    websites/staging/sis/trunk/content/faq.html
Modified:
    websites/staging/sis/trunk/content/   (props changed)
    websites/staging/sis/trunk/content/branches.html
    websites/staging/sis/trunk/content/code-patterns.html
    websites/staging/sis/trunk/content/downloads.html
    websites/staging/sis/trunk/content/index.html
    websites/staging/sis/trunk/content/license.html
    websites/staging/sis/trunk/content/mail-lists.html
    websites/staging/sis/trunk/content/release-management-setup.html
    websites/staging/sis/trunk/content/release-management.html
    websites/staging/sis/trunk/content/site-management.html
    websites/staging/sis/trunk/content/source.html
    websites/staging/sis/trunk/content/team-list.html

Propchange: websites/staging/sis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Jul 25 13:09:19 2013
@@ -1 +1 @@
-1506941
+1506953

Modified: websites/staging/sis/trunk/content/branches.html
==============================================================================
--- websites/staging/sis/trunk/content/branches.html (original)
+++ websites/staging/sis/trunk/content/branches.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/code-patterns.html
==============================================================================
--- websites/staging/sis/trunk/content/code-patterns.html (original)
+++ websites/staging/sis/trunk/content/code-patterns.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/downloads.html
==============================================================================
--- websites/staging/sis/trunk/content/downloads.html (original)
+++ websites/staging/sis/trunk/content/downloads.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Added: websites/staging/sis/trunk/content/faq.html
==============================================================================
--- websites/staging/sis/trunk/content/faq.html (added)
+++ websites/staging/sis/trunk/content/faq.html Thu Jul 25 13:09:19 2013
@@ -0,0 +1,156 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <title>Frequently asked questions</title>
+    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+    <link rel="stylesheet" type="text/css" media="screen" href="css/bootstrap.min.css">
+    <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+    <link rel="stylesheet" type="text/css" media="screen" href="css/sis.css">
+
+    
+
+    
+    <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor
license agreements.  See the NOTICE file distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file to you under the Apache License,
Version 2.0 (the &quot;License&quot;); 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 &quot;AS IS&quot; 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. -->
+  </head>
+
+  <body>
+    <div class="navbar navbar-inverse navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/index.html"> Apache SIS&trade; </a>
+          <div class="nav-collapse">
+            <ul class="nav">
+              <li class="dropdown"> <a class="dropdown-toggle" data-toggle="dropdown">About<b
class="caret"></b></a>
+                <ul class="dropdown-menu">
+                  <li><a href="mail-lists.html">Mailing Lists</a></li>
+                  <li><a href="license.html">Project License</a></li>
+                  <li><a href="team-list.html">Project Team</a></li>
+                </ul>
+              </li>
+              <li class="dropdown"> <a class="dropdown-toggle" data-toggle="dropdown">Project
Documentation<b class="caret"></b></a>
+                <ul class="dropdown-menu">
+                  <li><a href="downloads.html">Downloads</a></li>
+                  <li><a href="source.html">Source Code</a></li>
+                  <li><a href="code-patterns.html">Code patterns</a></li>
+                  <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
+                  <li><a href="release-management.html">Release Management</a></li>
+                </ul>
+              </li>
+              <li class="dropdown"> <a class="dropdown-toggle" data-toggle="dropdown">ASF
<b class="caret"></b></a>
+                <ul class="dropdown-menu">
+                  <li><a href="http://www.apache.org">The Foundation</a></li>
+                  <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+                  <li><a href="http://www.apache.org/foundation/sponsorship.html">Become
a Sponsor</a></li>
+                  <li><a href="http://www.apache.org/security/">Security</a></li>
+                </ul>
+              </li>
+            </ul>
+          </div> <!-- /.nav-collapse -->
+        </div><!-- /.container -->
+      </div><!-- /.navbar-inner -->
+    </div>
+
+    <div class="container-fluid">
+      <div class="row-fluid">
+        <div class="span2">
+          <div class="well sidebar-nav">
+            <ul class="nav nav-list">
+              <li class="nav-header">Apache SIS</li>
+              <li class="active"><a href="index.html">Home</a></li>
+              <li><a href="mail-lists.html">Mailing Lists</a></li>
+              <li><a href="license.html">Project License</a></li>
+              <li><a href="team-list.html">Project Team</a></li>
+              <li class="nav-header">Project Documentation</li>
+              <li><a href="downloads.html">Downloads</a></li>
+              <li><a href="source.html">Source Code</a></li>
+              <li><a href="code-patterns.html">Code patterns</a></li>
+              <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
+              <li><a href="release-management.html">Release Management</a></li>
+              <li class="nav-header">ASF</li>
+              <li><a href="http://www.apache.org">The Foundation</a></li>
+              <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+              <li><a href="http://www.apache.org/foundation/sponsorship.html">Become
a Sponsor</a></li>
+              <li><a href="http://www.apache.org/security/">Security</a></li>
+            </ul>
+          </div><!--/.well -->
+        </div><!--/span-->
+        <div class="span10">
+          <section id="content" class="row">
+            <article class="span12">
+              <p class="page-title">Frequently asked questions</p>
+              <p>This page lists some Frequently Asked Questions (FAQ) when using Apache
SIS.</p>
+<div class="toc">
+<ul>
+<li><a href="#metadata">Metadata</a><ul>
+<li><a href="#metadata-implementation">Custom implementations</a><ul>
+<li><a href="#metadata-proxy">My metadata are stored in a database-like framework.
Implementing every GeoAPI interfaces for them is impractical.</a></li>
+<li><a href="#i-cant-marshall-my-custom-implementation-jaxbexception-metadata-unknownclass">I
can't marshall my custom implementation (JAXBException).    {#metadata-unknownClass"}</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="#referencing">Referencing</a><ul>
+<li><a href="#axisOrder">Axis order</a></li>
+</ul>
+</li>
+</ul>
+</div>
+<h1 id="metadata">Metadata</h1>
+<p>Frequently asked questions about the <code>sis-metadata</code> module.</p>
+<h2 id="metadata-implementation">Custom implementations</h2>
+<p>Frequently asked questions custom implementations of <code>org.opengis.metadata</code>
interfaces.</p>
+<h3 id="metadata-proxy">My metadata are stored in a database-like framework. Implementing
every GeoAPI interfaces for them is impractical.</h3>
+<p>Developers do not need to implement directly the metadata interfaces.
+If the underlying storage framework can access metadata from their class and attribute names
(either Java names
+or ISO/OGC names), then it is possible to implement a single engine accessing any kind of
metadata and let the
+Java Virtual Machine implements the GeoAPI interfaces on-the-fly, using the <code>java.lang.reflect.Proxy</code>
class.
+See the <code>Proxy</code> Javadoc for details, keeping in mind that the ISO/OGC
name of a <code>java.lang.Class</code> or
+<code>java.lang.reflect.Method</code> object can be obtained as below:</p>
+<div class="codehilite"><pre><span class="n">UML</span> <span
class="n">uml</span> <span class="o">=</span> <span class="n">method</span><span
class="o">.</span><span class="na">getAnnotation</span><span class="o">(</span><span
class="n">UML</span><span class="o">.</span><span class="na">class</span><span
class="o">);</span>
+<span class="k">if</span> <span class="o">(</span><span class="n">uml</span>
<span class="o">!=</span> <span class="kc">null</span><span class="o">)</span>
<span class="o">{</span>
+    <span class="n">String</span> <span class="n">name</span> <span
class="o">=</span> <span class="n">uml</span><span class="o">.</span><span
class="na">identifier</span><span class="o">();</span>
+    <span class="c1">// Fetch the metadata here.</span>
+<span class="o">}</span>
+</pre></div>
+
+
+<p>This is indeed the approach taken by the <code>org.apache.sis.metadata.sql</code>
package for providing an implementation
+of all GeoAPI metadata interfaces reading their values directly from a SQL database.</p>
+<h3 id="i-cant-marshall-my-custom-implementation-jaxbexception-metadata-unknownclass">I
can't marshall my custom implementation (<code>JAXBException</code>).    {#metadata-unknownClass"}</h3>
+<p>The classes given to the JAXB marshaller shall contain JAXB annotations,
+otherwise the following exception is thrown:</p>
+<div class="codehilite"><pre>javax.xml.bind.JAXBException: class MyCustomClass
+nor any of its super class is known to this context.
+</pre></div>
+
+
+<p>The easiest workaround is to wrap the custom implementation into one of the implementations
+provided in the <code>org.apache.metadata.iso</code> package.
+All those SIS implementation classes provide shallow copy constructor for making that easy.
+Note that you need to wrap only the root class, not the attributes.
+The attribute values will be wrapped automatically as needed by JAXB adapters.</p>
+<h1 id="referencing">Referencing</h1>
+<p>Frequently asked questions about the <code>sis-referencing</code> module.</p>
+<h3 id="axisOrder">Axis order</h3>
+<p>(... to be provided later ...)</p>
+            </article>
+          </section>
+        </div><!--/span-->
+      </div><!--/row-fluid-->
+    </div><!--/container-fluid-->
+
+  <footer class="footer">
+    <div class="container">
+      <p>Copyright &copy; 2013 The Apache Software Foundation, Licensed under the
+        <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version
2.0</a>.<br />
+          Apache SIS, Apache, the Apache feather logo are trademarks of The Apache Software
Foundation.</p>
+    </div>
+  </footer>
+
+  <script src="js/jquery-1.9.1.min.js"></script>
+  <script src="js/bootstrap.min.js"></script>
+
+</body>
+</html>

Modified: websites/staging/sis/trunk/content/index.html
==============================================================================
--- websites/staging/sis/trunk/content/index.html (original)
+++ websites/staging/sis/trunk/content/index.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/license.html
==============================================================================
--- websites/staging/sis/trunk/content/license.html (original)
+++ websites/staging/sis/trunk/content/license.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/mail-lists.html
==============================================================================
--- websites/staging/sis/trunk/content/mail-lists.html (original)
+++ websites/staging/sis/trunk/content/mail-lists.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/release-management-setup.html
==============================================================================
--- websites/staging/sis/trunk/content/release-management-setup.html (original)
+++ websites/staging/sis/trunk/content/release-management-setup.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/release-management.html
==============================================================================
--- websites/staging/sis/trunk/content/release-management.html (original)
+++ websites/staging/sis/trunk/content/release-management.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/site-management.html
==============================================================================
--- websites/staging/sis/trunk/content/site-management.html (original)
+++ websites/staging/sis/trunk/content/site-management.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/source.html
==============================================================================
--- websites/staging/sis/trunk/content/source.html (original)
+++ websites/staging/sis/trunk/content/source.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>

Modified: websites/staging/sis/trunk/content/team-list.html
==============================================================================
--- websites/staging/sis/trunk/content/team-list.html (original)
+++ websites/staging/sis/trunk/content/team-list.html Thu Jul 25 13:09:19 2013
@@ -33,6 +33,7 @@
                   <li><a href="source.html">Source Code</a></li>
                   <li><a href="code-patterns.html">Code patterns</a></li>
                   <li><a href="https://issues.apache.org/jira/browse/SIS">Issue
Tracker</a></li>
+                  <li><a href="faq.html">FAQ</a></li>
                   <li><a href="release-management.html">Release Management</a></li>
                 </ul>
               </li>
@@ -65,6 +66,7 @@
               <li><a href="source.html">Source Code</a></li>
               <li><a href="code-patterns.html">Code patterns</a></li>
               <li><a href="https://issues.apache.org/jira/browse/SIS">Issue Tracker</a></li>
+              <li><a href="faq.html">FAQ</a></li>
               <li><a href="release-management.html">Release Management</a></li>
               <li class="nav-header">ASF</li>
               <li><a href="http://www.apache.org">The Foundation</a></li>



Mime
View raw message