媒体智能电视大数据编码规范.docx

《媒体智能电视大数据编码规范.docx》由会员分享，可在线阅读，更多相关《媒体智能电视大数据编码规范.docx（19页珍藏版）》请在三一文库上搜索。

1、5.【强制】采用4个空格缩进，禁止使用tab字符。说明：如果使用tab缩进，必须设置1个tab为4个空格。IDEA设置tab为4个空格时，请勿勾选1.setabcharacter：而在ec1.ipse中，必须勾选insertspacesfortabs0正例：(涉及1-5点)pub1.icstaticvoidmain(Stringargs)/缩进4个空格Stringsay=he1.1.o；/运算符的左右必须有一个空格intf1.ag=0；/关键词if与括号之间必须有一个空格，括号内的f与左括号，0与右括号不需要空格if(f1.ag=0)System.out.print1.n(say)；/左大括号

2、前加空格且不换行；左大括号后换行if(f1.ag=1)System.out.printin(wor1.d)；/右大括号前换行，右大括号后有e1.se,不用换行e1.seSystem,out.PrintIn(ok)；/在右大括号后直接结束，则必须换行)6.【强制】注释的双斜线与注释内容之间有且仅有一个空格。正例：/这是示例注释，请注意在双斜线之后有一个空格StringparamnewString)；10 .【强制】IDE的textfi1.eencoding设置为UTF-8；IDE中文件的换行符便用UniX格式，不要使用Windows格式。11 .【单个方法的总行数不超过80行。说明：除注释之外的

3、方法签名、左右大括号、方法内代码、空行、回车及任何不可见字符的总行数不超过80行。正例：代码逻辑分清红花和绿叶，个性和共性，绿叶逻辑单独出来成为额外方法，使主干代码更加清晰；共性逻辑抽取成为共性方法，便于复用和维护。12 .没有必要增加若干空格来使变量的赋值等号与上一行对应位置的等号对齐。正例：intone=1：1.ongtwo=21.；f1.oatthree=3F；StringBuiIdersb=newStringBui1.derO:说明：增加sb这个变量，如果需要对齐，则给one.two,three都要增加几个空格，在变量比较多的情况下，是非常累赘的事情。13 .，不同逻辑、不同语义、不同

4、业务的代码之间插入一个空行分隔开来以提升可读性。说明：任何情形，没有必要插入多个空行进行隔开。(四)OoP规约1 .【强制】避免通过一个类的对象引用访问此类的静态变量或静态方法，无谓增加编译器解析成本，直接用类名来访问即可。2 .【强制】所有的覆写方法，必须加的Verride注解。说明:getbject()与getbject()的问题。一个是字母的0,一个是数字的0,加SOverride可以准确判断是否覆盖成功。另外，如果在抽象类中对方法签名进行修改，其实现类会马上编译报错。3 .【强制】相同参数类型，相同业务含义，才可以使用Java的可变参数，避免使用Object。说明：可变参数必须放置在参

5、数列表的最后。(提倡同学们尽量不用可变参数编程)上例：pub1.ic1.istIistUsers(Stringtype,1.ong.ids)4 .【强制】外部正在调用或者二方库依赖的接口，不允许修改方法签名，避免对接口调用方产生影响。接口过时必须加如CPreCaIed注解，并清晰地说明采用的新接口或者新服务是什么。5 .【强制】不能使用过时的类或方法。说明：.UR1.Decoder中的方法decode(StringencodeStr)这个方法已经过时，应该使用双参数decode(Stringsource.Stringencode)接口提供方既然明确是过时接口，那么有义务同时提供新的接口；作为调

6、用方来说，有义务去考证过时方法的新实现是什么。6 .【强制】ObjeCt的equa1.s方法容易批空指针异常，应使用常量或确定有值的对象来调用equa1.s正例:test,equa1.s(object)；反例:object,equa1.s(test)；说明:推荐使用java.uti1.Objectstfequa1.s(JDK7引入的工具类)。7 .【强制】所有整型包装类对象之间值的比较，全部使用equa1.s方法比较。说明：对于Integervar=?在-128至127范围内的赋值，Integer对象是在IntegerCache.cache产生，会复用已有对象，这个区间内的Integer值可以

7、直接使用=进行判断，但是这个区间之外的所有数据，都会在堆上产生，并不会复用已有对象，这是一个大坑，推荐使用equa1.s方法进行判断。8 .【强制】浮点数之间的等值判断，基本数据类型不能用=来比较，包装数据类型不能用equa1.s来判断。说明：浮点数采用“尾数+阶码”的编码方式，类似于科学计数法的“有效数字+指数”的表示方式。二进制无法精确表示大部分的十进制小数，具体原理参考码出高效。反例：f1.oata1.0f-0.9f；f1.oatb=0.9f-0.8f：if(a=b)/预期进入此代码快，执行其它业务逻辑/但事实上a=b的结果为fa1.seF1.oatxF1.oat.va1.ue1.ia：

8、F1.oatyF1.oat.va1.*0f1b)：ix.equa1.s：y：)(/预期进入此代码快，执行其它业务逻辑/但事实上equa1.s的结果为fa1.se)正例：(1)指定一个误差范围，两个浮点数的差值在此范围之内，则认为是相等的。f1.oata1.0f0.9f；f1.oatb0.9f-0.8f;f1.oatdiff1.e-6f:ifMath,absab)diff;Systemout.printin：true)：(2)使用BigDecima1.来定义值，再进行浮点数的运算操作。BigDecima1.anewBigDecima1.1.0)：BigDecima1.bnewBigDecima

9、1.0.9)：BigDewBigDecima1.0.8：BigDecima1.x=a.subtractgeneratetoString时，如果继承了另一个POJO类，注意在前面加一下super.toStringo说明:在方法执行抛出异常时，可以直接调用POJO的toString()方法打印其属性值，便于排查问题。16 .【强制】禁止在POJO类中，同时存在对应属性XXX的isXxx()和getXxx()方法。说明：框架在调用属性XXX的提取方法时，并不能确定哪个方法一定是被优先调用到。17 .使用索引访问用String的sp1.it方法得到的数组时，需做最后一个分幅符后有无内容的检查，否则会有

10、把IndeXOUtofBOUndSEXCePtiOn的风险。说明：Stringstr=atb,c,；String11ary=str.sp1.it(,)；/7于员期大于3,行果是3System,out.printin(ary.1.ength)：18 .【当一个类有多个构造方法，或者多个同名方法，这些方法应该按顺序放置在一起，便于阅读，此条规则优先于下一条。19 .I类内方法定义的顺序依次是：公有方法或保护方法私有方法getter/setter方法。说明：公有方法是类的调用者和维护者最关心的方法，首屏展示最好；保护方法虽然只是子类关心，也可能是“模板设计模式”下的核心方法；而私有方法外部一般不需要

11、特别关心，是一个黑盒实现；因为承载的信息价值较低，所有Service和DO的getter/setter方法放在类体最后。20 .】setter方法中，参数名称与类成员变量名称一致，this.成员名=参数名。在getter/Setter方法中，不要增加业务逻辑，增加排查问题的难度。说明：对象c1.one方法默认是浅拷贝，若想实现深拷贝需覆写C1.one方法实现域对象的深度遍历式拷贝。24. t类成员与方法访问控制从严：1 ）如果不允许外部直接通过new来创建对象，那么构造方法必须是privateo2）工具类不允许有pub1.ic或defau1.t构造方法。3）类非static成员变量并且与子类共

12、享，必须是protectedo4）类非static成员变量并且仅在本类使用，必须是privateo5）类static成员变量如果仅在本类使用，必须是privateo6）若是static成员变量，考虑是否为fina1.。7）类成员方法只供类内部调用，必须是PriVateI）8）类成员方法只对继承类公开，那么限制为protected.说明：任何类、方法、参数、变量，严控访问范围。过于宽泛的访问范围，不利于模块解耦。思考：如果是一个private的方法，想删除就删除，可是一个pub1.ic的service成员方法或成员变量，删除一下，不得手心冒点汗吗？变量像自己的小孩，尽量在自己的视线内，变量作用域

13、太大，无限制的到处跑，那么你会担心的。（五）集合处理1.【强制】关于hashCode和equa1.s的处理，遵循如不规则：1）只要覆写equa1.s,就必须覆写hashCode02）因为Set存储的是不重复的对象，依据hashCode和equa1.s进行判断，所以Set存储的对象必须榄写这两个方法。3）如果自定义对象作为Map的键，那么必须覆写IiashCode和equa1.so说明：String已覆写hashCode和equa1.s方法，所以我们可以愉快地使用String对象作为key来使用。2.【强制】Array1.iSt的SUb1.iSt结果不可强转成Array1.ist,否则会抛出C1

14、assCastException异常，即java.uti1.RandomAccessSub1.istcannotbecasttojava.uti1.Array1.isto说明：sub1.ist返回的是Array1.iSt的内部类Sub1.ist,并不是Array1.iSt而是Array1.ist的一个视图，对于Sub1.ist子列表的所有操作最终会反映到原列表上。8 .【强制】使用工具类ArrayS.as1.ist()把数组转换成集合时，不能使用其修改集合相关的方法，它的add/remove/cIear方法会抛出UnsupportedOperatiOnException异常。说明：as1.i

15、st的返回对象是一个Arrays内部类，并没有实现集合的修改方法。Arrays.as1.ist体现的是适配器模式，只是转换接口，后台的数据仍是数组。Stringstr=newString,yang,hao；1.ist1.ist=Arrays.as1.ist(str)；第一种情况：1.ist,addCyangguanbao)；运行时异常。第二种情况：str01=changed；也会随之修改，反之亦然。9 .【强制】泛型通配符?extendsT来接收返回的数据，此写法的泛型集合不能使用add方法，而?superT不能使用get方法，作为接口调用赋值时易出错。说明：扩展说一下PECS(Produce

16、rExtendsConsumerSUPer)原则：第一、频繁往外读取内容的，适合用?extendsTo第二、经常往里插入的，适合用?superT10 .【强制】在无泛型限制定义的集合赋值给泛型限制的集合时，在使用集合元素时，需要进行instanceof判断，避免抛出C1.assCastException异常。说明：毕竟泛型是在JDK5后才出现，考虑到向前兼容，编译器是允许非泛型集合与泛型集合互相赋值。反例：1.istStringgenericsnu1.1.1.istRotGenericsnewArray1.ist10；notGenericsaddnewObject1)：notGenerics.

17、addnewInteger11：genericsnotGenerics：/此处抛出C1.assCastException异常Stringstringgenerics.get1O：11 .【强制】不要在foreach循环里进行元素的remove/add操作。remove元素请使用Iterator方式，如果并发操作，需要对IteratOr对象加锁。nameprefixBromUserThreadFactory1S-WhatFeaturOfGroup+-Worker-：OverridepubicThreadnewThr111.)；ThreadthreadnewThreadnu1.1.,task.na

18、me.O,fa1.se)：Systemout.printInithreadgetName：)；returnthread；)3 .【强制】线程资源必须通过线程池提供，不允许在应用中自行显式创建线程。说明：线程池的好处是减少在创建和销毁线程上所消耗的时间以及系统资源的开销,解决资源不足的问题。如果不使用线程池，有可能造成系统创建大量同类线程而导致消耗完内存或者“过度切换”的问题。4 .【强制】线程池不允许使用Executors去创建，而是通过ThreadPoo1.Executor的方式，这样的处理方式让写的同学更加明确线程池的运行规则，规避资源耗尽的风险。说明：Executors返回的线程池对象的

19、弊端如下：1)FixedThreadPoo1.和Sing1.eThreadPoo1.：允许的请求队列长度为Integer.MAXJtA1.UE,可能会堆积大量的请求，从而导致OoMo2)CachedThreadPoo1：允许的创建线程数量为IntegerNAXVA1.UE,可能会创建大量的线程，从而导致OOMo5.【强制】SinIPIeDateFOrmat是线程不安全的类，一般不要定义为static变量，如果定义为static,必须加锁，或者使用DateUtiIS工具类。正例：注意线程安全，使用DateUti1.s0亦推荐如下处理：锁方法与try代码块之间没有任何可能抛出异常的方法调用，避免加

20、锁成功后，在fina1.1.y中无法解锁。说明一：如果在1.ock方法与try代码块之间的方法调用抛出异常，那么无法解锁，造成其它线程无法成功获取锁。说明二：如果1.ock方法在try代码块之内，可能由于其它方法抛出异常，导致在fina1.1.y代码块中，un1.ock对未加锁的对象解锁，它会调用AQS的IryRCIeaSe方法(取决于具体实现类)，抛出11Iega1.MonitorStateException异常。说明三：在1.ock对象的1.ock方法实现中可能抛出unchecked异常，产生的后果与说明二相同。正例：1.ock1.ock=newXxx1.ockO；/.1.ock,1.oc

21、k()；trydoSomething()；doOthers()；fina1.1.y1.ock,un1.ock()；反例：)1.ock1.ock=newXxx1.ockO;/.try/如果此处抛出异常，则直接执行fina1.1.y代码块doSomething()；/无论加锁是否成功，fina1.1.y代码块都会执行1.ock,1.ock()；doOthers()；fina1.1.y13. 资金相关的金融敏感信息，使用悲观锁策略I;说明：乐观锁在获得锁的同时巳经完成了更新操作，校验逻辑容易出现漏洞，另外，乐观锁对冲突的解决策略有较复杂的要求，处理不当容易造成系统压力或数据异常，所以资金相关的金融敏

22、感信息不建议使用乐观锁更新。14. 使用Coun1.Down1.atch进行异步转同步操作，每个线程退出前必须调用CountDown方法，线程执行代码注意catch异常，确保CountDown方法被执行到，避免主线程无法执行至await方法，直到超时才返回结果。说明：注意，子战程抛出异常堆栈，不能在主线程Ey-Catch至九15. 避免Random实例被多线程使用，虽然共享该实例是线程安全的，但会因竞争同一seed导致的性能下降。说明：Random实例包括java,utiI.Random的实例或者Math.randomO的方式O王例：在JDK7之后，可以直接使用APIThread1.oca1R

23、andom,而在JDK7之前，需要编码保证每个线程持有一个实例。16. 在并发场景下，通过双重检查锁(doub1.e-checked1.ocking)实现延迟初始化的优化问题隐患(可参考TheDoub1.e-Checked1.ockingisBrokenDec1.aration),推荐解决方案中较为简单一种(适用于JDK5及以上版本)，将目标属性声明为vo1.ati1.e型。反例：pub1.icc1.ass1.azyInitDemo.privateHe1.perhe1.per=nu1.1.；pub1.icHe1.pergetHe1.per()if(he1.per=nu1.1)synchroni

24、zed(this)if(he1.per=nu1.1.)he1.per=newHe1.pcrO;)returnhe1.per；/othermethodsandfie1.ds.)反例：pub1.icfina1.voidacquire(1.ongarg)if(!trycquire(arg)&acquireQueued(addWaiter(Node.EXC1.USIVE),arg),Se1.fInterruptO;)7 .不要在其它表达式(尤其是条件表达式)中，插入赋值语句。说明：赋值点类似于人体的穴位，对于代码的理解至关重要，所以赋值语句需要清晰地单独成为一行。反例：pub1.ic1.ockget1

25、ock(boo1.eanfair)(/算术表达式中出现求值操作，容易忽略gun1.值已经被改变thresho1.d=(count=Integer.MAXVA1.UE)-1：/条件表达式中出现赋值操作，容易误认为是sync=fairreturn(sync=fair)?newFairSyncO：newNonfairSyncO；8 .循环体中的语句要考量性能，以下操作尽量移至循环体外处理，如定义对象、变量、获取数据库连接，进行不必要的try-catch操作(这个try-catch是否可以移至循环体外)。9 .J避免采用取反逻辑运算符。说明：取反逻辑不利于快速理解，并且取反逐辑写法必然存在对应的正向

26、逻辑写法。正例：使用if(x=628)来表达X小于628o10 .【接口入参保护，这种场景常见的是用作批量操作的接口。11 .【参考】下列情形，需要进行参数校验：1)调用频次低的方法。2)执行时间开销很大的方法。此情形中，参数校验时间几乎可以忽略不计，但如反例：“TCP连接超时”解释成“传输控制协议连接超时”，理解反而费脑筋。7 .代码修改的同时，注释也要进行相应的修改，尤其是参数、返回值、异常、核心逻辑等的修改。说明：代码与注释更新不同步，就像路网与导航软件更新不同步一样，如果导航软件严重滞后，就失去了导航的意义。8 .【参考】谨慎注释掉代码。在上方详细说明，而不是简单地注释掉。如果无用,则

27、删除。说明：代码被注释掉有两种可能性：1）后续会恢复此段代码逻辑。2）永久不用。前者如果没有备注信息，难以知晓注释动机。后者建议直接删掉（代码仓库已然保存了历史代码）。9 .【参考】对于注释的要求：第一、能够准确反映设计思想和代码逻辑：第二、能够描述业务含义，使别的程序员能够迅速了解到代码背后的信息。完全没有注释的大段代码对于阅读者形同天书，注释是给自己看的，即使隔很长时间，也能清晰理解当时的思路；注释也是给继任者看的，使其能够快速接替自己的工作。10 .【参考】好的命名、代码结构是自解释的，注释力求精简准确、表达到位。避免出现注释的一个极端：过多过滥的注释，代码的逻辑一旦修改，修改注释是相当

28、大的负担。反例：门pute1.ephantintofridgeput（e1.ephant,fridge）；方法名put,加上两个有意义的变量名e1.ephant和fridge,已经说明了这是在干什么，语义清晰的代码不需要额外的注释。11 .【参考】特殊注释标记，请注明标记人与标记时间。注意及时处理这些标记，通过标记扫描，经常清理此类标记。线上故障有时候就是来源于这些标记处的代码。1）待办事宜（TODo）：（标记人，标记时间，预计处理时间）表示需要实现，但目前还未实现的功能。这实际上是一个JaVadOC的标签，目前的JaYadoC还没有实现，但已经被广泛使用。只能应用于类，接口和方法（因为它是一

29、个JaVadoC标签）。2）错误，不能工作（FIXME）：（标记人，标记时间，预计处理时间）在注释中用FIXME标记某代码是错误的，而且不能工作，需要及时纠正的情况。7 .不要在视图模板中加入任何复杂的逻辑。说明：根据MVC理论，视图的职责是展示，不要抢模型和控制器的活。8 .:任何数据结构的构造或初始化，都应指定大小，避免数据结构无限增长吃光内存。9 .及时清理不再使用的代码段或配置信息。说明：对于垃圾代码或过时配置，坚决清理干净，避免程序过度腌肿，代码冗余。正例：对于暂时被注释掉，后续可能恢复使用的代码片断，在注释代码上方，统一规定使用三个斜杠(/)来说明注释掉代码的理由。二、异常日志(一

30、)异常处理1 .【强制】JaVa类库中定义的可以通过预检查方式规避的RuntimeException异常不应该通过CatCh的方式来处理，比如：NU1.1.POinterEXCeP1.iOn,IndexOutOfBoundsException等等。说明：无法通过预检查的异常除外，比如，在解析字符串形式的数字时，可能存在数字格式错误，不得不通过catchNuinberFormatException来实现。正例:if(obj!=nu1.1.).反例：tryIobj.method()；catch(Nu1.IPoiDterExcep1.ione),!,2 .【强制】异常不要用来做流程控制，条件控制。说

31、明：异常设计的初衷是解决程序运行中的各种意外情况，且异常的处理效率比条件判断方式要低很多。3 .【强制】Ca1.Ch时请分清稳定代码和非稳定代码，稳定代码指的是无论如何不会出错的代码。对于非稳定代码的Cateh尽可能进行区分异常类型，再做对应的异常处理。说明：对大段代码进行try-catch,使程序无法根据不同的异常做出正确的应激反应，也不利于定位问题，这是一种不负责任的表现。正例：用户注册的场景中，如果用户输入非法字符，或用户名称已存在，或用户输入密码过于简单，在程2 )对SerViCe层通用能力的下沉，如缓存方案、中间件通用处理。3)与DAO层交互，对多个D0的组合复用。DAO层:数据访问

32、层，与底层MySQ1.,Orac1.e,Hbase等进行数据交互。外部接口或第三方平台：包括其它部门RPC开放接口，基础平台，其它公司的HTTP接H。3 .【参考】(分层异常处理规约)在DAO层，产生的异常类型有很多，无法用细粒度的异常进行catch,使用catch(Exceptione)方式，并thrownewDAOException(e),不需要打印日志，因为日志在ManagerZService层一定需要捕获并打印到日志文件中去，如果同台服务器再打日志，浪费性能和存储。在Service层出现异常时，必须记录出错日志到磁盘，尽可能带上参数信息，相当于保护案发现场。如果Manager层与Ser

33、vice同机部署，日志方式与DAO层处理一致，如果是单独部署,则采用与Service一致的处理方式。Web层绝不应该继续往上抛异常，因为已经处于顶层，如果意识到这个异常将导致页面无法正常渲染，那么就应该直接跳转到友好错误页面，加上用户容易理解的错误提示信息。开放接口层要将异常处理成错误码和错误信息方式返回。4 .【参考】分层领域模型规约：DO(DataObject)：此对象与数据库表结构对应，通过DAO层向上传输数据源对象。DTO(DataTransferObject)：数据传输对象，Service或Manager向外传输的对象。BO(BusinessObject)：业务对象，由Service

34、层输出的封装业务逻辑的对象。AO(App1.icationObject)：应用对象，在Web层与SerViCe层之间抽象的复用对象模型，极为贴近展示层，复用度不高。VO(ViewObject)：显示层对象，通常是Web向模板渲染引擎层传输的对象。Query：数据查询对象，各层接收上层的查询请求。注意超过2个参数的查询封装，禁止使用Map类来传输。(二)二方库依赖1 .【强制】定义GAV遵从以下规则:1） GroupID格式：Com.公司/BU.业务线.子业务线,最多4级。说明:公司BU例如:a1.ibaba/taobao/tma1.1/a1.iexpress等BU一级;子业务线可选。IF例：c

35、om.taobao.jstorm或com.a1.ibaba,dubbo.register2） ArtifaCt1.D格式：产品线名-模块名。语义不重里不遗漏，先到中央仓库去查证一下。正例：dubbo-c1.ient/fastjson-api/jstor11-too1.3） Version：详细规定参考下方。2 .【强制】二方库版本号命名方式：主版本号.次版本号.修订号1）主版本号：产品方向改变，或者大规模API不兼容，或者架构不兼容升级。2）次版本号：保持相对兼容性，增加主要功能特性，影响范围极小的AP1.不兼容修改。3）修订号：保持完全兼容性，修复BUG、新增次要功能特性等。说明：注意起始版

36、本号必须为：1.0.0,而不是0.0.1,正式发布的类库必须先去中央仓库进行查证，使版本号有延续性，正式版本号不允许覆盖升级。如当前版本：1.3.3,那么下一个合理的版本号：1.3.4或1.4.0或2.0.03 .【强制】线上应用不要依赖SNAPSHOT版本（安全包除外）。说明：不依赖SNAPSHOT版本是保证应用发布的暴等性。另外，也可以加快编译时的打包构建。4 .【强制】二方库的新增或升级，保持除功能点之外的其它jar包仲裁结果不变。如果有改变，必须明确评估和验证。说明：在升级时，进行dependency：reso1.ve前后信息比对，如果仲裁结果完全不一致，那么通过dependency：

37、tree命令，找出差异点，进行exc1.ude排除jar包。5 .【强制】二方库里可以定义枚举类型，参数可以使用枚举类型，但是接口返回值不允许使用枚举类型或者包含枚举类型的POJO对象。6 .【强制】依赖于一个二方库群时，必须定义一个统一的版本变量，避免版本号不一致。说明：依赖springframework-core,-context,-beans,它们都是同一个版本，可以定义一个变量来保存版本：$SPring.version）,定义依赖的时候，引用该版本。7 .【强制】禁止在子项目的pom依赖中出现相同的GroupId,相同的ArtifactId,但是不同的Version0说明：在本地调试时

38、会使用各子项目指定的版本号，但是合并成一个war,只能有一个版本号出现在最后的Iib目录中。可能出现线下调试是正确的，发布到线上却出故障的问题。1.1 ）底层基础技术框架、核心数据管理平台、或近硬件端系统谨慎引入第三方实现。9 .所有pom文件中的依赖声明放在dependencies语句块中，所有版本仲裁放在CdependencyManagement）语句块中。说明：VdependencyManagemenD里只是声明版本，并不实现引入，因此子项目需要显式的声明依赖，version和scope都读取自父pom0而dependencies）所有声明在主pom的dependencies里的依赖都会

39、自动引入，并默认被所有的子项目继承。10 .：二方库不要有配置项，最低限度不要再增加配置项。11 .【参考】为避免应用二方库的依籁冲突问题，二方库发布者应当遵循以下原则:1）精简可控原则，移除一切不必要的Ap1.和依赖，只包含ServiceAPI,必要的领域模型对象、Uti1.s类、常量、枚举等。如果依赖其它二方库，尽量是provided引入，让二方库使用者去依赖具体版本号；无1.og具体实现，只依赖日志框架。2）稳定可追溯原则,每个版本的变化应该被记录，二方库由谁维护，源码在哪里,都需要能方便查到。除非用户主动升级版本，否则公共二方库的行为不应该发生变化。（三）服务器1. 高并发服务器建议调

40、小TCP怖议的time_wait超时时间。说明：操作系统默认240秒后，才会关闭处于time_wait状态的连接，在高并发访问下，服务器端会因为处于time_wait的连接数太多，可能无法建立新的连接，所以需要在服务器上调小此等待值。壬瓦：在IinUX服务器上请通过变更etcsysct1.conf文件去修改该缺省值（秒）：net.ipv4.tcp_fin_timeout=302. 调大服务器所支持的最大文件句柄数（FiIeDescriptor,简写为fd）O说明：主流操作系统的设计是将TCP/UDP连接采用与文件一样的方式去管理，即一个连接对应于一个fd主流的IinUX服务器默认所支持最大fd

41、数量为1024,当并发连接数很大时很容易因为fd不足而出现“opentoomanyfi1.es错误，导致新的连接无法建立。建议将IinUX服务器所支持的最大句柄数调高数倍（与服务器的内存数量相关）。3. r1给JVM环境参数设置-XX：+HCaPDUmPonOUtOMemoryError参数，让JVM碰到OOv场景时输出dump信息。说明：OOM的发生是有概率的，甚至相隔数月才出现一例，出错时的堆内信息对解决问题非常有帮助。4. 】在线上生产环境，JVM的XmS和XmX设置一样大小的内存容量，避免在GC后调整堆大小带来的压力。5. 参考服务器内部重定向使用forward；外部重定向地址使用UR

42、1.拼装工具类来生成，否则会带来UR1.维护不一致的问题和潜在的安全风险。七、设计规约1 .【强制】存储方案和底层数据结构的设计获得评审一致通过，并沉淀成为文档。说明：有缺陷的底层数据结构容易导致系统风险上升，可扩展性下降，重构成本也会因历史数据迁移和系统平滑过渡而陡然增加，所以，存储方案和数据结构需要认真地进行设计和评审，生产环境提交执行后，需要进行d。UbIeCheck。正低：评审内容包括存储介质选型、表结构设计能否满足技术方案、存取性能和存储空间能否满足业务发展、表或字段之间的辩证关系、字段名称、字段类型、索引等；数据结构变更（如在原有表中新增字段）也需要进行评审通过后上线。2 .【强制

43、在需求分析阶段，如果与系统交互的User越过一类并且相关的UserCase超过5个，使用用例图来表达更加清晰的结构化需求。3 .【强制】如果某个业务对象的状态超过3个，使用状态图来表达并且明确状态变化的各个触发条件I）说明：状态图的核心是对象状杰，首先明确对象有多少种状态,然后明确两两状态之间是否存在直接转换关系，再明确触发状态转换的条件是什么。正例：淘宝订单状态有已下单、待付款、已付款、待发货、已发货、已收货等。比如已下单与已收货这两种状态之间是不可能有直接转换关系的。4 .【强制】如果系统中某个功能的调用链路上的涉及对象超过3个，使用时序图来表达并且明确各调用环节的输入与输出。说明：时序

44、图反映了一系列对象间的交互与协作关系，清晰立体地反映系统的调用纵深链路。5 .【强制】如果系统中模型类超过5个，并且存在复杂的依赖关系，使用类图来表达并且明确类之间的关系。说明：类图像建筑领域的施工图，如果搭平房，可能不需要，但如果建造蚂蚁Z空间大楼，肯定需要详细的施工图。6 .【强制】如果系统中超过2个对象之间存在协作关系，并且需要表示复杂的处理流程，使用活动图来表示。说明：活动图是流程图的扩展，增加了能够体现协作关系的对象泳道，支持表示并发等。7 .：需求分析与系统设计在考虑主干功能的同时，需要充分评估异常流程与业务边界。反例：用户在淘宝付款过程中，银行扣款成功，发送绐用户扣款成功短信，但

45、是支付宝入款时由于断网演练产生异常，淘宝订单页面依然显示未付款，导致用户投诉。8 .类在设计与实现时要符合单一原则。说明：单一原则最易理解却是最难实现的一条规则，随着系统演进，很多时候，忘记了类设计的初衷。9 .谨慎使用继承的方式来进行扩展，优先使用聚合/组合的方式来实现。说明：不得已使用继承的话，必须符合里氏代换原则，此原则说父类能够出现的地方子类一定能够出现，比如，“把钱交出来”，钱的子类美元、欧元、人民币等都可以出现。10 .系统设计时，根据依赖倒置原则，尽量依赖抽象类与接口，有利于扩展与维护。说明：低层次模块依赖于高层次模块的抽象，方便系统间的解耦。11 .系统设计时，注意对扩展开放，对修改闭合。说明：极端情况下，交付线上生产环境的代码都是不可修改的，同一业务域内的需求变化，通过模块或类的扩展来实现。12 .系统设计阶段，共性业务或公共行为抽取出来公共模块、公共配置、公共类,公共方法等，避免出现重复代码或重复配置的情况。说明：随着代码的重复次数不断增加，维护成本指数级上升。13 .避免如下误解：敏捷开发=讲故事+编码+发布。说明：敏捷开发是快速交付迭代可用的系统，省略多余的设计方案，摒弃传统的审批流程，但核心关键点上的必要设计和文档沉淀是需要的。反例：某团队为了业务快速发展，敏捷成了产品经理催进度的借口，系统中均是勉强能运行但像面