You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by bu...@apache.org on 2015/08/11 18:25:55 UTC
svn commit: r961499 - in /websites/staging/sling/trunk/content: ./
documentation/bundles/configuration-installer-factory.html
Author: buildbot
Date: Tue Aug 11 16:25:55 2015
New Revision: 961499
Log:
Staging update by buildbot for sling
Modified:
websites/staging/sling/trunk/content/ (props changed)
websites/staging/sling/trunk/content/documentation/bundles/configuration-installer-factory.html
Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Aug 11 16:25:55 2015
@@ -1 +1 @@
-1695296
+1695337
Modified: websites/staging/sling/trunk/content/documentation/bundles/configuration-installer-factory.html
==============================================================================
--- websites/staging/sling/trunk/content/documentation/bundles/configuration-installer-factory.html (original)
+++ websites/staging/sling/trunk/content/documentation/bundles/configuration-installer-factory.html Tue Aug 11 16:25:55 2015
@@ -39,7 +39,18 @@
</div>
<div class="menu">
- <p><strong><a href="/documentation.html">Documentation</a></strong> <br />
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p><strong><a href="/documentation.html">Documentation</a></strong> <br />
<a href="/documentation/getting-started.html">Getting Started</a> <br />
<a href="/documentation/the-sling-engine.html">The Sling Engine</a> <br />
<a href="/documentation/development.html">Development</a> <br />
@@ -90,8 +101,19 @@
<h1>Configuration Installer Factory</h1>
- <p>The configuration installer factory provides support for configurations to the <a href="/documentation/bundles/osgi-installer.html">OSGI installer</a>. The provisioning of artifacts is handled by installer providers like the file installer or the JCR installer.</p>
-<h2 id="configurations">Configurations</h2>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ visibility: hidden;
+}
+h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover > .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink { visibility: visible }</style>
+<p>The configuration installer factory provides support for configurations to the <a href="/documentation/bundles/osgi-installer.html">OSGI installer</a>. The provisioning of artifacts is handled by installer providers like the file installer or the JCR installer.</p>
+<h2 id="configurations">Configurations<a class="headerlink" href="#configurations" title="Permanent link">¶</a></h2>
<p>Configuration file names are related to the PID and factory PID. The structure of the file name is as follows:</p>
<div class="codehilite"><pre><span class="n">filename</span> <span class="p">::=</span> <span class="o"><</span><span class="n">pid</span><span class="o">></span> <span class="p">(</span> <span class="s">'-'</span> <span class="o"><</span><span class="n">subname</span><span class="o">></span> <span class="p">)</span>? <span class="p">(</span><span class="s">'.cfg'</span><span class="o">|</span><span class="s">'.config'</span><span class="p">)</span>
</pre></div>
@@ -107,7 +129,7 @@
<p>If a configuration is modified, the file installer will write the configuration back to a file to ensure peristence across restarts (if <code>sling.fileinstall.writeback</code> is enabled).</p>
-<h3 id="property-files">Property Files</h3>
+<h3 id="property-files">Property Files<a class="headerlink" href="#property-files" title="Permanent link">¶</a></h3>
<p>Configuration files ending in '.cfg' are plain property files (<code>java.util.Property</code>). The format is simple:</p>
<div class="codehilite"><pre><span class="n">file</span> <span class="p">::=</span> <span class="p">(</span> <span class="n">header</span> <span class="o">|</span> <span class="n">comment</span> <span class="p">)</span> <span class="o">*</span>
<span class="n">header</span> <span class="p">::=</span> <span class="o"><</span><span class="n">header</span><span class="o">></span> <span class="p">(</span> <span class="s">':'</span> <span class="o">|</span> <span class="s">'='</span> <span class="p">)</span> <span class="o"><</span><span class="n">value</span><span class="o">></span> <span class="p">(</span> <span class="s">'\<nl> <value> ) *</span>
@@ -121,7 +143,7 @@
</pre></div>
-<h3 id="configuration-files">Configuration Files</h3>
+<h3 id="configuration-files">Configuration Files<a class="headerlink" href="#configuration-files" title="Permanent link">¶</a></h3>
<p>Configuration files ending in '.config' use the format of the Apache Felix ConfigAdmin implementation. It allows to specify the type and cardinality of a configuration property and is not limited to string values.</p>
<p>The first line of such a file might start with a comment line (a line starting with a #). Comments within the file are not allowed.</p>
<p>The format is:</p>
@@ -135,10 +157,11 @@
<span class="n">values</span> <span class="p">::=</span> <span class="n">simple</span> <span class="p">{</span> <span class="s">','</span> <span class="n">simple</span> <span class="p">}</span>
<span class="n">simple</span> <span class="p">::=</span> <span class="s">'"'</span> <span class="n">stringsimple</span> <span class="s">'"'</span>
<span class="n">type</span> <span class="p">::=</span> <span class="o"><</span>1<span class="o">-</span><span class="n">char</span> <span class="n">type</span> <span class="n">code</span><span class="o">></span>
-<span class="n">stringsimple</span> <span class="p">::=</span> <span class="o"><</span><span class="n">quoted</span> <span class="n">string</span> <span class="n">representation</span> <span class="n">of</span> <span class="n">the</span> <span class="n">value</span><span class="o">></span>
+<span class="n">stringsimple</span> <span class="p">::=</span> <span class="o"><</span><span class="n">quoted</span> <span class="n">string</span> <span class="n">representation</span> <span class="n">of</span> <span class="n">the</span> <span class="n">value</span> <span class="n">where</span> <span class="n">both</span> <span class="s">'"'</span> <span class="n">and</span> <span class="s">'='</span> <span class="n">need</span> <span class="n">to</span> <span class="n">be</span> <span class="n">escaped</span><span class="o">></span>
</pre></div>
+<p>The quoted string format is equal to the definition from HTTP 1.1 (<a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html">RFC2616</a>), except that both '"' and '=' need to be escaped.</p>
<p>The 1 character type code is one of:</p>
<ul>
<li>'T' : simple string</li>
@@ -151,12 +174,12 @@
<li>'C' : Character</li>
<li>'B' : Boolean</li>
</ul>
-<h1 id="project-info">Project Info</h1>
+<h1 id="project-info">Project Info<a class="headerlink" href="#project-info" title="Permanent link">¶</a></h1>
<ul>
<li>Configuration installer factory (<a href="http://svn.apache.org/repos/asf/sling/trunk/installer/factories/configuration">org.apache.sling.installer.factory.configuration</a>)</li>
</ul>
<div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
- Rev. 1648494 by cziegeler on Tue, 30 Dec 2014 09:45:30 +0000
+ Rev. 1695337 by kwin on Tue, 11 Aug 2015 16:25:43 +0000
</div>
<div class="trademarkFooter">
Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project