Changeset 15037 for trunk/Xul_Commons/modules/scenariCommons/ExtPoints.jsm

Timestamp:

03/05/10 12:43:33 (2 years ago)

Author:

sys

Message:

SubExtPoints : paramètre pour overwrite de la def parent.

File:

• trunk/Xul_Commons/modules/scenariCommons/ExtPoints.jsm (modified) (8 diffs)

trunk/Xul_Commons/modules/scenariCommons/ExtPoints.jsm

@@ -118 +118 @@
          * @param pLevelAuthority Niveau d'autorité associée à cette affectation.
          * @param pValue Valeur à associer à la pref (string, number, boolean ou null)
+         * @param pOverwriteParent [Optionnel] utilisé uniquement par les SubExtPoints pour écraser la valeur 
+         *                              de l'extPoints parent quelquesoit le niveau d'autorité.
          * @return true si la valeur a été prise en compte, false si une valeur de niveau supérieur ou égal existe déjà.
          */
-        setPref : function(pCd, pLevelAuthority, pValue){
+        setPref : function(pCd, pLevelAuthority, pValue, pOverwriteParent){
                 var vCurrentLevel = this.fPrefLevels[pCd];
                 if(vCurrentLevel==null || vCurrentLevel < pLevelAuthority) {
@@ -137 +139 @@
          * @param pLevelAuthority Niveau d'autorité associée à cette affectation.
          * @param pDefaultValue Valeur à utiliser si aucune prefXpcom n'est définie.
+         * @param pOverwriteParent [Optionnel] utilisé uniquement par les SubExtPoints pour écraser la valeur 
+         *                              de l'extPoints parent quelquesoit le niveau d'autorité.
          * @return true si la pref a été modifiée, false si une valeur de niveau supérieur ou égal existe déjà.
          */
-        setPrefFromXpcom : function(pCd, pLevelAuthority, pDefaultValue){
+        setPrefFromXpcom : function(pCd, pLevelAuthority, pDefaultValue, pOverwriteParent){
                 var vCurrentLevel = this.fPrefLevels[pCd];
                 if(vCurrentLevel==null || vCurrentLevel < pLevelAuthority) {
@@ -169 +173 @@
          * @param pValueEntry Valeur de l'entrée, null est autorisé et élimine l'entrée de la liste. 
          * @param pSortKey Clé pour trier la liste, 0 par défaut.
+         * @param pOverwriteParent [Optionnel] utilisé uniquement par les SubExtPoints pour écraser la valeur 
+         *                              de l'extPoints parent quelquesoit le niveau d'autorité.
          * @return true si la valeur a été prise en compte, false si une valeur de niveau supérieur ou égal existe déjà.
          */
-        addToList : function(pCdList, pCdEntry, pLevelAuthority, pValueEntry, pSortKey){
+        addToList : function(pCdList, pCdEntry, pLevelAuthority, pValueEntry, pSortKey, pOverwriteParent){
                 var vList = this.fLists[pCdList];
                 if( ! vList) {
@@ -198 +204 @@
          * @param pCdSvc Code du service pointé, null est autorisé et élimine l'entrée de la liste. 
          * @param pSortKey Clé pour trier la liste, 0 par défaut.
+         * @param pOverwriteParent [Optionnel] utilisé uniquement par les SubExtPoints pour écraser la valeur 
+         *                              de l'extPoints parent quelquesoit le niveau d'autorité.
          * @return true si la valeur a été prise en compte, false si une valeur de niveau supérieur ou égal existe déjà.
          */
-        addSvcToList : function(pCdList, pCdEntry, pLevelAuthority, pCdSvc, pSortKey){
+        addSvcToList : function(pCdList, pCdEntry, pLevelAuthority, pCdSvc, pSortKey, pOverwriteParent){
                 var vList = this.fLists[pCdList];
                 if( ! vList) {
@@ -225 +233 @@
          * @param pLevelAuthority Niveau d'autorité associée à cette affectation.
          * @param pSvc Objet JS correspondant à ce service.
+         * @param pOverwriteParent [Optionnel] utilisé uniquement par les SubExtPoints pour écraser la valeur 
+         *                              de l'extPoints parent quelquesoit le niveau d'autorité.
          * @return true si ce svc a été prise en compte, false si un svc de niveau supérieur ou égal existe déjà.
          */
-        registerSvcByInst : function(pCd, pLevelAuthority, pSvc) {
+        registerSvcByInst : function(pCd, pLevelAuthority, pSvc, pOverwriteParent) {
                 var vSvcDef = this.fSvcs[pCd];
                 if(!vSvcDef || vSvcDef.fLevel < pLevelAuthority) {
@@ -291 +301 @@
          * @param pIsClassToInstanciate si true, l'objet issue de la lib est considéré comme une class 
          *              qu'il faut instancier pour créer le singleton (utile pour les .jsm en particulier).
+         * @param pOverwriteParent [Optionnel] utilisé uniquement par les SubExtPoints pour écraser la valeur 
+         *                              de l'extPoints parent quelquesoit le niveau d'autorité.
          * @return true si ce svc a été pris en compte, false si un svc de niveau supérieur ou égal est déjà déclaré.
          */
-        registerSvcByLib : function(pCd, pLevelAuthority, pUrlLib, pIsClassToInstanciate) {
+        registerSvcByLib : function(pCd, pLevelAuthority, pUrlLib, pIsClassToInstanciate, pOverwriteParent) {
                 var vSvcDef = this.fSvcs[pCd];
                 if(!vSvcDef || vSvcDef.fLevel < pLevelAuthority) {
@@ -731 +743 @@
 
 /**
- * Construteur du SubExtPoints
+ * SubExtPoints : extPoints qui surcharge un extPoints parent.
+ * 
+ * Un paramètre supplémentaire aux méthodes d'affectation permet de forcer l'écrasement
+ * de la valeur de l'extPoints parent quelquesoit le niveau d'autorité.
  * 
  * XXX Attention, avec cette impl, une modification ultérieure de l'extPoints parent 
@@ -748 +763 @@
         __proto__ : ExtPoints.prototype,
         
-        setPref : function(pCd, pLevelAuthority, pValue){
-                if(this.fParentExtPoints.getPrefLevel(pCd) >= pLevelAuthority) return false;
+        setPref : function(pCd, pLevelAuthority, pValue, pOverwriteParent){
+                if(! pOverwriteParent && this.fParentExtPoints.getPrefLevel(pCd) >= pLevelAuthority) return false;
                 return ExtPoints.prototype.setPref.apply(this, arguments); //call super
         },
         
         
-        setPrefFromXpcom : function(pCd, pLevelAuthority, pDefaultValue){
-                if(this.fParentExtPoints.getPrefLevel(pCd) >= pLevelAuthority) return false;
+        setPrefFromXpcom : function(pCd, pLevelAuthority, pDefaultValue, pOverwriteParent){
+                if(! pOverwriteParent && this.fParentExtPoints.getPrefLevel(pCd) >= pLevelAuthority) return false;
                 return ExtPoints.prototype.setPrefFromXpcom.apply(this, arguments); //call super
         },
         
-        addToList : function(pCdList, pCdEntry, pLevelAuthority, pValueEntry, pSortKey){
-                if(this.fParentExtPoints.getEntryListLevel(pCdList, pCdEntry) >= pLevelAuthority) return false;
+        addToList : function(pCdList, pCdEntry, pLevelAuthority, pValueEntry, pSortKey, pOverwriteParent){
+                if(! pOverwriteParent && this.fParentExtPoints.getEntryListLevel(pCdList, pCdEntry) >= pLevelAuthority) return false;
                 return ExtPoints.prototype.addToList.apply(this, arguments); //call super
         },
         
-        addSvcToList : function(pCdList, pCdEntry, pLevelAuthority, pCdSvc, pSortKey){
-                if(this.fParentExtPoints.getEntryListLevel(pCdList, pCdEntry) >= pLevelAuthority) return false;
+        addSvcToList : function(pCdList, pCdEntry, pLevelAuthority, pCdSvc, pSortKey, pOverwriteParent){
+                if(! pOverwriteParent && this.fParentExtPoints.getEntryListLevel(pCdList, pCdEntry) >= pLevelAuthority) return false;
                 return ExtPoints.prototype.addSvcToList.apply(this, arguments); //call super
         },
         
-        registerSvcByInst : function(pCd, pLevelAuthority, pSvc) {
-                if(this.fParentExtPoints.getSvcLevel(pCd) >= pLevelAuthority) return false;
+        registerSvcByInst : function(pCd, pLevelAuthority, pSvc, pOverwriteParent) {
+                if(! pOverwriteParent && this.fParentExtPoints.getSvcLevel(pCd) >= pLevelAuthority) return false;
                 return ExtPoints.prototype.registerSvcByInst.apply(this, arguments); //call super
         },
         
-        registerSvcByLib : function(pCd, pLevelAuthority, pUrlLib, pIsClassToInstanciate) {
-                if(this.fParentExtPoints.getSvcLevel(pCd) >= pLevelAuthority) return false;
+        registerSvcByLib : function(pCd, pLevelAuthority, pUrlLib, pIsClassToInstanciate, pOverwriteParent) {
+                if(! pOverwriteParent && this.fParentExtPoints.getSvcLevel(pCd) >= pLevelAuthority) return false;
                 return ExtPoints.prototype.registerSvcByLib.apply(this, arguments); //call super
         },