Synopsis
The Harbormaster architecture is a Model Driven Architecture and as such requires a model to generate a project. The model should capture:
-
- The name of each important thing found in the requirements:
Employee, Account, Company, Order, Product, etc...
- The data attributes for each thing:
first_name, last_name, ssn, dob, etc...
- Enumerated types that encapsulate a group of like data:
VolumeLevel : High, Medium, Low
- The parent name for a thing with a parent that represents an “is-a” relationship:
PlasmaTV is-a TV
- All relationships between things. These relationships can be in one direction (uni-directional) or in both directions (bi-directional) and have varying multiplicity:
1-to-1, 1-to-Many, Many-to-1, and Many-to-Many
Supported Model Formats
| Type |
extension |
example |
details |
purpose |
| YAML |
yaml, .yml |
Link |
Link |
| Refactor |
New App |
 |
 |
|
| JSON |
json |
Link |
Link |
| Refactor |
New App |
|
|
|
| Eclipse Modeling Framework |
emf |
Link |
Link |
| Refactor |
New App |
|
|
|
| UML |
uml |
Link |
Link |
| Refactor |
New App |
|
|
|
| XMI |
xmi |
Link |
Link |
| Refactor |
New App |
|
|
|
| SQL Script |
sql |
Link |
Link |
| Refactor |
New App |
|
|
|
POJOs
(Plain Old Java Objects) |
jar, war |
N/A |
Link |
| Refactor |
New App |
|
|
|
| Git Repository |
git |
Link |
Link |
| Refactor |
New App |
|
|
|
What To Consider
Primary Keys
In a model, it is best to exclude a primary key attribute. Harbormaster will auto-generate a primary key attribute and name it using the format {className}Id. If you create a primary key field, you should follow this naming convention so Harbormaster will detect it.
Compound Primary Keys
It is best NOT to use compound primary keys. Harbormaster has been designed to handle compound keys but the level of complexity it introduces does not normally warrant their usage. There is no guarantee each supported tech stack will effectively accommodate a compound primary key. Therefore, it is suggested to avoid them.
Model File Extension
It is important the name of a model file have the appropriate extension so Harbormaster can deduce its type. Each supported model type and expected extension is detailed above.
