Gnumler Manual

Summary

1. A brief introduction
2. How to deploy gnumler
3. How can I use it to generate Hibernate mapping? a simple example
4. Creating and modifying an UML diagram

Gnuler is a Java application which allows you to generate, starting from the UML class diagram of your application, the corresponding DB diagram in the form of a Hybernate description file, which can be used as is to create the persistent layer underlying your application.
Gnumler also allows you to start form the ER diagram (or even from the SQL description of your database!!) of your database and to generate the corresponding class diagram of an application which can be build over that.
You can also modify the generated mapping as well as the diagrams by using gnumler intuitive GUI.

But what's most, you can use gnumler engine to create a tool capable to map any kind of diagram

You can download Gnumler in the form of a .jar file. To deploy it you have to:

Using Linux:

from console:
- enter the directory where gnumler.jar is
- write java -jar gnumler.jar classpath

Using Windows:

Let's see now a simple example of what you can do with Gnumler.

Suppose we have an UML diagram described in a xmi file. You can generate this kind of diagram with any specific tool, let's say Umbrello. A good example could be the one of the Hiberante tutorial, you can see the code below.

package events;
import java.util.Date;
public class Event {

private Long id;
private String title;
private Date date;
public Event() {}
public Long getId() {
return id;
}
private void setId(Long id) {
this.id = id;
}
public Date getDate() {
return date;
}
public void setDate(Date date) {
this.date = date;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
}

What you can find above is the java code of our example. Suppose now you have a description of that in an xmi format, just like the following one

1. Choose load xmi from the file menu.
2. Choose UMLToDbLogic Translation from the Tools menu.
3. Click over the GenerateGraph button from the menu bar.
4. Now you'll see your diagram appearing into the main window: UML diagram will appear on the left coloured in pink, DB diagram will appear on the right in green.
5. Choosing Show XML button from the menu bar you can view the XML file describeing the hibernate mapping.

Loading existing models

How to generate the mapping

How to generate an automated mapping of a uml diagram

How to generate a personalized mapping

How to obtain the inverse mapping (from UML to DbLogic)

After the mapping: closer to the DB