Xoad 0.5.0.0 > Docs / Source / XOAD / XOAD Cache / XOAD Cache.html

Questions? Need Help? Want to share? » PHP Forum
Script Name:
Xoad 0.5.0.0

Download:
xoad-0.5.0.0.zip

Category:
Development Tools

Archive Content:

Xoad 0.5.0.0

Xoad 0.5.0.0 > Classes

Xoad 0.5.0.0 > Classes > Events > Storage

Xoad 0.5.0.0 > Classes > Events

Xoad 0.5.0.0 > Classes

Xoad 0.5.0.0 > Config

Xoad 0.5.0.0

Xoad 0.5.0.0 > Docs > Source

Xoad 0.5.0.0 > Docs > Source > Media

Xoad 0.5.0.0 > Docs > Source > Media > Images

Xoad 0.5.0.0 > Docs > Source > Media > Lib

Xoad 0.5.0.0 > Docs > Source > Media

Xoad 0.5.0.0 > Docs > Source

Xoad 0.5.0.0 > Docs > Source > XOAD > XOAD Cache

Xoad 0.5.0.0 > Docs > Source > XOAD

Xoad 0.5.0.0 > Docs > Source > XOAD > XOAD Events

Xoad 0.5.0.0 > Docs > Source > XOAD > XOAD HTML

Xoad 0.5.0.0 > Docs > Source > XOAD

Xoad 0.5.0.0 > Docs > Source > Filesource

Xoad 0.5.0.0 > Docs > Tutorials

Xoad 0.5.0.0 > Docs > Tutorials > Images

Xoad 0.5.0.0 > Docs > Tutorials > Style

Xoad 0.5.0.0 > Examples > Basic

Xoad 0.5.0.0 > Examples > Chat

Xoad 0.5.0.0 > Examples > Chat > Images

Xoad 0.5.0.0 > Examples > Chat

Xoad 0.5.0.0 > Examples > Chat > Var

Xoad 0.5.0.0 > Examples > ChatAdvanced

Xoad 0.5.0.0 > Examples > ChatAdvanced > Images > Default

Xoad 0.5.0.0 > Examples > ChatAdvanced

Xoad 0.5.0.0 > Examples > ChatAdvanced > Smilies

Xoad 0.5.0.0 > Examples > ChatAdvanced > Style

Xoad 0.5.0.0 > Examples > Events

Xoad 0.5.0.0 > Examples > Exam

Xoad 0.5.0.0 > Examples > Explorer

Xoad 0.5.0.0 > Examples > Explorer > Images

Xoad 0.5.0.0 > Examples > Explorer

Xoad 0.5.0.0 > Examples > Explorer > Style

Xoad 0.5.0.0 > Examples > Forms

Xoad 0.5.0.0 > Examples > Html > Content

Xoad 0.5.0.0 > Examples > Html

Xoad 0.5.0.0 > Extensions > Cache

Xoad 0.5.0.0 > Extensions > Cache > Classes

Xoad 0.5.0.0 > Extensions > Cache > Classes > Storage

Xoad 0.5.0.0 > Extensions > Cache > Classes

Xoad 0.5.0.0 > Extensions > Html > Classes > DOM

Xoad 0.5.0.0 > Extensions > Html > Classes

Xoad 0.5.0.0 > Extensions > Html

Xoad 0.5.0.0 > Extensions > Html > Js

Xoad 0.5.0.0

Xoad 0.5.0.0 > Js

Xoad 0.5.0.0

Xoad 0.5.0.0 > Tests

Xoad 0.5.0.0

XOAD Cache.html:


<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  <html xmlns="http://www.w3.org/1999/xhtml">
        <head>
            <!-- template designed by Marco Von Ballmoos  -->
            <title>Docs For Class XOAD_Cache</title>
            <link rel="stylesheet" href="../../media/stylesheet.css" />
                        <script src="../../media/lib/classTree.js"></script>
                                                <script language="javascript" type="text/javascript">
                var imgPlus = new Image();
                var imgMinus = new Image();
                imgPlus.src = "../../media/images/plus.png";
                imgMinus.src = "../../media/images/minus.png";
                
                function showNode(Node){
                            switch(navigator.family){
                                case 'nn4':
                                    // Nav 4.x code fork...
                            var oTable = document.layers["span" + Node];
                            var oImg = document.layers["img" + Node];
                                    break;
                                case 'ie4':
                                    // IE 4/5 code fork...
                            var oTable = document.all["span" + Node];
                            var oImg = document.all["img" + Node];
                                    break;
                                case 'gecko':
                                    // Standards Compliant code fork...
                            var oTable = document.getElementById("span" + Node);
                            var oImg = document.getElementById("img" + Node);
                                    break;
                            }
                    oImg.src = imgMinus.src;
                    oTable.style.display = "block";
                }
                
                function hideNode(Node){
                            switch(navigator.family){
                                case 'nn4':
                                    // Nav 4.x code fork...
                            var oTable = document.layers["span" + Node];
                            var oImg = document.layers["img" + Node];
                                    break;
                                case 'ie4':
                                    // IE 4/5 code fork...
                            var oTable = document.all["span" + Node];
                            var oImg = document.all["img" + Node];
                                    break;
                                case 'gecko':
                                    // Standards Compliant code fork...
                            var oTable = document.getElementById("span" + Node);
                            var oImg = document.getElementById("img" + Node);
                                    break;
                            }
                    oImg.src = imgPlus.src;
                    oTable.style.display = "none";
                }
                
                function nodeIsVisible(Node){
                            switch(navigator.family){
                                case 'nn4':
                                    // Nav 4.x code fork...
                            var oTable = document.layers["span" + Node];
                                    break;
                                case 'ie4':
                                    // IE 4/5 code fork...
                            var oTable = document.all["span" + Node];
                                    break;
                                case 'gecko':
                                    // Standards Compliant code fork...
                            var oTable = document.getElementById("span" + Node);
                                    break;
                            }
                    return (oTable && oTable.style.display == "block");
                }
                
                function toggleNodeVisibility(Node){
                    if (nodeIsVisible(Node)){
                        hideNode(Node);
                    }else{
                        showNode(Node);
                    }
                }
            </script>
                    </head>
        <body>
            <div class="page-body">            
<h2 class="class-name"><img src="../../media/images/Class_logo.png"
                                                        alt=" Class"
                                                        title=" Class"
                                                        style="vertical-align: middle"> XOAD_Cache</h2>

<a name="sec-description"></a>
<div class="info-box">
    <div class="info-box-title">Description</div>
    <div class="nav-bar">
                    <span class="disabled">Description</span> |
                                                            <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
                        
                    </div>
    <div class="info-box-body">
                <!-- ========== Info from phpDoc block ========= -->
<p class="short-description">XOAD_Cache Class.</p>
<p class="description"><p>This class allows you to cache the callbacks to  the server. By default the caching is disabled and  you must call XOAD_Cache::allowCaching to  configure which classes and methods will be cached.</p><p>Example:</p><p><pre><ol><code><pre><li> &lt;?<span class="src-id">php</span></li>
<li>&nbsp;</li>
<li> <span class="src-id"><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html">XOAD_Cache</a></span><span class="src-sym">::</span><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html#methodallowCaching">allowCaching</a><span class="src-sym">(</span><span class="src-str">'ExampleClass'</span><span class="src-sym">,  </span><span class="src-str">'invokeMethod'</span><span class="src-sym">,  </span><span class="src-num">30</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li>&nbsp;</li>
<li> <span class="src-php">?&gt;</span></li>
</pre></code></ol></pre></p></p>
    <ul class="tags">
                <li><span class="field">version:</span> 0.5.0.0</li>
                <li><span class="field">author:</span> Stanimir Angeloff</li>
            </ul>
        <p class="notes">
            Located in <a class="field" href="_extensions_Cache_classes_Cache_class_php.html">/extensions/Cache/classes/Cache.class.php</a> (line <span class="field"><a href="../..//__filesource/fsource_XOAD_XOAD_Cache_extensionsCacheclassesCache.class.php.html#a56">56</a></span>)
        </p>
        
                
        <pre></pre>
    
            </div>
</div>




    <a name="sec-method-summary"></a>
    <div class="info-box">
        <div class="info-box-title">Method Summary</span></div>
        <div class="nav-bar">
            <a href="#sec-description">Description</a> |
                                                <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
        </div>
        <div class="info-box-body">            
            <div class="method-summary">
                                
                <div class="method-definition">
                    <img src="../../media/images/Method.png" alt=" "/>
                                            <span class="method-result">void</span>
                                        <a href="#allowCaching" title="details" class="method-name">allowCaching</a>
                                            ([<span class="var-type">array</span>&nbsp;<span class="var-name">$className</span> = <span class="var-default">null</span>],  [<span class="var-type">array</span>&nbsp;<span class="var-name">$method</span> = <span class="var-default">null</span>],  [<span class="var-type">array</span>&nbsp;<span class="var-name">$expire</span> = <span class="var-default">null</span>],  [<span class="var-type">array</span>&nbsp;<span class="var-name">$arguments</span> = <span class="var-default">null</span>],  [<span class="var-type">array</span>&nbsp;<span class="var-name">$members</span> = <span class="var-default">null</span>])
                                    </div>
                                
                <div class="method-definition">
                    <img src="../../media/images/Method.png" alt=" "/>
                                            <span class="method-result">bool</span>
                                        <a href="#cacheRequest" title="details" class="method-name">cacheRequest</a>
                                            (<span class="var-type">array</span>&nbsp;<span class="var-name">&$request</span>,  <span class="var-type">array</span>&nbsp;<span class="var-name">&$response</span>)
                                    </div>
                                
                <div class="method-definition">
                    <img src="../../media/images/Method.png" alt=" "/>
                                            <span class="method-result">bool</span>
                                        <a href="#dispatch" title="details" class="method-name">dispatch</a>
                                            (<span class="var-type">array</span>&nbsp;<span class="var-name">&$request</span>,  <span class="var-type">array</span>&nbsp;<span class="var-name">&$cacheData</span>)
                                    </div>
                                
                <div class="method-definition">
                    <img src="../../media/images/PrivateMethod.png" alt=" "/>
                                            <span class="method-result">object Singleton</span>
                                        <a href="#getStorage" title="details" class="method-name">&amp;getStorage</a>
                                        ()
                                    </div>
                                
                <div class="method-definition">
                    <img src="../../media/images/Method.png" alt=" "/>
                                            <span class="method-result">bool</span>
                                        <a href="#initialize" title="details" class="method-name">initialize</a>
                                            (<span class="var-type">array</span>&nbsp;<span class="var-name">&$request</span>)
                                    </div>
                            </div>
        </div>
    </div>        

    
    <a name="sec-methods"></a>
    <div class="info-box">
        <div class="info-box-title">Methods</div>
        <div class="nav-bar">
            <a href="#sec-description">Description</a> |
                                                                <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
                        
        </div>
        <div class="info-box-body">
            <A NAME='method_detail'></A>
<a name="methodallowCaching" id="allowCaching"><!-- --></a>
<div class="evenrow">
    
    <div class="method-header">
        <img src="../../media/images/Method.png" />
        <span class="method-title">allowCaching</span> (line <span class="line-number"><a href="../..//__filesource/fsource_XOAD_XOAD_Cache_extensionsCacheclassesCache.class.php.html#a348">348</a></span>)
    </div> 
    
    <!-- ========== Info from phpDoc block ========= -->
<p class="short-description">Installs a new caching criteria.</p>
<p class="description"><p>By default the caching is disabled and you must call this  method to configure which classes and methods will be cached.</p><p>If you call this method with no arguments,  caching will be  enabled for all classes and methods.</p><p>When generating the ID for each request the class name,  method name  and arguments list is used to build a long string which is later  used for the ID. You can configure <a href="../../XOAD/XOAD_Cache/XOAD_Cache.html">XOAD_Cache</a> to include  some of the class variables too.</p><p>Example:</p><p><pre><ol><code><pre><li> &lt;?<span class="src-id">php</span></li>
<li>&nbsp;</li>
<li> <span class="src-comm">// Allow caching for all classes.</span></li>
<li> <span class="src-id"><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html">XOAD_Cache</a></span><span class="src-sym">::</span><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html#methodallowCaching">allowCaching</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li>&nbsp;</li>
<li> <span class="src-comm">// Allow caching only for the 'Example' class.</span></li>
<li> <span class="src-id"><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html">XOAD_Cache</a></span><span class="src-sym">::</span><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html#methodallowCaching">allowCaching</a><span class="src-sym">(</span><span class="src-str">'Example'</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li>&nbsp;</li>
<li> <span class="src-comm">// Allow caching only for the 'Example-&gt;invoke' method.</span></li>
<li> <span class="src-id"><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html">XOAD_Cache</a></span><span class="src-sym">::</span><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html#methodallowCaching">allowCaching</a><span class="src-sym">(</span><span class="src-str">'Example'</span><span class="src-sym">,  </span><span class="src-str">'invoke'</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li>&nbsp;</li>
<li> <span class="src-comm">// Allow caching for the 'invoke' method in every class.</span></li>
<li> <span class="src-id"><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html">XOAD_Cache</a></span><span class="src-sym">::</span><a href="../../XOAD/XOAD_Cache/XOAD_Cache.html#methodallowCaching">allowCaching</a><span class="src-sym">(</span><span class="src-id">null</span><span class="src-sym">,  </span><span class="src-str">'invoke'</span><span class="src-sym">)</span><span class="src-sym">;</span></li>
<li>&nbsp;</li>
<li> <span class="src-php">?&gt;</span></li>
</pre></code></ol></pre></p></p>
    <ul class="tags">
                <li><span class="field">static:</span> </li>
                <li><span class="field">access:</span> public</li>
            </ul>
    
    <div class="method-signature">
        <span class="method-result">void</span>
        <span class="method-name">
            allowCaching
        </span>
                    ([<span class="var-type">array</span>&nbsp;<span class="var-name">$className</span> = <span class="var-default">null</span>],  [<span class="var-type">array</span>&nbsp;<span class="var-name">$method</span> = <span class="var-default">null</span>],  [<span class="var-type">array</span>&nbsp;<span class="var-name">$expire</span> = <span class="var-default">null</span>],  [<span class="var-type">array</span>&nbsp;<span class="var-name">$arguments</span> = <span class="var-default">null</span>],  [<span class="var-type">array</span>&nbsp;<span class="var-name">$members</span> = <span class="var-default">null</span>])
            </div>
    
            <ul class="parameters">
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$className</span><span class="var-description">: The class name filter. This value can be null.</span>            </li>
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$method</span><span class="var-description">: The method name filter. This value can be null.</span>            </li>
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$expire</span><span class="var-description">: The lifetime time in seconds for the                                 cached data. This value can be null.</span>            </li>
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$arguments</span><span class="var-description">: Array that contains the list of arguments to                                 use when generating the request ID. By default                                 each argument is used. This value can be null.</span>            </li>
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$members</span><span class="var-description">: Array that contains the list of class variables                                 to use when generating the request ID. By                                 default no class variables are used. This value                                 can be null.</span>            </li>
                </ul>
        
        
    </div>
<a name="methodcacheRequest" id="cacheRequest"><!-- --></a>
<div class="oddrow">
    
    <div class="method-header">
        <img src="../../media/images/Method.png" />
        <span class="method-title">cacheRequest</span> (line <span class="line-number"><a href="../..//__filesource/fsource_XOAD_XOAD_Cache_extensionsCacheclassesCache.class.php.html#a278">278</a></span>)
    </div> 
    
    <!-- ========== Info from phpDoc block ========= -->
<p class="short-description">This method is called when the request matches the configurated  criterias for caching,  but there is no data in the cache.</p>
    <ul class="tags">
                <li><span class="field">return:</span> True if the request is cached,  false otherwise.</li>
                <li><span class="field">static:</span> </li>
                <li><span class="field">access:</span> public</li>
            </ul>
    
    <div class="method-signature">
        <span class="method-result">bool</span>
        <span class="method-name">
            cacheRequest
        </span>
                    (<span class="var-type">array</span>&nbsp;<span class="var-name">&$request</span>,  <span class="var-type">array</span>&nbsp;<span class="var-name">&$response</span>)
            </div>
    
            <ul class="parameters">
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$request</span><span class="var-description">: The data that is associated with the                                 callback.</span>            </li>
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$response</span><span class="var-description">: The data that is associated with the                                 response.</span>            </li>
                </ul>
        
        
    </div>
<a name="methoddispatch" id="dispatch"><!-- --></a>
<div class="evenrow">
    
    <div class="method-header">
        <img src="../../media/images/Method.png" />
        <span class="method-title">dispatch</span> (line <span class="line-number"><a href="../..//__filesource/fsource_XOAD_XOAD_Cache_extensionsCacheclassesCache.class.php.html#a185">185</a></span>)
    </div> 
    
    <!-- ========== Info from phpDoc block ========= -->
<p class="short-description">This method is called when the request matches the configurated criterias for caching.</p>
<p class="description"><p>If the request is cached and it's not expired then the cached  response is used,  otherwise the server dispatches the call  and the response is cached.</p><p></p></p>
    <ul class="tags">
                <li><span class="field">return:</span> True if the request is cached,  false otherwise.</li>
                <li><span class="field">static:</span> </li>
                <li><span class="field">access:</span> public</li>
            </ul>
    
    <div class="method-signature">
        <span class="method-result">bool</span>
        <span class="method-name">
            dispatch
        </span>
                    (<span class="var-type">array</span>&nbsp;<span class="var-name">&$request</span>,  <span class="var-type">array</span>&nbsp;<span class="var-name">&$cacheData</span>)
            </div>
    
            <ul class="parameters">
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$request</span><span class="var-description">: The data that is associated with the                                 callback.</span>            </li>
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$cacheData</span><span class="var-description">: The data that is associated with the                                 caching criteria.</span>            </li>
                </ul>
        
        
    </div>
<a name="methodgetStorage" id="getStorage"><!-- --></a>
<div class="oddrow">
    
    <div class="method-header">
        <img src="../../media/images/PrivateMethod.png" />
        <span class="method-title">getStorage</span> (line <span class="line-number"><a href="../..//__filesource/fsource_XOAD_XOAD_Cache_extensionsCacheclassesCache.class.php.html#a69">69</a></span>)
    </div> 
    
    <!-- ========== Info from phpDoc block ========= -->
<p class="short-description">Retrieves an instanse to the configurated XOAD_Cache storage provider.</p>
    <ul class="tags">
                <li><span class="field">return:</span> <a href="../../XOAD/XOAD_Cache/XOAD_Cache_Storage.html">XOAD_Cache_Storage</a> inherited class based                     on the configuration (see <a href="../../XOAD/_config_extensions_config_php.html#defineXOAD_CACHE_STORAGE_DSN">XOAD_CACHE_STORAGE_DSN</a>).</li>
                <li><span class="field">static:</span> </li>
                <li><span class="field">access:</span> private</li>
            </ul>
    
    <div class="method-signature">
        <span class="method-result">object Singleton</span>
        <span class="method-name">
            &amp;getStorage
        </span>
                ()
            </div>
    
        
        
    </div>
<a name="methodinitialize" id="initialize"><!-- --></a>
<div class="evenrow">
    
    <div class="method-header">
        <img src="../../media/images/Method.png" />
        <span class="method-title">initialize</span> (line <span class="line-number"><a href="../..//__filesource/fsource_XOAD_XOAD_Cache_extensionsCacheclassesCache.class.php.html#a140">140</a></span>)
    </div> 
    
    <!-- ========== Info from phpDoc block ========= -->
<p class="short-description">This method is called on every request to the server.</p>
<p class="description"><p>If the request matches the configurated criterias for  caching this method will call XOAD_Cache::dispatch.</p></p>
    <ul class="tags">
                <li><span class="field">return:</span> True if the request is cached,  false otherwise.</li>
                <li><span class="field">static:</span> </li>
                <li><span class="field">access:</span> public</li>
            </ul>
    
    <div class="method-signature">
        <span class="method-result">bool</span>
        <span class="method-name">
            initialize
        </span>
                    (<span class="var-type">array</span>&nbsp;<span class="var-name">&$request</span>)
            </div>
    
            <ul class="parameters">
                    <li>
                <span class="var-type">array</span>
                <span class="var-name">$request</span><span class="var-description">: The data that is associated with the                                 callback.</span>            </li>
                </ul>
        
        
    </div>
                        
        </div>
    </div>

    
    <p class="notes" id="credit">
        Documentation generated on Thu,  13 Oct 2005 09:55:42 +0300 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.3.0RC3</a>
    </p>
    </div></body>
</html>


Other Development Tools Scripts:

WebMaster Resources Home

©RingsWorld.com