Deciding Your Data Model Strategy

INDEX PREVIOUS NEXT

0. No use of existing data.
There are three possible situations:
• You do not have existing data that you want to display and you will create your diagram(s) from scratch.
• You have existing data, but you want to duplicate it before displaying it, and it does not matter how the data will be represented in memory.
• You have exported your data to an XML file, and you want to read in the XML data.
In these cases, use the default SDM model implementation, ilog.views.sdm.model.IlvDefaultSDMModel.
The nodes and the links of the default model are instances of the classes IlvDefaultSDMNode and IlvDefaultSDMLink. . These objects have an arbitrary set of user-defined properties, so the default model can represent all kinds of objects.
1. Display existing data in a database.
Your data is stored in a database, and you want to display it but not modify it directly in the diagram component.
The model package provides a specific SDM model for this case: ilog.views.sdm.model.IlvJDBCSDMModel. This model uses the JDBC API to access the database. All you need to do is configure the model with the database URL, the names of the tables containing the nodes and links, and a few other parameters.
2. Existing JavaBeans.
You have existing data stored in classes which conform to the JavaBeans standard: there are accessor methods (get and set) for each Bean property.
In this case, use the class ilog.views.sdm.model.IlvJavaBeanSDMModel. This model uses your JavaBeans as the nodes and links of a graph, so there is no duplication or additional memory consumption. The properties of nodes and links are read and written using the JavaBeans API. All you have to do is supply the set of JavaBeans that will make up your graph. For an example, see JavaBeans Example.
3. Existing Java classes that are not JavaBeans or existing data but no Java classes.
For example, you already have an implementation of a Swing JTree model that represents your data and you want to display the contents of the tree without duplicating data.
One of the following applies:
• You have existing data represented by Java classes that are not JavaBeans.
• You want to display data that is not already represented in memory by Java classes.
In such cases, there are two possible approaches:
• Use the class IlvAbstractSDMModel, and wrap your objects into new objects that implement the IlvSDMNode and IlvSDMLink interfaces. This requires an extra object allocation because of the indirection, but allows you to make use of the predefined interfaces for nodes and links. For an example, see NonJavaBeans Example: Abstract Model Variant.
• Subclass the basic model, ilog.views.sdm.model.IlvBasicSDMModel, and implement the methods that list the objects and retrieve the properties of each object. This requires more work but is more open, and may be preferable if all objects already exist. For an example, see NonJavaBeans Example: Basic Model Variant.

Table 2.1 summarizes the strategies described in this section.