UNPKG

base-domain

Version:

simple module to help build Domain-Driven Design

886 lines (586 loc) 27.2 kB
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>BaseModel</title> <link rel="stylesheet" href="http://yui.yahooapis.com/3.9.1/build/cssgrids/cssgrids-min.css"> <link rel="stylesheet" href="../assets/vendor/prettify/prettify-min.css"> <link rel="stylesheet" href="../assets/css/main.css" id="site_styles"> <link rel="icon" href="../assets/favicon.ico"> <script src="http://yui.yahooapis.com/combo?3.9.1/build/yui/yui-min.js"></script> </head> <body class="yui3-skin-sam"> <div id="doc"> <div id="hd" class="yui3-g header"> <div class="yui3-u-3-4"> <h1><img src="../assets/css/logo.png" title="" width="117" height="52"></h1> </div> <div class="yui3-u-1-4 version"> <em>API Docs for: </em> </div> </div> <div id="bd" class="yui3-g"> <div class="yui3-u-1-4"> <div id="docs-sidebar" class="sidebar apidocs"> <div id="api-list"> <h2 class="off-left">APIs</h2> <div id="api-tabview" class="tabview"> <ul class="tabs"> <li><a href="#api-classes">Classes</a></li> <li><a href="#api-modules">Modules</a></li> </ul> <div id="api-tabview-filter"> <input type="search" id="api-filter" placeholder="Type to filter APIs"> </div> <div id="api-tabview-panel"> <ul id="api-classes" class="apis classes"> <li><a href="../classes/Base.html">Base</a></li> <li><a href="../classes/BaseDict.html">BaseDict</a></li> <li><a href="../classes/BaseFactory.html">BaseFactory</a></li> <li><a href="../classes/BaseList.html">BaseList</a></li> <li><a href="../classes/BaseModel.html">BaseModel</a></li> <li><a href="../classes/BaseRepository.html">BaseRepository</a></li> <li><a href="../classes/DictFactory.html">DictFactory</a></li> <li><a href="../classes/DomainError.html">DomainError</a></li> <li><a href="../classes/Entity.html">Entity</a></li> <li><a href="../classes/Facade.html">Facade</a></li> <li><a href="../classes/Fixture.html">Fixture</a></li> <li><a href="../classes/FixtureModel.html">FixtureModel</a></li> <li><a href="../classes/Includer.html">Includer</a></li> <li><a href="../classes/ListFactory.html">ListFactory</a></li> <li><a href="../classes/MasterRepository.html">MasterRepository</a></li> <li><a href="../classes/PropInfo.html">PropInfo</a></li> <li><a href="../classes/ResourceClientInterface.html">ResourceClientInterface</a></li> <li><a href="../classes/TypeInfo.html">TypeInfo</a></li> <li><a href="../classes/Util.html">Util</a></li> </ul> <ul id="api-modules" class="apis modules"> <li><a href="../modules/base-domain.html">base-domain</a></li> </ul> </div> </div> </div> </div> </div> <div class="yui3-u-3-4"> <div id="api-options"> Show: <label for="api-show-inherited"> <input type="checkbox" id="api-show-inherited" checked> Inherited </label> <label for="api-show-protected"> <input type="checkbox" id="api-show-protected"> Protected </label> <label for="api-show-private"> <input type="checkbox" id="api-show-private"> Private </label> <label for="api-show-deprecated"> <input type="checkbox" id="api-show-deprecated"> Deprecated </label> </div> <div class="apidocs"> <div id="docs-main"> <div class="content"> <h1>BaseModel Class</h1> <div class="box meta"> <div class="extends"> Extends <a href="../classes/Base.html" class="crosslink">Base</a> </div> <div class="foundat"> Defined in: <a href="../files/src_lib_base-model.coffee.html#l8"><code>src&#x2F;lib&#x2F;base-model.coffee:8</code></a> </div> Module: <a href="../modules/base-domain.html">base-domain</a> </div> <div class="box intro"> <p>Base model class of DDD pattern.</p> <p>the parent &quot;Base&quot; class just simply gives a @getFacade() method.</p> </div> <div id="classdocs" class="tabview"> <ul class="api-class-tabs"> <li class="api-class-tab index"><a href="#index">Index</a></li> <li class="api-class-tab methods"><a href="#methods">Methods</a></li> <li class="api-class-tab properties"><a href="#properties">Properties</a></li> </ul> <div> <div id="index" class="api-class-tabpanel index"> <h2 class="off-left">Item Index</h2> <div class="index-section methods"> <h3>Methods</h3> <ul class="index-list methods extends"> <li class="index-item method public"> <a href="#method_getEntityProps">getEntityProps</a> <span class="flag static">static</span> </li> <li class="index-item method inherited"> <a href="#method_getFacade">getFacade</a> </li> <li class="index-item method public"> <a href="#method_getModelProps">getModelProps</a> <span class="flag static">static</span> </li> <li class="index-item method public"> <a href="#method_getPropInfo">getPropInfo</a> </li> <li class="index-item method"> <a href="#method_include">include</a> </li> <li class="index-item method"> <a href="#method_inherit">inherit</a> </li> <li class="index-item method"> <a href="#method_setEntityProp">setEntityProp</a> </li> <li class="index-item method"> <a href="#method_toPlainObject">toPlainObject</a> </li> <li class="index-item method"> <a href="#method_unsetEntityProp">unsetEntityProp</a> </li> <li class="index-item method protected"> <a href="#method_withParentProps">withParentProps</a> <span class="flag static">static</span> </li> </ul> </div> <div class="index-section properties"> <h3>Properties</h3> <ul class="index-list properties extends"> <li class="index-item property protected"> <a href="#property_properties">properties</a> <span class="flag static">static</span> </li> <li class="index-item property protected"> <a href="#property_TYPES">TYPES</a> <span class="flag static">static</span> </li> </ul> </div> </div> <div id="methods" class="api-class-tabpanel"> <h2 class="off-left">Methods</h2> <div id="method_getEntityProps" class="method item public"> <h3 class="name"><code>getEntityProps</code></h3> <span class="paren">()</span> <span class="returns-inline"> <span class="type">Array</span> </span> <span class="flag public">public</span> <span class="flag static">static</span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l97"><code>src&#x2F;lib&#x2F;base-model.coffee:97</code></a> </p> </div> <div class="description"> <p>get list of properties which contains entity</p> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type">Array</span>: </div> </div> </div> <div id="method_getFacade" class="method item inherited"> <h3 class="name"><code>getFacade</code></h3> <span class="paren">()</span> <span class="returns-inline"> <span class="type"><a href="../classes/Facade.html" class="crosslink">Facade</a></span> </span> <div class="meta"> <p>Inherited from <a href="../classes/Base.html#method_getFacade">Base</a>: <a href="../files/src_lib_base.coffee.html#l32"><code>src&#x2F;lib&#x2F;base.coffee:32</code></a> </p> </div> <div class="description"> <p>get facade</p> <p>the implementation is in Facade#requre()</p> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type"><a href="../classes/Facade.html" class="crosslink">Facade</a></span>: </div> </div> </div> <div id="method_getModelProps" class="method item public"> <h3 class="name"><code>getModelProps</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code class="optional">[options]</code> </li> </ul><span class="paren">)</span> </div> <span class="returns-inline"> <span class="type">Array</span> </span> <span class="flag public">public</span> <span class="flag static">static</span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l108"><code>src&#x2F;lib&#x2F;base-model.coffee:108</code></a> </p> </div> <div class="description"> <p>get list of properties which contains relational model</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name optional">[options]</code> <span class="type">Object</span> <span class="flag optional" title="This parameter is optional.">optional</span> <div class="param-description"> </div> <ul class="params-list"> <li class="param"> <code class="param-name optional">[includeList]</code> <span class="type">Boolean</span> <span class="flag optional" title="This parameter is optional.">optional</span> <div class="param-description"> <p>include props of BaseList</p> </div> </li> </ul> </li> </ul> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type">Array</span>: </div> </div> </div> <div id="method_getPropInfo" class="method item public"> <h3 class="name"><code>getPropInfo</code></h3> <span class="paren">()</span> <span class="returns-inline"> <span class="type"><a href="../classes/PropInfo.html" class="crosslink">PropInfo</a></span> </span> <span class="flag public">public</span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l58"><code>src&#x2F;lib&#x2F;base-model.coffee:58</code></a> </p> </div> <div class="description"> <p>get an instance of PropInfo, which summarizes properties of this class</p> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type"><a href="../classes/PropInfo.html" class="crosslink">PropInfo</a></span>: </div> </div> </div> <div id="method_include" class="method item"> <h3 class="name"><code>include</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code class="optional">[options]</code> </li> </ul><span class="paren">)</span> </div> <span class="returns-inline"> <span class="type">Promise(BaseModel)</span> </span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l258"><code>src&#x2F;lib&#x2F;base-model.coffee:258</code></a> </p> </div> <div class="description"> <p>include all relational models if not set</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name optional">[options]</code> <span class="type">Object</span> <span class="flag optional" title="This parameter is optional.">optional</span> <div class="param-description"> </div> <ul class="params-list"> <li class="param"> <code class="param-name optional">[recursive]</code> <span class="type">Boolean</span> <span class="flag optional" title="This parameter is optional.">optional</span> <div class="param-description"> <p>recursively include models or not</p> </div> </li> </ul> </li> </ul> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type">Promise(BaseModel)</span>: <p>self</p> </div> </div> </div> <div id="method_inherit" class="method item"> <h3 class="name"><code>inherit</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>anotherModel</code> </li> </ul><span class="paren">)</span> </div> <span class="returns-inline"> <span class="type"><a href="../classes/BaseModel.html" class="crosslink">BaseModel</a></span> </span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l205"><code>src&#x2F;lib&#x2F;base-model.coffee:205</code></a> </p> </div> <div class="description"> <p>inherit value of anotherModel</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">anotherModel</code> <span class="type"><a href="../classes/BaseModel.html" class="crosslink">BaseModel</a></span> <div class="param-description"> </div> </li> </ul> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type"><a href="../classes/BaseModel.html" class="crosslink">BaseModel</a></span>: <p>this</p> </div> </div> </div> <div id="method_setEntityProp" class="method item"> <h3 class="name"><code>setEntityProp</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>prop</code> </li> <li class="arg"> <code>submodel</code> </li> </ul><span class="paren">)</span> </div> <span class="returns-inline"> <span class="type"><a href="../classes/BaseModel.html" class="crosslink">BaseModel</a></span> </span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l167"><code>src&#x2F;lib&#x2F;base-model.coffee:167</code></a> </p> </div> <div class="description"> <p>set related model(s)</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">prop</code> <span class="type">String</span> <div class="param-description"> <p>property name of the related model</p> </div> </li> <li class="param"> <code class="param-name">submodel</code> <span class="type"><a href="../classes/Entity.html" class="crosslink">Entity</a> | Array<Entity></span> <div class="param-description"> </div> </li> </ul> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type"><a href="../classes/BaseModel.html" class="crosslink">BaseModel</a></span>: <p>this</p> </div> </div> </div> <div id="method_toPlainObject" class="method item"> <h3 class="name"><code>toPlainObject</code></h3> <span class="paren">()</span> <span class="returns-inline"> <span class="type">Object</span> </span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l220"><code>src&#x2F;lib&#x2F;base-model.coffee:220</code></a> </p> </div> <div class="description"> <p>create plain object without relational entities descendants of Entity are removed, but not descendants of BaseModel descendants of Entity in descendants of BaseModel are removed ( = recursive)</p> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type">Object</span>: <p>plainObject</p> </div> </div> </div> <div id="method_unsetEntityProp" class="method item"> <h3 class="name"><code>unsetEntityProp</code></h3> <div class="args"> <span class="paren">(</span><ul class="args-list inline commas"> <li class="arg"> <code>prop</code> </li> </ul><span class="paren">)</span> </div> <span class="returns-inline"> <span class="type"><a href="../classes/BaseModel.html" class="crosslink">BaseModel</a></span> </span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l189"><code>src&#x2F;lib&#x2F;base-model.coffee:189</code></a> </p> </div> <div class="description"> <p>unset related model(s)</p> </div> <div class="params"> <h4>Parameters:</h4> <ul class="params-list"> <li class="param"> <code class="param-name">prop</code> <span class="type">String</span> <div class="param-description"> <p>property name of the related models</p> </div> </li> </ul> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type"><a href="../classes/BaseModel.html" class="crosslink">BaseModel</a></span>: <p>this</p> </div> </div> </div> <div id="method_withParentProps" class="method item protected"> <h3 class="name"><code>withParentProps</code></h3> <span class="paren">()</span> <span class="returns-inline"> <span class="type">Object</span> </span> <span class="flag protected">protected</span> <span class="flag static">static</span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l70"><code>src&#x2F;lib&#x2F;base-model.coffee:70</code></a> </p> </div> <div class="description"> <p>extend @properties of Parent class</p> </div> <div class="returns"> <h4>Returns:</h4> <div class="returns-description"> <span class="type">Object</span>: </div> </div> <div class="example"> <h4>Example:</h4> <div class="example-content"> <pre class="code prettyprint"><code>class Parent extends BaseModel </code></pre> </div> </div> </div> </div> <div id="properties" class="api-class-tabpanel"> <h2 class="off-left">Properties</h2> <div id="property_properties" class="property item protected"> <h3 class="name"><code>properties</code></h3> <span class="type">Object</span> <span class="flag protected">protected</span> <span class="flag static">static</span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l36"><code>src&#x2F;lib&#x2F;base-model.coffee:36</code></a> </p> </div> <div class="description"> <p>key-value pair representing property&#39;s name - type of the model</p> <pre class="code prettyprint"><code>firstName : @TYPES.STRING lastName : @TYPES.STRING age : @TYPES.NUMBER registeredAt : @TYPES.DATE team : @TYPES.MODEL &#39;team&#39; hobbies : @TYPES.MODEL_LIST &#39;hobby&#39; info : @TYPES.ANY </code></pre><p>see type-info.coffee for full options.</p> </div> </div> <div id="property_TYPES" class="property item protected"> <h3 class="name"><code>TYPES</code></h3> <span class="type">Object</span> <span class="flag protected">protected</span> <span class="flag final">final</span> <span class="flag static">static</span> <div class="meta"> <p> Defined in <a href="../files/src_lib_base-model.coffee.html#l22"><code>src&#x2F;lib&#x2F;base-model.coffee:22</code></a> </p> </div> <div class="description"> <p>key-value pair representing typeName - type</p> <p>use for definition of @properties for each extender</p> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> <script src="../assets/vendor/prettify/prettify-min.js"></script> <script>prettyPrint();</script> <script src="../assets/js/yui-prettify.js"></script> <script src="../assets/../api.js"></script> <script src="../assets/js/api-filter.js"></script> <script src="../assets/js/api-list.js"></script> <script src="../assets/js/api-search.js"></script> <script src="../assets/js/apidocs.js"></script> </body> </html>