Home /Modules/api/slrtp.html

slrtp.html

api/sleela/3.1/version-026/package/slrtp.html · 326 line(s) · html

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Package slrtp — SleelaDoc API</title>
<link rel="stylesheet" href="../style.css">

</head>
<body>
<header class="top">
  <div class="brand"><a href="../index.html">SleelaDoc API</a></div>
  <div class="tag">HTML documentation for the SLeeLa standard library (/lib)</div>
</header>
<div class="wrap">
<nav class="side">
  <a href="../index.html"><strong>Home</strong></a>
  <a href="../packages.html"><strong>All packages</strong></a>
  <a href="../glossary.html"><strong>Glossary</strong></a>
  <a href="../authorship.html"><strong>Authorship</strong></a>
  <h2>Packages</h2><ul>
<li><a href="../package/advantage.html">advantage</a></li>
<li><a href="../package/alphabet.html">alphabet</a></li>
<li><a href="../package/antivirus.html">antivirus</a></li>
<li><a href="../package/api.html">api</a></li>
<li><a href="../package/array.html">array</a></li>
<li><a href="../package/audio.html">audio</a></li>
<li><a href="../package/autocad.html">autocad</a></li>
<li><a href="../package/ballum.html">ballum</a></li>
<li><a href="../package/bash.html">bash</a></li>
<li><a href="../package/boolean.html">boolean</a></li>
<li><a href="../package/cdma.html">cdma</a></li>
<li><a href="../package/char.html">char</a></li>
<li><a href="../package/character.html">character</a></li>
<li><a href="../package/character-recognition.html">character-recognition</a></li>
<li><a href="../package/churn.html">churn</a></li>
<li><a href="../package/citizen.html">citizen</a></li>
<li><a href="../package/codecs.html">codecs</a></li>
<li><a href="../package/collections.html">collections</a></li>
<li><a href="../package/common-rails.html">common-rails</a></li>
<li><a href="../package/compiler.html">compiler</a></li>
<li><a href="../package/compression.html">compression</a></li>
<li><a href="../package/config.html">config</a></li>
<li><a href="../package/connector.html">connector</a></li>
<li><a href="../package/coorenagraph.html">coorenagraph</a></li>
<li><a href="../package/core.html">core</a></li>
<li><a href="../package/cpu.html">cpu</a></li>
<li><a href="../package/crypto.html">crypto</a></li>
<li><a href="../package/data.html">data</a></li>
<li><a href="../package/data-structures.html">data-structures</a></li>
<li><a href="../package/database.html">database</a></li>
<li><a href="../package/debugger.html">debugger</a></li>
<li><a href="../package/decompiler.html">decompiler</a></li>
<li><a href="../package/deliberation.html">deliberation</a></li>
<li><a href="../package/drivers.html">drivers</a></li>
<li><a href="../package/examples.html">examples</a></li>
<li><a href="../package/filesystem.html">filesystem</a></li>
<li><a href="../package/gameplay.html">gameplay</a></li>
<li><a href="../package/governance.html">governance</a></li>
<li><a href="../package/gui.html">gui</a></li>
<li><a href="../package/guidoc.html">guidoc</a></li>
<li><a href="../package/hotlink.html">hotlink</a></li>
<li><a href="../package/html.html">html</a></li>
<li><a href="../package/http.html">http</a></li>
<li><a href="../package/http-1.0.html">http-1.0</a></li>
<li><a href="../package/http-2.0.html">http-2.0</a></li>
<li><a href="../package/http-3.0.html">http-3.0</a></li>
<li><a href="../package/http-4.0.html">http-4.0</a></li>
<li><a href="../package/http-5.0.html">http-5.0</a></li>
<li><a href="../package/http-6.0.html">http-6.0</a></li>
<li><a href="../package/http-7.0.html">http-7.0</a></li>
<li><a href="../package/http-8.0.html">http-8.0</a></li>
<li><a href="../package/http-9.0.html">http-9.0</a></li>
<li><a href="../package/http-servers.html">http-servers</a></li>
<li><a href="../package/ide.html">ide</a></li>
<li><a href="../package/ide-workbench.html">ide-workbench</a></li>
<li><a href="../package/idea.html">idea</a></li>
<li><a href="../package/inference-model.html">inference-model</a></li>
<li><a href="../package/inputs.html">inputs</a></li>
<li><a href="../package/international-criminal-court.html">international-criminal-court</a></li>
<li><a href="../package/io.html">io</a></li>
<li><a href="../package/java.html">java</a></li>
<li><a href="../package/java28.html">java28</a></li>
<li><a href="../package/journey.html">journey</a></li>
<li><a href="../package/languages.html">languages</a></li>
<li><a href="../package/large-language-models.html">large-language-models</a></li>
<li><a href="../package/ledger.html">ledger</a></li>
<li><a href="../package/linux-editors.html">linux-editors</a></li>
<li><a href="../package/manifesto.html">manifesto</a></li>
<li><a href="../package/math.html">math</a></li>
<li><a href="../package/memory.html">memory</a></li>
<li><a href="../package/modules.html">modules</a></li>
<li><a href="../package/moral-capacitor.html">moral-capacitor</a></li>
<li><a href="../package/munction.html">munction</a></li>
<li><a href="../package/native.html">native</a></li>
<li><a href="../package/net.html">net</a></li>
<li><a href="../package/neural-nets.html">neural-nets</a></li>
<li><a href="../package/nordshrift.html">nordshrift</a></li>
<li><a href="../package/observer.html">observer</a></li>
<li><a href="../package/opcodes.html">opcodes</a></li>
<li><a href="../package/operating-system.html">operating-system</a></li>
<li><a href="../package/os-level-support.html">os-level-support</a></li>
<li><a href="../package/philosophers.html">philosophers</a></li>
<li><a href="../package/philosophy.html">philosophy</a></li>
<li><a href="../package/politico.html">politico</a></li>
<li><a href="../package/process.html">process</a></li>
<li><a href="../package/psychiatry.html">psychiatry</a></li>
<li><a href="../package/public.html">public</a></li>
<li><a href="../package/reflection.html">reflection</a></li>
<li><a href="../package/regex.html">regex</a></li>
<li><a href="../package/registry.html">registry</a></li>
<li><a href="../package/rmi.html">rmi</a></li>
<li><a href="../package/rrs.html">rrs</a></li>
<li><a href="../package/runtime.html">runtime</a></li>
<li><a href="../package/security.html">security</a></li>
<li><a href="../package/server-edition.html">server-edition</a></li>
<li><a href="../package/signal-processing.html">signal-processing</a></li>
<li><a href="../package/sldocument.html">sldocument</a></li>
<li><a href="../package/sleela.html">sleela</a></li>
<li><a href="../package/sleela-sql.html">sleela-sql</a></li>
<li><a href="../package/sleela-terminal.html">sleela-terminal</a></li>
<li><a href="../package/sleeladoc.html">sleeladoc</a></li>
<li><a href="../package/slrtp.html">slrtp</a></li>
<li><a href="../package/social-model.html">social-model</a></li>
<li><a href="../package/softlisten.html">softlisten</a></li>
<li><a href="../package/sommeliers.html">sommeliers</a></li>
<li><a href="../package/spatial.html">spatial</a></li>
<li><a href="../package/sst.html">sst</a></li>
<li><a href="../package/synchro.html">synchro</a></li>
<li><a href="../package/systems.html">systems</a></li>
<li><a href="../package/telephony-skya.html">telephony-skya</a></li>
<li><a href="../package/terminal.html">terminal</a></li>
<li><a href="../package/terminal_pixel.html">terminal_pixel</a></li>
<li><a href="../package/text.html">text</a></li>
<li><a href="../package/ui.html">ui</a></li>
<li><a href="../package/us-infrastructure.html">us-infrastructure</a></li>
<li><a href="../package/user-interface.html">user-interface</a></li>
<li><a href="../package/video.html">video</a></li>
<li><a href="../package/vm.html">vm</a></li>
<li><a href="../package/web-server-technology.html">web-server-technology</a></li>
<li><a href="../package/website.html">website</a></li>
<li><a href="../package/wifi.html">wifi</a></li>
<li><a href="../package/xlt.html">xlt</a></li>
<li><a href="../package/xml.html">xml</a></li>
</ul>
</nav>
<main>
<div class="crumbs"><a href="../index.html">Home</a> &rsaquo; <a href="../packages.html">Packages</a> &rsaquo; slrtp</div>
<h1>Package <code>slrtp</code></h1>
<div class="lead">This package contains <strong>7</strong> source unit(s) defining <strong>7</strong> class(es) / struct(s). Each unit below lists its fields (the values it stores) and methods (the actions it performs), with a plain explanation of each.</div>
<input class="search" placeholder="Filter on this page (Ctrl+F also works)…" oninput="flt(this.value)">
<h2 class="section" data-u="slpackage">SLPackage <span class="pill syntax">#sleela 3.0</span> <span class="muted" style="font-size:13px">(lib/slrtp/SLPackage.sleela)</span></h2>
<div data-u="slpackage slpackage">
<h3 id="SLPackage">SLPackage <span class="pill">class</span></h3>
<p class="desc">Defines the SLeeLa standard-library package for slrtp -- the Sleela Retrouval Tactical Processor, SLeeLa&#x27;s AOP-style interception framework (aspects, pointcuts, join points, before / after / around advice). This facade exposes the package to the SLeeLa compiler, Loader, and Nordshrift.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>packageName</code></td><td><span class="sig">String packageName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slrtp-demo">slrtp-demo <span class="pill syntax">#sleela 3.0</span> <span class="muted" style="font-size:13px">(lib/slrtp/slrtp-demo.sleela)</span></h2>
<div data-u="slrtp-demo slrtpdemo">
<h3 id="SlrtpDemo">SlrtpDemo <span class="pill">class</span></h3>
<p class="desc">A runnable demonstration of SLRTP (Sleela Retrouval Tactical Processor), SLeeLa&#x27;s AOP-style interception framework. It builds a tracing aspect and a guard aspect, installs them in a processor, and shows a target service weaving the processor around its own method -- before advice, an around advice that substitutes a cached result, and after-returning advice. Run it: sleela run lib/slrtp/slrtp-demo.sleela Sibling classes (SLRTPJoinPoint, SLRTPPointcut, SLRTPAdvice, SLRTPProcessor, SLRTPAspect) are auto-linked from this directory; no imports are needed.</p>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>charge</code></td><td><span class="sig">String charge(SLRTPProcessor p, String account, int cents)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>main</code></td><td><span class="sig">void main()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slrtpadvice">SLRTPAdvice <span class="pill syntax">#sleela 3.0</span> <span class="muted" style="font-size:13px">(lib/slrtp/SLRTPAdvice.sleela)</span></h2>
<div data-u="slrtpadvice slrtpadvice">
<h3 id="SLRTPAdvice">SLRTPAdvice <span class="pill">class</span></h3>
<p class="desc">An SLRTP advice -- the action taken at the join points its pointcut selects, akin to Java/AspectJ before / after-returning / after-throwing / around advice. Because the SLeeLa semantic checker is nominal and does not upcast, advice is DATA-DRIVEN rather than subclassed: an advice carries a pointcut plus an action code, and the processor applies the built-in action when the advice fires. The built-in actions cover the common cross-cutting concerns (tracing, counting, and around short-circuit / return-substitution); the join point it receives is mutable, so an around advice can decline to proceed or rewrite the return value.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>ACTION_LOG</code></td><td><span class="sig">int ACTION_LOG = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ACTION_COUNT</code></td><td><span class="sig">int ACTION_COUNT = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ACTION_SKIP</code></td><td><span class="sig">int ACTION_SKIP = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>ACTION_SUBSTITUTE</code></td><td><span class="sig">int ACTION_SUBSTITUTE = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>name</code></td><td><span class="sig">String name = &quot;advice&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>pointcut</code></td><td><span class="sig">SLRTPPointcut pointcut</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>action</code></td><td><span class="sig">int action = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>substituteValue</code></td><td><span class="sig">String substituteValue = &quot;&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>hits</code></td><td><span class="sig">int hits = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>lastTrace</code></td><td><span class="sig">String lastTrace = &quot;&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>define</code></td><td><span class="sig">void define(String adviceName, SLRTPPointcut pc, int act, String subValue)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getName</code></td><td><span class="sig">String getName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getPointcut</code></td><td><span class="sig">SLRTPPointcut getPointcut()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getAction</code></td><td><span class="sig">int getAction()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getHits</code></td><td><span class="sig">int getHits()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getLastTrace</code></td><td><span class="sig">String getLastTrace()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>appliesTo</code></td><td><span class="sig">boolean appliesTo(SLRTPJoinPoint jp)</span></td><td class="desc">True when this advice applies to the join point.</td></tr>
<tr><td><code>fire</code></td><td><span class="sig">boolean fire(SLRTPJoinPoint jp)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slrtpaspect">SLRTPAspect <span class="pill syntax">#sleela 3.0</span> <span class="muted" style="font-size:13px">(lib/slrtp/SLRTPAspect.sleela)</span></h2>
<div data-u="slrtpaspect slrtpaspect">
<h3 id="SLRTPAspect">SLRTPAspect <span class="pill">class</span></h3>
<p class="desc">An SLRTP aspect -- a named bundle of advice that address one cross-cutting concern (tracing, metering, access control), akin to a Java/AspectJ @Aspect. An aspect collects its advice, then installs them all into an SLRTPProcessor in one call, so a concern is enabled or disabled as a unit.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>name</code></td><td><span class="sig">String name = &quot;aspect&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_ADVICE</code></td><td><span class="sig">int MAX_ADVICE = 32</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>advice</code></td><td><span class="sig">SLRTPAdvice[] advice = new SLRTPAdvice[32]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>adviceCount</code></td><td><span class="sig">int adviceCount = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>named</code></td><td><span class="sig">void named(String aspectName)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getName</code></td><td><span class="sig">String getName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getAdviceCount</code></td><td><span class="sig">int getAdviceCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>add</code></td><td><span class="sig">boolean add(SLRTPAdvice a)</span></td><td class="desc">Add one advice to this aspect. Returns false when the aspect is full.</td></tr>
<tr><td><code>installInto</code></td><td><span class="sig">int installInto(SLRTPProcessor p)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slrtpjoinpoint">SLRTPJoinPoint <span class="pill syntax">#sleela 3.0</span> <span class="muted" style="font-size:13px">(lib/slrtp/SLRTPJoinPoint.sleela)</span></h2>
<div data-u="slrtpjoinpoint slrtpjoinpoint">
<h3 id="SLRTPJoinPoint">SLRTPJoinPoint <span class="pill">class</span></h3>
<p class="desc">A join point in SLRTP (Sleela Retrouval Tactical Processor) -- one described point in a program&#x27;s execution that advice can act on, akin to a Java/AspectJ join point. It names the target type and method, the current phase (before / after-returning / after-throwing / around), the call&#x27;s argument summary, and carries the mutable return / proceed state that around advice reads and rewrites.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>PHASE_BEFORE</code></td><td><span class="sig">int PHASE_BEFORE = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>PHASE_AFTER_RETURNING</code></td><td><span class="sig">int PHASE_AFTER_RETURNING = 1</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>PHASE_AFTER_THROWING</code></td><td><span class="sig">int PHASE_AFTER_THROWING = 2</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>PHASE_AROUND</code></td><td><span class="sig">int PHASE_AROUND = 3</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>typeName</code></td><td><span class="sig">String typeName = &quot;&quot;</span></td><td class="desc">Identity of the intercepted call.</td></tr>
<tr><td><code>methodName</code></td><td><span class="sig">String methodName = &quot;&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>phase</code></td><td><span class="sig">int phase = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>args</code></td><td><span class="sig">String args = &quot;&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>argCount</code></td><td><span class="sig">int argCount = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>returnValue</code></td><td><span class="sig">String returnValue = &quot;&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>thrown</code></td><td><span class="sig">String thrown = &quot;&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>proceeded</code></td><td><span class="sig">boolean proceeded = true</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>describe</code></td><td><span class="sig">void describe(String type, String method, int ph, String argSummary, int count)</span></td><td class="desc">Build a fully-specified join point.</td></tr>
<tr><td><code>getTypeName</code></td><td><span class="sig">String getTypeName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getMethodName</code></td><td><span class="sig">String getMethodName()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getPhase</code></td><td><span class="sig">int getPhase()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getArgs</code></td><td><span class="sig">String getArgs()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getArgCount</code></td><td><span class="sig">int getArgCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getReturnValue</code></td><td><span class="sig">String getReturnValue()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setReturnValue</code></td><td><span class="sig">void setReturnValue(String v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getThrown</code></td><td><span class="sig">String getThrown()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setThrown</code></td><td><span class="sig">void setThrown(String v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>didProceed</code></td><td><span class="sig">boolean didProceed()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>setProceeded</code></td><td><span class="sig">void setProceeded(boolean v)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>phaseName</code></td><td><span class="sig">String phaseName()</span></td><td class="desc">The human-readable name of the current phase.</td></tr>
<tr><td><code>signature</code></td><td><span class="sig">String signature()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slrtppointcut">SLRTPPointcut <span class="pill syntax">#sleela 3.0</span> <span class="muted" style="font-size:13px">(lib/slrtp/SLRTPPointcut.sleela)</span></h2>
<div data-u="slrtppointcut slrtppointcut">
<h3 id="SLRTPPointcut">SLRTPPointcut <span class="pill">class</span></h3>
<p class="desc">An SLRTP pointcut -- a predicate that selects the join points an advice applies to, akin to a Java/AspectJ pointcut expression. It matches a join point on three independent fields: target type, method name, and phase. Each field is either an exact string or the universal wildcard &quot;*&quot; (match any). Matching uses only string equality, so it is exact and portable; it does not attempt substring or regex matching the primitive String type here cannot perform.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>typePattern</code></td><td><span class="sig">String typePattern = &quot;*&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>methodPattern</code></td><td><span class="sig">String methodPattern = &quot;*&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>phasePattern</code></td><td><span class="sig">String phasePattern = &quot;*&quot;</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>select</code></td><td><span class="sig">void select(String type, String method, String phaseLabel)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getTypePattern</code></td><td><span class="sig">String getTypePattern()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getMethodPattern</code></td><td><span class="sig">String getMethodPattern()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getPhasePattern</code></td><td><span class="sig">String getPhasePattern()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>fieldMatches</code></td><td><span class="sig">boolean fieldMatches(String pattern, String value)</span></td><td class="desc">One field matches when the pattern is the wildcard or equals the value.</td></tr>
<tr><td><code>matches</code></td><td><span class="sig">boolean matches(SLRTPJoinPoint jp)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>describe</code></td><td><span class="sig">String describe()</span></td><td class="desc">A readable rendering, e.g. &quot;pay.* @around&quot;.</td></tr>
</table>
</div>
<h2 class="section" data-u="slrtpprocessor">SLRTPProcessor <span class="pill syntax">#sleela 3.0</span> <span class="muted" style="font-size:13px">(lib/slrtp/SLRTPProcessor.sleela)</span></h2>
<div data-u="slrtpprocessor slrtpprocessor">
<h3 id="SLRTPProcessor">SLRTPProcessor <span class="pill">class</span></h3>
<p class="desc">The Sleela Retrouval Tactical Processor -- SLRTP&#x27;s weaver and dispatcher, akin to a Java/Spring AOP proxy that runs registered advice around a call. Because SLeeLa has no bytecode weaver, interception is EXPLICIT: a caller wraps a method body with runBefore / runAround / runAfterReturning / runAfterThrowing, passing a join point. The processor finds every registered advice whose pointcut matches and fires it in registration order; an around advice may short-circuit the real call (SKIP) or rewrite its result (SUBSTITUTE). The processor keeps a bounded trace log so a program or test can inspect what fired without reading stdout.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>MAX_ADVICE</code></td><td><span class="sig">int MAX_ADVICE = 64</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>advice</code></td><td><span class="sig">SLRTPAdvice[] advice = new SLRTPAdvice[64]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>adviceCount</code></td><td><span class="sig">int adviceCount = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>MAX_TRACE</code></td><td><span class="sig">int MAX_TRACE = 256</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>trace</code></td><td><span class="sig">String[] trace = new String[256]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>traceCount</code></td><td><span class="sig">int traceCount = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dispatched</code></td><td><span class="sig">int dispatched = 0</span></td><td class="desc">Count of join points dispatched and of around calls that were skipped.</td></tr>
<tr><td><code>shortCircuits</code></td><td><span class="sig">int shortCircuits = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>register</code></td><td><span class="sig">int register(SLRTPAdvice a)</span></td><td class="desc">Register an advice. Returns the slot index, or -1 when full.</td></tr>
<tr><td><code>getAdviceCount</code></td><td><span class="sig">int getAdviceCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getDispatched</code></td><td><span class="sig">int getDispatched()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getShortCircuits</code></td><td><span class="sig">int getShortCircuits()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>getTraceCount</code></td><td><span class="sig">int getTraceCount()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>traceAt</code></td><td><span class="sig">String traceAt(int i)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>recordTrace</code></td><td><span class="sig">void recordTrace(String line)</span></td><td class="desc">Append one line to the bounded trace ring (drops oldest when full).</td></tr>
<tr><td><code>dispatch</code></td><td><span class="sig">boolean dispatch(SLRTPJoinPoint jp)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>runBefore</code></td><td><span class="sig">void runBefore(String type, String method, String args, int argCount)</span></td><td class="desc">BEFORE phase: run matching before/around advice prior to the real call.</td></tr>
<tr><td><code>runAfterReturning</code></td><td><span class="sig">void runAfterReturning(String type, String method, String args, int argCount, String result)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>runAfterThrowing</code></td><td><span class="sig">void runAfterThrowing(String type, String method, String args, int argCount, String error)</span></td><td class="desc">AFTER-THROWING phase: run after the call raised, carrying an error marker.</td></tr>
<tr><td><code>runAround</code></td><td><span class="sig">SLRTPJoinPoint runAround(String type, String method, String args, int argCount, String proposedResult)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>dumpTrace</code></td><td><span class="sig">void dumpTrace()</span></td><td class="desc">Print the recorded trace to stdout (for demos / debugging).</td></tr>
</table>
</div>
<script>function flt(q){q=q.toLowerCase();document.querySelectorAll('[data-u]').forEach(function(el){el.style.display = el.getAttribute('data-u').indexOf(q)>=0||q==''?'':'none';});}</script>
<footer>
Generated by <code>tools/generate-sleeladoc-api.py</code> from the live
<code>/lib</code> tree on 2026-11-15 04:04 UTC.
SleelaDoc — the SLeeLa documentation brand. SLeeLa — MEARVK LLC · Max Rupplin · UNCW, NCSU, Harvard · 2026 · George Soros 2507-2608.
</footer>
</main>
</div>
</body>
</html>