namespace.js Javascript的命名空间库_javascript技巧
命名空間
github：https://github.com/hirokidaichi/namespace-js
定义Namespace对象：
var Namespace
现在来具体看一下Namespace对象的定义，它是一个NamespaceDefinition对象。该对象是一个函数对象（NamespaceDefinition对象的构造函数，如果不给参数的话就默认生成一个main的命名空间），还有三个属性，Object，Definition，Proc。其值依次为NamespaceObjectFactory，NamespaceDefinition，createProcedure函数对象类。
复制代码 代码如下:
196 var createNamespace = function(fqn){
197 return new NamespaceDefinition(
198 NamespaceObjectFactory.create(fqn || 'main')
199 );
200 };
201 merge(createNamespace, {
202 'Object' : NamespaceObjectFactory,
203 Definition: NamespaceDefinition,
204 Proc : createProcedure
205 });
NamespaceObjectFactory：根据fqn生成NamespaceObject对象。
NamespaceObjectFactory对象只有一个create方法，参数就是命名空间的名字（Fully Qualified Name）。该方法有一个闭包环境，该环境里有一个cache变量用于缓存所有生成的NamespaceObject对象。
一个NamespaceObject对象包含有三个属性，stash(记录当前namespace)，fqn（namespace名字），proc（createProcedure对象）。方法包括：enqueue，call，valueof，merge，getStash，getExport
复制代码 代码如下:
74 var NamespaceObject = function _Private_Class_Of_NamespaceObject(fqn){
75 merge(this, {
76 stash: { CURRENT_NAMESPACE : fqn },
77 fqn : fqn,
78 proc : createProcedure()
79 });
80 };
81 merge(NamespaceObject.prototype, {
82 enqueue: function(context) {
83 this.proc.next(context);
84 },
85 call: function(state,callback) {
86 this.proc.call(state, callback);
87 },
88 valueOf: function() {
89 return "#NamespaceObject";
90 },
91 merge: function(obj) {
92 merge(this.stash,obj);
93 return this;
94 },
95 getStash: function() {
96 return this.stash;
97 },
98 getExport: function(importName) {
99 if (importName === '*') return this.stash;
100
101 var importNames = importName.split(/,/),
102 retStash = {};
103 for(var i = 0,l=importNames.length;i
105 }
106 return retStash;
107 }
108 });
109 var NamespaceObjectFactory = (function() {
110 var cache = {};
111 return {
112 create :function(fqn){
113 _assertValidFQN(fqn);
114 return (cache[fqn] || (cache[fqn] = new NamespaceObject(fqn)));
115 }
116 };
117 })();
NamespaceDefinition：
该对象包括5个属性，namespaceObject，requires，useList，stash，defineCallback。并提供了相关的方法：use，_mergeStashWithNS，loadImport，define，getStash，valueOf，apply
该对象是namespace库的核心，它提供了所有需要的方法。
初始化的时候，在NamespaceObject的proc的steps队列里追加一个函数对象，该函数将调用apply方法。
复制代码 代码如下:
119 var NamespaceDefinition = function _Private_Class_Of_NamespaceDefinition(nsObj) {
120 merge(this, {
121 namespaceObject: nsObj,
122 requires : [],
123 useList : [],
124 stash : {},
125 defineCallback : undefined
126 });
127 var _self = this;
128 nsObj.enqueue(function($c){ _self.apply($c); });
129 };
130 merge(NamespaceDefinition.prototype, {
131 use: function(syntax){
132 this.useList.push(syntax);
133 var splitted = syntax.split(/\s+/);
134 var fqn = splitted[0];
135 var importName = splitted[1];
136 _assertValidFQN(fqn);
137 this.requires.push(function($c){
138 var context = this;
139 var require = NamespaceObjectFactory.create(fqn);
140 require.call(this,function(state){
141 context.loadImport(require,importName);
142 $c();
143 });
144 });
145 return this;
146 },
147 _mergeStashWithNS: function(nsObj){
148 var nsList = nsObj.fqn.split(/\./);
149 var current = this.getStash();
150
151 for(var i = 0,l=nsList.length;i
153 current = current[nsList[i]];
154 }
155
156 var lastLeaf = nsList[nsList.length-1];
157 current[lastLeaf] = merge(current[lastLeaf] || {}, nsObj.getStash());
158 },
159 loadImport: function(nsObj,importName){
160 if( importName ){
161 merge( this.stash, nsObj.getExport(importName) );
162 }else{
163 this._mergeStashWithNS( nsObj );
164 }
165 },
166 define: function(callback){
167 var nsDef = this, nsObj = this.namespaceObject;
168 this.defineCallback = function($c) {
169 var ns = {
170 provide : function(obj){
171 nsObj.merge(obj);
172 $c();
173 }
174 };
175 merge(ns, nsDef.getStash());
176 merge(ns, nsObj.getStash());
177 callback(ns);
178 };
179 },
180 getStash: function(){
181 return this.stash;
182 },
183 valueOf: function(){
184 return "#NamespaceDefinition uses :" + this.useList.join(',');
185 },
186 apply: function(callback){
187 var nsDef = this;
188 createProcedure(nsDef.requires)
189 .next(nsDef.defineCallback)
190 .call(nsDef,function(){
191 callback( nsDef.getStash() );
192 });
193 }
194 });
createProcedure：该对象是一个函数对象，返回Procedure对象的next方法的结果。
Procedure：
Procedure对象有三个属性：state，steps，_status（默认为init）。提供一下几种方法：next，isRunnig，enqueue，dequeue，call，_invoke。
复制代码 代码如下:
1 var Namespace = (function(){
2 /* utility */
3 var merge = function(target, source){ // 把source的所有自身属性copy到target中去，并返回target对象 4 for(var p in source)
5 if(source.hasOwnProperty( p )) target[p] = source[p];
6 return target;
7 };
8 var _assertValidFQN = function(fqn){ // 验证namespace名字的有效性，必须是小写英数字，下划线和点
9 if(!(/^[a-z0-9_.]+/).test(fqn)) throw('invalid namespace');
10 };
11
12 var Procedure = function _Private_Class_Of_Proc(){
13 merge(this, {
14 state : {}, // 状态
15 steps : [], // 存储状态的数组
16 _status: 'init'
17 });
18 };
19 merge(Procedure.prototype, {
20 next: function(state){ // 如果state有值，存入到steps队列队尾，然后返回this
21 if(state) this.enqueue(state);
22 return this;
23 },
24 isRunning: function(){ // 判定是否为running状态
25 return (this._status === 'running');
26 },
27 enqueue: function(state){ // 这里其实是用数组steps来模拟队列，enqueue就是从队尾入队列
28 this.steps.push(state);
29 },
30 dequeue: function(){ // dequeue就是从对头出队列
31 return this.steps.shift();
32 },
33 call: function(initialState,callback){ //
34 if( this.isRunning() ) throw("do not run twice");
35
36 this.state = initialState || {}; // 保存当前state（NamespaceDefinition对象）
37 this.enqueue(function($c){ // 函数入队列steps
38 $c(); // 执行传进来的函数
39 if(callback)callback(this); // 如果存在回调函数的，执行回调函数
40 });
41 this._status = 'running'; // 设置状态为running
42 this._invoke(); // 调用_invoke
43 },
44 _invoke: function(){
45 var _self = this;
46 var step = _self.dequeue(); // 对象出队列(FIFO)
47 if( !step ){
48 _self._status = 'finished'; // 如果队列为空，则设置状态为finished
49 return;
50 } // step是数组的情况下不走这条路径
51 if( step.call ) { // 如果该对象是函数对象的时候，则执行该call方法，并指定内部this为_self.state，回调函数里面继续调用_invoke
52 return step.call( _self.state,function _cont(state){
53 if( state ) _self.state = state;
54 _self._invoke();
55 });
56 }
57 var finishedProcess = 0;
58 if( step.length === 0 ) _self._invoke(); // 如果该数组长度为0，则调用_invoke
59 for(var i =0,l=step.length;i
61 finishedProcess++;
62 if( finishedProcess == l ){
63 _self._invoke();
64 }
65 });
66 }
67 }
68 });
69
70 var createProcedure = function(state) {
71 return new Procedure().next(state);
72 };
73
74 var NamespaceObject = function _Private_Class_Of_NamespaceObject(fqn){
75 merge(this, {
76 stash: { CURRENT_NAMESPACE : fqn },
77 fqn : fqn,
78 proc : createProcedure()
79 });
80 };
81 merge(NamespaceObject.prototype, {
82 enqueue: function(context) {
83 this.proc.next(context);
84 },
85 call: function(state,callback) {
86 this.proc.call(state, callback);
87 },
88 valueOf: function() {
89 return "#NamespaceObject";
90 },
91 merge: function(obj) {
92 merge(this.stash,obj);
93 return this;
94 },
95 getStash: function() {
96 return this.stash;
97 },
98 getExport: function(importName) {
99 if (importName === '*') return this.stash;
100
101 var importNames = importName.split(/,/),
102 retStash = {};
103 for(var i = 0,l=importNames.length;i
105 }
106 return retStash;
107 }
108 });
109 var NamespaceObjectFactory = (function() {
110 var cache = {};
111 return {
112 create :function(fqn){
113 _assertValidFQN(fqn);
114 return (cache[fqn] || (cache[fqn] = new NamespaceObject(fqn)));
115 }
116 };
117 })();
118
119 var NamespaceDefinition = function _Private_Class_Of_NamespaceDefinition(nsObj) {
120 merge(this, {
121 namespaceObject: nsObj,
122 requires : [],
123 useList : [],
124 stash : {},
125 defineCallback : undefined
126 });
127 var _self = this;
128 nsObj.enqueue(function($c){ _self.apply($c); });
129 };
130 merge(NamespaceDefinition.prototype, {
131 use: function(syntax){ // 使用namespace
132 this.useList.push(syntax); // 该namespace字符串存入数组useList
133 var splitted = syntax.split(/\s+/); // namespace和它的对象使用空格分开
134 var fqn = splitted[0]; // 取得namespace
135 var importName = splitted[1]; // 取得namespace中的对象
136 _assertValidFQN(fqn);
137 this.requires.push(function($c){ // 放一个函数到requires数组中
138 var context = this;
139 var require = NamespaceObjectFactory.create(fqn); // 获取指定的NamespaceObject对象，之前生成过得对象可以直接从缓存中获取
140 require.call(this,function(state){ // 调用NamespaceObject对象的call方法
141 context.loadImport(require,importName);
142 $c();
143 });
144 });
145 return this;
146 },
147 _mergeStashWithNS: function(nsObj){
148 var nsList = nsObj.fqn.split(/\./);
149 var current = this.getStash();
150
151 for(var i = 0,l=nsList.length;i
153 current = current[nsList[i]];
154 }
155
156 var lastLeaf = nsList[nsList.length-1];
157 current[lastLeaf] = merge(current[lastLeaf] || {}, nsObj.getStash());
158 },
159 loadImport: function(nsObj,importName){
160 if( importName ){
161 merge( this.stash, nsObj.getExport(importName) );
162 }else{
163 this._mergeStashWithNS( nsObj );
164 }
165 },
166 define: function(callback){
167 var nsDef = this, nsObj = this.namespaceObject;
168 this.defineCallback = function($c) { // 给defineCallback赋值，同时定义一下该回调函数的上下文，nsDef和nsObj两个对象。
169 var ns = {
170 provide : function(obj){
171 nsObj.merge(obj);
172 $c();
173 }
174 };
175 merge(ns, nsDef.getStash());
176 merge(ns, nsObj.getStash());
177 callback(ns);
178 };
179 },
180 getStash: function(){
181 return this.stash;
182 },
183 valueOf: function(){
184 return "#NamespaceDefinition uses :" + this.useList.join(',');
185 },
186 apply: function(callback){
187 var nsDef = this;
188 createProcedure(nsDef.requires)
189 .next(nsDef.defineCallback)
190 .call(nsDef,function(){
191 callback( nsDef.getStash() );
192 });
193 }
194 });
195
196 var createNamespace = function(fqn){
197 return new NamespaceDefinition(
198 NamespaceObjectFactory.create(fqn || 'main')
199 );
200 };
201 merge(createNamespace, {
202 'Object' : NamespaceObjectFactory,
203 Definition: NamespaceDefinition,
204 Proc : createProcedure
205 });
206 return createNamespace;
207 })();
追加定义Namespace支持的方法：
Namespace.use
Namespace.fromInternal
Namespace.GET
Namespace.fromExternal
复制代码 代码如下:
1 Namespace.use = function(useSyntax){ return Namespace().use(useSyntax); }
2 Namespace.fromInternal = Namespace.GET = (function(){
3 var get = (function(){
4 var createRequester = function() {
5 var xhr;
6 try { xhr = new XMLHttpRequest() } catch(e) {
7 try { xhr = new ActiveXObject("Msxml2.XMLHTTP.6.0") } catch(e) {
8 try { xhr = new ActiveXObject("Msxml2.XMLHTTP.3.0") } catch(e) {
9 try { xhr = new ActiveXObject("Msxml2.XMLHTTP") } catch(e) {
10 try { xhr = new ActiveXObject("Microsoft.XMLHTTP") } catch(e) {
11 throw new Error( "This browser does not support XMLHttpRequest." )
12 }
13 }
14 }
15 }
16 }
17 return xhr;
18 };
19 var isSuccessStatus = function(status) {
20 return (status >= 200 && status 21 status == 304 ||
22 status == 1223 ||
23 (!status && (location.protocol == "file:" || location.protocol == "chrome:") );
24 };
25
26 return function(url,callback){
27 var xhr = createRequester();
28 xhr.open('GET',url,true);
29 xhr.onreadystatechange = function(){
30 if(xhr.readyState === 4){
31 if( isSuccessStatus( xhr.status || 0 )){
32 callback(true,xhr.responseText);
33 }else{
34 callback(false);
35 }
36 }
37 };
38 xhr.send('')
39 };
40 })();
41
42 return function(url,isManualProvide){
43 return function(ns){
44 get(url,function(isSuccess,responseText){
45 if( isSuccess ){
46 if( isManualProvide )
47 return eval(responseText);
48 else
49 return ns.provide( eval( responseText ) );
50 }else{
51 var pub = {};
52 pub[url] = 'loading error';
53 ns.provide(pub);
54 }
55 });
56 };
57 };
58 })();
59
60 Namespace.fromExternal = (function(){
61 var callbacks = {};
62 var createScriptElement = function(url,callback){
63 var scriptElement = document.createElement('script');
64
65 scriptElement.loaded = false;
66
67 scriptElement.onload = function(){
68 this.loaded = true;
69 callback();
70 };
71 scriptElement.onreadystatechange = function(){
72 if( !/^(loaded|complete)$/.test( this.readyState )) return;
73 if( this.loaded ) return;
74 scriptElement.loaded = true;
75 callback();
76 };
77 scriptElement.src = url;
78 document.body.appendChild( scriptElement );
79 return scriptElement.src;
80 };
81 var domSrc = function(url){
82 return function(ns){
83 var src = createScriptElement(url,function(){
84 var name = ns.CURRENT_NAMESPACE;
85 var cb = callbacks[name];
86 delete callbacks[name];
87 cb( ns );
88 });
89 }
90 };
91 domSrc.registerCallback = function(namespace,callback) {
92 callbacks[namespace] = callback;
93 };
94 return domSrc;
95 })();
96
97 try{ module.exports = Namespace; }catch(e){}
具体看一个例子：
复制代码 代码如下:
1 Namespace('logtest')
2 .define(function (ns) {
3 console.log(2);
4 ns.provide({
5 log : function () { console.log(3); }
6 });
7 });
8
9 console.log(4);
10
11 Namespace
12 .use('logtest')
13 .apply( function (ns) {
14 console.log(5);
15 ns.logtest.log();
16 });
1：Namespace('logtest') => new NamespaceDefinition(NamespaceObjectFactory.create('logtest'))
即生成一个NamespaceDefinition对象，该对象是由NamespaceObject对象来初始化的，该对象同时还有三个属性，Object，Definition，Proc。其值依次为 NamespaceObjectFactory，NamespaceDefinition，createProcedure函数对象类。Namespace('logtest') 返回的结果就是生成的NamespaceDefinition对象，然后调用其define方法，初始化defineCallback。此时仅仅是定义，不做具体的动作。
复制代码 代码如下:
166 define: function(callback){
167 var nsDef = this, nsObj = this.namespaceObject;
168 this.defineCallback = function($c) { // 给defineCallback赋值，同时定义一下该回调函数的上下文，nsDef和nsObj两个对象。
169 var ns = {
170 provide : function(obj){
171 nsObj.merge(obj);
172 $c();
173 }
174 };
175 merge(ns, nsDef.getStash());
176 merge(ns, nsObj.getStash());
177 callback(ns);
178 };
179 },
2：使用之前定义的namespace里面的对象，Namespace.use() => Namespace().use() => Namespace('main').use()。调用use的时候初始化requires数组。
复制代码 代码如下:
131 use: function(syntax){ // 使用namespace
132 this.useList.push(syntax); // 该namespace字符串存入数组useList
133 var splitted = syntax.split(/\s+/); // namespace和它的对象使用空格分开
134 var fqn = splitted[0]; // 取得namespace
135 var importName = splitted[1]; // 取得namespace中的对象
136 _assertValidFQN(fqn);
137 this.requires.push(function($c){ // 放一个函数到requires数组中
138 var context = this;
139 var require = NamespaceObjectFactory.create(fqn); // 获取指定的NamespaceObject对象，之前生成过得对象可以直接从缓存中获取
140 require.call(this,function(state){ // 调用NamespaceObject对象的call方法
141 context.loadImport(require,importName);
142 $c();
143 });
144 });
145 return this;
146 },
3：调用main的apply方法。看一下具体的apply方法
复制代码 代码如下:
186 apply: function(callback){
187 var nsDef = this;
188 createProcedure(nsDef.requires)
189 .next(nsDef.defineCallback)
190 .call(nsDef,function(){
191 callback( nsDef.getStash() );
192 });
193 }
取出requires数组里面的对象生成Proc对象，并把该requires数组里的对象入队列steps中，还有nsDef.defineCallback也入队列（此例中为undefined），调用Proc的call方法。第一个参数是nsDef，第二个参数是回调函数。
具体使用方法：
在定义Namespace的时候，所有的定义放在define里面，并且以匿名函数的形式定义。function (ns) { // 具体的实现 // 定义对外公开的对象，外部在use该nsName之后，就可以通过ns.nsName.key()来调用它 ns.provide({ key : value});}
使用namespace.js的好处，所有的定义都是在需要的时候才开始执行的，也就是在具体使用的时候才开始解析定义。
ps：具体内部调用关系还是没有弄明白，今后有时间再整理，这篇太乱了。
本網站聲明
本文內容由網友自願投稿，版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容，請聯絡admin@php.cn
熱AI工具
Undresser.AI Undress
人工智慧驅動的應用程序，用於創建逼真的裸體照片
AI Clothes Remover
用於從照片中去除衣服的線上人工智慧工具。
Undress AI Tool
免費脫衣圖片
Clothoff.io
AI脫衣器
Video Face Swap
使用我們完全免費的人工智慧換臉工具，輕鬆在任何影片中換臉！
熱門文章
刺客信條陰影：貝殼謎語解決方案
1 個月前
By DDD
Windows 11 KB5054979中的新功能以及如何解決更新問題
3 週前
By DDD
在哪裡可以找到原子中的起重機控制鑰匙卡
1 個月前
By DDD
如何修復KB5055523無法在Windows 11中安裝？
2 週前
By DDD
Inzoi：如何申請學校和大學
3 週前
By DDD
熱工具
記事本++7.3.1
好用且免費的程式碼編輯器
SublimeText3漢化版
中文版，非常好用
禪工作室 13.0.1
強大的PHP整合開發環境
Dreamweaver CS6
視覺化網頁開發工具
SublimeText3 Mac版
神級程式碼編輯軟體(SublimeText3)
解決PHP報錯：未找到指定的命名空間類
Aug 18, 2023 pm 11:28 PM
解決PHP報錯：未找到指定的命名空間類別在使用PHP進行開發時，我們經常會遇到各種各樣的報錯資訊。其中一個常見的報錯就是「未找到指定的命名空間類別」。這個錯誤通常是由於引入的類別檔案沒有被正確地命名空間引用所引起的。本文將介紹如何解決這個問題，並提供一些程式碼範例。首先，讓我們來看看一個常見的報錯訊息範例：Fatalerror:UncaughtError:C
如何在F3框架中使用命名空間（Namespace）？
Jun 03, 2023 am 08:02 AM
F3框架是一款簡單易用，靈活可擴充的PHPWeb框架，它的命名空間（Namespace）機制為我們提供了一個更規範、可讀性更強、程式碼結構更為清晰的程式設計方式。在這篇文章中，我們將探討如何在F3框架中使用命名空間。一、什麼是命名空間命名空間常被用來解決在PHP中命名衝突的問題，它可以將一個或多個類別、函數或常數封裝在一個命名空間中，相當於為它們加上一個前綴。例
Redis的命名空間與過期機制的設計想法與實作方式
May 11, 2023 am 10:40 AM
Redis是一個開源的高效能的鍵值儲存資料庫。在使用Redis進行資料儲存的時候，我們需要考慮到鍵的命名空間與過期機制的設計，來維護Redis的效能和資料完整性。本文將介紹Redis的命名空間和過期機制的設計想法和實作方式。一、Redis的命名空間設計思路在Redis中，鍵是可以任意設定的。為了方便管理和區分不同的資料類型，Redis引入了命名空間的概念。命
C++語法錯誤：使用了未定義的命名空間，怎麼處理？
Aug 21, 2023 pm 09:49 PM
C++是一種廣泛使用的高階程式語言，它具有很高的靈活性和可擴展性，但同時也需要開發者嚴格掌握其語法規則才能避免錯誤。其中，常見的錯誤之一就是「使用了未定義的命名空間」。本文將介紹該錯誤的含義、出現原因和解決方法。一、什麼是使用了未定義的命名空間？在C++中，命名空間是一種組織可重複使用程式碼的方式，以便保持程式碼的模組性和可讀性。使用命名空間的方式可以使同名的函數
PHP8新功能範例：如何利用命名空間和程式碼來更好地組織程式碼結構？
Sep 11, 2023 pm 12:22 PM
PHP8新功能範例：如何利用命名空間和程式碼來更好地組織程式碼結構？引言：PHP8是PHP程式語言的重要版本，它引入了許多令人興奮的新特性和改進。其中一個最重要的新功能是命名空間（namespace）。命名空間是一種將程式碼組織成更好結構的方法，它能夠避免相同名稱的類別、函數和常數之間的衝突。在本文中，我們將介紹如何利用命名空間和程式碼來更好地組織PHP8程式碼的結構
PHP 5.3新功能：如何使用命名空間解決類別名稱衝突問題
Jul 30, 2023 pm 12:25 PM
PHP5.3新功能：如何使用命名空間解決類別名稱衝突問題引言：在PHP的開發過程中，隨著專案變得越來越龐大和複雜，類別名稱衝突問題也隨之而來。為了解決這個問題，PHP5.3版本引入了命名空間的概念。命名空間提供了一種將相關的類別、函數和常數組織在一起的方式，以避免命名衝突的問題。本文將詳細介紹PHP命名空間的概念和如何使用命名空間解決類別名稱衝突問題，並附帶程式碼範例
PHP 自動載入的最佳實務：保障穩定與效能
Mar 02, 2024 pm 09:10 PM
PHP自動載入概述自動化載入是一種機制，用於在使用之前自動載入類別及其相依性。在php中，這透過使用__autoload()函數或Composer等自動載入器來實現。正確的自動載入設定對於確保程式碼庫的穩定性和效能至關重要。 PSR-4自動載入標準PSR-4是PHP-FIG定義的自動載入標準。它基於命名空間和目錄結構的約定，以簡化類別文件的查找。要遵守PSR-4：定義根命名空間（例如MyApp）。使用反斜線()作為命名空間分隔符號。使用小寫字母表示命名空間元素。為每個命名空間元素建立一個對應的目錄。將類文
解決PHP命名空間錯誤並產生對應錯誤提示的方法
Aug 07, 2023 pm 05:16 PM
解決PHP命名空間錯誤並產生對應錯誤提示的方法PHP是一種廣泛使用的伺服器端腳本語言，被用於開發Web應用程式。在PHP中，命名空間（Namespace）是一種管理和組織程式碼的機制，可以避免命名衝突，提高程式碼的可讀性和可維護性。然而，由於命名空間定義和使用的複雜性，有時會導致錯誤的產生。本文將介紹一些解決PHP命名空間錯誤並產生對應報錯提示的方法。一、命名空
