July 07, 2017

高质量代码的特征

回想起来,我觉得我们似乎在误读Uncle Bob的Clean Code,至少我们错误地将所谓Clean与可读性代码简单地划上了等号。尤为不幸的是,在Clean Code一书中,从第二章到第五章都围绕着可读性代码做文章,于是加深了这种错误的印象。

许多具有代码洁癖的程序员将代码可读性视为神圣不可侵犯的真理,并奉其为高质量代码的最重要特征,封上了“神坛”。殊不知,Uncle Bob在Clean Code的第一章就通过别人之口对所谓“Clean Code”进行了正名:所谓整洁代码并非仅仅是“清晰”这么简单。

按照Kent Beck的简单设计规则,排在第一位的其实不是可读性,而是“通过所有测试”。......

June 26, 2017

Java的ClassPath问题

在文章《Spark Submit的ClassPath问题》中,我探讨了针对spark-submit的Jar包,如何指定外部依赖的Jar包。同样的问题在本地部署时仍然存在。此时,运行Jar并不是通过spark-submit,而是通过java命令,例如:

exec java -Xmx2000m -DMORT_HOME=$MORT_HOME -Ddata-set-parquet.path=$MORT_HOME/parquet -Dconfig.file=$MORT_HOME/mort.conf -jar $MORT_HOME/target/mort.jar > $MORT_HOME/mort......

April 11, 2017

继续探索with语句

在上一篇博客《漂亮的with,鱼与熊掌可以兼得》中,展现了with的优雅之处,然而在比较with与|>时,言犹未尽,讲得不够透彻。

在那篇博客中,我说:

毕竟with/1并不是try/catch,它并不能捕获执行中抛出的错误,然后转向else进行错误处理。只有当模式匹配出现错误时,才会转向else。

要优雅地处理错误,并用优雅的with/1将逻辑串联起来,就需要重构get_user,get_response,send_response等函数。当程序逻辑正确时,返回一个tuple对象{:ok, result};如果出现错误,则返回{:error, error}。

如果进行了这样......

April 05, 2017

漂亮的with,鱼与熊掌可以兼得

假设要加载磁盘上的一个文件,并以二进制形式读取文件的数据。若要从健壮性的角度考虑,需得考虑两种异常情况:

加载文件失败,例如给定的文件路径并不存在该文件

读取文件数据失败,例如磁盘扇区有故障

显然,生活中总是存在着例外,我们不能乐观对待,还得未雨绸缪,唯有对这些异常情况做充分判断,由代码组成的软件系统才够健壮:

case File.read(path) do

{:ok, binary} ->

case :beam_lib.chunks(binary, :abstract_code) do

{:ok, data} ->

......

March 26, 2017

推行TDD的思考

我在参与的开发项目以及咨询项目中,都有实践TDD的经验。直至今日,我仍然会在某些功能开发时采用TDD的方式实现功能。虽然没有达到将TDD溶于开发血液之中形成自然而然的习惯,但至少也是我常用的编程利器之一,偶尔使用,效果还算不错。

以下内容则是我在某大型团队中推行TDD时的一些思考。当时的整个咨询过程,至少在TDD推行上可以称得上是举步维艰。如今看来,这些思考仍有现实意义。

目前看来,我在推行TDD过程,主要的障碍有如下几点:

开发人员的质量意识;

分析需求并进行任务分解的能力;

将测试作为开发起点的开发习惯;

开发人员的重构能力,包括如何识别坏味道和如何运用重构手法;

单元测试的基础设......