admin 管理员组

文章数量: 887021


2023年12月23日发(作者:java核心卷)

程序员必读:JavaBean规范

Webjx网页教学提示:作为Java程序员,对于JavaBean也许你会说再熟悉不过了,它活跃于系统的很多层,不同的说法有 PO、VO、DTO、POJO。然而它无外乎就是一个Class类,带上些属性和它们的setter/getter方法,set/get后面那一个字母大写。虽然我们现在很少把JavaBean与那个古老的2.0的EJB搞混

作为Java程序员,对于JavaBean也许你会说再熟悉不过了,它活跃于系统的很多层,不同的说法有 PO、VO、DTO、POJO。然而它无外乎就是一个Class类,带上些属性和它们的setter/getter方法,set/get后面那一个字母大写。虽然我们现在很少把JavaBean与那个古老的2.0的EJB搞混,但为什么明明用IDE为属性生成的getter/setter方法,应用一运行,还是报找不到某个bean属性的setter或getter方法呢?

要知道,在Sun的网站上那个关于JavaBean规范的PDF文档可是有足足实实的114页啊。难免有些规则有点古怪,至使知名的IDE都难以应对,所以我们还是有必要了解其中二三,来规范我们的JavaBean和解释一些情形。

Sun的关于JavaBean规范见:/javase/technologies/desktop/javabeans/docs/,其中可下载到 JavaBean规范的PDF文档。

实际中的问题

首先,当然还是要说它的属性及 setter/getter 方法。属性以小写字母开头,驼峰命名格式,相应的 getter/setter 方法是 get/set 接上首字母大写的属性名。多数情况是对的,且当前流行的 IDE(Eclipse、JBuilder) 也都认这个死理,这里 NetBean 值得表扬一下。但要是碰到些遗留的代码中属性名不规范,或者有些人就是顽固,或真是对属性命名犹豫不决时的写下的代码时,那还是有得你研究一下。

这里来看看 Eclipse 为几个属性生成的 getter/setter 方法吧:

sName(从 C 转过来的,受匈牙利的影响,认为 Name 是个字符串,所以加个前缀 s)

getSName()/setSName(String name)

URL (平时认为是缩略语/专有名词,理当全部大写,这在我们对待 ID 时经常发生的)

getURL()/setURL(String url)

上面第一个由 Eclipse 为我们生成的 getSName()/setSName(String name)

方法,参照 JavaBean 规范来说,其实是错误的。如果出现这样的方法,放到我们的标签(像 Struts 标签,如 ),或是进行 Hibernate/iBatis 那种映射时,你就能收到报 找不到 sName 属性相应的 getter/setter 方法 那样的错误。不是明明有 getSName() 和 setSName(String name),可是方法名错了,正确的版本应该是 getsName() 和 setsName(String name)。

前面首先解释了属性命名不规范产生问题的原因,现在就来更仔细的了解关于 JavaBean 属性及其 getter/setter 方法的约定,有些是硬性的。

属性与存取访问的规定

为 JavaBean 创建属性时,必须牢记:缩略语通常被视为一个独立的单词,而不是单个字母。例如,URL 对应的属性名应该用 url,相应的

getUrl()/setUrl(),所以 ID 还是用 id 作为属性吧,相应的

getId()/setId()。

规范中另一个特别的地方就是,第二个字母为大写的属性名要区别对待。如果属性名的第二个字母是大写的,那么该属性名直接用作 getter/setter 方法中 get/set 的后部分,就是说大小写不变。这就是为什么 sName 对应的存取方法是 getsName()/setsName() 的原因,不能不说这条规则很令人费解。那就更有必要看看下面表格的规范:

属性是首字母大写,次字母小写是,你永远都找不到它的 getter/setter 方法的,对这个属性的使用是会害人的。对于 boolean 类型属性的 getter 方法是 isXxx() 还是 getXxx() 就自己决定了,isXxx() 应该更接近于自然语言,更顺溜些。

知道了属性及存取方法的规定,那么你即使是面对古老代码,在使用标签来引用或与 Hibernate/iBatis 等进行映射,你就知道该填什么样的属性名了。

还有一个我们很少碰触到的是关于可索引属性的 getter/setter 方法(这方面 C# 表现的比 Java 要优秀),比如有属性

private OrderItem[] orderItem;

那它相应的 getter/setter 除常见的两个外,还有带索引参数的两个版本,如下:

public OrderItem[] getOrderItem();

public void setOrderItem(OrderItem[] newArray);

public OrderItem[] getOrderItem(int index);

public void setOrderItem(int index, OrderItem

orderItem);

关于 Bean 导航

最后就是 Bean 导航的规范,通常用点记法(dot notation) 来引用属性,同时也要注意索引属性的访问。在 Web MVC 的表单中,以及标签中,

Jarkata-Commons-BeanUtils 中用得很多。看点记法的示例:

比如像 Struts1 标签:

会显示出 FormBean 中 stocks 列表的第二个元素的 code 属性,提交就填充到相应的位置上去。


本文标签: 属性 规范 大写 命名 方法