分享一篇去年的项目总结

xxxTMS项目总结

追梦1819(2017-7-26)

 

背景

  今天是2019年5月13日,而这篇总结是去年7月26号写的。博主一直都有一个习惯,就是在一个项目完成时或者一个大的版本迭代后,都会对工作的方方面面进行一个总结。不过这篇总结比较特殊,公司领导要求我们写的,而博主的这篇总结,也被领导拿出来给其余同事当范例参考。当时开发的是公司的 xxxTMS 项目,项目开发不久,团队也是新组建的,大家处在一个探索期和磨合期。

  可是再回头看是,这个团队以及当时领导的管理,是我见过的效率最高和管理最好的(此处的管理是指项目管理,不涉及公司层面的行政或者人事管理)。今天拿出这篇总结,目的是提醒自己不管什么时候,都不能忘记自己的初心,同时要对自己的工作的方方面面不断思考,而不只是做一个敲代码的机器。

 

前言
  TMS本次迭代开发,我负责的模块主要有:到达确认、回单上传、回单确认、企业钱包等功能。在开发过程中,遇到了很多问题,以下是对所遇到问题的描述以及总结。

 

正文

一、问题描述

  项目开发过程中,我将所遇到的问题分为两个部分,需求理解部分(1-6)和功能实现部分(7-9)。

 

1、需求文档不够详细。下面是所遇到的几个实例。

1) 回单录入列表,应该是“有回单”且“已到达”状态,但文档只有“仅显示待回单录入的运单”几个字;

2) 到达确认的逻辑,有到付金额显示到付金额,无到付金额显示尾款,两者都无不显示,这个逻辑在需求文档中都没有;

3) 钱包注册过程中,在使用体验上来说是应该有【上一步】按钮,但是需求文档没提到,后面使我们自己加入的;

4) 检索部,为提升用户的体验效果,有的字段可以作为检索条件,比如运单编号;

 

2、部分新的需求或者新的样式到开发后期产品部才确定下来,比如钱包相关的功能,这在一定程度上同样会影响开发进度;

 

3、需求的不断变更(难以避免);

 

4、如果是调用上海那边的接口,很容易出问题,他们所给的api文档,可能不是最新的;

 

5、每个人只关注了自己的个人开发模块,对项目没有一个整体的认识,或者说与自己相关的模块都没有去了解;

 

6、业务理解得不够深刻,甚至把比较复杂的逻辑理解得很简单,导致开发后期手忙脚乱;

 

7、基本上都只是相似功能代码的复制粘贴和修改。这导致了很多问题:

1) 出现很多没用的垃圾代码;

2) 不理解所以然,会出现很多意想不到的bug;

3) 很多不规范的代码甚至错误的代码会不断“流传下去”,会进入一个恶性循环;

4) 看似相同的功能,但是实现方式不同的代码,并不能复用,更加不能简单的复制粘贴。例如系统中有很多的照片上传功能,但是实现时,有的接口是接受图片路径,有的接口直接接收图片;

 

8、框架不熟,如angular和bootstrap;

 

9、部分字段的校验被忽略。

 

二、总结

  遇到问题,我们得总结出相应的方法去解决,避免下一次掉进同样的坑。

1、关于需求理解,我一直都认为是开发过程中的重中之重。只有正确的、深刻的理解好需求,才能更好更快的进行开发,以下是关于需求理解的一些感想:

1) 尽可能细化需求文档,更深入理解,不理解的、不够详细的或者我们想到而产品部没有提到的,尽早跟产品部沟通;

2) 复杂的逻辑,尽量能画出图表,有助于理解和修正;

3) 需求的不断变更,是在任何项目开发、产品开发的过程中无法避免的。但是希望产品部的设计人员能够以书面的方式通知需求变更,然后调整相应的开发时间和测试时间。而不是仅仅口头说变就变,这样可能影响开发进度;

4) 在深入了解自己开发模块的前提下,至少要理解跟自己相关的模块,比如数据的来源的对应模块,数据的输出对应模块等。拿运单管理模块来说,运单的状态变化要了然于胸;

5) 如果是调用别人的接口,一定要保证沟通的正确性(如字段名、字段类型)、及时性(必须是最新的接口);

 

2、关于功能实现的总结

1) 在开发过程中,要善于总结,比如类似功能的代码,框架的基本使用,一些常用字段的校验等,形成自己的“代码库”,这样在后续的开发过程中会极大的提高效率;

2) 复制粘贴类似功能的代码,一定要多问几个为什么。尽量做到理解每一行代码的意义,不写无用无效的代码;

3) 所用到的框架(TMS系统主要用到了spring+hibernate(后端),bootstrap+angular(前端)),应该主动、多花时间去熟悉去学习,尽量能够做到知其然知其所以然;

 

三、后续

1、开发过程中,我们不应是为了开发而开发。要多多站在用户的角度考虑(当然,这个如果跟需求文档设计的不一致,就要先跟产品部沟通)。比如上面说到的检索部加一些比较实用的检索条件、钱包开户加【上一步】按钮等;

 

2、项目所用到的技术,要去深究,不能一直只浮在表面,不然可能会产生许多不可意料的坑。

1JAVA SE 1.1深入JAVA API 1.1.1Lang包 1.1.1.1String类和StringBuffer类 位于java.lang包中,这个包中的类使用时不用导入 String类一旦初始化就不可以改变,而stringbuffer则可以。它用于封装内容可变的字符串。它可以使用tostring()转换成string字符串。 String x=”a”+4+”c”编译时等效于String x=new StringBuffer().append(“a”).append(4).append(“c”).toString(); 字符串常量是一种特殊的匿名对象,String s1=”hello”;String s2=”hello”;则s1==s2;因为他们指向同一个匿名对象。 如果String s1=new String(“hello”);String s2=new String(“hello”);则s1!=s2; /*逐行读取键盘输入,直到输入为“bye”时,结束程序 注:对于回车换行,在windows下面,有'\r'和'\n'两个,而unix下面只有'\n',但是写程序的时候都要把他区分开*/ public class readline { public static void main(String args[]) { String strInfo=null; int pos=0; byte[] buf=new byte[1024];//定义一个数组,存放换行前的各个字符 int ch=0; //存放读入的字符 system.out.println(“Please input a string:”); while(true) { try { ch=System.in.read(); //该方法每次读入一个字节的内容到ch变量中。 } catch(Exception e) { } switch(ch) { case '\r': //回车时,不进行处理 break; case '\n': //换行时,将数组总的内容放进字符串中 strInfo=new String(buf,0,pos); //该方法将数组中从第0个开始,到第pos个结束存入字符串。 if(strInfo.equals("bye")) //如果该字符串内容为bye,则退出程序。 { return; } else //如果不为bye,则输出,并且竟pos置为0,准备下次存入。 { System.out.println(strInfo); pos=0; break; } default: buf[pos++]=(byte)ch; //如果不是回车,换行,则将读取的数据存入数组中。 } } } } String类的常用成员方法 1、构造方法: String(byte[] byte,int offset,int length);这个在上面已经用到。 2、equalsIgnoreCase:忽略大小写的比较,上例中如果您输入的是BYE,则不会退出,因为大小写不同,但是如果使用这个方法,则会退出。 3、indexOf(int ch);返回字符ch在字符串中首次出现的位置 4、substring(int benginIndex); 5、substring(int beginIndex,int endIndex); 返回字符串的子字符串,4返回从benginindex位置开始到结束的子字符串,5返回beginindex和endindex-1之间的子字符串。 基本数据类型包装类的作用是:将基本的数据类型包装成对象。因为有些方法不可以直接处理基本数据类型,只能处理对象,例如vector的add方法,参数就只能是对象。这时就需要使用他们的包装类将他们包装成对象。 例:在屏幕上打印出一个*组成的矩形,矩形的宽度和高度通过启动程序时传递给main()方法的参数指定。 public class testInteger { public static void main(String[] args) //main()的参数是string类型的数组,用来做为长,宽时,要转换成整型。 { int w=new Integer(args[0]).intValue(); int h=Integer.parseInt(args[1]); //int h=Integer.valueOf(args[1]).intValue(); //以上为三种将字符串转换成整形的方法。 for(int i=0;i<h;i++) { StringBuffer sb=new StringBuffer(); //使用stringbuffer,是因为它是可追加的。 for(int j=0;j<w;j++) { sb.append('*'); } System.out.println(sb.toString()); //在打印之前,要将stringbuffer转化为string类型。 } } } 比较下面两段代码的执行效率: (1)String sb=new String(); For(int j=0;j<w;j++) { Sb=sb+’*’; } (2) StringBuffer sb=new StringBuffer(); For(int j=0;j<w;j++) { Sb.append(‘*’); } (1)和(2)在运行结果上相同,但效率相差很多。 (1)在每一次循环中,都要先将string类型转换为stringbuffer类型,然后将‘*’追加进去,然后再调用tostring()方法,转换为string类型,效率很低。 (2)在没次循环中,都只是调用原来的那个stringbuffer对象,没有创建新的对象,所以效率比较高。 1.1.1.2System类与Runtime类 由于java不支持全局函数和全局变量,所以java设计者将一些与系统相关的重要函数和变量放在system类中。 我们不能直接创建runtime的实例,只能通过runtime.getruntime()静态方法来获得。 编程实例:在java程序中启动一个windows记事本程序的运行实例,并在该运行实例中打开该运行程序的源文件,启动的记事本程序5秒后关闭。 public class Property { public static void main(String[] args) { Process p=null; //java虚拟机启动的进程。 try { p=Runtime.getRuntime().exec("notepad.exe Property.java"); //启动记事本并且打开源文件。 Thread.sleep(5000); //持续5秒 p.destroy(); //关闭该进程 } catch(Exception ex) { ex.printStackTrace(); } } } 1.1.1.3Java语言中两种异常的差别 Java提供了两类主要的异常:runtime exception和checked exception。所有的checked exception是从java.lang.Exception类衍生出来的,而runtime exception则是从java.lang.RuntimeException或java.lang.Error类衍生出来的。    它们的不同之处表现在两方面:机制上和逻辑上。    一、机制上    它们在机制上的不同表现在两点:1.如何定义方法;2. 如何处理抛出的异常。请看下面CheckedException的定义:    public class CheckedException extends Exception    {    public CheckedException() {}    public CheckedException( String message )    {    super( message );    }    }    以及一个使用exception的例子:    public class ExceptionalClass    {    public void method1()    throws CheckedException    {     // ... throw new CheckedException( “...出错了“ );    }    public void method2( String arg )    {     if( arg == null )     {      throw new NullPointerException( “method2的参数arg是null!” );     }    }    public void method3() throws CheckedException    {     method1();    }    }    你可能已经注意到了,两个方法method1()和method2()都会抛出exception,可是只有method1()做了声明。另外,method3()本身并不会抛出exception,可是它却声明会抛出CheckedException。在向你解释之前,让我们先来看看这个类的main()方法:    public static void main( String[] args )    {    ExceptionalClass example = new ExceptionalClass();    try    {    example.method1();    example.method3();    }    catch( CheckedException ex ) { } example.method2( null );    }    在main()方法中,如果要调用method1(),你必须把这个调用放在try/catch程序块当中,因为它会抛出Checked exception。    相比之下,当你调用method2()时,则不需要把它放在try/catch程序块当中,因为它会抛出的exception不是checked exception,而是runtime exception。会抛出runtime exception的方法在定义时不必声明它会抛出exception。    现在,让我们再来看看method3()。它调用了method1()却没有把这个调用放在try/catch程序块当中。它是通过声明它会抛出method1()会抛出的exception来避免这样做的。它没有捕获这个exception,而是把它传递下去。实际上main()方法也可以这样做,通过声明它会抛出Checked exception来避免使用try/catch程序块(当然我们反对这种做法)。    小结一下:    * Runtime exceptions:    在定义方法时不需要声明会抛出runtime exception;    在调用这个方法时不需要捕获这个runtime exception;    runtime exception是从java.lang.RuntimeException或java.lang.Error类衍生出来的。    * Checked exceptions:    定义方法时必须声明所有可能会抛出的checked exception;    在调用这个方法时,必须捕获它的checked exception,不然就得把它的exception传递下去;    checked exception是从java.lang.Exception类衍生出来的。    二、逻辑上    从逻辑的角度来说,checked exceptions和runtime exception是有不同的使用目的的。checked exception用来指示一种调用方能够直接处理的异常情况。而runtime exception则用来指示一种调用方本身无法处理或恢复的程序错误。    checked exception迫使你捕获它并处理这种异常情况。以java.net.URL类的构建器(constructor)为例,它的每一个构建器都会抛出MalformedURLException。MalformedURLException就是一种checked exception。设想一下,你有一个简单的程序,用来提示用户输入一个URL,然后通过这个URL去下载一个网页。如果用户输入的URL有错误,构建器就会抛出一个exception。既然这个exception是checked exception,你的程序就可以捕获它并正确处理:比如说提示用户重新输入。 
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值