<html> <head> <title>Service UpdatableLayer</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" type="text/css" href="../../../../../idl.css"> </head> <body> <div id="adc-idlref"> <a name="_top_"> </a><table class="navimain" border="0" cellpadding="3"> <tr> <td class="navimain"><a href="../../module-ix.html" class="navimain">Overview</a></td> <td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td> <td class="navimain"><a href="UpdatableLayer-xref.html" class="navimain">Use</a></td> <td class="navimainnone">Devguide</td> <td class="navimain"><a href="../../../../../index-files/index-1.html" class="navimain">Index</a></td> </tr> </table> <table class="navisub" border="0" cellpadding="0"> <tr> <td class="navisub"><a href="#ServicesSummary" class="navisub">Services' Summary</a></td> <td class="navisub"><a href="#InterfacesSummary" class="navisub">Interfaces' Summary</a></td> <td class="navisub">Properties' Summary</td> <td class="navisub"><a href="#ServicesDetails" class="navisub">Services' Details</a></td> <td class="navisub"><a href="#InterfacesDetails" class="navisub">Interfaces' Details</a></td> <td class="navisub">Properties' Details</td> </tr> </table> <hr> <table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;"> <tr> <td><p class="namechain"><a href="../../../../../module-ix.html" class="namechain">::</a> <a href="../../../../module-ix.html" class="namechain">com</a> :: <a href="../../../module-ix.html" class="namechain">sun</a> :: <a href="../../module-ix.html" class="namechain">star</a> :: <a href="../module-ix.html" class="namechain">configuration</a> :: <a href="module-ix.html" class="namechain">backend</a> :: </p> </td> </tr> <tr> <td class="title">service UpdatableLayer</td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>provides read/write access to a configuration data layer. </dd> <dd><p>A layer contains the configuration setting changes to be performed on a default layer (or schema) to obtain the values of those settings for a given entity and component. </p> <p>An updatable layer can be read or replaced with another layer. </p> </dd> <dt><b/></dt> <dd/></dl> </td> </tr> </table> <hr> <a name="ServicesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Included Services - Summary</td> </tr> <tr> <td class="imsum_left"><a href="Layer.html">Layer</a></td> <td class="imsum_right"><p>handles read access to the contents of the layer. (<a href="#Layer">details</a>)</p> </td> </tr> </table> <a name="InterfacesSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Exported Interfaces - Summary</td> </tr> <tr> <td class="imsum_left"><a href="XUpdatableLayer.html">XUpdatableLayer</a></td> <td class="imsum_right"><p>provides write access to the contents of the layer. (<a href="#XUpdatableLayer">details</a>)</p> </td> </tr> </table> <a name="ServicesDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Included Services - Details</td> </tr> <tr/> <tr> <td class="imdetail"><a name="Layer" class="membertitle"><a href="Layer.html">Layer</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><dl> <dt><b>Description</b></dt> <dd>handles read access to the contents of the layer. </dd> <dd><p> If the implementation supports ::com::sun::star::<a href="../../util/module-ix.html">util</a>::<a href="../../util/XTimeStamped.html">XTimeStamped</a>, then after executing <a href="XUpdatableLayer.html">XUpdatableLayer</a>::<a href="XUpdatableLayer.html#replaceWith">replaceWith()</a> the timestamp will be the one for the replaced contents and if reading after updates is supported the next read will reproduce the replaced data. </p> </dd> </dl> </td> </tr> </table> </td> </tr> </table> <a name="InterfacesDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Exported Interfaces - Details</td> </tr> <tr/> <tr> <td class="imdetail"><a name="XUpdatableLayer" class="membertitle"><a href="XUpdatableLayer.html">XUpdatableLayer</a></a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-data" bgcolor="#ffffff" align="center"> <tr> <td><dl> <dt><b>Description</b></dt> <dd>provides write access to the contents of the layer. </dd> <dd><p> Depending of the actual type (simple, i.e pure <a href="XLayer.html">XLayer</a> or composite, i.e <a href="XCompositeLayer.html">XCompositeLayer</a>) of the current layer and the provided replacement layer, the operation performed by <a href="XUpdatableLayer.html">XUpdatableLayer</a>::<a href="XUpdatableLayer.html#replaceWith">replaceWith()</a>, will vary. </p> <p> For the different current/replacement layer combinations, we have: <dl> <dt>Simple/Simple<dt> <dd>the provided layer's contents replace the current one's.</dd> <dt>Composite/Composite<dt> <dd>all layers (main and sub) present in the provided layer are used to replace the corresponding current layer contents. Sublayers present in the current layer but not in the provided one are left untouched. Sublayers present in the provided layer but not in the current one are added to the current layer. </dd> <dt>Simple/Composite<dt> <dd>the main layer and sublayers of the provided layer are merged into one whose contents replace the current layer. </dd> <dt>Composite/Simple<dt> <dd>the provided layer is split into a composite one whose contents are then used to replace the current layer as described above. </dd> </dl> <em> Not all implementations of <a href="XUpdatableLayer.html">XUpdatableLayer</a> support conversions of the replacement layer. In such a case the sublayers of the provided layer may be ignored or all simple data be merged into the main layer. </em> </p> </dd> </dl> </td> </tr> </table> </td> </tr> </table> <br> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2009 Sun Microsystems, Inc.</p> </div> <!-- id="adc-idlref" --> </body> </html>