Chapter 9 Generating Persistent Objects for Java and JSF Pages

Generated File List

The following files are generated:

• Eclipse Project Files - If you have selected the Generate Eclipse project artifacts generation option, .project file and .classpath file are generated by PowerDesigner. But if you are regenerating codes, these two files will not be generated again.
• Persistent Java Classes - If mapping definition type specified includes Annotation, Default, Annotation or Mapping File & Annotation, annotations will be generated in Java sources.
• Primary Key Classes - Primary key classes are generated to ease find-by-primary-key operation. It is also mandatory for composite primary key.
• EJB 3 Configuration File - The EJB 3 persistence configuration file persistence.xml is generated in META-INFO sub directory of Java source directory.
• Log4J Configuration File - PowerDesigner uses Log4j as the default logging framework to log messages. The Log4j properties file log4j.properties is generated in Java source directory.
• Utility Class - The Util.java class contains some utility functions that are used by unit tests, such as compare date by precision. It is defined in the com.sybase.orm.util package.
• EJB 3 O/R Mapping Files - If mapping definition type specified includes mapping file, Mapping File & Annotation or Mapping file, EJB 3 O/R mapping files will be generated. These mapping files are generated in the same directory with Java source.
• Factory and Data Access Objects - To help simplify the development of your application, PowerDesigner generates DAO Factory and Data Access Objects (DAO), using Factory and DAO design pattern.
• Unit Test Classes - generated to help user perform test to prove that:
  
  
  • The mappings are correctly defined
  • The CRUD (Create, Read, Update and Delete) work properly
  • The find methods work
  • The navigations work
• Unit test classes include:
  
  
  • Test helper classes - provide some utility functions for unit test classes, such as creating new instances, modifying state of instances, saving instances etc.
  • Unit Test Classes - For each persistent entity, PowerDesigner generates a unit test class. The generated test cases are:
    
    
    • Insert test method - to test instance insert.
    • Update test method - to test instance update.
    • Delete test method - to test instance delete.
    • Property finder test methods - to test every property finder method defined in Dao.
    • Get all instance list test method - to test get all instances method.
    • Navigation test method - to test association mapping.
    • Inheritance test method - to test inheritance mapping.
    • User defined operation test methods - skeleton test methods for user defined functions.
• AllTest Class - a test suite that runs all the unit test cases.
• Ant Build File - PowerDesigner can generate an Ant build file to help you to compile and run unit tests if you set the Generate Ant build.xml file option to true in the Java code generation window. The Ant build.xml contains customized elements for EJB 3:
  
  
  • Custom properties - that specify directories and class path.
  • Custom target definitions - to define JUnit tasks.
  • Custom tasks - to run JUnit test or generate JUnit test reports.

Copyright (C) 2006. Sybase Inc. All rights reserved.