API命名，痛苦中。。。牛们给个好建议吧 <- 中国开发网

CNDEV.ORG

当前在线

论坛

CBD
- 程序员情感CBD
- 程序员见面交流会
CBD开发区
- Java/J2ME
- .NET/C#
- 数据库
- Delphi/BCB
- Visual C
其它
情感
游戏
- CNDEV-CS/WOW
- 浩宇长空
生活
论坛系统

API命名，痛苦中。。。牛们给个好建议吧

[阅读: 536] 2009-07-17 04:14:35

之前提供的API接口是
LoadKey(KeyNo, DataLen, Data...)
现在增加了一个新的接口是按名字访问，但又不能直接增加一个API叫
LoadKey(KeyName, DataLen, Data...)
那么新的接口名字叫成啥呢，或如何兼容以保证函数的清晰，以及更利于二次开发者更容易理解？

相关信息:

API命名，痛苦中。。。牛们给个好建议吧 (160字) (核弹头 [535] 2009-07-17 12:14)
- LoadKeyByName (空) (dead_lee [360] 2009-07-17 12:19)
  - 这个想过，比较好理解，不过因为有一批函数都需要增加ByName，而且有的API本来现在名字已经够长的了（接近20个字母），再加了ByName，感觉太长了吧。。。 (空) (核弹头 [409] 2009-07-17 12:23)
    - 有本书说过, 不要担心函数名称太长.. (36字) (dead_lee [422] 2009-07-17 13:16)
- LoadKey_Name (10字) (leejd [392] 2009-07-17 12:30)
  - 靠，BS用下划线的 (136字) (核弹头 [378] 2009-07-17 12:33)
    - 下划线的清晰，看代码省时间 (空) (leejd [424] 2009-07-17 12:34)
    - 是c++啊，那1不错 (39字) (haitao [491] 2009-07-17 12:51)
      - 大师，你这就错了，之前的不能变啊，否则无法兼容了 (空) (核弹头 [393] 2009-07-17 12:54)
        c++支持缺省参数，旧版本的源代码不知道有新的参数，不填，同名的新函数就按缺省值执行，效果就等于旧函数 (76字) (haitao [499] 2009-07-20 08:39)
    - LoadKey 和load_key都是2种不同的风格。*nix下的人大部分习惯用下划线，比如linux的kernel。但大小写混用再加下划线就比较讨厌了。 (空) (Water-E [442] 2009-07-17 13:04)
      - 这个同意，俺在写标准c的时候，接口命名就全部变成load_key之类的了 (空) (核弹头 [319] 2009-07-17 13:19)
    - 位置放错了。 (空) (核弹头 [353] 2009-07-17 13:21)
      - 最烦调用一些不查手册就无法调用的方法了 (19字) (dead_lee [395] 2009-07-17 13:28)
- LoadKey( GetKeyNo(KeyName), DataLen, Data...) (空) (没脾气2x [369] 2009-07-17 12:38)
  - 大王果然有想法，不过这样的定义要两次交互，不适合俺们小设备的访问的 (空) (核弹头 [365] 2009-07-17 12:53)
- LoadKeyII(Key, KeyType, DataLen, Data...) (空) (周星驰 [410] 2009-07-17 12:41)
  - 我现在纠结在LoadKey2和LoadKeyByName之间 (空) (核弹头 [337] 2009-07-17 12:55)
    - ByName (空) (holly [382] 2009-07-17 13:09)
- 或者LoadKey2009、LoadKeyXP、LoadKeyX之类的。 (空) (周星驰 [336] 2009-07-17 12:46)
- LKbyName (空) (Kaye [369] 2009-07-17 12:56)
- 考，俺觉得你现在烦恼的是走路该先迈左脚还是右脚。 (空) (Water-E [324] 2009-07-17 13:09)
  - 呵呵，可能几个相差不大，反正都是那个意思 (83字) (核弹头 [442] 2009-07-17 13:18)
- 综上，看来好像没人建议用第一个方案，请问，为什么？ (69字) (核弹头 [358] 2009-07-17 13:28)
- template <class TKey> KeyLoader: (177字) (周星驰 [672] 2009-07-17 13:57)
  - 不错, 不过如果key也是string呢... (空) (dead_lee [326] 2009-07-17 13:59)
  - 看不懂 (27字) (核弹头 [362] 2009-07-17 14:03)
    - 明显没有被大师熏陶过 (空) (oxygen [395] 2009-07-17 14:13)
  - 模板用在interface里会导致无穷无尽的兼容性问题和移植的难题. (空) (bjwf [359] 2009-07-17 14:36)
- 不会吧。不是有重构吗? (空) (leeming [341] 2009-07-17 14:23)
  - 咋个重构 (空) (核弹头 [345] 2009-07-17 14:26)
    - 写一行代码，编译几分钟 (57字) (leejd [417] 2009-07-17 14:27)
      - 这个不可能哇 (22字) (核弹头 [379] 2009-07-17 14:37)
- LoadKey(String KeyQuery, int DataLen, byet[] Data...)，LoadKey("330013", 512, data)，LoadKey…… (155字) (sealw [504] 2009-07-17 14:32)
  - 如果是Java，直接多态不就得了，好像是这个名词吧。 (95字) (核弹头 [402] 2009-07-17 14:39)
    - C++和Java一样的吧？ (空) (sealw [401] 2009-07-17 14:41)
      - 俺这个不是C++，是标准C (空) (核弹头 [341] 2009-07-17 15:04)
    - overload, C++和Java都一样 (空) (dead_lee [432] 2009-07-17 14:42)
  - 最烦调用一些不查手册就无法调用的方法了 (19字) (dead_lee [5] 今天 13:28) (空) (dead_lee [401] 2009-07-17 14:42)
    - 最烦写程序了(dead_lee [5] 今天 13:28) (空) (dead_lee [1] 今天 14:42) (空) (sealw [352] 2009-07-17 14:48)
      - 根本两回事. (60字) (dead_lee [432] 2009-07-17 14:54)
    - 别人的API，没有手册俺都不敢调。 (空) (Water-E [377] 2009-07-17 15:14)
- 你自己都说了要保证函数的清晰，以及更利于二次开发者更容易理解？ (17字) (有狐 [404] 2009-07-20 00:27)
  - .....原来是老帖 (空) (有狐 [397] 2009-07-20 00:27)
  - 不老，才几天，主要是让大伙从开发者角度来帮俺判断一下。 (56字) (核弹头 [421] 2009-07-20 00:57)
    - 麻烦一人，造福千万人，这样你的境界才高嘛 (空) (有狐 [376] 2009-07-20 13:26)
      - 重用越多的，越要考虑使用者的便利 (7字) (haitao [364] 2009-07-20 13:43)
    - 就LoadKeyABCD(key, keylen, keytype, blabla)吧 (198字) (周星驰 [408] 2009-07-20 13:47)

欢迎光临本社区，您还没有登录，不能发贴子。请在这里登录

页面内容处理时间: 0.011 - 525272