/*
* Copyright 2008 The Apache Software Foundation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.ibatis.ibator.plugins;
import java.util.Iterator;
import java.util.List;
import org.apache.ibatis.ibator.api.IbatorPluginAdapter;
import org.apache.ibatis.ibator.api.IntrospectedColumn;
import org.apache.ibatis.ibator.api.IntrospectedTable;
import org.apache.ibatis.ibator.api.dom.OutputUtilities;
import org.apache.ibatis.ibator.api.dom.java.FullyQualifiedJavaType;
import org.apache.ibatis.ibator.api.dom.java.JavaVisibility;
import org.apache.ibatis.ibator.api.dom.java.Method;
import org.apache.ibatis.ibator.api.dom.java.Parameter;
import org.apache.ibatis.ibator.api.dom.java.TopLevelClass;
import org.apache.ibatis.ibator.internal.util.JavaBeansUtil;
/**
* This plugin adds equals() and hashCode() methods to the generated model
* classes. It demonstrates the process of adding methods to generated classes
*
* The equals method generated by this class is correct in most
* cases, but will probably NOT be correct if you have specified a rootClass -
* because our equals method only checks the fields it knows about.
*
* The hashCode method generated by this class is a very simplistic
* implementation. A better implementation would rely on the HashCodeUtil
* from www.javapractices.com - but we do not want to introduce another
* dependency in this simple plugin.
*
* @author Jeff Butler
*
*/
public class EqualsHashCodePlugin extends IbatorPluginAdapter {
public EqualsHashCodePlugin() {
}
/**
* This plugin is always valid - no properties are required
*/
public boolean validate(List warnings) {
return true;
}
@Override
public boolean modelBaseRecordClassGenerated(TopLevelClass topLevelClass,
IntrospectedTable introspectedTable) {
List columns;
if (introspectedTable.getRules().generateRecordWithBLOBsClass()) {
columns = introspectedTable.getNonBLOBColumns();
} else {
columns = introspectedTable.getAllColumns();
}
generateEquals(topLevelClass, columns, introspectedTable);
generateHashCode(topLevelClass, columns, introspectedTable);
return true;
}
@Override
public boolean modelPrimaryKeyClassGenerated(TopLevelClass topLevelClass,
IntrospectedTable introspectedTable) {
generateEquals(topLevelClass, introspectedTable.getPrimaryKeyColumns(),
introspectedTable);
generateHashCode(topLevelClass, introspectedTable.getPrimaryKeyColumns(),
introspectedTable);
return true;
}
@Override
public boolean modelRecordWithBLOBsClassGenerated(TopLevelClass topLevelClass,
IntrospectedTable introspectedTable) {
generateEquals(topLevelClass, introspectedTable.getAllColumns(),
introspectedTable);
generateHashCode(topLevelClass, introspectedTable.getAllColumns(),
introspectedTable);
return true;
}
/**
* Generates an equals method that does a comparison of
* all fields.
*
* The generated equals method will be correct unless:
*
* - Other fields have been added to the Ibator generated classes
* - A rootClass is specified that holds state
*
*
* @param topLevelClass the class to which the method will be added
* @param introspectedColumns column definitions of this class and
* any superclass of this class
* @param introspectedTable the table corresponding to this class
*/
protected void generateEquals(TopLevelClass topLevelClass,
List introspectedColumns,
IntrospectedTable introspectedTable) {
Method method = new Method();
method.setVisibility(JavaVisibility.PUBLIC);
method.setReturnType(FullyQualifiedJavaType
.getBooleanPrimitiveInstance());
method.setName("equals"); //$NON-NLS-1$
method.addParameter(new Parameter(FullyQualifiedJavaType
.getObjectInstance(), "that")); //$NON-NLS-1$
if (introspectedTable.isJava5Targeted()) {
method.addAnnotation("@Override"); //$NON-NLS-1$
}
ibatorContext.getCommentGenerator().addGeneralMethodComment(method,
introspectedTable);
method.addBodyLine("if (this == that) {"); //$NON-NLS-1$
method.addBodyLine("return true;"); //$NON-NLS-1$
method.addBodyLine("}"); //$NON-NLS-1$
StringBuilder sb = new StringBuilder();
sb.append("if (!(that instanceof "); //$NON-NLS-1$
sb.append(topLevelClass.getType().getShortName());
sb.append(")) {"); //$NON-NLS-1$
method.addBodyLine(sb.toString());
method.addBodyLine("return false;"); //$NON-NLS-1$
method.addBodyLine("}"); //$NON-NLS-1$
sb.setLength(0);
sb.append(topLevelClass.getType().getShortName());
sb.append(" other = ("); //$NON-NLS-1$
sb.append(topLevelClass.getType().getShortName());
sb.append(") that;"); //$NON-NLS-1$
method.addBodyLine(sb.toString());
boolean first = true;
Iterator iter = introspectedColumns.iterator();
while (iter.hasNext()) {
IntrospectedColumn introspectedColumn = iter.next();
sb.setLength(0);
if (first) {
sb.append("return ("); //$NON-NLS-1$
first = false;
} else {
OutputUtilities.javaIndent(sb, 1);
sb.append("&& ("); //$NON-NLS-1$
}
String getterMethod = JavaBeansUtil.getGetterMethodName(
introspectedColumn.getJavaProperty(), introspectedColumn
.getFullyQualifiedJavaType());
if (introspectedColumn
.getFullyQualifiedJavaType().isPrimitive()) {
sb.append("this."); //$NON-NLS-1$
sb.append(getterMethod);
sb.append("() == "); //$NON-NLS-1$
sb.append("other."); //$NON-NLS-1$
sb.append(getterMethod);
sb.append("())"); //$NON-NLS-1$
} else {
sb.append("this."); //$NON-NLS-1$
sb.append(getterMethod);
sb.append("() == null ? other."); //$NON-NLS-1$
sb.append(getterMethod);
sb.append("() == null : this."); //$NON-NLS-1$
sb.append(getterMethod);
sb.append("().equals(other."); //$NON-NLS-1$
sb.append(getterMethod);
sb.append("()))"); //$NON-NLS-1$
}
if (!iter.hasNext()) {
sb.append(';');
}
method.addBodyLine(sb.toString());
}
topLevelClass.addMethod(method);
}
/**
* Generates a hashCode method that multiplies the hashCodes of
* all fields.
*
* Note that this is a very simplistic implementation of hashCode.
*
* @param topLevelClass the class to which the method will be added
* @param introspectedColumns column definitions of this class and
* any superclass of this class
* @param introspectedTable the table corresponding to this class
*/
protected void generateHashCode(TopLevelClass topLevelClass,
List introspectedColumns,
IntrospectedTable introspectedTable) {
Method method = new Method();
method.setVisibility(JavaVisibility.PUBLIC);
method.setReturnType(FullyQualifiedJavaType
.getIntInstance());
method.setName("hashCode"); //$NON-NLS-1$
if (introspectedTable.isJava5Targeted()) {
method.addAnnotation("@Override"); //$NON-NLS-1$
}
ibatorContext.getCommentGenerator().addGeneralMethodComment(method,
introspectedTable);
method.addBodyLine("int hash = 23;"); //$NON-NLS-1$
StringBuilder sb = new StringBuilder();
boolean valueDeclared = false;
Iterator iter = introspectedColumns.iterator();
while (iter.hasNext()) {
IntrospectedColumn introspectedColumn = iter.next();
FullyQualifiedJavaType fqjt = introspectedColumn
.getFullyQualifiedJavaType();
String getterMethod = JavaBeansUtil.getGetterMethodName(
introspectedColumn.getJavaProperty(), fqjt);
if (fqjt.isPrimitive()) {
boolean cast = false;
if ("boolean".equals(fqjt.getFullyQualifiedName())) { //$NON-NLS-1$
// no adding the booleans to the hashCode computation
continue;
} else if ("long".equals(fqjt.getFullyQualifiedName())) { //$NON-NLS-1$
cast = true;
} else if ("double".equals(fqjt.getFullyQualifiedName())) { //$NON-NLS-1$
cast = true;
} else if ("float".equals(fqjt.getFullyQualifiedName())) { //$NON-NLS-1$
cast = true;
}
sb.setLength(0);
if (!valueDeclared) {
sb.append("int "); //$NON-NLS-1$
valueDeclared = true;
}
sb.append("value = "); //$NON-NLS-1$
if (cast) {
sb.append("(int) "); //$NON-NLS-1$
}
sb.append(getterMethod);
sb.append("();"); //$NON-NLS-1$
method.addBodyLine(sb.toString());
method.addBodyLine("if (value != 0) {"); //$NON-NLS-1$
method.addBodyLine("hash *= value;"); //$NON-NLS-1$
method.addBodyLine("}"); //$NON-NLS-1$
} else {
sb.setLength(0);
sb.append("if ("); //$NON-NLS-1$
sb.append(getterMethod);
sb.append("() != null) {"); //$NON-NLS-1$
method.addBodyLine(sb.toString());
sb.setLength(0);
sb.append("hash *= "); //$NON-NLS-1$
sb.append(getterMethod);
sb.append("().hashCode();"); //$NON-NLS-1$
method.addBodyLine(sb.toString());
method.addBodyLine("}"); //$NON-NLS-1$
}
}
method.addBodyLine("return hash;"); //$NON-NLS-1$
topLevelClass.addMethod(method);
}
}