Async関数

Spread.SheetsのAsyncFunctionは、非同期の値の評価をサポートします。非同期関数は、サーバー側での計算など、計算結果を即時に取得できないプロセスに関連して使用します。

<h1 id="async関数">Async関数</h1> <p>Spread.Sheetsの<strong>AsyncFunction</strong>は、非同期の値の評価をサポートします。非同期関数は、サーバー側での計算など、計算結果を即時に取得できないプロセスに関連して使用します。</p> <p><strong>GC.Spread.CalcEngine.Functions.AsyncFunction</strong>を継承してクラスを作成します。</p> <p><strong>defaultValue</strong>メソッドを使用して、表示文字列を定義します。</p> <p>値を評価するため、<strong>evaluateAsync</strong>メソッドを提供します。結果を設定するには、context.<strong>setAsyncResult</strong>を使用します。</p> <pre><code class="hljs js language-js"> <span class="hljs-keyword">var</span> asum = <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params"></span>) </span>{}; asum.prototype = <span class="hljs-keyword">new</span> GC.Spread.CalcEngine.Functions.AsyncFunction(<span class="hljs-string">'ASUM'</span>, <span class="hljs-number">1</span>, <span class="hljs-number">255</span>); asum.prototype.defaultValue = <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params"></span>) </span>{ <span class="hljs-keyword">return</span> <span class="hljs-string">'Loading...'</span>; }; asum.prototype.evaluateAsync = <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">context, arg</span>) </span>{ <span class="hljs-comment">// 評価結果を設定します。</span> context.setAsyncResult(result); }; </code></pre> <p>非同期関数の評価モードを指定するには、<strong>AsyncFunctionEvaluateMode</strong>を使用します。評価モードには、次の3つがあります。</p> <pre><code class="hljs js language-js"> Functions.AsyncFunctionEvaluateMode = { <span class="hljs-attr">onRecalculation</span>: <span class="hljs-number">0</span>, <span class="hljs-attr">calculateOnce</span>: <span class="hljs-number">1</span>, <span class="hljs-attr">onInterval</span>: <span class="hljs-number">2</span> </code></pre> <ul> <li><strong>0:セルの再計算が必要になった時点で、AsyncFunctionも再計算されます。たとえば、B1='MyAsync1(A1) + MyAsync2(A2)' のような場合です。A1の値が変更されると、B1の数式は再計算されます。これにより、'MyAsync1(A1)'、'MyAsync2(A2)' はいずれも再計算されます。</strong></li> <li><strong>1:REFRESH関数の数式は一度だけ評価されます。</strong></li> <li><strong>2:REFRESH関数の数式は、指定の時間間隔に基づき再計算されます。</strong></li> </ul> <p><strong>refresh</strong>メソッドを設定します。</p> <pre><code class="hljs js language-js"> refresh(formula, evaluateMode, interval) </code></pre> <ul> <li><strong>REFRESH関数の最初の引数には、任意の数式を使用できます。</strong></li> <li><strong>evaluateModeの値は、GC.Spread.CalcEngine.Functions.AsyncFunctionEvaluateMode列挙体のいずれかの値である必要があります。</strong></li> <li><strong>intervalは、evaluateModeの値が2の場合のみに有効となります。</strong></li> <li><strong>通常、REFRESH関数は最も外側の関数として使用します。</strong></li> <li><strong>REFRESH関数の内部でAsyncFunctionを設定する場合は、REFRESH関数の設定が使用されます。AsyncFunctionの設定は無効となります。</strong></li> </ul> <p><strong>addCustomFunction</strong>メソッドを使用して、定義した非同期関数を追加します。この関数は、<strong>setFormula</strong>メソッドを使用するなどの方法で、数式内で使用できます。</p> <pre><code class="hljs js language-js"> sheet.addCustomFunction(<span class="hljs-keyword">new</span> asum()); sheet.setFormula(<span class="hljs-number">1</span>, <span class="hljs-number">1</span>, <span class="hljs-string">'ASUM(A1,B1)'</span>); </code></pre>
window.onload = function () { var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {sheetCount: 2}); initSpread(spread); }; function initSpread(spread) { var asyncSum = function () { }; asyncSum.prototype = new GC.Spread.CalcEngine.Functions.AsyncFunction("ASUM", 1, 255); asyncSum.prototype.defaultValue = function () { return "Loading..."; }; asyncSum.prototype.evaluateAsync = function (context) { // use setTimeout to simulate server side evaluation // in read world it maybe an ajax post to server for evaluation var args = arguments; setTimeout(function () { var result = 0; for (var i = 1; i < args.length; i++) { result += args[i]; } result *= 2; context.setAsyncResult(result); }, 2000); }; var GetNumberFromServer = function () { }; GetNumberFromServer.prototype = new GC.Spread.CalcEngine.Functions.AsyncFunction("GETNUMBERFROMSERVER", 1, 2); GetNumberFromServer.prototype.evaluate = function (context, arg1, arg2) { setTimeout(function () { var value = Math.random() + 1; context.setAsyncResult(value); }, 500); }; GC.Spread.CalcEngine.Functions.defineGlobalCustomFunction("GETNUMBERFROMSERVER", new GetNumberFromServer()); var GetTimeFromServer = function () { }; GetTimeFromServer.prototype = new GC.Spread.CalcEngine.Functions.AsyncFunction("GETTIMEFROMSERVER"); GetTimeFromServer.prototype.evaluate = function (context) { setTimeout(function () { var date = new Date(); context.setAsyncResult(date); }, 500); }; GetTimeFromServer.prototype.evaluateMode = function () { return 2; }; GetTimeFromServer.prototype.interval = function () { return 1000; }; GC.Spread.CalcEngine.Functions.defineGlobalCustomFunction("GETTIMEFROMSERVER", new GetTimeFromServer()); var sheet = spread.sheets[0]; sheet.suspendPaint(); sheet.options.allowCellOverflow = true; sheet.setArray(0, 0, [[5, 15]]); sheet.addCustomFunction(new asyncSum()); sheet.setFormula(1, 1, "ASUM(A1,B1)"); sheet.getCell(1, 1).foreColor("green"); sheet.setValue(4, 0, "Edit the formula of B2 or referenced cell' value to see how async function works."); sheet.setValue(8, 0, 'ChangeValue'); sheet.setValue(8, 1, 'Formula'); sheet.setValue(8, 2, 'Result'); sheet.setValue(8, 3, 'Comments'); sheet.setValue(9, 3, 'On A10 changed'); sheet.setValue(10, 3, 'On A10 changed'); sheet.setValue(11, 3, 'Evaluate once'); sheet.setValue(12, 3, 'Every 2 seconds'); sheet.setValue(9, 0, 1); sheet.setValue(9, 1, '=GetNumberFromServer(A10)'); sheet.setValue(10, 1, '=Refresh(GetNumberFromServer(A10), 0)'); sheet.setValue(11, 1, '=Refresh(GetNumberFromServer(A10), 1)'); sheet.setValue(12, 1, '=Refresh(GetNumberFromServer(A10), 2, 2000)'); sheet.setFormula(9, 2, '=GetNumberFromServer(A10)'); sheet.setFormula(10, 2, '=Refresh(GetNumberFromServer(A10), 0)'); sheet.setFormula(11, 2, '=Refresh(GetNumberFromServer(A10), 1)'); sheet.setFormula(12, 2, '=Refresh(GetNumberFromServer(A10), 2, 2000)'); sheet.setColumnWidth(0, 100); sheet.setColumnWidth(1, 300); sheet.setColumnWidth(2, 200); sheet.setColumnWidth(3, 200); sheet.setValue(15, 1, "=Refresh(now(), 2, 1000)"); sheet.setValue(15, 3, "Every 1 seconds"); sheet.setFormula(15, 2, "=Refresh(now(), 2, 1000)"); sheet.setValue(18, 1, "=GetTimeFromServer()"); sheet.setValue(18, 3, "Every 1 seconds"); sheet.setFormula(18, 2, "=GetTimeFromServer()"); sheet.getCell(18, 2).hAlign(GC.Spread.Sheets.HorizontalAlign.right); sheet.resumePaint(); }
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta name="spreadjs culture" content="ja-jp" /> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets-resources-ja/dist/gc.spread.sheets.resources.ja.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script> <script src="app.js" type="text/javascript"></script> <link rel="stylesheet" type="text/css" href="styles.css"> </head> <body> <div class="sample-tutorial"> <div id="ss" style="width:100%; height:100%;"></div> </div> </body> </html>
.sample-tutorial { position: relative; height: 100%; overflow: hidden; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }