CascadiaDigitalCollective/gxg-framework
CascadiaDigitalCollective/gxg-framework
2
0
Fork 0
mirror of https://github.com/mistergibson/gxg-framework.git synced 2026-08-15 03:46:00 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions
gxg-framework/doc/GxG/Database/PersistedArray.html
G. Gibson 4bb9f2f2ea Initial Commit
2021-11-16 08:41:53 -08:00

3354 lines
255 KiB
HTML
Raw Blame History

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>class GxG::Database::PersistedArray - RDoc Documentation</title>
<script type="text/javascript">
var rdoc_rel_prefix = "../../";
var index_rel_prefix = "../../";
</script>
<script src="../../js/navigation.js" defer></script>
<script src="../../js/search.js" defer></script>
<script src="../../js/search_index.js" defer></script>
<script src="../../js/searcher.js" defer></script>
<script src="../../js/darkfish.js" defer></script>
<link href="../../css/fonts.css" rel="stylesheet">
<link href="../../css/rdoc.css" rel="stylesheet">
<body id="top" role="document" class="class">
<nav role="navigation">
<div id="project-navigation">
<div id="home-section" role="region" title="Quick navigation" class="nav-section">
<h2>
<a href="../../index.html" rel="home">Home</a>
</h2>
<div id="table-of-contents-navigation">
<a href="../../table_of_contents.html#pages">Pages</a>
<a href="../../table_of_contents.html#classes">Classes</a>
<a href="../../table_of_contents.html#methods">Methods</a>
</div>
</div>
<div id="search-section" role="search" class="project-section initially-hidden">
<form action="#" method="get" accept-charset="utf-8">
<div id="search-field-wrapper">
<input id="search-field" role="combobox" aria-label="Search"
aria-autocomplete="list" aria-controls="search-results"
type="text" name="search" placeholder="Search" spellcheck="false"
title="Type to search, Up and Down to navigate, Enter to load">
</div>
<ul id="search-results" aria-label="Search Results"
aria-busy="false" aria-expanded="false"
aria-atomic="false" class="initially-hidden"></ul>
</form>
</div>
</div>
<div id="class-metadata">
<div id="parent-class-section" class="nav-section">
<h3>Parent</h3>
<p class="link"><a href="../../Object.html">Object</a>
</div>
<!-- Method Quickref -->
<div id="method-list-section" class="nav-section">
<h3>Methods</h3>
<ul class="link-list" role="directory">
<li ><a href="#method-c-new">::new</a>
<li ><a href="#method-i-3C-3C">#&lt;&lt;</a>
<li ><a href="#method-i-5B-5D">#[]</a>
<li ><a href="#method-i-5B-5D-3D">#[]=</a>
<li ><a href="#method-i-alive-3F">#alive?</a>
<li ><a href="#method-i-clear_constraint">#clear_constraint</a>
<li ><a href="#method-i-constraint">#constraint</a>
<li ><a href="#method-i-db_address">#db_address</a>
<li ><a href="#method-i-deactivate">#deactivate</a>
<li ><a href="#method-i-delete_at">#delete_at</a>
<li ><a href="#method-i-destroy">#destroy</a>
<li ><a href="#method-i-each">#each</a>
<li ><a href="#method-i-each_index">#each_index</a>
<li ><a href="#method-i-each_with_index">#each_with_index</a>
<li ><a href="#method-i-element_version">#element_version</a>
<li ><a href="#method-i-export">#export</a>
<li ><a href="#method-i-find_index">#find_index</a>
<li ><a href="#method-i-get_at_path">#get_at_path</a>
<li ><a href="#method-i-get_delegate">#get_delegate</a>
<li ><a href="#method-i-get_permissions">#get_permissions</a>
<li ><a href="#method-i-get_reservation">#get_reservation</a>
<li ><a href="#method-i-include-3F">#include?</a>
<li ><a href="#method-i-increment_version">#increment_version</a>
<li ><a href="#method-i-inspect">#inspect</a>
<li ><a href="#method-i-iterative">#iterative</a>
<li ><a href="#method-i-parent">#parent</a>
<li ><a href="#method-i-paths_to">#paths_to</a>
<li ><a href="#method-i-pop">#pop</a>
<li ><a href="#method-i-process-21">#process!</a>
<li ><a href="#method-i-push">#push</a>
<li ><a href="#method-i-refresh_links">#refresh_links</a>
<li ><a href="#method-i-release_reservation">#release_reservation</a>
<li ><a href="#method-i-reservation">#reservation</a>
<li ><a href="#method-i-save">#save</a>
<li ><a href="#method-i-save_version">#save_version</a>
<li ><a href="#method-i-search">#search</a>
<li ><a href="#method-i-set_at_path">#set_at_path</a>
<li ><a href="#method-i-set_constraint">#set_constraint</a>
<li ><a href="#method-i-set_delegate">#set_delegate</a>
<li ><a href="#method-i-set_element_version">#set_element_version</a>
<li ><a href="#method-i-set_parent">#set_parent</a>
<li ><a href="#method-i-set_permissions">#set_permissions</a>
<li ><a href="#method-i-set_title">#set_title</a>
<li ><a href="#method-i-set_version">#set_version</a>
<li ><a href="#method-i-size">#size</a>
<li ><a href="#method-i-structure_attached-3F">#structure_attached?</a>
<li ><a href="#method-i-structure_detach">#structure_detach</a>
<li ><a href="#method-i-sync_export">#sync_export</a>
<li ><a href="#method-i-title">#title</a>
<li ><a href="#method-i-ufs">#ufs</a>
<li ><a href="#method-i-unload">#unload</a>
<li ><a href="#method-i-unpersist">#unpersist</a>
<li ><a href="#method-i-uuid">#uuid</a>
<li ><a href="#method-i-version">#version</a>
<li ><a href="#method-i-version-3D">#version=</a>
<li ><a href="#method-i-wait_for_reservation">#wait_for_reservation</a>
<li ><a href="#method-i-write_permission-3F">#write_permission?</a>
<li ><a href="#method-i-write_reserved-3F">#write_reserved?</a>
</ul>
</div>
</div>
</nav>
<main role="main" aria-labelledby="class-GxG::Database::PersistedArray">
<h1 id="class-GxG::Database::PersistedArray" class="class">
class GxG::Database::PersistedArray
</h1>
<section class="description">
<p><a href="../../Class.html"><code>Class</code></a> Place-holder Definitions</p>
</section>
<section id="5Buntitled-5D" class="documentation-section">
<section id="public-class-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Public Class Methods</h3>
</header>
<div id="method-c-new" class="method-detail ">
<div class="method-heading">
<span class="method-name">new</span><span
class="method-args">(settings = {})</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="new-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 651</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">initialize</span>(<span class="ruby-identifier">settings</span> = {})
<span class="ruby-comment"># mount element: {:database =&gt; &lt;database&gt;, :uuid =&gt; &lt;uuid&gt;, :credential =&gt; &lt;uuid&gt;, :delegate =&gt; nil/&lt;uuid&gt;, :parent =&gt; nil/&lt;an-object&gt;}</span>
<span class="ruby-comment"># create element: {:database =&gt; &lt;database&gt;, :credential =&gt; &lt;uuid&gt;, :delegate =&gt; nil/&lt;uuid&gt;, :parent =&gt; nil/&lt;an-object&gt;}</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">settings</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">valid_uuid?</span>(<span class="ruby-identifier">settings</span>[<span class="ruby-value">:credential</span>])
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">&quot;You must supply a valid credential UUID (37 character limit) as a String or Symbol&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@quick</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:quick</span>]
<span class="ruby-ivar">@credential</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:credential</span>].<span class="ruby-identifier">to_sym</span>
<span class="ruby-ivar">@reservation</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-ivar">@delegate</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:delegate</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">settings</span>[<span class="ruby-value">:parent</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-ivar">@parent</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:parent</span>]
<span class="ruby-keyword">else</span>
<span class="ruby-ivar">@parent</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@constraint</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:constraint</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>()
<span class="ruby-identifier">the_uuid</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:uuid</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_uuid</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>)
<span class="ruby-identifier">the_uuid</span> = <span class="ruby-identifier">the_uuid</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># TODO: validate uuid pattern</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">settings</span>[<span class="ruby-value">:title</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>)
<span class="ruby-identifier">the_title</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:title</span>]
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">the_title</span> = (<span class="ruby-string">&quot;Untitled PersistedArray &quot;</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">count</span>.<span class="ruby-identifier">to_s</span>))
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">valid_uuid?</span>(<span class="ruby-identifier">the_uuid</span>)
<span class="ruby-comment"># without specifying a uuid, the implied intent is to create a new PersistedArray</span>
<span class="ruby-identifier">the_uuid</span> = <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">uuid_generate</span>()
<span class="ruby-keyword">while</span> ((<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_uuid</span>}).<span class="ruby-identifier">count</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>) <span class="ruby-keyword">or</span> (<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_uuid</span>}).<span class="ruby-identifier">count</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>))
<span class="ruby-identifier">the_uuid</span> = <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">uuid_generate</span>()
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># create blank array record</span>
<span class="ruby-identifier">new_dbid</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">insert</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">the_uuid</span>), <span class="ruby-value">:title</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">the_title</span>), <span class="ruby-value">:constraint</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-ivar">@constraint</span>.<span class="ruby-identifier">to_s</span>)})
<span class="ruby-comment">#</span>
<span class="ruby-ivar">@db_address</span> = {<span class="ruby-value">:database</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>]), <span class="ruby-value">:table</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:element_array</span>, <span class="ruby-value">:dbid</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">new_dbid</span>)}
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@parent</span>
<span class="ruby-ivar">@permission</span> = <span class="ruby-ivar">@parent</span>.<span class="ruby-identifier">get_permissions</span>()
<span class="ruby-comment"># settings[:database].enforce_permission_policy({:action =&gt; :extend, :credential =&gt; @credential, :source =&gt; settings[:parent], :destination =&gt; self})</span>
<span class="ruby-comment"># settings[:database].extend_element_permissions(settings[:parent].db_address()[:table], settings[:parent].db_address()[:dbid], :element_array, new_dbid)</span>
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># create raw permissions for this element</span>
<span class="ruby-ivar">@permission</span> = {<span class="ruby-value">:execute</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">false</span>, <span class="ruby-value">:rename</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:move</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:destroy</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:create</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:write</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:read</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>}
<span class="ruby-comment"># settings[:database].assign_element_permission(:element_array, new_dbid, @credential, {:execute =&gt; false, :rename =&gt; true, :move =&gt; true, :destroy =&gt; true, :create =&gt; true, :write =&gt; true, :read =&gt; true})</span>
<span class="ruby-comment"># settings[:database].enforce_permission_policy({:action =&gt; :extend, :credential =&gt; @credential, :source =&gt; self, :destination =&gt; self})</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">assign_element_permission</span>(<span class="ruby-value">:element_array</span>, <span class="ruby-identifier">new_dbid</span>, <span class="ruby-ivar">@credential</span>, <span class="ruby-ivar">@permission</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># mount according to uuid</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_uuid</span>
<span class="ruby-comment"># mount</span>
<span class="ruby-identifier">record</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">the_uuid</span>)}).<span class="ruby-identifier">first</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">record</span>
<span class="ruby-ivar">@uuid</span> = <span class="ruby-identifier">the_uuid</span>.<span class="ruby-identifier">to_sym</span>
<span class="ruby-ivar">@title</span> = <span class="ruby-identifier">record</span>[<span class="ruby-value">:title</span>].<span class="ruby-identifier">to_s</span>
<span class="ruby-ivar">@version</span> = <span class="ruby-identifier">record</span>[<span class="ruby-value">:version</span>].<span class="ruby-identifier">to_f</span>
<span class="ruby-ivar">@db_address</span> = {<span class="ruby-value">:database</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>]), <span class="ruby-value">:table</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:element_array</span>, <span class="ruby-value">:dbid</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">record</span>[<span class="ruby-value">:dbid</span>])}
<span class="ruby-ivar">@element_links</span> = []
<span class="ruby-keyword">if</span> <span class="ruby-identifier">record</span>[<span class="ruby-value">:constraint</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-ivar">@constraint</span> = <span class="ruby-identifier">record</span>[<span class="ruby-value">:constraint</span>].<span class="ruby-identifier">to_sym</span>
<span class="ruby-keyword">else</span>
<span class="ruby-ivar">@constraint</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@permission</span>
<span class="ruby-ivar">@permission</span> = <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">effective_element_permission</span>(<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>], <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>], <span class="ruby-ivar">@credential</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># @read_reservation = @db_address[:database].reserve_element_locks(@credential, (@db_address[:database].element_manifest(@db_address[:table], @db_address[:dbid])), :read)</span>
<span class="ruby-comment">#</span>
<span class="ruby-identifier">load_element_links</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Unable to mount the PersistedArray record&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Unable to mount the PersistedArray record&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Database not available for storage&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Invalid Database object&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">&quot;You must supply a hash of details&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
<section id="public-instance-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Public Instance Methods</h3>
</header>
<div id="method-i-3C-3C" class="method-detail ">
<div class="method-heading">
<span class="method-name">&lt;&lt;</span><span
class="method-args">(*args)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="3C-3C-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1303</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">&lt;&lt;</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">item</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">self</span>[(<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">size</span>)] = <span class="ruby-identifier">item</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">self</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-5B-5D" class="method-detail ">
<div class="method-heading">
<span class="method-name">[]</span><span
class="method-args">(indexer=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="5B-5D-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1203</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">[]</span>(<span class="ruby-identifier">indexer</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-comment"># if exists</span>
<span class="ruby-comment"># if is not loaded, load element (if String or ByteArray)</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-identifier">indexer</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Integer</span>)
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)]
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">ByteArray</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:loaded</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>
<span class="ruby-comment"># ### Load Base Element contents from the database.</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>)
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:element_text_uuid</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:text_page</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:parent_uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:element_text_uuid</span>].<span class="ruby-identifier">to_s</span>}).<span class="ruby-identifier">order</span>(<span class="ruby-value">:ordinal</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">text_page</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">text_page</span>[<span class="ruby-value">:content</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:element_text</span>].<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:binary_page</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:parent_uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:element_binary_uuid</span>].<span class="ruby-identifier">to_s</span>}).<span class="ruby-identifier">order</span>(<span class="ruby-value">:ordinal</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">binary_page</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">binary_page</span>[<span class="ruby-value">:content</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:loaded</span>] = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span> = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;You must specify with an Integer, not a #{indexer.class.inspect}&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Database not available&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Attempted to access a defunct structure&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-5B-5D-3D" class="method-detail ">
<div class="method-heading">
<span class="method-name">[]=</span><span
class="method-args">(indexer=nil, value=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="5B-5D-3D-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 892</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">[]=</span>(<span class="ruby-identifier">indexer</span>=<span class="ruby-keyword">nil</span>, <span class="ruby-identifier">value</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-comment"># Only works with Integer indexes.</span>
<span class="ruby-keyword">unless</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>()
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Attempted to alter a defunct structure&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>()
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Database not available&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">indexer</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Integer</span>)
<span class="ruby-comment"># Review : rewrite ????</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-identifier">valid_field_classes</span>()) <span class="ruby-operator">||</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Array</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">get_reservation</span>()
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-comment"># Further screen value provided:</span>
<span class="ruby-comment"># ### Check provided PersistedHashes and PersistedArrays</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">db_address</span>()
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;The structure you are attaching is Deactivated (not supported).&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">structure_attached?</span>()
<span class="ruby-comment"># Review : experimental - auto-detach from prior structural relationship and reassign here.</span>
<span class="ruby-comment"># raise Exception, &quot;Cross linked structures not supported&quot;</span>
<span class="ruby-identifier">value</span>.<span class="ruby-identifier">structure_detach</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">value</span>.<span class="ruby-identifier">search</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_value</span>, <span class="ruby-identifier">the_selector</span>, <span class="ruby-identifier">the_container</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">db_address</span>()
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;The structure you are attaching has a Deactivated item within it (not supported).&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># ### Check provided Hashes and Arrays</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Array</span>)
<span class="ruby-identifier">value</span>.<span class="ruby-identifier">search</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_value</span>, <span class="ruby-identifier">the_selector</span>, <span class="ruby-identifier">the_container</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">db_address</span>()
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;The structure you are attaching has a Deactivated item within it (not supported).&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">structure_attached?</span>(<span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">uuid</span>.<span class="ruby-identifier">to_s</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">the_container</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Array</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;The structure you are attaching has a cross-linked structure within it (cross linked structures not supported).&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-identifier">valid_field_classes</span>()) <span class="ruby-operator">||</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Array</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;The structure you are attaching has an unpersistable item within it (not supported).&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># ### Property Exists?</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)]
<span class="ruby-comment"># set property to value</span>
<span class="ruby-identifier">operation</span> = <span class="ruby-value">:set_value</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@format</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Formatted - the structure cannot be altered&quot;</span>
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># add property : value pair</span>
<span class="ruby-identifier">operation</span> = <span class="ruby-value">:add_value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># ### Prepare new value</span>
<span class="ruby-identifier">new_value</span> = {
<span class="ruby-value">:linkid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>,
<span class="ruby-value">:content</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>,
<span class="ruby-value">:loaded</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">false</span>,
<span class="ruby-value">:state</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0</span>,
<span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> {
<span class="ruby-value">:parent_uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@uuid</span>.<span class="ruby-identifier">to_s</span>,
<span class="ruby-value">:ordinal</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0</span>,
<span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0.0</span>,
<span class="ruby-value">:element</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-string">&quot;element_boolean&quot;</span>,
<span class="ruby-value">:element_boolean</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">-1</span>,
<span class="ruby-value">:element_integer</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0</span>,
<span class="ruby-value">:element_float</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0.0</span>,
<span class="ruby-value">:element_bigdecimal</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-operator">::</span><span class="ruby-constant">BigDecimal</span>.<span class="ruby-identifier">new</span>(<span class="ruby-string">&quot;0.0&quot;</span>),
<span class="ruby-value">:element_datetime</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-operator">::</span><span class="ruby-constant">DateTime</span>.<span class="ruby-identifier">now</span>,
<span class="ruby-value">:time_offset</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0.0</span>,
<span class="ruby-value">:time_prior</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0.0</span>,
<span class="ruby-value">:time_after</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0.0</span>,
<span class="ruby-value">:length</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">0</span>,
<span class="ruby-value">:element_text</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-string">&quot;&quot;</span>,
<span class="ruby-value">:element_text_uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-string">&quot;&quot;</span>,
<span class="ruby-value">:element_binary_uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-string">&quot;&quot;</span>,
<span class="ruby-value">:element_array_uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-string">&quot;&quot;</span>,
<span class="ruby-value">:element_hash_uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-string">&quot;&quot;</span>
}
}
<span class="ruby-comment">#</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-comment"># ### Assimilate PersistedHash or PersistedArray</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:loaded</span>] = <span class="ruby-keyword">true</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:state</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">hash</span>
<span class="ruby-comment"># Note: version is sync&#39;d here, but don&#39;t rely upon property version with linked structures, but use structure&#39;s version method.</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">version</span>()
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>)
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element</span>] = <span class="ruby-string">&quot;element_hash&quot;</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_hash_uuid</span>] = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">uuid</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element</span>] = <span class="ruby-string">&quot;element_array&quot;</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_array_uuid</span>] = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">uuid</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># ### Persist Hashes and Arrays</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Array</span>)
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">iterative_persist</span>(<span class="ruby-identifier">value</span>,<span class="ruby-ivar">@credential</span>)
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:loaded</span>] = <span class="ruby-keyword">true</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:state</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">hash</span>
<span class="ruby-comment"># Note: version is sync&#39;d here, but don&#39;t rely upon property version with linked structures, but use structure&#39;s version method.</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">version</span>()
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>)
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element</span>] = <span class="ruby-string">&quot;element_hash&quot;</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_hash_uuid</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">uuid</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element</span>] = <span class="ruby-string">&quot;element_array&quot;</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_array_uuid</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">uuid</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># ### Persist Base Element Values</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element</span>] = <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-identifier">element_table_for_instance</span>(<span class="ruby-identifier">value</span>).<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">case</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element</span>]
<span class="ruby-keyword">when</span> <span class="ruby-string">&quot;element_boolean&quot;</span>
<span class="ruby-keyword">case</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">class</span>
<span class="ruby-keyword">when</span> <span class="ruby-operator">::</span><span class="ruby-constant">NilClass</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_boolean</span>] = <span class="ruby-value">-1</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">when</span> <span class="ruby-operator">::</span><span class="ruby-constant">FalseClass</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_boolean</span>] = <span class="ruby-value">0</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-keyword">false</span>
<span class="ruby-keyword">when</span> <span class="ruby-operator">::</span><span class="ruby-constant">TrueClass</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_boolean</span>] = <span class="ruby-value">1</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">when</span> <span class="ruby-string">&quot;element_integer&quot;</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_integer</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">when</span> <span class="ruby-string">&quot;element_float&quot;</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_float</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">when</span> <span class="ruby-string">&quot;element_bigdecimal&quot;</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_bigdecimal</span>] = <span class="ruby-operator">::</span><span class="ruby-constant">BigDecimal</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_bigdecimal</span>]
<span class="ruby-keyword">when</span> <span class="ruby-string">&quot;element_datetime&quot;</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_datetime</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">when</span> <span class="ruby-string">&quot;element_text&quot;</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">256</span>
<span class="ruby-comment"># Note: be sure to keep text version &amp; length sync&#39;d with linked text element record</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">operation</span> <span class="ruby-operator">==</span> <span class="ruby-value">:set_value</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>]
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_text_uuid</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:element_text_uuid</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:length</span>] = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">size</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_text</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:length</span>] = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">size</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">when</span> <span class="ruby-string">&quot;element_binary&quot;</span>
<span class="ruby-comment"># Note: be sure to keep version &amp; length sync&#39;d with linked binary element record</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">operation</span> <span class="ruby-operator">==</span> <span class="ruby-value">:set_value</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>]
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_binary_uuid</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:element_binary_uuid</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:length</span>] = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">size</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>] = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-node">&quot;Unable to map an element type for value: #{value.inspect}&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># ### Commit Changes</span>
<span class="ruby-keyword">case</span> <span class="ruby-identifier">operation</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">:set_value</span>
<span class="ruby-comment"># Note: Set In-memory value only, don&#39;t save unless you have to.</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">class</span>) <span class="ruby-operator">||</span> ([<span class="ruby-keyword">true</span>, <span class="ruby-keyword">false</span>, <span class="ruby-keyword">nil</span>].<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>]) <span class="ruby-operator">&amp;&amp;</span> [<span class="ruby-keyword">true</span>, <span class="ruby-keyword">false</span>, <span class="ruby-keyword">nil</span>].<span class="ruby-identifier">include?</span>(<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>]))
<span class="ruby-comment"># Replace value directly, but don&#39;t save yet unless you have to (:state refers to the last &#39;loaded-in-from-db&#39; state of the data).</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:linkid</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:linkid</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">version</span>()
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = (((<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>].<span class="ruby-identifier">to_f</span> <span class="ruby-operator">+</span> <span class="ruby-value">0.0001</span>) <span class="ruby-operator">*</span> <span class="ruby-value">10000.0</span>).<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">10000.0</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:ordinal</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:ordinal</span>]
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:loaded</span>] = <span class="ruby-keyword">true</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:state</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:state</span>]
<span class="ruby-comment"># ### Did string grow or shrink crossing the threshold??</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>)
<span class="ruby-keyword">if</span> (<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">256</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">256</span>)
<span class="ruby-comment"># shrank - delete text object and pages as well as property record (slow)</span>
<span class="ruby-identifier">element_destroy</span>(<span class="ruby-identifier">indexer</span>)
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)] = <span class="ruby-identifier">new_value</span>
<span class="ruby-identifier">element_write</span>(<span class="ruby-identifier">indexer</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> (<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">256</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">256</span>)
<span class="ruby-comment"># grew - create text object and pages (a little less slow)</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)] = <span class="ruby-identifier">new_value</span>
<span class="ruby-identifier">element_write</span>(<span class="ruby-identifier">indexer</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># N/A</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)] = <span class="ruby-identifier">new_value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># N/A</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)] = <span class="ruby-identifier">new_value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-comment"># Note: this ensures attachment to this object</span>
<span class="ruby-identifier">property_write</span>(<span class="ruby-identifier">property_key</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># Other class value being substituted.</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">version</span>()
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = (((<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>].<span class="ruby-identifier">to_f</span> <span class="ruby-operator">+</span> <span class="ruby-value">0.0001</span>) <span class="ruby-operator">*</span> <span class="ruby-value">10000.0</span>).<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">10000.0</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:ordinal</span>] = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:ordinal</span>]
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:loaded</span>] = <span class="ruby-keyword">true</span>
<span class="ruby-comment"># Destroy old property record on db, and associated linked objects.</span>
<span class="ruby-comment"># Review : this is slow - look into optimizations here.</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">ByteArray</span>, <span class="ruby-operator">::</span><span class="ruby-constant">String</span>)
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>)
<span class="ruby-keyword">if</span> (<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">256</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">256</span>) <span class="ruby-operator">||</span> (<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">256</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">256</span>)
<span class="ruby-identifier">element_destroy</span>(<span class="ruby-identifier">indexer</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">element_destroy</span>(<span class="ruby-identifier">indexer</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)] = <span class="ruby-identifier">new_value</span>
<span class="ruby-identifier">element_write</span>(<span class="ruby-identifier">indexer</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">:add_value</span>
<span class="ruby-comment"># Note: set in-memory value and save.</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">version</span>()
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = <span class="ruby-value">0.0</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:ordinal</span>] = <span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">size</span>
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:loaded</span>] = <span class="ruby-keyword">true</span>
<span class="ruby-comment">#</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)] = <span class="ruby-identifier">new_value</span>
<span class="ruby-comment"># Review : is this wise to do this here??</span>
<span class="ruby-identifier">element_write</span>(<span class="ruby-identifier">indexer</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># ### Handle coordination between persisted objects:</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-comment"># ### Extend Reservation to persisted objects ( Review : does this slow it down too much?? )</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">release_reservation</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">reservation_add_element</span>((<span class="ruby-ivar">@reservation</span> <span class="ruby-operator">||</span> <span class="ruby-ivar">@delegate</span>), (<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:table</span>]), <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:dbid</span>])
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">set_delegate</span>((<span class="ruby-ivar">@reservation</span> <span class="ruby-operator">||</span> <span class="ruby-ivar">@delegate</span>))
<span class="ruby-comment"># ### Extend Permissions to persisted object</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">extend_element_permissions</span>(<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>],<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>],<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:table</span>],<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:dbid</span>])
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">enforce_permission_policy</span>({<span class="ruby-value">:action</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:extend</span>, <span class="ruby-value">:credential</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@credential</span>, <span class="ruby-value">:source</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">self</span>, <span class="ruby-value">:destination</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>]})
<span class="ruby-comment">#</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">set_parent</span>(<span class="ruby-keyword">self</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">increment_version</span>()
<span class="ruby-identifier">result</span> = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>]
<span class="ruby-comment">#</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;You do not have sufficient privileges to make this change. (write-reservation)&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;The value is not persistable.&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;You must provide a index in the form of an Integer.&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-alive-3F" class="method-detail ">
<div class="method-heading">
<span class="method-name">alive?</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="alive-3F-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 773</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">alive?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_exists?</span>(<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>],<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>])
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">false</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">false</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-clear_constraint" class="method-detail ">
<div class="method-heading">
<span class="method-name">clear_constraint</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="clear_constraint-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 602</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">clear_constraint</span>()
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@constraint</span>
<span class="ruby-ivar">@constraint</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>])}).<span class="ruby-identifier">update</span>({<span class="ruby-value">:constraint</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-string">&quot;&quot;</span>})
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-constraint" class="method-detail ">
<div class="method-heading">
<span class="method-name">constraint</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="constraint-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 612</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">constraint</span>()
<span class="ruby-ivar">@constraint</span>.<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-db_address" class="method-detail ">
<div class="method-heading">
<span class="method-name">db_address</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="db_address-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 785</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">db_address</span>()
<span class="ruby-ivar">@db_address</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-deactivate" class="method-detail ">
<div class="method-heading">
<span class="method-name">deactivate</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="deactivate-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 789</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">deactivate</span>()
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>()
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">element</span> = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">index</span>)][<span class="ruby-value">:content</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">element</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">containers</span> = [(<span class="ruby-identifier">element</span>)]
<span class="ruby-identifier">element</span>.<span class="ruby-identifier">search</span>({<span class="ruby-value">:include_inactive</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">false</span>}) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_value</span>, <span class="ruby-identifier">the_selector</span>, <span class="ruby-identifier">the_container</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">deactivate</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_container</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">containers</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">the_container</span>)
<span class="ruby-identifier">containers</span>.<span class="ruby-identifier">unshift</span>(<span class="ruby-identifier">the_container</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">containers</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_container</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">the_container</span>.<span class="ruby-identifier">deactivate</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">release_reservation</span>()
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@element_links</span> = []
<span class="ruby-ivar">@db_address</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-delete_at" class="method-detail ">
<div class="method-heading">
<span class="method-name">delete_at</span><span
class="method-args">(indexer=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="delete_at-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1244</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">delete_at</span>(<span class="ruby-identifier">indexer</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-comment"># if exists</span>
<span class="ruby-comment"># if is not loaded, load element</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-identifier">indexer</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Integer</span>)
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-identifier">property_key</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)]
<span class="ruby-comment"># This will load the unloaded prior to separation.</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">self</span>[(<span class="ruby-identifier">indexer</span>)]
<span class="ruby-identifier">the_link</span> = <span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">delete_at</span>(<span class="ruby-identifier">indexer</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">save</span>
<span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">release_reservation</span>()
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">reservation_remove_element</span>((<span class="ruby-ivar">@reservation</span> <span class="ruby-operator">||</span> <span class="ruby-ivar">@delegate</span>), <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:table</span>], <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:dbid</span>])
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># Eliminate orphaned text and binary objects in the database. They will exist only in memory.</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">ByteArray</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">256</span>
<span class="ruby-comment"># eliminate text object and pages.</span>
<span class="ruby-identifier">the_temp_record</span> = <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_text</span>].<span class="ruby-identifier">select</span>(<span class="ruby-value">:dbid</span>).<span class="ruby-identifier">where</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_text_uuid</span>]}).<span class="ruby-identifier">first</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_temp_record</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_destroy</span>(<span class="ruby-ivar">@credential</span>, <span class="ruby-value">:element_text</span>, <span class="ruby-identifier">the_temp_record</span>[<span class="ruby-value">:dbid</span>])
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">ByteArray</span>)
<span class="ruby-comment"># eliminate binary object and pages.</span>
<span class="ruby-identifier">the_temp_record</span> = <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_binary</span>].<span class="ruby-identifier">select</span>(<span class="ruby-value">:dbid</span>).<span class="ruby-identifier">where</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:element_binary_uuid</span>]}).<span class="ruby-identifier">first</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_temp_record</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_destroy</span>(<span class="ruby-ivar">@credential</span>, <span class="ruby-value">:element_binary</span>, <span class="ruby-identifier">the_temp_record</span>[<span class="ruby-value">:dbid</span>])
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:array_elements</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_link</span>[<span class="ruby-value">:linkid</span>]}).<span class="ruby-identifier">delete</span>
<span class="ruby-identifier">refresh_ordinals</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">increment_version</span>()
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;You do not have sufficient privileges to make this change&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;You must specify with a Symbol, not a #{key.class.inspect}&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Database not available&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Attempted to access a defunct structure&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-destroy" class="method-detail ">
<div class="method-heading">
<span class="method-name">destroy</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="destroy-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 847</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">destroy</span>()
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">false</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">begin</span>
<span class="ruby-keyword">unless</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;You do not have a write-lock for this element&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@permission</span>[<span class="ruby-value">:destroy</span>]
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;You do not have permission to destory this element&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_in_use?</span>(<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>], <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>])
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Element is still linked to a structure. Use &lt;PersistedHash&gt;.delete(&lt;key&gt;).destroy or &lt;PersistedArray&gt;.delete_at(&lt;index&gt;).destroy&quot;</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-identifier">address</span> = <span class="ruby-ivar">@db_address</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">deactivate</span>
<span class="ruby-identifier">address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_destroy</span>(<span class="ruby-ivar">@credential</span>, <span class="ruby-identifier">address</span>[<span class="ruby-value">:table</span>],<span class="ruby-identifier">address</span>[<span class="ruby-value">:dbid</span>])
<span class="ruby-comment"># Review : consider either emptying the db trash now, or adding a flag to manifest records to prevent future loading.</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;You do not have sufficient privileges to make this change&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Database not available&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">Exception</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_error</span>
<span class="ruby-identifier">log_error</span>({<span class="ruby-value">:error</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_error</span>})
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-each" class="method-detail ">
<div class="method-heading">
<span class="method-name">each</span><span
class="method-args">(&amp;block)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="each-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1432</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">each</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:call</span>)
<span class="ruby-identifier">load_element_links</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-keyword">self</span>[(<span class="ruby-identifier">index</span>)])
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">self</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-value">:each</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-each_index" class="method-detail ">
<div class="method-heading">
<span class="method-name">each_index</span><span
class="method-args">(&amp;block)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="each_index-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1446</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">each_index</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:call</span>)
<span class="ruby-identifier">load_element_links</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">index</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">self</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-value">:each_index</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-each_with_index" class="method-detail ">
<div class="method-heading">
<span class="method-name">each_with_index</span><span
class="method-args">(offset=0,&amp;block)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="each_with_index-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1460</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">each_with_index</span>(<span class="ruby-identifier">offset</span>=<span class="ruby-value">0</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:call</span>)
<span class="ruby-identifier">load_element_links</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-value">:each</span>).<span class="ruby-identifier">with_index</span>(<span class="ruby-identifier">offset</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">entry</span>, <span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-keyword">self</span>[(<span class="ruby-identifier">index</span>)], <span class="ruby-identifier">index</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">self</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-value">:each_with_index</span>,<span class="ruby-identifier">offset</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-element_version" class="method-detail ">
<div class="method-heading">
<span class="method-name">element_version</span><span
class="method-args">(index=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="element_version-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 526</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">element_version</span>(<span class="ruby-identifier">index</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-value">0.0</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">index</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Numeric</span>)
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">index</span>)]
<span class="ruby-identifier">result</span> = <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">index</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-export" class="method-detail ">
<div class="method-heading">
<span class="method-name">export</span><span
class="method-args">(options={:exclude_file_segments=&gt;false})</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="export-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1347</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">export</span>(<span class="ruby-identifier">options</span>={<span class="ruby-value">:exclude_file_segments</span><span class="ruby-operator">=&gt;</span><span class="ruby-keyword">false</span>})
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-identifier">exclude_file_segments</span> = (<span class="ruby-identifier">options</span>[<span class="ruby-value">:exclude_file_segments</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword">false</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:clone</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>
<span class="ruby-comment"># Review : why are cloned objects unconstrained? sync issues??</span>
<span class="ruby-identifier">result</span> = {<span class="ruby-value">:type</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:element_array</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">uuid_generate</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@title</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@version</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:content</span> <span class="ruby-operator">=&gt;</span> []}
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">result</span> = {<span class="ruby-value">:type</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:element_array</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@uuid</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@title</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@version</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:constraint</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@constraint</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:content</span> <span class="ruby-operator">=&gt;</span> []}
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">export_db</span> = [{<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">self</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">result</span>}]
<span class="ruby-identifier">children_of</span> = <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_parent</span>=<span class="ruby-keyword">nil</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">list</span> = []
<span class="ruby-identifier">export_db</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">node</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">node</span>[<span class="ruby-value">:parent</span>].<span class="ruby-identifier">object_id</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">the_parent</span>.<span class="ruby-identifier">object_id</span>
<span class="ruby-identifier">list</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">node</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">list</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># Build up export_db:</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">search</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_value</span>, <span class="ruby-identifier">the_selector</span>, <span class="ruby-identifier">the_container</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:clone</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>
<span class="ruby-identifier">the_uuid</span> = <span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">uuid_generate</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">the_uuid</span> = <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">uuid</span>().<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> (<span class="ruby-identifier">exclude_file_segments</span> <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>) <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">the_selector</span> <span class="ruby-operator">==</span> <span class="ruby-value">:file_segments</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">the_selector</span> <span class="ruby-operator">==</span> <span class="ruby-value">:segments</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">the_selector</span> <span class="ruby-operator">==</span> <span class="ruby-value">:portions</span>)
<span class="ruby-identifier">export_db</span> <span class="ruby-operator">&lt;&lt;</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> {}, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:element_hash</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_uuid</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">title</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">version</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:format</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">format</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:content</span> <span class="ruby-operator">=&gt;</span> {}}}
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">export_db</span> <span class="ruby-operator">&lt;&lt;</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:element_hash</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_uuid</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">title</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">version</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:format</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">format</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:content</span> <span class="ruby-operator">=&gt;</span> {}}}
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:clone</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>
<span class="ruby-identifier">the_uuid</span> = <span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">uuid_generate</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">the_uuid</span> = <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">uuid</span>().<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> (<span class="ruby-identifier">exclude_file_segments</span> <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>) <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">the_selector</span> <span class="ruby-operator">==</span> <span class="ruby-value">:file_segments</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">the_selector</span> <span class="ruby-operator">==</span> <span class="ruby-value">:segments</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">the_selector</span> <span class="ruby-operator">==</span> <span class="ruby-value">:portions</span>)
<span class="ruby-identifier">export_db</span> <span class="ruby-operator">&lt;&lt;</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> [], <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:element_array</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_uuid</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">title</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">version</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:constraint</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">constraint</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:content</span> <span class="ruby-operator">=&gt;</span> []}}
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">export_db</span> <span class="ruby-operator">&lt;&lt;</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-value">:element_array</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_uuid</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">title</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">version</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:constraint</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">constraint</span>().<span class="ruby-identifier">clone</span>, <span class="ruby-value">:content</span> <span class="ruby-operator">=&gt;</span> []}}
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-identifier">valid_field_classes</span>())
<span class="ruby-identifier">data_type</span> = <span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-identifier">element_table_for_instance</span>(<span class="ruby-identifier">the_value</span>)
<span class="ruby-keyword">case</span> <span class="ruby-identifier">data_type</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">:element_bigdecimal</span>
<span class="ruby-identifier">data</span> = <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">:element_datetime</span>
<span class="ruby-identifier">data</span> = <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">:element_binary</span>
<span class="ruby-identifier">data</span> = <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">encode64</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">:element_text</span>
<span class="ruby-identifier">data</span> = <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">data</span> = <span class="ruby-identifier">the_value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">export_db</span> <span class="ruby-operator">&lt;&lt;</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">data_type</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">the_container</span>.<span class="ruby-identifier">version</span>(<span class="ruby-identifier">the_selector</span>) <span class="ruby-operator">||</span> <span class="ruby-value">0.0</span>), <span class="ruby-value">:content</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">data</span>}}
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># Collect children export content:</span>
<span class="ruby-identifier">link_db</span> = [(<span class="ruby-identifier">export_db</span>[<span class="ruby-value">0</span>])]
<span class="ruby-keyword">while</span> <span class="ruby-identifier">link_db</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span> <span class="ruby-keyword">do</span>
<span class="ruby-identifier">entry</span> = <span class="ruby-identifier">link_db</span>.<span class="ruby-identifier">shift</span>
<span class="ruby-identifier">children_of</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">entry</span>[<span class="ruby-value">:object</span>]).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_child</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">entry</span>[<span class="ruby-value">:record</span>][<span class="ruby-value">:content</span>][(<span class="ruby-identifier">the_child</span>[<span class="ruby-value">:parent_selector</span>])] = <span class="ruby-identifier">the_child</span>[<span class="ruby-value">:record</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_child</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">link_db</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">the_child</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-find_index" class="method-detail ">
<div class="method-heading">
<span class="method-name">find_index</span><span
class="method-args">(the_value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="find_index-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1336</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">find_index</span>(<span class="ruby-identifier">the_value</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">element</span>, <span class="ruby-identifier">indexer</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">element</span>[<span class="ruby-value">:content</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">the_value</span>
<span class="ruby-identifier">result</span> = <span class="ruby-identifier">indexer</span>
<span class="ruby-keyword">break</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-get_at_path" class="method-detail ">
<div class="method-heading">
<span class="method-name">get_at_path</span><span
class="method-args">(the_path=&quot;/&quot;)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="get_at_path-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1633</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">get_at_path</span>(<span class="ruby-identifier">the_path</span>=<span class="ruby-string">&quot;/&quot;</span>)
<span class="ruby-comment"># /^(?:[0-9])*[0-9](?:[0-9])*$/ = nil if an alpha present there, else 0 only numeric</span>
<span class="ruby-comment"># Attribution : http://stackoverflow.com/questions/1240674/regex-match-a-string-containing-numbers-and-letters-but-not-a-string-of-just-nu</span>
<span class="ruby-comment">#</span>
<span class="ruby-comment"># if &quot;:&quot; detected do: (str.gsub(&quot;%2f&quot;,&quot;/&quot;).to_sym) as key else (str.gsub(&quot;%2f&quot;,&quot;/&quot;))</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_path</span> <span class="ruby-operator">==</span> <span class="ruby-string">&quot;/&quot;</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">self</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">object_stack</span> = [(<span class="ruby-keyword">self</span>)]
<span class="ruby-identifier">path_stack</span> = <span class="ruby-identifier">the_path</span>.<span class="ruby-identifier">split</span>(<span class="ruby-string">&quot;/&quot;</span>)
<span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">to_enum</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">path_element</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">element</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">path_element</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-keyword">if</span> (<span class="ruby-identifier">path_element</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/^(?:[0-9])*[0-9](?:[0-9])*$/</span>) <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
<span class="ruby-identifier">element</span> = <span class="ruby-identifier">path_element</span>.<span class="ruby-identifier">to_i</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">element</span> = <span class="ruby-identifier">path_element</span>
<span class="ruby-identifier">element</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-string">&quot;%2f&quot;</span>,<span class="ruby-string">&quot;/&quot;</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">element</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&quot;:&quot;</span>
<span class="ruby-identifier">element</span> = <span class="ruby-identifier">element</span>[(<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>)].<span class="ruby-identifier">to_sym</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">element</span>
<span class="ruby-identifier">result</span> = <span class="ruby-identifier">object_stack</span>.<span class="ruby-identifier">first</span>[(<span class="ruby-identifier">element</span>)]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">result</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">NilClass</span>)
<span class="ruby-keyword">break</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">object_stack</span>.<span class="ruby-identifier">unshift</span>(<span class="ruby-identifier">result</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># ignore double slashes? &#39;//&#39;</span>
<span class="ruby-comment"># break</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-get_delegate" class="method-detail ">
<div class="method-heading">
<span class="method-name">get_delegate</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="get_delegate-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 496</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">get_delegate</span>()
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@delegate</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>)
<span class="ruby-ivar">@delegate</span>.<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-get_permissions" class="method-detail ">
<div class="method-heading">
<span class="method-name">get_permissions</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Permission Management:</p>
<div class="method-source-code" id="get_permissions-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 321</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">get_permissions</span>()
<span class="ruby-ivar">@permission</span>.<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-get_reservation" class="method-detail ">
<div class="method-heading">
<span class="method-name">get_reservation</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="get_reservation-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 424</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">get_reservation</span>()
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">false</span>
<span class="ruby-comment"># Review : Experimental design change - deprecate @delegate use, require entire structure (and sub-structures) to get solid @reservation (all of them) or this fails.</span>
<span class="ruby-comment"># Note : keep your structures small as this opens the door for stack-depth exceptions if it is nested too deep. (say 256 or less layers deep??)</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@reservation</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@permission</span>[<span class="ruby-value">:write</span>]
<span class="ruby-identifier">clean_up_list</span> = []
<span class="ruby-comment"># Review : efficiency - write locks only apply to PersistedHashes and PersistedArrays so do we need a full manifest??</span>
<span class="ruby-identifier">the_reservation</span> = <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">reserve_element_locks</span>(<span class="ruby-ivar">@credential</span>, (<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_manifest</span>(<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>], <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>])), <span class="ruby-value">:write</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_reservation</span>
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ordinal</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">ordinal</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>([<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>])
<span class="ruby-identifier">clean_up_list</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">ordinal</span>)][<span class="ruby-value">:content</span>]
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">ordinal</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">get_reservation</span>()
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">release_element_locks</span>(<span class="ruby-identifier">the_reservation</span>)
<span class="ruby-identifier">the_reservation</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">break</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_reservation</span>
<span class="ruby-ivar">@reservation</span> = <span class="ruby-identifier">the_reservation</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">clean_up_list</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_object</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">the_object</span>.<span class="ruby-identifier">release_reservation</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># xxx keep old code for now</span>
<span class="ruby-comment"># if (@reservation || @delegate)</span>
<span class="ruby-comment"># result = true</span>
<span class="ruby-comment"># else</span>
<span class="ruby-comment"># if self.alive?</span>
<span class="ruby-comment"># if @permission[:write]</span>
<span class="ruby-comment"># @reservation = @db_address[:database].reserve_element_locks(@credential, (@db_address[:database].element_manifest(@db_address[:table], @db_address[:dbid])), :write)</span>
<span class="ruby-comment"># if @reservation</span>
<span class="ruby-comment"># @element_links.each_index do |ordinal|</span>
<span class="ruby-comment"># if @element_links[(ordinal)][:content].is_any?([::GxG::Database::PersistedHash, ::GxG::Database::PersistedArray])</span>
<span class="ruby-comment"># @element_links[(ordinal)][:content].set_delegate((@reservation || @delegate))</span>
<span class="ruby-comment"># end</span>
<span class="ruby-comment"># end</span>
<span class="ruby-comment"># result = true</span>
<span class="ruby-comment"># end</span>
<span class="ruby-comment"># #</span>
<span class="ruby-comment"># end</span>
<span class="ruby-comment"># end</span>
<span class="ruby-comment"># end</span>
<span class="ruby-comment"># xxx end old code</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-include-3F" class="method-detail ">
<div class="method-heading">
<span class="method-name">include?</span><span
class="method-args">(the_value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="include-3F-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1325</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">include?</span>(<span class="ruby-identifier">the_value</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">false</span>
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">element</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">element</span>[<span class="ruby-value">:content</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">the_value</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">break</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-increment_version" class="method-detail ">
<div class="method-heading">
<span class="method-name">increment_version</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="increment_version-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 552</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">increment_version</span>()
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-ivar">@version</span> = (((<span class="ruby-ivar">@version</span> <span class="ruby-operator">+</span> <span class="ruby-value">0.0001</span>) <span class="ruby-operator">*</span> <span class="ruby-value">10000.0</span>).<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">10000.0</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-inspect" class="method-detail ">
<div class="method-heading">
<span class="method-name">inspect</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="inspect-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 746</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">inspect</span>()
<span class="ruby-comment"># FORNOW: make re-entrant (yes, I know!) Fortunately, circular links are impossible with PersistedArray.</span>
<span class="ruby-comment"># TODO: make interative instead of re-entrant.</span>
<span class="ruby-identifier">result</span> = <span class="ruby-string">&quot;(Not Loaded)&quot;</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_byte_size</span>(<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>], <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>]) <span class="ruby-operator">&lt;=</span> <span class="ruby-value">10485760</span>
<span class="ruby-comment"># smaller than 10MB</span>
<span class="ruby-identifier">result</span> = <span class="ruby-string">&quot;[&quot;</span>
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">element_index</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">element_index</span>)].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>)
<span class="ruby-identifier">result</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">element_index</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">inspect</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">result</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-string">&quot;(Not Loaded)&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">element_index</span> <span class="ruby-operator">==</span> (<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>)
<span class="ruby-identifier">result</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-string">&quot;, &quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-string">&quot;]&quot;</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">result</span> = <span class="ruby-string">&quot;(Too Damned Big)&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-iterative" class="method-detail ">
<div class="method-heading">
<span class="method-name">iterative</span><span
class="method-args">(options={:include_inactive =&gt; true}, &amp;block)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="iterative-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1474</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">iterative</span>(<span class="ruby-identifier">options</span>={<span class="ruby-value">:include_inactive</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>}, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
<span class="ruby-identifier">result</span> = []
<span class="ruby-identifier">visit</span> = <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_node</span>=<span class="ruby-keyword">nil</span>, <span class="ruby-identifier">accumulator</span>=[]<span class="ruby-operator">|</span>
<span class="ruby-identifier">node_stack</span> = []
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_node</span>
<span class="ruby-identifier">node_stack</span> <span class="ruby-operator">&lt;&lt;</span> ({<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">the_node</span>)})
<span class="ruby-keyword">while</span> (<span class="ruby-identifier">node_stack</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>) <span class="ruby-keyword">do</span>
<span class="ruby-identifier">a_node</span> = <span class="ruby-identifier">node_stack</span>.<span class="ruby-identifier">shift</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">a_node</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">a_node</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">alive?</span>
<span class="ruby-identifier">a_node</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">each_pair</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_key</span>, <span class="ruby-identifier">the_value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">node_stack</span> <span class="ruby-operator">&lt;&lt;</span> ({<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">a_node</span>[<span class="ruby-value">:object</span>], <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_key</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>})
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:include_inactive</span>]
<span class="ruby-identifier">accumulator</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">a_node</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">a_node</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">a_node</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">alive?</span>
<span class="ruby-identifier">a_node</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_value</span>, <span class="ruby-identifier">the_index</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">node_stack</span> <span class="ruby-operator">&lt;&lt;</span> ({<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">a_node</span>[<span class="ruby-value">:object</span>], <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_index</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>})
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:include_inactive</span>]
<span class="ruby-identifier">accumulator</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">a_node</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">a_node</span>.<span class="ruby-identifier">alive?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:include_inactive</span>]
<span class="ruby-identifier">accumulator</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">a_node</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">accumulator</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-identifier">children_of</span> = <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_db</span>=[], <span class="ruby-identifier">the_parent</span>=<span class="ruby-keyword">nil</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">list</span> = []
<span class="ruby-identifier">the_db</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">node</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">node</span>[<span class="ruby-value">:parent</span>].<span class="ruby-identifier">object_id</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">the_parent</span>.<span class="ruby-identifier">object_id</span>
<span class="ruby-identifier">list</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">node</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">list</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">begin</span>
<span class="ruby-identifier">database</span> = <span class="ruby-identifier">visit</span>.<span class="ruby-identifier">call</span>(<span class="ruby-keyword">self</span>,[])
<span class="ruby-identifier">link_db</span> = <span class="ruby-identifier">children_of</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">database</span>, <span class="ruby-keyword">self</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:call</span>)
<span class="ruby-keyword">while</span> (<span class="ruby-identifier">link_db</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>) <span class="ruby-keyword">do</span>
<span class="ruby-identifier">entry</span> = <span class="ruby-identifier">link_db</span>.<span class="ruby-identifier">shift</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">entry</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">object_id</span> <span class="ruby-operator">==</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">object_id</span>
<span class="ruby-comment"># calls with parameters: the_value, the_key/the_index (the_selector), the_container</span>
<span class="ruby-identifier">raw_result</span> = <span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">entry</span>[<span class="ruby-value">:object</span>], <span class="ruby-identifier">entry</span>[<span class="ruby-value">:parent_selector</span>], <span class="ruby-identifier">entry</span>[<span class="ruby-value">:parent</span>])
<span class="ruby-keyword">if</span> <span class="ruby-identifier">raw_result</span>
<span class="ruby-identifier">result</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">raw_result</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">entry</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">object_id</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword">nil</span>.<span class="ruby-identifier">object_id</span>
<span class="ruby-identifier">children</span> = <span class="ruby-identifier">children_of</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">database</span>, <span class="ruby-identifier">entry</span>[<span class="ruby-value">:object</span>])
<span class="ruby-identifier">children</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">child</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">link_db</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">child</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">Exception</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_error</span>
<span class="ruby-identifier">log_error</span>({<span class="ruby-value">:error</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_error</span>, <span class="ruby-value">:parameters</span> <span class="ruby-operator">=&gt;</span> {}})
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-parent" class="method-detail ">
<div class="method-heading">
<span class="method-name">parent</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="parent-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 629</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parent</span>()
<span class="ruby-ivar">@parent</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-paths_to" class="method-detail ">
<div class="method-heading">
<span class="method-name">paths_to</span><span
class="method-args">(the_object=nil,base_path=&quot;&quot;)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="paths_to-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1566</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">paths_to</span>(<span class="ruby-identifier">the_object</span>=<span class="ruby-keyword">nil</span>,<span class="ruby-identifier">base_path</span>=<span class="ruby-string">&quot;&quot;</span>)
<span class="ruby-comment"># new idea here:</span>
<span class="ruby-identifier">search_results</span> = []
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">base_path</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&quot;/&quot;</span>
<span class="ruby-identifier">base_path</span> = (<span class="ruby-string">&quot;/&quot;</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">base_path</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">base_path</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>
<span class="ruby-identifier">path_stack</span> = <span class="ruby-identifier">base_path</span>.<span class="ruby-identifier">split</span>(<span class="ruby-string">&quot;/&quot;</span>)[<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>].<span class="ruby-identifier">reverse</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">path_stack</span> = []
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">origin</span> = <span class="ruby-keyword">self</span>.<span class="ruby-identifier">get_at_path</span>(<span class="ruby-identifier">base_path</span>)
<span class="ruby-identifier">container_stack</span> = [{<span class="ruby-value">:selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:container</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">origin</span>}]
<span class="ruby-identifier">find_container</span> = <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_container</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">container_stack</span>.<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">entry</span>, <span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">entry</span>[<span class="ruby-value">:container</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">the_container</span>
<span class="ruby-identifier">result</span> = <span class="ruby-identifier">entry</span>
<span class="ruby-keyword">break</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">last_container</span> = <span class="ruby-identifier">origin</span>
<span class="ruby-identifier">found</span> = <span class="ruby-keyword">false</span>
<span class="ruby-comment"># tester = {:a=&gt;1, :b=&gt;2, :c=&gt;[0, 5], :testing=&gt;{:d=&gt;4.0, :e=&gt;0.9, :f =&gt; nil}}</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">origin</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Array</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Struct</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">origin</span>.<span class="ruby-identifier">process!</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_value</span>, <span class="ruby-identifier">selector</span>, <span class="ruby-identifier">container</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">last_container</span>.<span class="ruby-identifier">object_id</span> <span class="ruby-operator">!=</span> <span class="ruby-identifier">container</span>.<span class="ruby-identifier">object_id</span>
<span class="ruby-identifier">container_record</span> = <span class="ruby-identifier">find_container</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">container</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">container_record</span>
<span class="ruby-identifier">path_stack</span> = <span class="ruby-identifier">container_record</span>[<span class="ruby-value">:prefix</span>].<span class="ruby-identifier">split</span>(<span class="ruby-string">&quot;/&quot;</span>).<span class="ruby-identifier">reverse</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
<span class="ruby-identifier">path_stack</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-string">&quot;&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">last_container</span> = <span class="ruby-identifier">container</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">selector</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Symbol</span>)
<span class="ruby-identifier">safe_key</span> = (<span class="ruby-string">&quot;:&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">selector</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">safe_key</span> = <span class="ruby-identifier">selector</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">safe_key</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-string">&quot;/&quot;</span>,<span class="ruby-string">&quot;%2f&quot;</span>)
<span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">unshift</span>(<span class="ruby-identifier">safe_key</span>)
<span class="ruby-comment"># compare the_value</span>
<span class="ruby-identifier">found</span> = <span class="ruby-keyword">false</span>
<span class="ruby-keyword">if</span> (<span class="ruby-identifier">the_value</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">the_object</span>)
<span class="ruby-identifier">found</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">found</span>
<span class="ruby-identifier">search_results</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-string">&quot;/&quot;</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">reverse</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">&quot;/&quot;</span>))
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Array</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Struct</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">container_stack</span>.<span class="ruby-identifier">unshift</span>({<span class="ruby-value">:selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">selector</span>, <span class="ruby-value">:container</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:prefix</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">reverse</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">&quot;/&quot;</span>))})
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">shift</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">search_results</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-string">&quot;/&quot;</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">&quot;/&quot;</span>))
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">search_results</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-pop" class="method-detail ">
<div class="method-heading">
<span class="method-name">pop</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="pop-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1321</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">pop</span>()
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">delete_at</span>((<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>))
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-process-21" class="method-detail ">
<div class="method-heading">
<span class="method-name">process!</span><span
class="method-args">(options={:include_inactive =&gt; true}, &amp;block)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="process-21-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1553</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">process!</span>(<span class="ruby-identifier">options</span>={<span class="ruby-value">:include_inactive</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>}, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">iterative</span>(<span class="ruby-identifier">options</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
<span class="ruby-keyword">self</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-push" class="method-detail ">
<div class="method-heading">
<span class="method-name">push</span><span
class="method-args">(*args)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="push-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1312</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">push</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-identifier">args</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">item</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">self</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">item</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">self</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-refresh_links" class="method-detail ">
<div class="method-heading">
<span class="method-name">refresh_links</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="refresh_links-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 643</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">refresh_links</span>()
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>()
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_in_use?</span>(<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>], <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>])
<span class="ruby-ivar">@parent</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-release_reservation" class="method-detail ">
<div class="method-heading">
<span class="method-name">release_reservation</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="release_reservation-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 405</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">release_reservation</span>()
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@reservation</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">release_element_locks</span>(<span class="ruby-ivar">@reservation</span>)
<span class="ruby-ivar">@reservation</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@delegate</span>
<span class="ruby-ivar">@delegate</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># release write-locks of all sub-items</span>
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ordinal</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">ordinal</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>([<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>])
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">ordinal</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">release_reservation</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-reservation" class="method-detail ">
<div class="method-heading">
<span class="method-name">reservation</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="reservation-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 385</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">reservation</span>()
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@reservation</span>.<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>)
<span class="ruby-ivar">@reservation</span>.<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-save" class="method-detail ">
<div class="method-heading">
<span class="method-name">save</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="save-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 820</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">save</span>()
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">false</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">begin</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>()
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">each_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">index</span><span class="ruby-operator">|</span>
<span class="ruby-comment"># Note: only save property data and header if: a) data is still loaded and b) state has changed.</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">index</span>)][<span class="ruby-value">:loaded</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">index</span>)][<span class="ruby-value">:state</span>] <span class="ruby-operator">!=</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">index</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">hash</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">index</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = (((<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">index</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>].<span class="ruby-identifier">to_f</span> <span class="ruby-operator">+</span> <span class="ruby-value">0.0001</span>) <span class="ruby-operator">*</span> <span class="ruby-value">10000.0</span>).<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">10000.0</span>)
<span class="ruby-identifier">element_write</span>(<span class="ruby-identifier">index</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Database not available&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">save_version</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">Exception</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_error</span>
<span class="ruby-identifier">log_error</span>({<span class="ruby-value">:error</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_error</span>})
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-save_version" class="method-detail ">
<div class="method-heading">
<span class="method-name">save_version</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="save_version-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 562</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">save_version</span>()
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>]}).<span class="ruby-identifier">update</span>({<span class="ruby-value">:version</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@version</span>})
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-search" class="method-detail ">
<div class="method-heading">
<span class="method-name">search</span><span
class="method-args">(options={:include_inactive =&gt; true}, &amp;block)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="search-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1558</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">search</span>(<span class="ruby-identifier">options</span>={<span class="ruby-value">:include_inactive</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">true</span>}, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
<span class="ruby-identifier">results</span> = []
<span class="ruby-keyword">if</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:call</span>)
<span class="ruby-identifier">results</span> = <span class="ruby-keyword">self</span>.<span class="ruby-identifier">iterative</span>(<span class="ruby-identifier">options</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">results</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_at_path" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_at_path</span><span
class="method-args">(the_path=&quot;/&quot;,the_value=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_at_path-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1673</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_at_path</span>(<span class="ruby-identifier">the_path</span>=<span class="ruby-string">&quot;/&quot;</span>,<span class="ruby-identifier">the_value</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_path</span> <span class="ruby-operator">!=</span> <span class="ruby-string">&quot;/&quot;</span>
<span class="ruby-identifier">container</span> = <span class="ruby-keyword">self</span>.<span class="ruby-identifier">get_at_path</span>(<span class="ruby-operator">::</span><span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-identifier">dirname</span>(<span class="ruby-identifier">the_path</span>))
<span class="ruby-keyword">if</span> <span class="ruby-identifier">container</span>
<span class="ruby-identifier">raw_selector</span> = <span class="ruby-operator">::</span><span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-identifier">basename</span>(<span class="ruby-identifier">the_path</span>)
<span class="ruby-identifier">selector</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">raw_selector</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
<span class="ruby-keyword">if</span> (<span class="ruby-identifier">raw_selector</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/^(?:[0-9])*[0-9](?:[0-9])*$/</span>) <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
<span class="ruby-identifier">selector</span> = <span class="ruby-identifier">raw_selector</span>.<span class="ruby-identifier">to_i</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">selector</span> = <span class="ruby-identifier">raw_selector</span>
<span class="ruby-identifier">selector</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-string">&quot;%2f&quot;</span>,<span class="ruby-string">&quot;/&quot;</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">selector</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&quot;:&quot;</span>
<span class="ruby-identifier">selector</span> = <span class="ruby-identifier">selector</span>[(<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>)].<span class="ruby-identifier">to_sym</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">selector</span>
<span class="ruby-identifier">container</span>[(<span class="ruby-identifier">selector</span>)] = <span class="ruby-identifier">the_value</span>
<span class="ruby-identifier">result</span> = <span class="ruby-identifier">container</span>[(<span class="ruby-identifier">selector</span>)]
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># ignore double slashes? &#39;//&#39;</span>
<span class="ruby-comment"># break</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_constraint" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_constraint</span><span
class="method-args">(format_uuid=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_constraint-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 591</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_constraint</span>(<span class="ruby-identifier">format_uuid</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@constraint</span>
<span class="ruby-keyword">if</span> <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">valid_uuid?</span>(<span class="ruby-identifier">format_uuid</span>)
<span class="ruby-ivar">@constraint</span> = <span class="ruby-identifier">format_uuid</span>.<span class="ruby-identifier">to_sym</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>])}).<span class="ruby-identifier">update</span>({<span class="ruby-value">:constraint</span> <span class="ruby-operator">=&gt;</span> (<span class="ruby-ivar">@constraint</span>.<span class="ruby-identifier">to_s</span>)})
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_delegate" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_delegate</span><span
class="method-args">(the_delegate=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_delegate-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 504</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_delegate</span>(<span class="ruby-identifier">the_delegate</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_delegate</span>.<span class="ruby-identifier">is_any?</span>([<span class="ruby-operator">::</span><span class="ruby-constant">String</span>, <span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>])
<span class="ruby-ivar">@delegate</span> = <span class="ruby-identifier">the_delegate</span>.<span class="ruby-identifier">to_sym</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_element_version" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_element_version</span><span
class="method-args">(element_index, the_version=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_element_version-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 537</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_element_version</span>(<span class="ruby-identifier">element_index</span>, <span class="ruby-identifier">the_version</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">false</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">element_index</span>)]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_version</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Numeric</span>)
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">element_index</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = (((<span class="ruby-identifier">the_version</span>.<span class="ruby-identifier">to_f</span>) <span class="ruby-operator">*</span> <span class="ruby-value">10000.0</span>).<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">10000.0</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">log_warning</span>(<span class="ruby-node">&quot;Attempted to set version to an invalid version value #{the_version.inspect} for index #{element_index.inspect} on Object #{@uuid.inspect}&quot;</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">log_warning</span>(<span class="ruby-node">&quot;Attempted to set version with an invalid index #{element_index.inspect} on Object #{@uuid.inspect}&quot;</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_parent" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_parent</span><span
class="method-args">(object=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_parent-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 633</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_parent</span>(<span class="ruby-identifier">object</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">object</span>.<span class="ruby-identifier">is_any?</span>([<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>])
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@parent</span>
<span class="ruby-ivar">@parent</span> = <span class="ruby-identifier">object</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_permissions" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_permissions</span><span
class="method-args">(credential=nil, the_permission=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_permissions-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 325</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_permissions</span>(<span class="ruby-identifier">credential</span>=<span class="ruby-keyword">nil</span>, <span class="ruby-identifier">the_permission</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">credential</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">the_permission</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">credential</span>[<span class="ruby-value">:user</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">credential</span>[<span class="ruby-value">:user</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&quot;public&quot;</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">credential</span>[<span class="ruby-value">:user</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&quot;Public&quot;</span>
<span class="ruby-identifier">credential</span> = <span class="ruby-string">&quot;00000000-0000-4000-0000-000000000000&quot;</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">credential</span> = (<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">user_fetch</span>({<span class="ruby-value">:user_id</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">credential</span>[<span class="ruby-value">:user</span>].<span class="ruby-identifier">to_s</span>}) <span class="ruby-operator">||</span> {})[<span class="ruby-value">:uuid</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">credential</span>
<span class="ruby-identifier">credential</span> = <span class="ruby-identifier">credential</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">credential</span>[<span class="ruby-value">:group</span>]
<span class="ruby-identifier">credential</span> = <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">group_credential</span>(<span class="ruby-identifier">credential</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">credential</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">credential</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">the_permission</span> <span class="ruby-operator">==</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">the_permission</span> = <span class="ruby-identifier">credential</span>
<span class="ruby-identifier">credential</span> = <span class="ruby-ivar">@credential</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">credential</span>
<span class="ruby-identifier">credential</span> = <span class="ruby-ivar">@credential</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_permission</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Hash</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">valid_uuid?</span>(<span class="ruby-identifier">credential</span>)
<span class="ruby-identifier">manifest</span> = []
<span class="ruby-identifier">structures</span> = [{<span class="ruby-value">:table</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>], <span class="ruby-value">:dbid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>]}]
<span class="ruby-keyword">while</span> <span class="ruby-identifier">structures</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span> <span class="ruby-keyword">do</span>
<span class="ruby-identifier">entry</span> = <span class="ruby-identifier">structures</span>[<span class="ruby-value">0</span>]
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">element_manifest</span>(<span class="ruby-identifier">entry</span>[<span class="ruby-value">:table</span>],<span class="ruby-identifier">entry</span>[<span class="ruby-value">:dbid</span>]).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">record</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> [<span class="ruby-value">:element_hash</span>, <span class="ruby-value">:element_array</span>].<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">record</span>[<span class="ruby-value">:table</span>])
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">structures</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">record</span>)
<span class="ruby-identifier">structures</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">record</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-comment"># Review - only set/get/check permissions on persisted arrays/hashes</span>
<span class="ruby-comment"># unless manifest.include?(record)</span>
<span class="ruby-comment"># manifest &lt;&lt; record</span>
<span class="ruby-comment"># end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">manifest</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">structures</span>.<span class="ruby-identifier">shift</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">manifest</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">entry</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">assign_element_permission</span>(<span class="ruby-identifier">entry</span>[<span class="ruby-value">:table</span>], <span class="ruby-identifier">entry</span>[<span class="ruby-value">:dbid</span>], <span class="ruby-identifier">credential</span>, <span class="ruby-identifier">the_permission</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">log_error</span>({<span class="ruby-value">:error</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-constant">Exception</span>.<span class="ruby-identifier">new</span>(<span class="ruby-string">&quot;You MUST provide a valid permissions Hash.&quot;</span>), <span class="ruby-value">:parameters</span> <span class="ruby-operator">=&gt;</span> {<span class="ruby-value">:credential</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">credential</span>, <span class="ruby-value">:permission</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_permission</span>}})
<span class="ruby-keyword">false</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_title" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_title</span><span
class="method-args">(the_title=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_title-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 577</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_title</span>(<span class="ruby-identifier">the_title</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_title</span>
<span class="ruby-ivar">@title</span> = <span class="ruby-identifier">the_title</span>.<span class="ruby-identifier">to_s</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">256</span>]
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_array</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>]}).<span class="ruby-identifier">update</span>({<span class="ruby-value">:title</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@title</span>})
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">increment_version</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-set_version" class="method-detail ">
<div class="method-heading">
<span class="method-name">set_version</span><span
class="method-args">(the_version=0.0)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="set_version-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 566</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_version</span>(<span class="ruby-identifier">the_version</span>=<span class="ruby-value">0.0</span>)
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">write_reserved?</span>()
<span class="ruby-ivar">@version</span> = (((<span class="ruby-identifier">the_version</span>.<span class="ruby-identifier">to_f</span>) <span class="ruby-operator">*</span> <span class="ruby-value">10000.0</span>).<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">10000.0</span>)
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">save_version</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-size" class="method-detail ">
<div class="method-heading">
<span class="method-name">size</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="size-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 881</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">size</span>()
<span class="ruby-ivar">@element_links</span>.<span class="ruby-identifier">size</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-structure_attached-3F" class="method-detail ">
<div class="method-heading">
<span class="method-name">structure_attached?</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="structure_attached-3F-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 885</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">structure_attached?</span>()
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">structure_attached?</span>(<span class="ruby-ivar">@uuid</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-structure_detach" class="method-detail ">
<div class="method-heading">
<span class="method-name">structure_detach</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="structure_detach-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 888</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">structure_detach</span>()
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">structure_detach</span>(<span class="ruby-ivar">@uuid</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-sync_export" class="method-detail ">
<div class="method-heading">
<span class="method-name">sync_export</span><span
class="method-args">(options={})</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="sync_export-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1426</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">sync_export</span>(<span class="ruby-identifier">options</span>={})
<span class="ruby-comment"># Review : does this work with PersistedArray ??</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">save</span>
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">sync_export</span>(<span class="ruby-ivar">@credential</span>, [(<span class="ruby-ivar">@uuid</span>)], <span class="ruby-identifier">options</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-title" class="method-detail ">
<div class="method-heading">
<span class="method-name">title</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="title-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 573</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">title</span>()
<span class="ruby-ivar">@title</span>.<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-ufs" class="method-detail ">
<div class="method-heading">
<span class="method-name">ufs</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="ufs-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 616</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">ufs</span>()
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@constraint</span>
<span class="ruby-identifier">record</span> = <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">format_load</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-ivar">@constraint</span>.<span class="ruby-identifier">to_s</span>})
<span class="ruby-keyword">if</span> <span class="ruby-identifier">record</span>
<span class="ruby-identifier">record</span>[<span class="ruby-value">:ufs</span>]
<span class="ruby-keyword">else</span>
<span class="ruby-string">&quot;&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-string">&quot;&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-unload" class="method-detail ">
<div class="method-heading">
<span class="method-name">unload</span><span
class="method-args">(indexer=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="unload-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1174</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">unload</span>(<span class="ruby-identifier">indexer</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">false</span>
<span class="ruby-comment"># if key exists</span>
<span class="ruby-comment"># if key is loaded, unload element (if String or ByteArray)</span>
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">open?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-identifier">indexer</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Integer</span>)
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)]
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">String</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">ByteArray</span>)
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:loaded</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>
<span class="ruby-comment"># ### Unload Base Element contents from memory, leaving reference harness intact and active.</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">clear</span>
<span class="ruby-ivar">@element_links</span>[(<span class="ruby-identifier">indexer</span>)][<span class="ruby-value">:loaded</span>] = <span class="ruby-keyword">false</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;You must specify with an Integer, not a #{indexer.class.inspect}&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Database not available&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">&quot;Attempted to access a defunct structure&quot;</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-unpersist" class="method-detail ">
<div class="method-heading">
<span class="method-name">unpersist</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="unpersist-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 1704</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">unpersist</span>()
<span class="ruby-identifier">result</span> = []
<span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">alive?</span>
<span class="ruby-comment">#</span>
<span class="ruby-identifier">export_db</span> = [{<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-keyword">self</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">result</span>}]
<span class="ruby-identifier">children_of</span> = <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_parent</span>=<span class="ruby-keyword">nil</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">list</span> = []
<span class="ruby-identifier">export_db</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">node</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">node</span>[<span class="ruby-value">:parent</span>].<span class="ruby-identifier">object_id</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">the_parent</span>.<span class="ruby-identifier">object_id</span>
<span class="ruby-identifier">list</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">node</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">list</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># Build up export_db:</span>
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">search</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_value</span>, <span class="ruby-identifier">the_selector</span>, <span class="ruby-identifier">the_container</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>)
<span class="ruby-identifier">export_db</span> <span class="ruby-operator">&lt;&lt;</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> {}}
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">export_db</span> <span class="ruby-operator">&lt;&lt;</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> []}
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">export_db</span> <span class="ruby-operator">&lt;&lt;</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=&gt;</span> <span class="ruby-identifier">the_value</span>}
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment"># Collect children export content:</span>
<span class="ruby-identifier">link_db</span> =[(<span class="ruby-identifier">export_db</span>[<span class="ruby-value">0</span>])]
<span class="ruby-keyword">while</span> <span class="ruby-identifier">link_db</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span> <span class="ruby-keyword">do</span>
<span class="ruby-identifier">entry</span> = <span class="ruby-identifier">link_db</span>.<span class="ruby-identifier">shift</span>
<span class="ruby-identifier">children_of</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">entry</span>[<span class="ruby-value">:object</span>]).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_child</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">entry</span>[<span class="ruby-value">:record</span>][(<span class="ruby-identifier">the_child</span>[<span class="ruby-value">:parent_selector</span>])] = <span class="ruby-identifier">the_child</span>[<span class="ruby-value">:record</span>]
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_child</span>[<span class="ruby-value">:object</span>].<span class="ruby-identifier">is_any?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedHash</span>, <span class="ruby-operator">::</span><span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-constant">Database</span><span class="ruby-operator">::</span><span class="ruby-constant">PersistedArray</span>)
<span class="ruby-identifier">link_db</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">the_child</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-comment">#</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-uuid" class="method-detail ">
<div class="method-heading">
<span class="method-name">uuid</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="uuid-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 512</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">uuid</span>()
<span class="ruby-ivar">@uuid</span>.<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-version" class="method-detail ">
<div class="method-heading">
<span class="method-name">version</span><span
class="method-args">(input=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="version-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 516</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">version</span>(<span class="ruby-identifier">input</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-ivar">@version</span>.<span class="ruby-identifier">clone</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-version-3D" class="method-detail ">
<div class="method-heading">
<span class="method-name">version=</span><span
class="method-args">(the_version=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="version-3D-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 520</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">version=</span>(<span class="ruby-identifier">the_version</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-keyword">if</span> <span class="ruby-identifier">the_version</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Numeric</span>)
<span class="ruby-ivar">@version</span> = (((<span class="ruby-identifier">the_version</span>.<span class="ruby-identifier">to_f</span>) <span class="ruby-operator">*</span> <span class="ruby-value">10000.0</span>).<span class="ruby-identifier">to_i</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">10000.0</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-wait_for_reservation" class="method-detail ">
<div class="method-heading">
<span class="method-name">wait_for_reservation</span><span
class="method-args">(timeout=nil)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="wait_for_reservation-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 483</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">wait_for_reservation</span>(<span class="ruby-identifier">timeout</span>=<span class="ruby-keyword">nil</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">true</span>
<span class="ruby-identifier">the_timeout</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">+</span> (<span class="ruby-identifier">timeout</span> <span class="ruby-operator">||</span> <span class="ruby-value">30.0</span>).<span class="ruby-identifier">to_f</span>
<span class="ruby-keyword">until</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">get_reservation</span>() <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span> <span class="ruby-keyword">do</span>
<span class="ruby-identifier">sleep</span> <span class="ruby-value">1.0</span>
<span class="ruby-keyword">if</span> <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">the_timeout</span>
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">false</span>
<span class="ruby-keyword">break</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-write_permission-3F" class="method-detail ">
<div class="method-heading">
<span class="method-name">write_permission?</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="write_permission-3F-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 393</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_permission?</span>()
<span class="ruby-ivar">@permission</span>[<span class="ruby-value">:write</span>]
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-write_reserved-3F" class="method-detail ">
<div class="method-heading">
<span class="method-name">write_reserved?</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<div class="method-source-code" id="write_reserved-3F-source">
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedarray.rb, line 397</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_reserved?</span>()
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@reservation</span> <span class="ruby-keyword">or</span> <span class="ruby-ivar">@delegate</span>
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">false</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
</section>
</main>
<footer id="validator-badges" role="contentinfo">
<p><a href="https://validator.w3.org/check/referer">Validate</a>
<p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.1.2.
<p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
</footer>
Reference in a new issue View git blame Copy permalink