So using JPA, Hibernate or EBeans is cool when you can just annotate your Java classes, but haven’t you always wished you could “generate” documentation of your data model from the code? Pulling information of the the JPA / Hibernate and other validation annotations?
Assuming you have all those nice Annotations in your beans:
@Entity
@Table(name = "project_bills")
public class Bill extends Model {
private static final long serialVersionUID = 1L;
@Id
@Column(name="PBI_ID")
public Long id;
@DoubleFormat
@Column(name="PBI_BILL_AMOUNT",length=22)
public Double billAmount;
@Column(name="PBI_BILL_DATE")
@DateTime(pattern="dd.MM.yyyy")
public Date billDate;
@Column(name="PBI_BILL_NUMBER",length=10)
public String billNumber;
@Column(name="PBI_CAN_BILL")
public Boolean canBill;
@Column(name="PBI_COMMENT",length=65535)
public String comment;
@Column(name="PBI_PAID_DATE")
@DateTime(pattern="dd.MM.yyyy")
public Date paidDate;Here is an example of how to go about accomplishing that task:
public static String listEntities(String _package) {
StringBuffer retval = new StringBuffer();
Reflections reflections = new Reflections(_package, Play.application().classloader());
Set<Class<?>> classes = reflections.getTypesAnnotatedWith(javax.persistence.Entity.class);
for (Class c : classes) {
retval.append(c.getName() + "\n");
retval.append(listAnnotations(c.getName()) + "\n\n");
retval.append(listAttributes(c.getName()) + "\n\n");
}
return retval.toString();
}
public static String listAnnotations(String _class) {
StringBuffer retval = new StringBuffer();
try {
Annotation[] annotations = Class.forName(_class).getAnnotations();
if (annotations.length != 0) {
for (int j = 0; j < annotations.length; j++) {
retval.append(annotations[j].toString() + ": " + annotations[j].annotationType() + "\n");
}
retval.append("\n");
}
} catch (ClassNotFoundException e) {
System.out.println(e.toString());
return retval.toString();
}
return retval.toString();
}
public static String listAttributes(String _class) {
StringBuffer retval2 = new StringBuffer();
boolean perstistent = false;
try {
for (Field field : Class.forName(_class).getDeclaredFields()) {
Class type = field.getType();
String name = field.getName();
perstistent = false;
StringBuffer retval = new StringBuffer();
retval.append("\t" + name + " (" + type + ")\n");
Annotation[] annotations = field.getDeclaredAnnotations();
if (annotations.length != 0) {
for (int j = 0; j < annotations.length; j++) {
retval.append(annotations[j].toString() + ": " + annotations[j].annotationType() + "\n");
if (annotations[j].toString().startsWith("@javax.persistence")) {
perstistent = true;
}
}
retval.append("\n");
}
if (perstistent) {
retval2.append(retval);
}
}
} catch (ClassNotFoundException e) {
System.out.println(e.toString());
return retval2.toString();
}
return retval2.toString();
}Which will generate something like this:
models.controlling.Bill @javax.persistence.Table(schema=, uniqueConstraints=[], catalog=, name=project_bills): interface javax.persistence.Table @javax.persistence.Entity(name=): interface javax.persistence.Entity id (class java.lang.Long) @javax.persistence.Id(): interface javax.persistence.Id @javax.persistence.Column(insertable=true, scale=0, unique=false, precision=0, columnDefinition=, name=PBI_ID, updatable=true, length=255, nullable=true, table=): interface javax.persistence.Column billAmount (class java.lang.Double) @utils.data.formatters.Formats$DoubleFormat(): interface utils.data.formatters.Formats$DoubleFormat @javax.persistence.Column(insertable=true, scale=0, unique=false, precision=0, columnDefinition=, name=PBI_BILL_AMOUNT, updatable=true, length=22, nullable=true, table=): interface javax.persistence.Column billDate (class java.util.Date) @javax.persistence.Column(insertable=true, scale=0, unique=false, precision=0, columnDefinition=, name=PBI_BILL_DATE, updatable=true, length=255, nullable=true, table=): interface javax.persistence.Column @play.data.format.Formats$DateTime(pattern=dd.MM.yyyy): interface play.data.format.Formats$DateTime billNumber (class java.lang.String) @javax.persistence.Column(insertable=true, scale=0, unique=false, precision=0, columnDefinition=, name=PBI_BILL_NUMBER, updatable=true, length=10, nullable=true, table=): interface javax.persistence.Column
Of course this is only the tip of the iceberg, but you get the idea.
Reference: How to use Reflection to Document your Data Model based on JPA Annotations from our JCG partner Brian Porter at the Poornerd blog.
Do you want to know how to develop your skillset to become a Java Rockstar?
Subscribe to our newsletter to start Rocking right now!
To get you started we give you our best selling eBooks for FREE!
1. JPA Mini Book
2. JVM Troubleshooting Guide
3. JUnit Tutorial for Unit Testing
4. Java Annotations Tutorial
5. Java Interview Questions
6. Spring Interview Questions
7. Android UI Design
and many more ....
I agree to the Terms and Privacy Policy
Thank you!
We will contact you soon.
Tags
JPA
This site uses Akismet to reduce spam. Learn how your comment data is processed.