mirror of
https://github.com/mistergibson/gxg-framework.git
synced 2026-08-15 03:46:00 -07:00
3334 lines
259 KiB
HTML
3334 lines
259 KiB
HTML
<!DOCTYPE html>
|
|
|
|
<html>
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
|
|
<title>class GxG::Database::PersistedHash - 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-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-db_address">#db_address</a>
|
|
|
|
<li ><a href="#method-i-deactivate">#deactivate</a>
|
|
|
|
<li ><a href="#method-i-delete">#delete</a>
|
|
|
|
<li ><a href="#method-i-destroy">#destroy</a>
|
|
|
|
<li ><a href="#method-i-each_pair">#each_pair</a>
|
|
|
|
<li ><a href="#method-i-element_version">#element_version</a>
|
|
|
|
<li ><a href="#method-i-export">#export</a>
|
|
|
|
<li ><a href="#method-i-format">#format</a>
|
|
|
|
<li ><a href="#method-i-format-3D">#format=</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-import_update">#import_update</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-keys">#keys</a>
|
|
|
|
<li ><a href="#method-i-parent">#parent</a>
|
|
|
|
<li ><a href="#method-i-parent-3D">#parent=</a>
|
|
|
|
<li ><a href="#method-i-paths_to">#paths_to</a>
|
|
|
|
<li ><a href="#method-i-process-21">#process!</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_delegate">#set_delegate</a>
|
|
|
|
<li ><a href="#method-i-set_element_version">#set_element_version</a>
|
|
|
|
<li ><a href="#method-i-set_format">#set_format</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-title-3D">#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-uuid-3D">#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::PersistedHash">
|
|
<h1 id="class-GxG::Database::PersistedHash" class="class">
|
|
class GxG::Database::PersistedHash
|
|
</h1>
|
|
|
|
<section class="description">
|
|
|
|
</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_persistedhash.rb, line 735</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 => <database>, :uuid => <uuid>, :credential => <uuid>, :delegate => nil/<uuid>, :parent => nil/<an-object>}</span>
|
|
<span class="ruby-comment"># create element: {:database => <database>, :credential => <uuid>, :delegate => nil/<uuid>, :parent => nil/<an-object>}</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">"You must supply a valid credential UUID (37 character limit) as a String or Symbol"</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-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-comment"># note - rewrite. if create then as subset, eventually will always mount if all checks out.</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">"Untitled PersistedHash "</span> <span class="ruby-operator"><<</span> (<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">connector</span>()[<span class="ruby-value">:element_hash</span>].<span class="ruby-identifier">count</span>.<span class="ruby-identifier">to_s</span>))
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-ivar">@format</span> = <span class="ruby-identifier">settings</span>[<span class="ruby-value">:format</span>]
|
|
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">the_uuid</span>
|
|
<span class="ruby-comment"># without specifying a uuid, the implied intent is to create a new PersistedHash</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_hash</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_uuid</span>}).<span class="ruby-identifier">count</span> <span class="ruby-operator">></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">=></span> <span class="ruby-identifier">the_uuid</span>}).<span class="ruby-identifier">count</span> <span class="ruby-operator">></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"># creat blank hash 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_hash</span>].<span class="ruby-identifier">insert</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=></span> (<span class="ruby-identifier">the_uuid</span>), <span class="ruby-value">:title</span> <span class="ruby-operator">=></span> (<span class="ruby-identifier">the_title</span>), <span class="ruby-value">:format</span> <span class="ruby-operator">=></span> (<span class="ruby-ivar">@format</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">=></span> (<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>]), <span class="ruby-value">:table</span> <span class="ruby-operator">=></span> <span class="ruby-value">:element_hash</span>, <span class="ruby-value">:dbid</span> <span class="ruby-operator">=></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 => :extend, :credential => @credential, :source => settings[:parent], :destination => self})</span>
|
|
<span class="ruby-comment"># settings[:database].extend_element_permissions(settings[:parent].db_address()[:table], settings[:parent].db_address()[:dbid], :element_hash, 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">=></span> <span class="ruby-keyword">false</span>, <span class="ruby-value">:rename</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:move</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:destroy</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:create</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:write</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">true</span>, <span class="ruby-value">:read</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">true</span>}
|
|
<span class="ruby-comment"># settings[:database].assign_element_permission(:element_hash, new_dbid, @credential, {:execute => false, :rename => true, :move => true, :destroy => true, :create => true, :write => true, :read => true})</span>
|
|
<span class="ruby-comment"># settings[:database].enforce_permission_policy({:action => :extend, :credential => @credential, :source => self, :destination => 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_hash</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_hash</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:uuid</span> <span class="ruby-operator">=></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">=></span> (<span class="ruby-identifier">settings</span>[<span class="ruby-value">:database</span>]), <span class="ruby-value">:table</span> <span class="ruby-operator">=></span> <span class="ruby-value">:element_hash</span>, <span class="ruby-value">:dbid</span> <span class="ruby-operator">=></span> (<span class="ruby-identifier">record</span>[<span class="ruby-value">:dbid</span>])}
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">record</span>[<span class="ruby-value">:format</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">0</span>
|
|
<span class="ruby-ivar">@format</span> = <span class="ruby-identifier">record</span>[<span class="ruby-value">:format</span>].<span class="ruby-identifier">to_sym</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-ivar">@property_links</span> = {}
|
|
<span class="ruby-comment">#</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_property_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">"Unable to mount the PersistedHash record"</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">"Unable to mount the PersistedHash record"</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">"Database not available for storage"</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">"Invalid Database object"</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">"You must supply a hash of details"</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-5B-5D" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">[]</span><span
|
|
class="method-args">(key=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_persistedhash.rb, line 1311</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">[]</span>(<span class="ruby-identifier">key</span>=<span class="ruby-keyword">nil</span>)
|
|
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
|
|
<span class="ruby-comment"># if key exists</span>
|
|
<span class="ruby-comment"># if key 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">key</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>)
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span>
|
|
<span class="ruby-identifier">log_warn</span>({<span class="ruby-value">:warning</span> <span class="ruby-operator">=></span> <span class="ruby-node">"Attempted oversized key usage (limited to 256 characters), truncated #{key.inspect} to #{key.to_s[(0..255)].to_sym.inspect}"</span>})
|
|
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>[(<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">255</span>)].<span class="ruby-identifier">to_sym</span>
|
|
<span class="ruby-keyword">end</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-keyword">if</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</span>)]
|
|
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">></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">=></span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>] <span class="ruby-operator"><<</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>] = <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">=></span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>] <span class="ruby-operator"><<</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">"You must specify with a Symbol, not a #{key.class.inspect}"</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">"Database not available"</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">"Attempted to access a defunct structure"</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">(key=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_persistedhash.rb, line 980</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">[]=</span>(<span class="ruby-identifier">key</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 Symbols.</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">"Attempted to alter a defunct structure"</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">"Database not available"</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">key</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>)
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span>
|
|
<span class="ruby-identifier">log_warn</span>({<span class="ruby-value">:warning</span> <span class="ruby-operator">=></span> <span class="ruby-node">"Attempted oversized key usage (limited to 256 characters), truncated #{key.inspect} to #{key.to_s[(0..255)].to_sym.inspect}"</span>})
|
|
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>[(<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">255</span>)].<span class="ruby-identifier">to_sym</span>
|
|
<span class="ruby-keyword">end</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"># 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">"The structure you are attaching is Deactivated (not supported)."</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, "Cross linked structures not supported"</span>
|
|
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">write_reserved?</span>()
|
|
<span class="ruby-identifier">value</span>.<span class="ruby-identifier">get_reservation</span>()
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">write_reserved?</span>()
|
|
<span class="ruby-identifier">value</span>.<span class="ruby-identifier">structure_detach</span>
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">"Unable to secure write-reservation for this structural change."</span>
|
|
<span class="ruby-keyword">end</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">"The structure you are attaching has a Deactivated item within it (not supported)."</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">"The structure you are attaching has a Deactivated item within it (not supported)."</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">&&</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">"The structure you are attaching has a cross-linked structure within it (cross linked structures not supported)."</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">"The structure you are attaching has an unpersistable item within it (not supported)."</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">@property_links</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"># 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">"Formatted - the structure cannot be altered"</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">=></span> <span class="ruby-keyword">nil</span>,
|
|
<span class="ruby-value">:content</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">nil</span>,
|
|
<span class="ruby-value">:loaded</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">false</span>,
|
|
<span class="ruby-value">:state</span> <span class="ruby-operator">=></span> <span class="ruby-value">0</span>,
|
|
<span class="ruby-value">:record</span> <span class="ruby-operator">=></span> {
|
|
<span class="ruby-value">:parent_uuid</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@uuid</span>.<span class="ruby-identifier">to_s</span>,
|
|
<span class="ruby-value">:property</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>,
|
|
<span class="ruby-value">:ordinal</span> <span class="ruby-operator">=></span> <span class="ruby-value">0</span>,
|
|
<span class="ruby-value">:version</span> <span class="ruby-operator">=></span> <span class="ruby-value">0.0</span>,
|
|
<span class="ruby-value">:element</span> <span class="ruby-operator">=></span> <span class="ruby-string">"element_boolean"</span>,
|
|
<span class="ruby-value">:element_boolean</span> <span class="ruby-operator">=></span> <span class="ruby-value">-1</span>,
|
|
<span class="ruby-value">:element_integer</span> <span class="ruby-operator">=></span> <span class="ruby-value">0</span>,
|
|
<span class="ruby-value">:element_float</span> <span class="ruby-operator">=></span> <span class="ruby-value">0.0</span>,
|
|
<span class="ruby-value">:element_bigdecimal</span> <span class="ruby-operator">=></span> <span class="ruby-operator">::</span><span class="ruby-constant">BigDecimal</span>.<span class="ruby-identifier">new</span>(<span class="ruby-string">"0.0"</span>),
|
|
<span class="ruby-value">:element_datetime</span> <span class="ruby-operator">=></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">=></span> <span class="ruby-value">0.0</span>,
|
|
<span class="ruby-value">:time_prior</span> <span class="ruby-operator">=></span> <span class="ruby-value">0.0</span>,
|
|
<span class="ruby-value">:time_after</span> <span class="ruby-operator">=></span> <span class="ruby-value">0.0</span>,
|
|
<span class="ruby-value">:length</span> <span class="ruby-operator">=></span> <span class="ruby-value">0</span>,
|
|
<span class="ruby-value">:element_text</span> <span class="ruby-operator">=></span> <span class="ruby-string">""</span>,
|
|
<span class="ruby-value">:element_text_uuid</span> <span class="ruby-operator">=></span> <span class="ruby-string">""</span>,
|
|
<span class="ruby-value">:element_binary_uuid</span> <span class="ruby-operator">=></span> <span class="ruby-string">""</span>,
|
|
<span class="ruby-value">:element_array_uuid</span> <span class="ruby-operator">=></span> <span class="ruby-string">""</span>,
|
|
<span class="ruby-value">:element_hash_uuid</span> <span class="ruby-operator">=></span> <span class="ruby-string">""</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'd here, but don't rely upon property version with linked structures, but use structure'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">"element_hash"</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">"element_array"</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'd here, but don't rely upon property version with linked structures, but use structure'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">"element_hash"</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">"element_array"</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">"element_boolean"</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</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">end</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</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">end</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</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">"element_integer"</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">"element_float"</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">"element_bigdecimal"</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">"element_datetime"</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">"element_text"</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span>
|
|
<span class="ruby-comment"># Note: be sure to keep text version & length sync'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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">"element_binary"</span>
|
|
<span class="ruby-comment"># Note: be sure to keep version & length sync'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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">"Unable to map an element type for value: #{value.inspect}"</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'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">@property_links</span>[(<span class="ruby-identifier">property_key</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">&&</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>]))
|
|
<span class="ruby-comment"># Replace value directly, but don't save yet unless you have to (:state refers to the last 'loaded-in-from-db' state of the data).</span>
|
|
<span class="ruby-identifier">new_value</span>[<span class="ruby-value">:linkid</span>] = <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator"><=</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">property_destroy</span>(<span class="ruby-identifier">property_key</span>)
|
|
<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</span>)] = <span class="ruby-identifier">new_value</span>
|
|
<span class="ruby-identifier">property_write</span>(<span class="ruby-identifier">property_key</span>)
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-keyword">if</span> (<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator"><=</span> <span class="ruby-value">256</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">></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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)] = <span class="ruby-identifier">new_value</span>
|
|
<span class="ruby-identifier">property_write</span>(<span class="ruby-identifier">property_key</span>)
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-comment"># N/A</span>
|
|
<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator"><=</span> <span class="ruby-value">256</span>) <span class="ruby-operator">||</span> (<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">size</span> <span class="ruby-operator"><=</span> <span class="ruby-value">256</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">new_value</span>[<span class="ruby-value">:content</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span>)
|
|
<span class="ruby-identifier">property_destroy</span>(<span class="ruby-identifier">property_key</span>)
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">property_destroy</span>(<span class="ruby-identifier">property_key</span>)
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-comment">#</span>
|
|
<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</span>)] = <span class="ruby-identifier">new_value</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">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">@property_links</span>.<span class="ruby-identifier">keys</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">property_write</span>(<span class="ruby-identifier">property_key</span>)
|
|
<span class="ruby-comment"># self.refresh_ordinals ??</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:table</span>]), <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:dbid</span>])
|
|
<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">db_address</span>()[<span class="ruby-value">:table</span>],<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">=></span> <span class="ruby-value">:extend</span>, <span class="ruby-value">:credential</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@credential</span>, <span class="ruby-value">:source</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">self</span>, <span class="ruby-value">:destination</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>]})
|
|
<span class="ruby-comment">#</span>
|
|
<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">"You do not have sufficient privileges to make this change. (write-reservation)"</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">"The value is not persistable."</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">"You must provide a property key in the form of a Symbol."</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_persistedhash.rb, line 861</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">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>
|
|
|
|
|
|
<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_persistedhash.rb, line 869</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_persistedhash.rb, line 873</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">@property_links</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span><span class="ruby-operator">|</span>
|
|
<span class="ruby-identifier">element</span> = <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">key</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">=></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-operator">&&</span> <span class="ruby-identifier">the_value</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:deactivate</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">@property_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" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">delete</span><span
|
|
class="method-args">(key=nil)</span>
|
|
|
|
<span class="method-click-advice">click to toggle source</span>
|
|
|
|
</div>
|
|
|
|
|
|
<div class="method-description">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="method-source-code" id="delete-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 1361</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">delete</span>(<span class="ruby-identifier">key</span>=<span class="ruby-keyword">nil</span>)
|
|
<span class="ruby-identifier">result</span> = <span class="ruby-keyword">nil</span>
|
|
<span class="ruby-comment"># if key exists</span>
|
|
<span class="ruby-comment"># if key 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">key</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>)
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span>
|
|
<span class="ruby-identifier">log_warn</span>({<span class="ruby-value">:warning</span> <span class="ruby-operator">=></span> <span class="ruby-node">"Attempted oversized key usage (limited to 256 characters), truncated #{key.inspect} to #{key.to_s[(0..255)].to_sym.inspect}"</span>})
|
|
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>[(<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">255</span>)].<span class="ruby-identifier">to_sym</span>
|
|
<span class="ruby-keyword">end</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">"Formatted - the structure cannot be altered"</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">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">@property_links</span>[(<span class="ruby-identifier">property_key</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">property_key</span>)]
|
|
<span class="ruby-identifier">the_link</span> = <span class="ruby-ivar">@property_links</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">property_key</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">></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">=></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">=></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">:hash_properties</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=></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">"You do not have sufficient privileges to make this change"</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">ArgumentError</span>, <span class="ruby-node">"You must specify with a Symbol, not a #{key.class.inspect}"</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">"Database not available"</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">"Attempted to access a defunct structure"</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_persistedhash.rb, line 931</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">"You do not have a write-lock for this element"</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">"You do not have permission to destory this element"</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">structure_attached?</span>(<span class="ruby-ivar">@uuid</span>)
|
|
<span class="ruby-identifier">raise</span> <span class="ruby-constant">Exception</span>, <span class="ruby-string">"Element is still linked to a structure. Use <PersistedHash>.delete(<key>).destroy or <PersistedArray>.delete_at(<index>).destroy"</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">"You do not have sufficient privileges to make this change"</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">"Database not available"</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">Exception</span> <span class="ruby-operator">=></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">=></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_pair" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">each_pair</span><span
|
|
class="method-args">(&block)</span>
|
|
|
|
<span class="method-click-advice">click to toggle source</span>
|
|
|
|
</div>
|
|
|
|
|
|
<div class="method-description">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="method-source-code" id="each_pair-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 1577</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">each_pair</span>(<span class="ruby-operator">&</span><span class="ruby-identifier">block</span>)
|
|
<span class="ruby-identifier">collection</span> = {}
|
|
<span class="ruby-ivar">@property_links</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span><span class="ruby-operator">|</span>
|
|
<span class="ruby-identifier">collection</span>[(<span class="ruby-identifier">key</span>)] = (<span class="ruby-keyword">self</span>[(<span class="ruby-identifier">key</span>)])
|
|
<span class="ruby-keyword">end</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">collection</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-value">:each_pair</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">key</span>,<span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
|
|
<span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">key</span>,<span class="ruby-identifier">value</span>)
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">collection</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-value">:each_pair</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">(key=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_persistedhash.rb, line 375</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">element_version</span>(<span class="ruby-identifier">key</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">key</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>)
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span>
|
|
<span class="ruby-identifier">log_warn</span>({<span class="ruby-value">:warning</span> <span class="ruby-operator">=></span> <span class="ruby-node">"Attempted oversized key usage (limited to 256 characters), truncated #{key.inspect} to #{key.to_s[(0..255)].to_sym.inspect}"</span>})
|
|
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>[(<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">255</span>)].<span class="ruby-identifier">to_sym</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-comment">#</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>)]
|
|
<span class="ruby-identifier">result</span> = <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>]
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">result</span> = <span class="ruby-value">0.0</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=>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_persistedhash.rb, line 1492</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">=></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 unformatted? sync issues??</span>
|
|
<span class="ruby-identifier">result</span> = {<span class="ruby-value">:type</span> <span class="ruby-operator">=></span> <span class="ruby-value">:element_hash</span>, <span class="ruby-value">: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-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@title</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@version</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:content</span> <span class="ruby-operator">=></span> {}}
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">result</span> = {<span class="ruby-value">:type</span> <span class="ruby-operator">=></span> <span class="ruby-value">:element_hash</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@uuid</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@title</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@version</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:format</span> <span class="ruby-operator">=></span> <span class="ruby-ivar">@format</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:content</span> <span class="ruby-operator">=></span> {}}
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-identifier">export_db</span> = [{<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">self</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=></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"><<</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">&&</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"><<</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> {}, <span class="ruby-value">:record</span> <span class="ruby-operator">=></span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=></span> <span class="ruby-value">:element_hash</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_uuid</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=></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">=></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">=></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">=></span> {}}}
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">export_db</span> <span class="ruby-operator"><<</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=></span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=></span> <span class="ruby-value">:element_hash</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_uuid</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=></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">=></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">=></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">=></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">&&</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"><<</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> [], <span class="ruby-value">:record</span> <span class="ruby-operator">=></span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=></span> <span class="ruby-value">:element_array</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_uuid</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=></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">=></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">=></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">=></span> []}}
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">export_db</span> <span class="ruby-operator"><<</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=></span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=></span> <span class="ruby-value">:element_array</span>, <span class="ruby-value">:uuid</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_uuid</span>, <span class="ruby-value">:title</span> <span class="ruby-operator">=></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">=></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">=></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">=></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"><<</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=></span> {<span class="ruby-value">:type</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">data_type</span>, <span class="ruby-value">:version</span> <span class="ruby-operator">=></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">=></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">></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"><<</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-comment">#</span>
|
|
<span class="ruby-identifier">result</span>
|
|
<span class="ruby-keyword">end</span></pre>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<div id="method-i-format" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">format</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="format-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 408</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">format</span>()
|
|
<span class="ruby-ivar">@format</span>.<span class="ruby-identifier">clone</span>
|
|
<span class="ruby-keyword">end</span></pre>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<div id="method-i-format-3D" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">format=</span><span
|
|
class="method-args">(the_format=nil)</span>
|
|
|
|
<span class="method-click-advice">click to toggle source</span>
|
|
|
|
</div>
|
|
|
|
|
|
<div class="method-description">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="method-source-code" id="format-3D-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 412</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">format=</span>(<span class="ruby-identifier">the_format</span>=<span class="ruby-keyword">nil</span>)
|
|
<span class="ruby-keyword">if</span> <span class="ruby-constant">GxG</span><span class="ruby-operator">::</span><span class="ruby-identifier">valid_uuid?</span>(<span class="ruby-identifier">the_format</span>)
|
|
<span class="ruby-ivar">@format</span> = <span class="ruby-identifier">the_format</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">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="/")</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_persistedhash.rb, line 1750</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">"/"</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">"/"</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">"/"</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">></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">"%2f"</span>,<span class="ruby-string">"/"</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">":"</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? '//'</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_persistedhash.rb, line 608</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>Review: move to <a href="Database.html"><code>Database</code></a> class as generic toolbox method at some point:</p>
|
|
|
|
|
|
|
|
|
|
<div class="method-source-code" id="get_permissions-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 432</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_persistedhash.rb, line 535</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-comment">#</span>
|
|
<span class="ruby-ivar">@property_links</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_key</span><span class="ruby-operator">|</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">the_key</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"><<</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">the_key</span>)][<span class="ruby-value">:content</span>]
|
|
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">the_key</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</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"># @property_links.keys.each do |the_key|</span>
|
|
<span class="ruby-comment"># if @property_links[(the_key)][:content].is_any?(::GxG::Database::PersistedHash, ::GxG::Database::PersistedArray)</span>
|
|
<span class="ruby-comment"># @property_links[(the_key)][: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</span>
|
|
<span class="ruby-identifier">result</span>
|
|
<span class="ruby-keyword">end</span></pre>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<div id="method-i-import_update" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">import_update</span><span
|
|
class="method-args">(the_record=nil)</span>
|
|
|
|
<span class="method-click-advice">click to toggle source</span>
|
|
|
|
</div>
|
|
|
|
|
|
<div class="method-description">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="method-source-code" id="import_update-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 1470</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">import_update</span>(<span class="ruby-identifier">the_record</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_record</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-ivar">@uuid</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">the_record</span>[<span class="ruby-value">:uuid</span>].<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">to_sym</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@reservation</span>
|
|
<span class="ruby-identifier">had_reservation</span> = <span class="ruby-keyword">true</span>
|
|
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">release_reservation</span>
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">had_reservation</span> = <span class="ruby-keyword">false</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:database</span>].<span class="ruby-identifier">synchronize_records</span>([{<span class="ruby-value">:operation</span> <span class="ruby-operator">=></span> <span class="ruby-value">:merge</span>, <span class="ruby-value">:data</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_record</span>}],<span class="ruby-ivar">@credential</span>)
|
|
<span class="ruby-ivar">@property_links</span> = {}
|
|
<span class="ruby-identifier">load_property_links</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">had_reservation</span>
|
|
<span class="ruby-keyword">self</span>.<span class="ruby-identifier">get_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">self</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_key)</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_persistedhash.rb, line 1357</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">include?</span>(<span class="ruby-identifier">the_key</span>)
|
|
<span class="ruby-ivar">@property_links</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">the_key</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_persistedhash.rb, line 696</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_persistedhash.rb, line 830</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 PersistedHash.</span>
|
|
<span class="ruby-comment"># TODO: make interative instead of re-entrant.</span>
|
|
<span class="ruby-identifier">result</span> = <span class="ruby-string">"(Not Loaded)"</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"><=</span> <span class="ruby-value">10485760</span>
|
|
<span class="ruby-comment"># smaller than 10MB</span>
|
|
<span class="ruby-identifier">inspection_db</span> = []
|
|
<span class="ruby-identifier">last_key</span> = <span class="ruby-ivar">@property_links</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">last</span>
|
|
<span class="ruby-identifier">result</span> = <span class="ruby-string">"{"</span>
|
|
<span class="ruby-ivar">@property_links</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">element_key</span><span class="ruby-operator">|</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">element_key</span>)][<span class="ruby-value">:loaded</span>] <span class="ruby-operator">==</span> <span class="ruby-keyword">true</span>
|
|
<span class="ruby-identifier">result</span> <span class="ruby-operator"><<</span> (<span class="ruby-node">":#{element_key.to_s} => "</span> <span class="ruby-operator"><<</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">element_key</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"><<</span> (<span class="ruby-node">":#{element_key.to_s} => (Not Loaded)"</span>)
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">last_key</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">element_key</span>
|
|
<span class="ruby-identifier">result</span> <span class="ruby-operator"><<</span> <span class="ruby-string">", "</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-identifier">result</span> <span class="ruby-operator"><<</span> <span class="ruby-string">"}"</span>
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">result</span> = <span class="ruby-string">"(Too Damned Big)"</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-comment">#</span>
|
|
<span class="ruby-comment">#</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 => true}, &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_persistedhash.rb, line 1591</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">=></span> <span class="ruby-keyword">true</span>}, <span class="ruby-operator">&</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"><<</span> ({<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></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">></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"><<</span> ({<span class="ruby-value">:parent</span> <span class="ruby-operator">=></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">=></span> <span class="ruby-identifier">the_key</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></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"><<</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"><<</span> ({<span class="ruby-value">:parent</span> <span class="ruby-operator">=></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">=></span> <span class="ruby-identifier">the_index</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></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"><<</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"># Review : is this for a Field??</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"><<</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"><<</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">></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"><<</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"><<</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">=></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">=></span> <span class="ruby-identifier">the_error</span>, <span class="ruby-value">:parameters</span> <span class="ruby-operator">=></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-keys" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">keys</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="keys-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 976</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">keys</span>()
|
|
<span class="ruby-ivar">@property_links</span>.<span class="ruby-identifier">keys</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_persistedhash.rb, line 418</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-parent-3D" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">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="parent-3D-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 422</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parent=</span>(<span class="ruby-identifier">object</span>=<span class="ruby-keyword">nil</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-comment"># Review : parent can only be set once -- is this best??</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></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="")</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_persistedhash.rb, line 1683</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">""</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">"/"</span>
|
|
<span class="ruby-identifier">base_path</span> = (<span class="ruby-string">"/"</span> <span class="ruby-operator"><<</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">></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">"/"</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">=></span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:container</span> <span class="ruby-operator">=></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=>1, :b=>2, :c=>[0, 5], :testing=>{:d=>4.0, :e=>0.9, :f => 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">"/"</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"><<</span> <span class="ruby-string">""</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">":"</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">"/"</span>,<span class="ruby-string">"%2f"</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"><<</span> (<span class="ruby-string">"/"</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">reverse</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">"/"</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">=></span> <span class="ruby-identifier">selector</span>, <span class="ruby-value">:container</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:prefix</span> <span class="ruby-operator">=></span> (<span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">reverse</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">"/"</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"><<</span> (<span class="ruby-string">"/"</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">path_stack</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">"/"</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-process-21" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">process!</span><span
|
|
class="method-args">(options={:include_inactive => true}, &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_persistedhash.rb, line 1670</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">=></span> <span class="ruby-keyword">true</span>}, <span class="ruby-operator">&</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">&</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-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_persistedhash.rb, line 688</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_persistedhash.rb, line 516</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">@property_links</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_key</span><span class="ruby-operator">|</span>
|
|
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">the_key</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">@property_links</span>[(<span class="ruby-identifier">the_key</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_persistedhash.rb, line 496</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_persistedhash.rb, line 904</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">@property_links</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">the_key</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">@property_links</span>[(<span class="ruby-identifier">the_key</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">@property_links</span>[(<span class="ruby-identifier">the_key</span>)][<span class="ruby-value">:state</span>] <span class="ruby-operator">!=</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">the_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">hash</span>
|
|
<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">the_key</span>)][<span class="ruby-value">:record</span>][<span class="ruby-value">:version</span>] = (((<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">the_key</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">property_write</span>(<span class="ruby-identifier">the_key</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">"Database not available"</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">=></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">=></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_persistedhash.rb, line 706</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_hash</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=></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">=></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 => true}, &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_persistedhash.rb, line 1675</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">=></span> <span class="ruby-keyword">true</span>}, <span class="ruby-operator">&</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">&</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="/",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_persistedhash.rb, line 1786</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">"/"</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">"/"</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">></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">"%2f"</span>,<span class="ruby-string">"/"</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">":"</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? '//'</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_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_persistedhash.rb, line 616</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_key, 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_persistedhash.rb, line 393</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_element_version</span>(<span class="ruby-identifier">element_key</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">@property_links</span>[(<span class="ruby-identifier">element_key</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">@property_links</span>[(<span class="ruby-identifier">element_key</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">"Attempted to set version to an invalid version value #{the_version.inspect} for #{element_key.inspect} on Object #{@uuid.inspect}"</span>)
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">log_warning</span>(<span class="ruby-node">"Attempted to set version with an invalid key #{element_key.inspect} on Object #{@uuid.inspect}"</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_format" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">set_format</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_format-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 624</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">set_format</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">@format</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">@format</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_hash</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=></span> (<span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:dbid</span>])}).<span class="ruby-identifier">update</span>({<span class="ruby-value">:format</span> <span class="ruby-operator">=></span> (<span class="ruby-ivar">@format</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_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_persistedhash.rb, line 678</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_persistedhash.rb, line 436</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">&&</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">"public"</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">"Public"</span>
|
|
<span class="ruby-identifier">credential</span> = <span class="ruby-string">"00000000-0000-4000-0000-000000000000"</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">=></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">&&</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">&&</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">=></span> <span class="ruby-ivar">@db_address</span>[<span class="ruby-value">:table</span>], <span class="ruby-value">:dbid</span> <span class="ruby-operator">=></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">></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"><<</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 << 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"><<</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">record</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">record</span>[<span class="ruby-value">:table</span>], <span class="ruby-identifier">record</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">=></span> <span class="ruby-constant">Exception</span>.<span class="ruby-identifier">new</span>(<span class="ruby-string">"You MUST provide a valid permissions Hash."</span>), <span class="ruby-value">:parameters</span> <span class="ruby-operator">=></span> {<span class="ruby-value">:credential</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">credential</span>, <span class="ruby-value">:permission</span> <span class="ruby-operator">=></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_persistedhash.rb, line 721</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">255</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_hash</span>].<span class="ruby-identifier">filter</span>({<span class="ruby-value">:dbid</span> <span class="ruby-operator">=></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">=></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_persistedhash.rb, line 710</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_persistedhash.rb, line 965</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">size</span>()
|
|
<span class="ruby-ivar">@property_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_persistedhash.rb, line 969</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_persistedhash.rb, line 972</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_persistedhash.rb, line 1572</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-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_persistedhash.rb, line 354</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-title-3D" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">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="title-3D-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 358</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">title=</span>(<span class="ruby-identifier">the_title</span>=<span class="ruby-keyword">nil</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">255</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></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_persistedhash.rb, line 639</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">@format</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">=></span> <span class="ruby-ivar">@format</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">""</span>
|
|
<span class="ruby-keyword">end</span>
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-string">""</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">(key=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_persistedhash.rb, line 1277</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">unload</span>(<span class="ruby-identifier">key</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">key</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">Symbol</span>)
|
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">></span> <span class="ruby-value">256</span>
|
|
<span class="ruby-identifier">log_warn</span>({<span class="ruby-value">:warning</span> <span class="ruby-operator">=></span> <span class="ruby-node">"Attempted oversized key usage (limited to 256 characters), truncated #{key.inspect} to #{key.to_s[(0..255)].to_sym.inspect}"</span>})
|
|
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>[(<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">255</span>)].<span class="ruby-identifier">to_sym</span>
|
|
<span class="ruby-keyword">end</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-keyword">if</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</span>)]
|
|
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</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">@property_links</span>[(<span class="ruby-identifier">property_key</span>)][<span class="ruby-value">:content</span>].<span class="ruby-identifier">clear</span>
|
|
<span class="ruby-ivar">@property_links</span>[(<span class="ruby-identifier">property_key</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">"You must specify with a Symbol, not a #{key.class.inspect}"</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">"Database not available"</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">"Attempted to access a defunct structure"</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_persistedhash.rb, line 1428</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">=></span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">nil</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> <span class="ruby-keyword">self</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=></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"><<</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"><<</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=></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"><<</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=></span> []}
|
|
<span class="ruby-keyword">else</span>
|
|
<span class="ruby-identifier">export_db</span> <span class="ruby-operator"><<</span> {<span class="ruby-value">:parent</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_container</span>, <span class="ruby-value">:parent_selector</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_selector</span>.<span class="ruby-identifier">clone</span>, <span class="ruby-value">:object</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">the_value</span>, <span class="ruby-value">:record</span> <span class="ruby-operator">=></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">></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"><<</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">
|
|
|
|
<p>Review : favor the following more Ruby-like accessors over the set_xxx style methods, eliminate older duplicate methods.</p>
|
|
|
|
|
|
|
|
|
|
<div class="method-source-code" id="uuid-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 344</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-uuid-3D" class="method-detail ">
|
|
|
|
<div class="method-heading">
|
|
<span class="method-name">uuid=</span><span
|
|
class="method-args">(the_uuid=nil)</span>
|
|
|
|
<span class="method-click-advice">click to toggle source</span>
|
|
|
|
</div>
|
|
|
|
|
|
<div class="method-description">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="method-source-code" id="uuid-3D-source">
|
|
<pre><span class="ruby-comment"># File lib/gxg/gxg_database_persistedhash.rb, line 348</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">uuid=</span>(<span class="ruby-identifier">the_uuid</span>=<span class="ruby-keyword">nil</span>)
|
|
<span class="ruby-keyword">if</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-ivar">@uuid</span> = <span class="ruby-identifier">the_uuid</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">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">()</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_persistedhash.rb, line 365</span>
|
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">version</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_persistedhash.rb, line 369</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_persistedhash.rb, line 595</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">>=</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_persistedhash.rb, line 504</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_persistedhash.rb, line 508</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>
|
|
|