Makumba comes with a number of convenient developer tools.
Those tools can be enabled or disabled at will (one might not want e.g. the data query tool to be enabled in a production environment) in the configuration file. The default location is under /mak-tools but this can be also changed if wished.
In addition to the list below, more tools are expected to be developed in the future, allowing e.g. to clean up database columns not used anymore or to migrate the data when doing data structure refactoring (e.g. when moving from a pointer to set).
JSP Viewer#The JSP code viewer comes with handy highlighting of JSP, JSTL and of course Makumba tags. It also provides convenient links to the data definitions used in the page, to the logic discovery (identifying matching business logic files) as well as to the version history of this particular file.
By default the JSP viewer can be accessed by using the .jspx extension on any JSP page
Data Definition Viewer#The data definition viewer allows to easily check the fields available in a given entity and the history of the changes. When a data definition contains references to other entities, links to the corresponding data definitions are provided, making it very easy to navigate from an entity to the other. When adding new data definitions, the data definition viewer also indicates syntax errors, if any, making it easy to spot and correct any issue.
The data definition viewer is also able to provide the list of JSP and Java files in which the entity is used, which comes handy when assessing the impact of a data structure change. For this list of relations to be available, one needs however to run the relation crawler first (located by default under /mak-tools/relationCrawler).
It is most common to access the data definition viewer from the JSP viewer, but it can also be accessed from (default) /mak-tools/dataDefinitions/
Java Viewer#The java viewer comes with handy highlighting and links to the classes, methods and data definitions used. As for the JSP and MDD viewers, the version history is only one click away.
It is most common to access the java viewer from the JSP viewer and its logic discovery, but it can also be accessed from (default) /mak-tools/classes/
For quick prototyping, code can be automatically generated from the data definitions. The code generator is available (when enabled) from the data definition viewer and will generate the code for creation, view, list, edition and deletion of the entity. Templates can be defined to refine the output.
Data Tools #
Data Query Tool#The data query tool allows the developer to run any SELECT queries using MQL (Makumba Query Language) or HQL (Hibernate Query Language). It dramatically eases the checking of the data contained in the DB, especially when joining across several tables is involved.
Besides the actual output of the query, the corresponding SQL is also given.