打造一款代码命名工具的详细教程

 更新时间:2020年09月01日 08:50:33   作者:JadePeng  
这篇文章主要介绍了来,我们一起打造一款代码命名工具,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下

你是否还在为代码命名而纠结不已?

here are only two hard things in Computer Science: cache invalidation and naming things.-- Phil Karlton

那么如何更好的命名呢? 是否有好的工具可以支持我们命名呢?网上搜索一圈没有发现满意的,于是自己动手丰衣足食,https://jadepeng.gitee.io/code-naming-tool/

使用方法: 打开网页后,在中文输入框中输入 中文命名,然后回车即可。也可以直接在英文输入框输入英文,搜索候选。

现有的工具

unbug.github.io/codelf/ 提供了一个选择,作者先调用有道、百度等翻译,然后调用searchcode搜索代码,从搜索的代码中提取变量名。

界面做的很酷,但是推荐出来的变量名称质量参差不齐,失去了参考意义。

新的思路

我们常说以史为鉴,换一个思路,我们可以从优秀的开源库中去吸收他们命名的经验,看看他们是如何命名的,来供我们参考。

实现思路:
1. 从spring、apache等代码库,读取变量、方法、类名称
2. 根据关键词匹配出候选命名
3. 候选结果排序

获取优秀命名

要获取命名,首先想到的是读取代码库,需要先下载代码,然后解析 ———— 工作量巨大,PASS。

那怎么做呢,换个角度,可以通过java的反射来实现。

首先添加一个辅助库:

<dependency>
   <groupId>org.reflections</groupId>
   <artifactId>reflections</artifactId>
   <version>0.9.12</version>
  </dependency>

然后初始化Reflections,FilterBuilder可以用来过滤类库,我们设置"org","javax","com","io", 基本上囊库了主要的开源类库,比如spring,apache等.

 List<ClassLoader> classLoadersList = new LinkedList<ClassLoader>();
  classLoadersList.add(ClasspathHelper.contextClassLoader());
  classLoadersList.add(ClasspathHelper.staticClassLoader());

  Reflections reflections = new Reflections(new ConfigurationBuilder()
    .setScanners(new SubTypesScanner(false), new ResourcesScanner())
    .setUrls(ClasspathHelper.forClassLoader(classLoadersList.toArray(new ClassLoader[0])))
    .filterInputsBy(new FilterBuilder().includePackage("org","javax","com","io")));

然后,可以通过reflections.getSubTypesOf(Object.class);来获取相关的class了,注意,我们初始化一个 Map<String, Integer> name2count = new HashMap<String, Integer>();用来存储代码命名以及对应的出现次数。

Set<Class<? extends Object>> allClasses =
    reflections.getSubTypesOf(Object.class);
  Map<String, Integer> name2count = new HashMap<String, Integer>();
  for (Class<?> clazz : allClasses) {
   System.out.println(clazz.getName());
   try {
    appendToNameMap(name2count, clazz.getSimpleName());

    Field[] fields = clazz.getDeclaredFields();
    for (Field field : fields) {
     String name = field.getName();
     appendToNameMap(name2count, name);
    }
    Method[] methods = clazz.getMethods();
    for (Method method : methods) {
     String name = method.getName();
     appendToNameMap(name2count, name);
     // parameters
     Parameter[] parameters = method.getParameters();
     for (Parameter param : parameters) {
      name = param.getName();
      appendToNameMap(name2count, name);
     }
    }
   }catch(Throwable t)
   { }

其中appendToNameMap:

 private static void appendToNameMap(Map<String, Integer> name2count, String name) {
  // filter
  if(name.contains("-") || name.contains("_")|| name.contains("$")){
   return;
  }

  if (!name2count.containsKey(name)) {
   name2count.put(name, 1);
  } else {
   name2count.put(name, name2count.get(name) +1);
  }
 }

最后把结果存储到文件,作为我们的资源。

FileUtils.writeAllText(JSON.toJSONString(name2count), new File("name2count.txt"));

可以到https://gitee.com/jadepeng/code-naming-tool/blob/master/vars.js查看结果。

命名推荐

命名推荐,还是遵循,先翻译,然后根据翻译结果搜索并召回。

其中翻译直接调用网易有道的,但是搜索如何搞定呢?

最简单的方法,肯定是分词,然后建立索引,lucene是标配。但是上lucene就要上服务器,PASS!

我们来找一个浏览器端的lucene,google 后选定flexsearch.

flexsearch github上有6.5k star,因此优先选择。

下面来看具体的实现。

建立索引

初始化FlexSearch,然后将之前获取的代码命名建立索引。

var index = new FlexSearch({
   encode: "advanced",
   tokenize: "reverse",
   suggest: true,
   cache: true
  })
  var data = []
  var i = 0
  for (var name in names) {
   var indexName = name.replace(/([A-Z])/g, " $1")
   data[i] = {
    "name": name,
    "count": names[name]
   }
   index.add(i++, indexName)
  }

这里有个小技巧,name.replace(/([A-Z])/g, " $1") 可以将驼峰命名拆分成单词。
同时data数组会保存所有的命名和响应的出现次数。

搜索候选

先翻译,然后将翻译结果给FlexSearch搜索。

function searchFromIndex(value) {
  var results = index.search(value, 25)
 
  results = results.map(function (i) {
   return data[i]
  })
 
  results = results.sort(function (a, b) {
   return b.count - a.count
  })
  return results
 }

先搜索,出来的结果是data中的index序号,转换为list对象,然后按照count倒排。

tips: 理论上,翻译的结果可以去除一些停用词,搜索效果应该更好,这里先放着。

显示结果

对结果进行格式化:

function formatSuggestion(item){
 return `${item.name} <span class='tips'>代码库共出现${item.count}次 (相关搜索: <a target='_blank' href='https://unbug.github.io/codelf/#${item.name}'>codelf</a> &nbsp; <a target='_blank' href='https://searchcode.com/?q=${item.name}&lan=23'>searchcode</a>)</span>`;
}

增加到codelf 和 searchcode的链接,显示结果如下:

开源地址

命名工具地址: https://jadepeng.gitee.io/code-naming-tool/

总结

到此这篇关于来,我们一起打造一款代码命名工具的文章就介绍到这了,更多相关代码命名工具内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 使用java + selenium + OpenCV破解腾讯防水墙滑动验证码功能

    使用java + selenium + OpenCV破解腾讯防水墙滑动验证码功能

    这篇文章主要介绍了使用java + selenium + OpenCV破解腾讯防水墙滑动验证码,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-11-11
  • SpringBoot工程搭建打包、启动jar包和war包的教程图文详解

    SpringBoot工程搭建打包、启动jar包和war包的教程图文详解

    这篇文章主要介绍了SpringBoot工程搭建打包、启动jar包和war包的教程,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-09-09
  • java实现Api接口加密通信方式

    java实现Api接口加密通信方式

    这篇文章主要介绍了java实现Api接口加密通信方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-06-06
  • Java实现扑克牌程序

    Java实现扑克牌程序

    这篇文章主要为大家详细介绍了Java实现扑克牌程序,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-10-10
  • Spring Boot整合Mybatis Plus和Swagger2的教程详解

    Spring Boot整合Mybatis Plus和Swagger2的教程详解

    这篇文章主要介绍了Spring Boot整合Mybatis Plus和Swagger2的教程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-02-02
  • 举例讲解Java中的Stream流概念

    举例讲解Java中的Stream流概念

    这篇文章主要介绍了举例讲解Java中的Stream流概念,是Java入门学习中的基础知识,需要的朋友可以参考下
    2015-09-09
  • Spring Batch实现批量处理

    Spring Batch实现批量处理

    本文主要介绍了Spring Batch进行批量处理,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-06-06
  • java Semaphore共享锁实现原理解析

    java Semaphore共享锁实现原理解析

    这篇文章主要为大家介绍了Semaphore共享锁实现原理解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-01-01
  • Java 17 更新后的 strictfp 关键字

    Java 17 更新后的 strictfp 关键字

    strictfp 可能是最没有存在感的关键字了,很多人写了多年 Java 甚至都不知道它的存在,strictfp,字面意思就是严格的浮点型。这玩意儿居然还有个关键字,可见其地位还是很高的。下面文章小编就带大家详细介绍其关键字,需要的朋友可以参考一下
    2021-09-09
  • java多线程通过CompletableFuture组装异步计算单元

    java多线程通过CompletableFuture组装异步计算单元

    这篇文章主要为大家介绍了java多线程通过CompletableFuture组装异步计算单元,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04

最新评论