Hibernate的JavaBean属性名称大小写的一个Bug

      Hibernate的JavaBean的属性名称,如果第一个字母小写,第二个字母大写,则通过属性名称获取值,会出现小小的问题。

如Bean类名为BeanA,属性名称为fIELD(get/set方法则按照属性名对应设置,如getFIELD/setFIELD),通常情况下,我们会通过类似a.fIELD获取属性,但实际上如果在Hibernate中通过这样获取属性,如HQL语句:from BeanA a where a.fIELD = ?,则会提示fIELD属性找不到,而通过a.FIELD,则正确。把属性的第二个字母改为小写,get/set方法相应的设置为getFiELD/setFiELD,则通过a.fiELD获取属性,无任何问题。

     通过网上搜索,有人说是Hibernate的一个bug,以下为该文的转帖,正确与否,未做细究。

JavaBean:属性名大小写与getter方法命名问题

情况如下,Company类的对象有一个叫sAddress的属性,根据JavaBean Specification,getter和setter分别为getSAddress和setSAddress。但是编译时会报错:

Caused by: org.hibernate.PropertyNotFoundException: Could not find a getter for sAddress in class Company at org.hibernate.property.BasicPropertyAccessor.createGetter(BasicPropertyAccessor.java:282)
at org.hibernate.property.BasicPropertyAccessor.getGetter(BasicPropertyAccessor.java:275)

 

跟踪到org.hibernate.property.BasicPropertyAccessor类中的getterMethod(Class theClass, String propertyName)方法:

              1
            2
            3
            4
            5
            6
            7
            8
            9
            10
            11
            12
            13
            14
            15
            16
            17
            18
            19
            20
            21
            22
            23
            24
            25
            26
            
 private static Method getterMethod(Class theClass, String propertyName) {
            Method[] methods = theClass.getDeclaredMethods();
            for (int i = 0; i < methods.length; i++) {
            // only carry on if the method has no parameters
            if (methods[i].getParameterTypes().length == 0) {
            String methodName = methods[i].getName();
            // try "get"
            if (methodName.startsWith("get")) {
            String testStdMethod = Introspector.decapitalize(methodName.substring(3));
            String testOldMethod = methodName.substring(3);
            if (testStdMethod.equals(propertyName) || testOldMethod.equals(propertyName)) {
            return methods[i];
            }
            }
            // if not "get" then try "is"
            if (methodName.startsWith("is")) {
            String testStdMethod = Introspector.decapitalize(methodName.substring(2));
            String testOldMethod = methodName.substring(2);
            if (testStdMethod.equals(propertyName) || testOldMethod.equals(propertyName)) {
            return methods[i];
            }
            }
            }
            }
            return null;
            }

getterMethod()对Company类中声明的方法进行遍历,找到与属性名匹配的方法,即属性的getter方法。比较分两部分,第一部分,针对primitive和自定义类类型的属性;第二部分,针对boolean类型的属性(由于boolean类型属性的getter方法的特殊性)。

跟踪发现,methodName的值为“getSAddress”,propertyName的值为“sAddress”,testOldMethod的值为“SAddress”,testStdMethod的值为“SAddress”。testStdMethod和testOldMethod相同,而它们都不匹配propertyName!

因此,getterMethod()中找不到与属性sAddress匹配的getter方法,getterMethod()返回null,导致异常。

问题出在Introspector.decapitalize()方法。

decapitalize()源码如下:

              1
            2
            3
            4
            5
            6
            7
            8
            9
            10
            11
            12
            13
            14
            15
            16
            17
            18
            19
            20
            21
            22
            23
            24
            25
            
 /** * Utility method to take a string and convert it to normal Java variable * name capitalization. This normally means converting the first * character from upper case to lower case, but in the (unusual) special * case when there is more than one character and both the first and * second characters are upper case, we leave it alone. * * Thus "FooBah" becomes "fooBah" and "X" becomes "x", but "URL" stays * as "URL". * * @param name The string to be decapitalized. * @return The decapitalized version of the string. */
            public static String decapitalize(String name) {
            if (name == null || name.length() == 0) {
            return name;
            }
            if (name.length() > 1 && Character.isUpperCase(name.charAt(1)) &&
            Character.isUpperCase(name.charAt(0))){
            return name;
            }
            char chars[] = name.toCharArray();
            chars[0] = Character.toLowerCase(chars[0]);
            return new String(chars);
            }

注释说了:一般情况下,把字符串第一个字母变为小写,如把“FooBah”变为“fooBah”。但在特殊情况下,即字符串前两个字母都是大写的时候,什么也不做,如,遇到“URL”,原样返回。

decapitalize()的bug是:如果一个字符串,前两个字母大写,但后面还有小写字母,它仍然返回原字符串!

Hibernate的开发者注意到decapitalize()的特点,所以才在判断语句中使用一个或运算(不然只需要判断方法名截掉“get”,再改第一个字母为小写后的字符串与属性名是否相等即可,这也是按照JavaBean Specification定义的标准做法)。但是,Hibernate没有解决这个bug,可能是他们没有碰到我遇到的情况。

类似sAddress(一般性地说,第一个字母小写,第二个字母大写)属性命名就是bug的诱因。

那么,解决方法有三种:

  1. 把属性名改成SAddress,这样就满足上面匹配判断的第二个条件(方法名截掉“get”后,与属性名匹配)。但是,这样做不符合Java命名规范;
  2. 把getSAddress()改成getsAddress(),这样也满足上面匹配判断的第二个条件(方法名截掉“get”后,与属性名匹配)。但是,这样做不符合JavaBean命名规范;
  3. 把属性名改成strAddress,并形成一种约定:命名属性时,第二个字符只能是小写字母。这个方法不需要做更多地修改,符合所有规范,最为稳妥。

你可能感兴趣的:(Hibernate,String,character,getter,Primitive,methods)