Java设计和实现方法
方法签名
方法名是驼峰命名
方法名最好能说明该方法主要做什么
方法参数的名字最好能说明该参数的意义
方法参数个数最好低于6个
例如:
public void setTitleVisible(int length, String title, boolean visible ) {
//some implementation here
}
java5引入了相同类型的可变参数(不定项参数)
例如:
public void find(String ... elements) {
//some implementation here
}
在内部,java编译器将可变参数转化为数组
java5也允许可变参数为泛型,但是参数的类型不可知,java编译器为了确保参数被合理使用,建议方法声明为final,并且用@SafeVarargs注解。
例如:
@SafeVarargs
final public<T> void find(T ... elements) {
//some implementation here
}
另外一种方法
@SuppressWarnings("unchecked")
public<T> void findSuppressed(T ... elements) {
//some implementation here
}
下面展示方法签名中checked exceptions的使用,但是最近几年证实,它并没有如期望那样使用。
public void write(File file) throws IOException {
//some implementation here
}
最好标记方法参数为final,还有这种类型的方法参数可以被匿名方法访问。
方法体
最重要的一个原则:一个方法最好只实现一个功能
另一个原则:方法实现体最好比较短,一个屏幕一定要能看完
在方法体中,最好减少return语句的数量。建议仅仅只有一个return语句
方法重载
public String numberToString(Long number) {
return Long.toString(number);
}
public String numberToString(BigDecimal number) {
return number.toString();
}
方法重载有点像泛型,但是泛型有一些地方工作不太好的地方,方法重载可以很好的工作。
泛型和方法重载结合可以变得很强大,但是在java中并不经常使用。
例如:
public<T extends Number> String numberToString(T number) {
return number.toString();
} public String numberToString(BigDecimal number) {
return number.toPlainString();
}
方法重写
public class Parent {
public Object toObject(Number number) {
return number.toString();
}
} public class Child extends Parent {
@Override
public String toObject(Number number) {
return number.toString();
}
}
在子类中返回参数被改变啦,但是编译器是可以通过的。但是子类返回的参数类型必须是父类返回的参数类型的子类。
现在我们添加一个方法:
public class Child extends Parent {
public String toObject(Double number) {
return number.toString();
}
}
方法签名中(Double代替Number),但是在这种情况下,这是方法重载,并不是方法重写。
递归
例如:
public int sum(int[] numbers) {
if (numbers.length == 0) {
return 0;
} else if (numbers.length == 1) {
return numbers[0];
} else {
return numbers[0] + sum(Arrays.copyOfRange(numbers, 1,
numbers.length));
}
}
上诉方法并不是有效的实现方法,但是却很好的展示了递归。
递归存在这一个著名的问题,这个问题依赖于调用链有多深,这样会放大栈,引起StackOverflowError异常,但是事情并不总是那么坏,有一种技术可以避免stack overflows,叫做tail call optimization。如果方法是tail-recursive方法,那么这种技术会被应用。
例如:
public int sum(int initial, int[] numbers) {
if (numbers.length == 0) {
return initial;
} else if (numbers.length == 1) {
return initial + numbers[0];
} else {
return sum(initial + numbers[0],
Arrays.copyOfRange(numbers, 1, numbers.lenght));
}
}
不幸的是,现在java编译器(还有JVM JIT编译器)并不支持tail call optimization,但是仍然需要了解这种技术,当在java中写递归的时候,需要考虑。
文档方法
方法参数和返回值
文档化你的方法是很好的形式,但是并不能阻止用户输入错误的方法参数,所以,所有的公共方法都需要进行参数的验证,并不能相信用户总是输入正确的数据。
例如:
public int parse(String str) throws NumberFormatException {
if (null == str) {
throw new IllegalArgumentException("String should not be null");
} return Integer.parseInt(str);
}
在java8之前,在方法调用中,如果本次调用没有返回值,则返回null,这就是为什么Java会经常抛出NullPointerException异常,Java8使用Option<T>解决该问题。
方法作为API注意事项
使用有意义的方法名和方法参数
保持方法参数个数低于6
保持你的方法少,具有可读性
总是文档化你的公共方法,包括先决条件,例子
总是进行参数验证和sanity check
最好不要返回null值
不管什么时候,尝试涉及不变的方法
Java设计和实现方法的更多相关文章
- 《手把手教你》系列基础篇(九十七)-java+ selenium自动化测试-框架设计篇-Selenium方法的二次封装和页面基类(详解教程)
1.简介 上一篇宏哥介绍了如何设计支持不同浏览器测试,宏哥的方法就是通过来切换配置文件设置的浏览器名称的值,来确定启动什么浏览器进行脚本测试.宏哥将这个叫做浏览器引擎类.这个类负责获取浏览器类型和启动 ...
- java设计模式之工厂方法探究
简单工厂 + 工厂方法 + 抽象工厂 看了十几篇博客,每篇基本上都能有个自己的解释,我汇总这些内容,重新梳理整理了一番,以形成自己的理解. 简单工厂模式其实不算23种设计模式之 ...
- 浅谈Java中的hashcode方法
哈希表这个数据结构想必大多数人都不陌生,而且在很多地方都会利用到hash表来提高查找效率.在Java的Object类中有一个方法: 1 public native int hashCode(); 根据 ...
- atitit.java给属性赋值方法总结and BeanUtils 1.6.1 .copyProperty的bug
atitit.java给属性赋值方法总结and BeanUtils 1.6.1 .copyProperty的bug 1. core.setProperty(o, "materialId&qu ...
- 【转】浅谈Java中的hashcode方法(这个demo可以多看看)
浅谈Java中的hashcode方法 哈希表这个数据结构想必大多数人都不陌生,而且在很多地方都会利用到hash表来提高查找效率.在Java的Object类中有一个方法: public native i ...
- java设计原则:16种原则
一 类的设计原则 1 依赖倒置原则-Dependency Inversion Principle (DIP) 2 里氏替换原则-Liskov Substitution Principle (L ...
- java :equals()和hashcode()方法的结合使用
哈希表这个数据结构想必大多数人都不陌生,而且在很多地方都会利用到hash表来提高查找效率.在Java的Object类中有一个方法: 1 public native int hashCode(); 根据 ...
- Java中的大小写字母相互转换(不利用Java自带的方法)
Java中的大小写字母相互转换(不利用Java自带的方法) 1.设计源码 /** * * @title:UpperAndLower.java * @Package:com.you.utils * @D ...
- 如何重写Java中的equals方法
Java中,只有8种基本类型不是对象,例如:4种整形类型(byte, short, int,long),2种浮点类型(flout, double),boolean, char不是对象,其他的所有类型, ...
随机推荐
- IP头,TCP头,UDP头,MAC帧头定义(转)
源:IP头,TCP头,UDP头,MAC帧头定义 一.MAC帧头定义 /*数据帧定义,头14个字节,尾4个字节*/ typedef struct _MAC_FRAME_HEADER { ]; //目的m ...
- STM8建立IAR工程
STM8是意法半导体公司出的增强型八位单片机,性能比51单片机强大,而且价格便宜,在商业应用中很受欢迎 在STM8的开发工程中主要有两种开发工具链.第一是使用IAR开发环境,第二十使用cosmic+s ...
- Django中扩展Paginator实现分页
Reference:https://my.oschina.net/kelvinfang/blog/134342 Django中已经实现了很多功能,基本上只要我们需要的功能,都能够找到相应的包.要在Dj ...
- 安装pybloomfiltermmap 遇到bug
pybloomfiltermmap pip 安装 : sudo pip install pybloomfiltermmap I want to try one program which have m ...
- Bzoj3756
传送门:http://www.lydsy.com/JudgeOnline/problem.php?id=3756 题解:乱搞 代码: #include<iostream> #include ...
- 阿里CEO张勇公开信:把眼光从股市回到客户身上
8月25日消息,面对全球资本市场的剧烈波动,阿里巴巴集团CEO张勇今日发表致员工信,倡议全体阿里员工把眼光从股市回到客户身上,脚踏实地的服务帮助客户,为客户创造价值,继而为股东和自己创造价值. 张 ...
- PHP文件上传主要代码讲解
导读:在php开发过程中,文件上传也经常用到,这里简单介绍下. 在php开发过程中,文件上传也经常用到,这里简单介绍下. 代码如下: <?php if($_FILES['myfile'][ ...
- 横向子菜单栏ul根据其子元素li个数动态获取宽度,并与父li绝对垂直居中的jquery代码段
;(function(window){ $('.menuitem').hover(function(){ $('>a',this).css('background-color ...
- 【angularjs】【学习心得】路由基础篇
原文:http://www.imooc.com/wenda/detail/236998 AngularJS自带有路由模块ngRoute,但是有经验的老师都推荐我们使用功能更完善更强大的ui-route ...
- iOS 知识点
1. @dynamic.@synthesize 2. iOS NSTimer 3. iOS 之 Aggregate Target 4. iOS 属性之assign.copy.retain 5. iOS ...