java编码规范有哪些(java编码规则)
导语:我的Java编码习惯 – 配置规范
工作中少不了要制定各种各样的配置文件,这里和大家分享一下工作中我是如何制定配置文件的,这是个人习惯,结合强大的spring,效果很不错。
=============================需求==========================
如我们现在有一个这样的配置需求,顶层是Server,有port和shutdown2个属性,包含一个service集合,service对象有name一个属性,并包含一个connector集合,connector对象有port和protocol2个属性。
我一上来不会去考虑是用xml还是json还是数据库配置,我会第一步写好对应的配置bean。如上面的需求,就写3个bean。bean和bean之间的包含关系要体现出来。(使用了lombok)
然后找一个地方先用代码产生这个bean:
然后先测试,看看是否ok。为了演示,我就直接在controller里面调用一下
测试一下,工作正常
然后进行业务代码编写,等到所有功能测试完毕,就是【开发后期】,再来定义配置文件。中途当然少不了修改格式,字段等各种修改,对于我们来说只是修改bean定义,so easy。
都ok了,再决定使用哪种配置文件。如果是json,我们这样:
==============================JSON===========================
把上面接口调用的json复制下来,报存到配置文件。
json内容
然后修改config的bean生成的代码为:
代码太简洁了,有没有?!
==============================XML===========================
如果使用XML,麻烦一点,我这里使用XStream序列化和反序列化xml。
首先在bean上增加XStream相关注解
然后修改产品文件的bean代码如下:
XMLConfig工具类相关代码:
XStream库需要增加以下依赖:
所以个人爱好,格式推荐json格式配置。
=========================编码习惯=========================
配置文件编码禁忌:
1. 读取配置的代码和业务代码耦合在一起!大忌!千万千万不要!
如下,业务代码里面出现了json的配置代码。
2. 开发初期就定配置文件
毫无意义,还导致频繁改动!先定义bean,改bean简单多了。我的习惯是转测试前一天才生成配置文件。
=============================重要============================
最主要的思想是,不要直接和配置文件发生事情,一定要有第三者(这里是配置的bean)。你可以说是中间件,中介都行。 否则,一开始说用xml配置,后面说用json配置,再后面说配置放数据库?这算不算需求变更?你们说算不算?算吗?不算吗?何必这么认真呢?只是1,2行代码的问题,这里使用xml还是json,代码修改量是2行。而且改了测试的话,写个main函数或者junit测试即可,不需要测试业务,工程都不用起,你自己算算节约多少时间。
另外,代码里面是使用spring的习惯,没有spring也是一样的,或者配置的bean你不用spring注入,而用工具类获取也是一样,区别不大。
本文内容由小萱整理编辑!