javabean名字的由来_JavaBean属性命名规范问题分析

问题由来&＃xff1a;

最近在一个java bean类中定义了一个boolean类型的变量&＃xff1a;

//boolean属性&＃xff1a;是否显示

privatebooleanisShowCode ;

//使用Eclipse自动生成getter/setter方法如下&＃xff1a;

publicbooleanisShowCode() {

returnisShowCode;

}

publicvoidsetShowCode(booleanisShowCode) {

this.isShowCode &＃61; isShowCode;

}

spring在给java bean 设置值的时候&＃xff0c; 抛出异常&＃xff1a;

Caused by: org.springframework.beans.NotWritablePropertyException:

Invalid property&＃39;isShowCode&＃39;of beanclass[com.codemouse.beans.Country]:

Bean property&＃39;isShowCode&＃39;is not writable or has an invalid setter method.

Did you mean&＃39;showCode&＃39;?

at org.springframework.beans.BeanWrapperImpl.setPropertyValue(BeanWrapperImpl.java:1064)

代码运行环境&＃xff1a; jdk 1.6 &＃43; eclipse 3.2 &＃43; spring 3.1, 本文下面的代码都在该环境下测试。

原因跟踪分析&＃xff1a;跟踪Spring源码&＃xff0c; 可以看到下面这段代码&＃xff1a;

privateCachedIntrospectionResults(Class beanClass,

booleancacheFullMetadata)throwsBeansException {

... ...

this.beanInfo &＃61;newExtendedBeanInfo(Introspector.getBeanInfo(beanClass));

... ...

}

方法Introspector.getBeanInfo(beanClass)返回的时候&＃xff0c;获取到的java bean 信息中的isShowCode属性的名称已经被改成了"showCode"。

到这里可以确定问题不是出在spring代码中&＃xff0c; 网上有不少帖子说是spring的处理规则导致了这个问题&＃xff0c;这里是不是可以否定这种看法&＃xff1f;

问题跟踪到这&＃xff0c;也即跟踪到了java.beans包。尝试继续跟踪JDK源码&＃xff0c;可能由于我的JDK的jar包和源码不匹配的原因&＃xff0c; eclipse总是监控不到中间变量。也就没有再跟踪进去了。可以知道的是&＃xff0c;javabean中 的isShowCode 属性 和 对应的getter/setter方法应该是没有遵循javabean规范。Eclipse自动生成的getter/setter方法看来也是存在一些问题的。

Eclipse自动生成boolean类型属性的方法是不是有点奇怪呢&＃xff1f; 属性 isShowCode 的getter访问器是isShowCode()而不是getIsShowCode()&＃xff0c; setter设值器是setShowCode()而不是setIsShowCode()。原来在java bean 规范关于中提到&＃xff0c; boolean属性的getter访问器可以使用下面这种模式

public boolean is(){...};

来代替

public boolean get(){...};

Javabean 规范(下载链接&＃xff1a;http://download.oracle.com/otndocs/jcp/7224-javabeans-1.01-fr-spec-oth-JSpec/ ) 在8.3 章节"Design Patterns for Properties" 中的描述&＃xff1a;

Eclipse根据这种方式生成getter访问器和setter设值器&＃xff0c; 由于属性名isShowCode的is没有去掉&＃xff0c; 以致java bean类违背了java bean 的命名规范。

JavaBean 的属性名和getter/setter存取方法规则小结&＃xff1a;

1. 对于常规属性 &＃xff0c; 属性名称的***个单词小写且字母个数大于1&＃xff0c;第二个单词首字母大写 。对应的getter/setter方法名为&＃xff1a;get /set &＃43; ()&＃xff0c; 即属性名称的***个单词的首字母改成大写&＃xff0c; 前面再加上"get"或"set"前缀。

2. 对于布尔类型 &＃xff0c; 可以按常规属性的规则编写getter/setter方法外&＃xff0c; getter方法可以使用 is &＃43; ()的形式来代替。

3. 对于非常规属性&＃xff0c; 属性名称的***个单词小写且字母个数等于1&＃xff0c;第二个单词首字母大写 。

3.1 ) 对应的getter/setter方法名可以为&＃xff1a;get/set &＃43; ()&＃xff0c; 即***个单词的首字母为改为大写&＃xff0c;前面再加上"get"或"set"前缀。Eclipse3.2 按这种方式自动生成getter/setter方法。代码片段&＃xff1a;

中国

CN

true

privateString pName;

publicString getPName() {

returnpName;

}

publicvoidsetPName(String name) {

pName &＃61; name;

}

3.2 )对应的getter/setter方法名也可以为&＃xff1a;get/set&＃43; ()&＃xff0c; 即属性名称不变&＃xff0c;***个单词的首字母任然为小写&＃xff0c;前面再加上"get"或"set"前缀。这种方式也可以正常运行。网上有帖子说Eclipse3.5按这种方式自动生成getter/setter方法。

代码片段&＃xff1a;

中国

CN

true

privateString pName;

publicString getpName() {

returnpName;

}

publicvoidsetpName(String name) {

pName &＃61; name;

}

4. 对于非常规属性&＃xff0c; 属性名称的前两个字母都是大写 。即连续两个大写字母开头的属性名。

对应的getter/setter方法名为&＃xff1a; get/set &＃43; ()&＃xff0c; 即属性名称不变&＃xff0c;前面再加上"get"或"set"前缀。

spring3.1 配置文件代码片段&＃xff1a;

中国

CN

true

privateString PName;

publicString getPName() {

returnPName;

}

publicvoidsetPName(String name) {

PName &＃61; name;

}

5. 对于非常规属性或&＃xff0c; 属性名称***个字母大写 。网上有帖子说这是不符合JSR规范的&＃xff0c;会报 "属性找不到" 的错误。

(如帖子1: http://lzh166.iteye.com/blog/631838 &＃xff1b;

帖子2: http://hi.baidu.com/w8y56f/blog/item/4fd037e845bbbe372cf5342a.html)。我在我的 环境下测试了下&＃xff0c; 是不会报错的&＃xff0c;可以正常运行&＃xff0c;虽然这种命名方式是令人难以忍受的&＃xff1a;

中国

CN

true

12.345

privateString PropertyName;

publicString getPropertyName() {

returnPropertyName;

}

publicvoidsetPropertyName(String propertyName) {

PropertyName &＃61; propertyName;

}

privateDouble Xcoordinate;

publicDouble getXcoordinate() {

returnXcoordinate;

}

publicvoidsetXcoordinate(Double xcoordinate) {

Xcoordinate &＃61; xcoordinate;

}

测试方法&＃xff1a; ***个&＃64;test方法用普通javabean调用方式测试&＃xff1b; 第二个&＃64;test方法使用spring创建bean

&＃64;Test

publicvoidtestJavaBeanNamingRule0(){

Country country &＃61;newCountry();

country.setPropertyName("中国");

country.setXcoordinate(Double.valueOf(123.456f));

System.out.println(country.getPropertyName());

System.out.println(country.getXcoordinate());

}

&＃64;Test

publicvoidtestJavaBeanNamingRule(){

ApplicationContext ctx &＃61;newClassPathXmlApplicationContext("myBeans.xml");

Country country &＃61; (Country)ctx.getBean("country");

System.out.println(country.getPropertyName());

System.out.println(country.getXcoordinate());

}

运行结果&＃xff1a;都可以正常运行。

中国

123.45600128173828

log4j:WARN No appenders could be foundforlogger (org.springframework.core.env.StandardEnvironment).

log4j:WARN Please initialize the log4j system properly.

中国

12.345

总结&＃xff1a;

1. javabean属性命名尽量使用常规的驼峰式命名规则

2. 属性名***个单词尽量避免使用一个字母&＃xff1a;如eBook&＃xff0c; eMail。

3. boolean属性名避免使用 “is” 开头的名称

4. 随着jdk&＃xff0c; eclipse&＃xff0c; spring 等软件版本的不断提高&＃xff0c; 底版本的出现的问题可能在高版本中解决了&＃xff0c; 低版本原来正常的代码可能在高版本环境下不再支持。

【编辑推荐】

【责任编辑&＃xff1a;小林 TEL&＃xff1a;(010)68476606】

点赞 0