本来这行要详解Ext.extend的,但是发现网站有很详细的,那么就跳过去吧

为保持一个系列的分析,还是先搬过来吧,下章开始分析Ext4.0的新架构


在Java中,我们在实现继承的时候存在下面几个事实:

1, 准备两个类,他们用extends关键字链接起来

2, 如果超类没有默认构造函数,需要在子类构造函数中显式的super并传参,如果都是默认构造函数也可以super,不super虚拟机是自动的

3, 子类可追加,覆盖,重载方法,子类可以有自己的私有属性,他们在子类构造函数中被构造

4, 字段是数据,方法在代码区,和类建立方法表,同一个类的对象有自己的数据但是共享方法代码

比如有两个类,Plane和Space,Plane表示平面,Space表示空间,Space是Plane的子类,在java中

  1. /**
  2. * 根据字段数量分配内存块
  3. * 实例化的时候虚拟机调用Plane.Plane方法把这个内存块作为this和构造参数传进去,初始化完数据字段。
  4. * 建立方法表映射
  5. */
  6. class Plane {
  7. protected int x;
  8. protected int y;
  9. Plane(int x, int y) {
  10. this.x = x;
  11. this.y = y;
  12. }
  13. public void XY() {
  14. System.out.println(x * y);
  15. }
  16. }
  17. /**
  18. * 自动拥有了超类的行为,但是超类的属性需要超类去构造
  19. * 子类可构造自己的属性,添加自己的方法,覆盖超类的方法
  20. * <p/>
  21. * 按照继承结构的所有字段分配内存块,调用Space.Space将这个内存块作为this和参数一起传进去
  22. * 把超类的那部分给超类,然后自己初始化自己的。
  23. * <p/>
  24. * 建立方法表
  25. */
  26. class Space extends Plane {
  27. private int z;
  28. Space(int x, int y, int z) {
  29. super(x, y);
  30. this.z = z;
  31. }
  32. public void XYZ() {
  33. System.out.println(x * y * z);
  34. }
  35. }
  36. public class Test {
  37. public static void main(String[] args) {
  38. Plane plane = new Plane(2,3);
  39. plane.XY();
  40. Space space = new Space(2, 3, 4);
  41. space.XYZ();
  42. }
  43. }

那么在js中也一样,区别是代码要放到构造函数(可以理解为Java中的类)的原型上,原型是放置方法和不变属性的理想场所,原型是一个对象,它和普通对象唯一不同的就是他有一个constructor属性指向它所依附的构造器,在java中子类查找属性和方法是通过虚拟机来完成,但是在js中需要通过原型链来完成。也就是说继承关系对程序员是不透明的,需要了解这个原型机制,原型机制上存在两条链,一是原型链,二是构造函数链。

仿照上面java的代码,我们可以完成js的写法,如下:

  1.  
  1. var Plane = function(x, y) {
  2. this.x = x;
  3. this.y = y;
  4. };
  5. Plane.prototype.XY = function() {
  6. alert(this.x * this.y);
  7. };
  8. var Space = function(x, y, z) {
  9. //用this调用超类构造函数,没有java的super自动调用,所以要手动调用
  10. Plane.call(this, x, y);
  11. //Space.superclass.constructor.call(this, x, y); 可以用一个统一的语法
  12. //构造自己的数据
  13. this.z = z;
  14. };
  15. Space.prototype.XYZ = function() {
  16. alert(this.x * this.y * this.z);
  17. }

JS中函数的this指函数的调用者,不管是java还是js,this都可理解为新分配的那段容纳对象的内存。在java 中通过Space extends Plane,虚拟机就维护好了他们的继承关系以完成继承关系的自动查找,但是在js中需要我们手动的处理,在这个时候Space是调用不到XY这个方法的,因为他们没有在原型链上。我们可以开发一个函数来模拟java的关键字extends,比如这个函数叫做extend,通过执行extend(Plane,Space)完成原型链的组装。

那么extend怎么实现呢?首先要明白原型链,子类和父类在原型链上的关系是Space.prototype._proto_ == Plane.prototype,如果你理解不了,那就看String这个类吧,String.prototype._proto_ == Object.prototype,即String的原型会链接到Object的原型上,链接是通过_proto_这个属性来完成的。_proto_是一个只读的属性,只能通过构造函数写入,所以String是Object的子类。

现在Plane的prototype._proto_ 等于Object,Space的prototype._proto_也等于Object,我们要在extend函数变换这个关系,即完成Space.prototype._proto_ == Plane.prototype,我们知道一个对象的_proto_要指向某个构造函数的原型,需要让这个对象由那个构造函数构造,那么我们只需要让Space.prototype = new Plane()就可以了,这个时候Space.prototype._proto_ == Plane.prototype,而不再指向Object,原型还有一个属性constructor指向原型所在的构造器,由于Space.prototype刚被Plane创建出来,还没有这个属性,我们要手动赋值上去,代码是Space.prototype. constructor = Space。这样extend的责任就完成了。

但是这里有两个问题:

1, 由于Space的原型在extend中被替换了,那么它原有的方法就没有了。

2, Space的原型是Plane构造的,虽然做到了Space.prototype._proto_ == Plane.prototype,但是Plane也在原型上写入了x,y这两个垃圾数据,他们都是undefined,没有意义,所以要手动删除掉,这样extend这个方法就不能通用了。

首先解决第一个问题,我们要变化一点思路,利用js中函数也是数据的特性,我们把Space的那些方法拷贝到一个对象中,比如

  1.  
  1. var sbm= { XYZ : function() {
  2. alert(this.x * this.y * this.z);
  3. }
  4. };

把这个sbm也传递给extend,extend在替换完原型后将sbm上的所有方法复制到Space的原型上即可,sbm是一个对象直接量,用json语法。现在的extend就变为了三个参数,即extend(sb,sp,sbm),sb是子类,sp是超类,sbm是子类要放到原型上的方法。

对于第二个问题,本质原因是Plane这个函数要完成一些数据初始化,它是超类,我们不能控制,我们只关心Plane的原型而不关心它构造什么数据,所以我们可以把它的原型单独拿出来,再定义一个干净的函数,这个函数不做任何事,将这个干净函数的原型设置为Plane的原型,再用这个干净函数构造一个对象,这样出来的对象就是是干净的,也完成了_proto_指向了Plane.prototype,完美!有了这两个方法,我们就可以开始实现这个extend,代码如下:

  1.  
  1. var extend = function(sb, sp, sbm) {
  2. var F = function() {
  3. },sbp,spp = sp.prototype;
  4.  
  5. F.prototype = spp;
  6.  
  7. //用干净函数嫁接得到子类原型
  8. sbp = sb.prototype = new F();
  9.  
  10. sbp.constructor = sb; //然后指定一个constructor指回子类
  11.  
  12. //把sbm的上的属性拷贝到子类的原型上
  13. for (var p in sbm) {
  14. sbp[p] = sbm[p];
  15. }
  16. };

那么完成Space继承Plane的代码如下:

  1.  
  1. extend(Space, Plane, {
  2. XYZ : function() {
  3. alert(this.x * this.y * this.z);
  4. }
  5. });
  6.  
  7. var spaceObject = new Space(2, 3, 4);
  8.  
  9. spaceObject.XY();//成功调用超类方法
  10. spaceObject.XYZ();

OK,到了这里,我们基本上就完成任务了,完全从java的方向搞定的。我们现在利用js的特性来优化,让使用extend更加简单。

我们说在java中必须写两个类,每个类都写自己的字段 ,构造函数,方法等,在我们实现的extend函数中也确实把子类,父类都传递了进来,但是我们多了一个参数,那就是子类的方法集合即sbm,第一个参数sb本身也是函数,那是不是可以将这个函数也放进sbm传进来呢?这样extend就变为两个参数,即extend(sp,sbm),现在extend返回一个函数,返回的这个函数就是sp的子类,这是完全可行的,我们叫做extend2吧。

  1.  
  1. var extend2 = function(sp, sbm) {
  2. var sb = sbm.constructor;
  3. //如果说没有显式的构造函数,那么子类就是直接调用超类构造函数
  4. if (sb == Object) {
  5. sb = function() {
  6. sp.apply(this, arguments);
  7. };
  8. }
  9. extend(sb, sp, sbm);
  10. return sb;
  11. }

我们说要把子类的构造函数放到sbm上,放上去的key叫做constructor,就表示构造器,js中每一个对象都一个constructor属性,它指向构造了这个对象构造函数。sbm本来是个Object对象,它的constructor就指向Object,这个constructor是在sbm关联的那个原型上的,现在我们在sbm上设置某个子类的构造函数,这个时候表示sbm有个自己的constructor。

现在我们在extend2中要做的事情就是提取出构造函数,然后还原为三个参数去调用之前的extend,在java中我们的子类是可以不用构造器的,只要父类也有默认的构造器,那么在这里一样,sbm可能不包含constructor,那么我们需要做一个函数,它调用父类的构造函数,在java中这种情况过程是自动的。所以当sbm.constructor为Object的时候表示sbm没有指定构造函数,这个时候将

  1.  
  1. sb = function() {
  2. sp.apply(this, arguments);
  3. };

即调用父类构造函数。这样将sb,sp,sbm传递给extend就可以了。

这个时候我们新的继承语法如下:

  1.  
  1. var NewSpace = extend2(Plane, {
  2. constructor : function(x, y, z) {
  3. Plane.call(this, x, y);
  4. this.z = z;
  5. },
  6. XYZ : function() {
  7. alert(this.x * this.y * this.z);
  8. }
  9. });
  10.  
  11. var newObject = new NewSpace(3, 4, 5);
  12. newObject.XY();
  13. newObject.XYZ(

和prototype.js和mootolls的实现比较,大同小异

  1. // properties are directly passed to `create` method
  2. var Person = Class.create({
  3. initialize: function(name) {
  4. this.name = name;
  5. },
  6. say: function(message) {
  7. return this.name + ': ' + message;
  8. }
  9. });
  1. var Animal = new Class({
  2. initialize: function(age) {
  3. this.age = age;
  4. },
  5. say : function() {
  6. alert(this.age);
  7. }
  8. });
  9.  
  10. var Cat = new Class({
  11. Extends: Animal,
  12. initialize: function(name, age) {
  13. this.parent(age); // calls initalize method of Animal class
  14. this.name = name;
  15. }
  16. });
  1.  

到了这里其实已经差不多了,但是细心的读者会发现,我们在extend中会把sbm的所有属性拷贝到子类的原型上,这里岂不是就要把constructor也拷贝到原型上?如果sbm包含了这个constructor其实就无所谓,因为子类的原型的constructor本来就是需要指向这个构造函数的,但是sbm上没有constructor那岂不是要把Object拷贝到子类原型上,答案是不会的,我们在拷贝的时候用的for in循环是迭代不出默认的那个constructor的。

现在我们来看看Ext.extend,应该完全没有问题了。我们用了两个方法extend,extend2,Ext把它合并为了一个方法Ext.extend,所以它会判断传进来的参数然后进行变换,这样Ext.extend就支持两个参数和三个参数进行调用。对于前面用到拷贝属性,Ext做了一个工具函数叫做Ext.apply,对于将一个对象的属性拷贝到一个类的原型上,Ext做了一个工具类叫做Ext.override。

  1.  
  1. Ext.extend = function() {
  2. // inline overrides 把传入的对象属性复制到到this中
  3. var io = function(o) {
  4. for (var m in o) {
  5. this[m] = o[m];
  6. }
  7. };
  8. //oc其实就是Object函数
  9. var oc = Object.prototype.constructor;
  10.  
  11. return function(sb, sp, overrides) {
  12. //如果第二个参数是个对象而不是类,那么是用两个参数调用的,第一个参数是父类,第二个参数是对象
  13. if (typeof sp == 'object') {
  14. overrides = sp; //将第三个参数换为对象
  15. sp = sb; //把第一个参数赋值第二个当成父类
  16. sb = overrides.constructor != oc ? overrides.constructor : function() {
  17. sp.apply(this, arguments);
  18. }; //子类这个构造函数要么是外界传入的名字为constructor,要么就是直接调用超类构造函数的一个函数
  19. //传入的constructor除了构造自己还要调用超类的构造函数
  20. }
  21.  
  22. /**
  23. * 继承的两种参数
  24. * 1,自己写一个构造函数,初始化一些字段,然后调用超类构造函数,再写一个json对象,里面是要覆盖超类的方法或者追加的方法
  25. * 然后这样调用extend(sub,sup,{over1:f,over2:f,addf:f}),就像java的语法
  26. * SubClass extend SuperClass {
  27. * SubClass(){
  28. * super();
  29. * }
  30. * }
  31. *
  32. * 2,第一种可以理解为模拟java,但是因为构造函数也是数据,所以完全可以把构造函数也放进那个jdon对象,只不过约定好一个名字
  33. * 比如constructor,然后这样调用
  34. * extend(sup,{constructor:f,over1:f,over2:f,addf:f})
  35. */
  36. var F = function() {
  37. },
  38. sbp,
  39. spp = sp.prototype;
  40.  
  41. F.prototype = spp;
  42. sbp = sb.prototype = new F();
  43. //以上用干净函数嫁接得到子类原型
  44.  
  45. sbp.constructor = sb; //然后指定一个constructor指回子类,这样就大工告成
  46.  
  47. sb.superclass = spp; //在子类上指定一个静态字段指向超类原型,这样在子类构造函数中可访问超类构造函数sub.superclass.constructor.call(this, config)
  48.  
  49. /**
  50. * 这段代码是防御性的,在自己实现继承的时候,可能会出现原型上的构造函数指向问题,所以如果发现某个超类
  51. * 的构造函数是object,要么这个超类却是Object,要么出现了失误,所以这里再一次重设置一下,以防万一,这个代码我们在分析Ext的Observable的时候会提到的它的作用
  52. */
  53. if (spp.constructor == oc) {
  54. spp.constructor = sp;
  55. }
  56.  
  57. //子类上方一个静态的重写方法,注意js没有重载,可以用来重写子类原型上的函数
  58. sb.override = function(o) {
  59. Ext.override(sb, o);
  60. };
  61.  
  62. //用一个闭包在子类原型上引用一个超类原型,引用的是一个函数
  63. sbp.superclass = sbp.supr = (function() {
  64. return spp;
  65. });
  66.  
  67. //子类原型上放置一个重写函数,可以用来覆盖具体实例对象
  68. sbp.override = io;
  69.  
  70. //在子类原型上重写或添加函数
  71. Ext.override(sb, overrides);
  72.  
  73. //子类上直接放一个静态继承方法,貌似实现多继承
  74. sb.extend = function(o) {
  75. return Ext.extend(sb, o);
  76. };
  77.  
  78. return sb;
  79. };
  80. }();

现在使用Ext的extend来实现我们之前的继承代码就如下

  1. var Plane = function(o) {
  2. this.x = o.x;
  3. this.y = o.y;
  4. };
  5.  
  6. Plane.prototype.XY = function() {
  7. alert(this.x * this.y);
  8. };
  9.  
  10. var Space = Ext.extend(Plane, {
  11. constructor : function(o) {
  12. Space.superclass.constructor.call(this, o);
  13. this.z = o.z;
  14. },
  15. XYZ : function() {
  16. alert(this.x * this.y * this.z);
  17. }
  18. });
  19.  
  20. var space = new Space({ x:2,y:3,z:4});
  21.  
  22. space.XY();
  23. space.XYZ();

现在我们来分析一下Ext中的继承重头戏Observable,它位于Ext.util这个包下,它的意思即是观察者,使用观察者模式,EDA模式,UI组件就利用这种基于观察和事件的机制进行通信和渲染。

所有的UI组件都继承这个类,我们看看它的构造函数

  1.  
  1. EXTUTIL.Observable = function(){
  2. var me = this, e = me.events;
  3. if(me.listeners){
  4. me.on(me.listeners);
  5. delete me.listeners;
  6. }
  7. me.events = e || {};
  8. };

这个构造函数不需要参数,在java中,这种父类的构造可以自动的调用默认构造函数,但是这里要注意,if(me.listeners)依赖了子类的构造行为,这在面向对象原则中似乎是一个禁忌,但是如果一个继承体现完全由一个团队维护,他们同时制定继承规则和继承规范,这也无可厚非,这里的listeners可以在子类中不提供,可以让构造出来的对象自己调用on方法来添加监听器,同理这里的events,如果子类没构造会被赋值为一个空对象。那么这个Observable构造器做了两个事,一个是看子类是否在对象上放了监听器,如果放了,就调用对象的on方法进行事件和监听的绑定,二是看子类是否在对象上放置了events,如果没有就把对象的events属性设置为一个空对象。也就是说子类是完全可以不做任何事的,子类只负责自己的数据构造和行为覆盖或追加,events在和监听器绑定之后就是一个Ext.util.Event对象的容器,见这行代码: me.events[eventName] = ce = new EXTUTIL.Event(me, eventName);也就是说,在Ext中,一个活生生的能够响应事件的对象有一个Event容器,它保存了这个对象可以响应什么事件以及事件被触发后被调用的监听器。

Observable原型上放置的方法都是子类继承的方法,子类的对象就可以在运行时调用这些方法,如下:

原型上放置了一个静态变量和一些方法,这些方法都是和事件以及监听有关,注意Observable的原型是一个新的对象直接量,它的constructor属性肯定指向的是Object,不是指向的Observable,这岂不是存在bug,我通过代码检测发现alert(Ext.util.Observable.prototype.constructor == Ext.util.Observable);的结果确实又是true,怎么回事呢?答案就在Ext.extend的那段防御性代码,大家回过去看看吧!

现在我们写一个继承Obervable的类,不过不是UI组件,而是一个领域模型,比如论坛帖子,它在被修改之后会跑出一个被修改的事件,监听器捕获这个事件将修改保存到数据库中,代码如下:

  1.  
  1. ForumThread = Ext.extend(Ext.util.Observable, {
  2. constructor: function(config) {
  3. this.name = config.name;
  4. //把监听器放进超类的属性
  5. this.listeners = config.listeners;
  6.  
  7. this.events = {"change" : true};
  8.  
  9. //给领域模型设置事件,通过上面的写法也可以
  10. /* this.addEvents({
  11. "change" : true
  12. });*/
  13.  
  14. //调用超类构造超类不变量
  15. ForumThread.superclass.constructor.call(this, config)
  16. },
  17. //领域行为,会触发事件
  18. changeName : function(newName) {
  19. alert("原主题名字是:" + this.name);
  20. this.name = newName;
  21. alert("更改后主题名字是:" + this.name);
  22. this.fireEvent("change", this);//触发事件
  23. }
  24. });
  25.  
  26. Ext.onReady(function() {
  27. var forumThread = new ForumThread({
  28. name : '关于将Jdon框架提升为DCI框架的设想',
  29. //构造领域模型时注入监听处理程序
  30. listeners : {
  31. change : function(thread) {
  32. alert('接受到事件,将异步保存新的名字:' + thread.name);
  33. }
  34. }
  35. });
  36. //领域行为调用
  37. forumThread.changeName("关于将Jdon框架提升为DCI框架的设想,整合JdonMVC");
  38. });

如果事件设置和监听绑定直接在子类完成,那么就不必显式调超类构造函数

  1.  
  1. ForumThread = Ext.extend(Ext.util.Observable, {
  2. constructor: function(config) {
  3. this.name = config.name;
  4. this.events = {"change" : true};
  5. this.on(config.listeners);
  6. },
  7. //领域行为,会触发事件
  8. changeName : function(newName) {
  9. alert("原主题名字是:" + this.name);
  10. this.name = newName;
  11. alert("更改后主题名字是:" + this.name);
  12. this.fireEvent("change", this);//触发事件
  13. }
  14. });

写的真的很详细,真心赞一个,大家慢慢看吧

解读sencha touch移动框架的核心架构(二)的更多相关文章

  1. 解读sencha touch移动框架的核心架构(一)

    sencha的前身就是Extjs了,sencha 框架是世界上第一个基于HTML5的Mobile App框架 那么何谓框架,传统软件工程对于库和框架的区分主要着眼于对应用运行流程的控制权,框架提供架构 ...

  2. sencha touch 入门学习资料大全(2015-12-30)

    现在sencha touch已经更新到2.4.2版本了 重新整理一下资料 官方网站:http://www.sencha.com/products/touch/ 在线文档:http://docs.sen ...

  3. 【PHP】用了这么久的Laravel框架,你分析过核心架构了没

    Laravel最初的设计是为了面向MVC架构的,它可以满足如事件处理.用户身份验证等各种需求.另外它还有一个由管理数据库强力支持,用于管理模块化和可扩展性代码的软件包管理器. Laravel以其简洁. ...

  4. sencha touch 入门系列 (五)sencha touch运行及代码解析(上)

    由于最近项目比较忙,加之还要转战原生开发,所以很久没更新了,今天我们接着上一次的内容往下讲: 首先我们打开index.html,这是我们整个程序的访问入口,也是整个项目的引入地: <!DOCTY ...

  5. sencha touch 框架的几种核心脚本文件之间的区别

    sencha-touch-debug.js      供开发时用sencha-touch.js   供发布时用sencha-touch-all.js All     供不能使用SDK构建应用程序时,将 ...

  6. 动端逐渐出了许多的移动端的框架,比如Sencha Touch、JQTouch、Jquery-moblie、jqMobi等等。这些框架都有优缺点,不同的框架应用在不同的项目中。现简单阐述一下各框架的优缺点:

    移动前端工作的那些事---前端制作之微信小技巧篇   (2013-11-15 15:20) 转载▼ 标签: it css3/javascript html5 webapp 手机网站搭建 分类: 前端制 ...

  7. 移动Web框架:jQuery Mobile VS Sencha Touch

    最近常被问到是用 jQuery Mobile还是Sencha Touch,本人也比较关注这两个框架,试图从以下两方面发表点儿见解: 身家背景,都系出名门 1.jQuery Mobile 建立在jQue ...

  8. 跟我一起玩转Sencha Touch 移动 WebApp 开发(一)

    1.目录 移动框架简介,为什么选择Sencha Touch? 环境搭建 创建项目框架,框架文件简介 创建简单Tabpanel案例 自定义图标的方式 WebApp产品测试和发布 HTML5离线缓存 发布 ...

  9. (转)Sencha Touch和jQuery Mobile的比较

    原文:http://extjs.org.cn/node/664 Sencha Touch和jQuery Mobile的比较 Posted 周三, 08/07/2013 - 10:07 by admin ...

随机推荐

  1. 闲来无事,写个基于TCP协议的Socket通讯Demo

    .Net Socket通讯可以使用Socket类,也可以使用 TcpClient. TcpListener 和 UdpClient类.我这里使用的是Socket类,Tcp协议. 程序很简单,一个命令行 ...

  2. [8.3] Magic Index

    A magic index in an array A[0...n-1] is defined to be an index such that A[i] = i. Given a sorted ar ...

  3. js前端模块化之加载器原理解析(一)

    先来说一下前端模块化的价值:引用模块此处有详细的介绍,可以自行前往观看. 一.总结如下优点: (1)解决命名冲突(2)烦琐的文件依赖(3)模块的版本管理(4)提高可维护性(5)前端性能优化(6)跨环境 ...

  4. Angular初步

    一.angular.js是什么? angular.js是一个javascript的框架,与jquery是一个级别的,区别是jquery主要是擅长dom操作,而angular主要是擅长绑定数据显示数据. ...

  5. 前端页面开发,最低兼容IE 8的多设备跨平台问题解决!

    项目要求: 网站能够使用PC.ipad.mobile phone正常访问 页面PSD版式宽度分别为1024px和750px 参考资料 使用CSS3 Media Queries,其作用就是允许添加表达式 ...

  6. Java 清除数组相同元素

    定义一个函数清除该数组的重复元素,返回一个不能浪费长度的数组.代码如下: import java.util.*; public class demo1 { public static void mai ...

  7. Python之路第一课Day4--随堂笔记(迭代生成装饰器)

    上节回顾: 1.集合 a.关系测试 b.去重 2.文件操作及编码 3.函数 4.局部变量和全局变量 上节回顾 本节课内容: 1.迭代器生成器 2.装饰器 3.json pickle数据序列化 4.软件 ...

  8. 安装wampserver遇到,无法启动此程序,丢失MSVCR110.dll

    这个问题遇到多次了,根据网上的解决办法,下载这个动态链接库文件,安装到指定位置重启系统后还是解决不了,其实这个文件有时候是存在的也会出现这个问题.问题截图如下 其实这个我认为是系统缺少了相关组组件的安 ...

  9. bzoj3631: [JLOI2014]松鼠的新家(LCA+差分)

    题目大意:一棵树,以一定顺序走完n个点,求每个点经过多少遍 可以树链剖分,也可以直接在树上做差分序列的标记 后者打起来更舒适一点.. 具体实现: 先求x,y的lca,且dep[x]<dep[y] ...

  10. oracle 全文检索创建脚本示例

    --创建全文索引 grant execute on ctx_ddl to username;--使用其他帐号对username授权exec ctx_ddl.create_preference('my_ ...