### AppFuse开发框架(myapp)使用说明文档
#### 一、配置开发环境
AppFuse是一个开源的Java Web应用开发框架，旨在提供一个快速的应用程序开发基础。为了更好地使用AppFuse框架进行开发，以下是对开发环境配置的具体说明：
##### 1.1 Tomcat配置
根据文档中的建议，本框架推荐使用的Tomcat版本为5.0.*，并且JDK版本为1.4。然而，如果使用的是JDK 1.5或更高版本，则需要注意以下细节：
- **移除JAR文件**：需要移除Tomcat安装目录下的`common\endorsed`目录内的两个JAR文件（`xercesImpl.jar`和`xmlParserAPIs.jar`）。这是因为JDK 1.5及以上版本内置了XML解析器，而这两个JAR文件用于XML解析。在使用JDK 1.4时，这两个JAR文件是必要的，因为该版本的JDK不包含XML解析器。
- **解析冲突**：当使用JDK 1.5时，如果这两个JAR文件存在，则会导致Tomcat启动时与JDK自带的XML解析器发生冲突。
##### 1.2 应用程序安装
为了顺利地进行开发，还需要安装并配置以下工具：
- **Eclipse 3.3**：作为基本的集成开发环境。
- **MyEclipse 6.0**：用于Web开发。
- **Properties插件**：支持*.properties文件的编辑，并确保中文编码为UTF-8。
- **JSEclipse插件**：提供JavaScript辅助编程功能。
此外，还需要执行以下步骤来导入项目和生成Tomcat安装文件：
- **导入工程项目**：将MyApp项目整个目录复制到Eclipse的工作空间，然后通过File > Import > General > Existing Projects into Workspace来导入项目。
- **生成Tomcat安装文件**：
- 打开Ant插件，并添加`myapp/builder.xml`文件。
- 在Ant窗口中双击“tomcat-setup”任务，这将生成一个`myapp.xml`文件。
- 修改`myapp.xml`文件中的路径和数据源配置，然后将其复制到Tomcat安装目录下的`conf/Catalina/localhost`目录。
#### 二、单表的CRUD操作
AppFuse框架支持通过XDoclet自动生成模板代码，从而简化CRUD（Create、Read、Update、Delete）操作的实现。
##### 2.1 XDoclet生成模板代码
需要将`myapp/extras/appgen/build.xml`文件添加到Ant插件中。接下来，按照以下步骤生成CRUD模板代码：
- 在`myapp/build.properties`文件中配置数据库连接资源，并确保将相应的JDBC驱动放置在`myapp/WebRoot/WEB-INF/lib`目录下。
- 在Ant窗口中展开`myapp-appgen`树，双击`crud-springmvc`任务。
- 输入数据库表名，注意遵循命名规范（全部小写或下划线分隔，如`tablename`或`table_name`）。
- 输入完成后，XDoclet将通过Hibernate middlegen生成POJO，并进一步生成DAO、Service、Controller（Spring MVC）、JSP页面以及相应的配置文件。
以上步骤提供了关于如何使用AppFuse框架进行开发的基本指南，包括配置环境、导入项目以及生成CRUD操作所需的代码模板。这些指南对于初学者来说尤其有用，可以帮助他们快速上手并高效地进行应用程序的开发。
