#BlackDream 文件生成器构建平台
##机械重复性的工作如同黑色梦魇，同一个问题并不应该被解决两次。
##项目介绍
网上的代码生成器形形色色五花八门，功能也很强大，甚至某些代码生成器能够一键生成项目。但是，这些代码生成器有一个致命的问题，它们都是成型的代码生成器，即已固定了生成规则。
- 比如，代码生成器A只能生成Struts、Spring、Mybatis的代码，限制了用户的技术选型。
- 比如，代码生成器B数据必须通过连接数据库来获取，限制了用户的数据灵活性。
- 比如，代码生成器C生成的代码一定要分Controller层、Service层、Dao层，限制了用户的程序设计。
上面的举例只是生成Java项目，C、C++、C#、Python？HTML、JavaScript？又或者说一定要拘泥于生成代码？
BlackDream是文件生成器构建平台，可快速灵活地构建和共享文件生成器。前期定位于公司内部服务或者个人使用，数据量不会很多，采用xml存储数据，不采用数据库。
##部署手册
###部署的应该是blackdream项目，sample项目是基于程序接口操作数据的示例。
###系统部署成功后，其余的文档在系统导航条-帮助-用户指南可翻阅。
- 服务端：依赖Java8，Tomcat8。
- 配置文件：blackdream.properties。
- blackdream.username：系统root用户的用户名。
- blackdream.password：系统root用户的密码及新建系统用户时的默认密码。
- blackdream.datapath：系统数据存储的根路径。
##使用手册
- 客户端：支持Chrome、Firefox、Opera浏览器，推荐Chrome。
- 系统角色：root用户、开发者、使用者。
- root用户：拥有所有权限，有且只有一个root用户，开发者账号和使用者账号只能通过root账号新建。
- 开发者：拥有开发和使用权限，开发生成器需掌握JAVA、JS、VTL、EL。
- 使用者：只有使用权限，根据生成器规则输入数据生成目标文件。
##如何打造属于你的生成器
####进行登陆，地址http://localhost:8080/login.html 或者 http://localhost:8080/client/login.html (IP和端口根据自己部署情况来定)。
####进入首页。
####点击我的生成器，进入生成器管理界面。
####新建生成器。
####生成器有三部分组成：数据模型、模板文件、生成策略。详细文档参见帮助-用户指南。
####新建数据模型，数据模型定义了生成器所需生成数据的数据类型结构，每个生成器可制定多个数据模型。
####新建模板文件，模板文件定义了生成文件的模板，采用Velocity模板实现。
package com.lite.blackdream.po;
#set($typeSet = $classTool.inspect("java.util.LinkedHashSet").getType().newInstance())
#foreach($property in $po.association)
#if($property.propertyType == "Date" && $typeSet.add("java.util.Date"))#end
#end
#foreach($type in $typeSet)
import $type;
#end
/**
* $!{po.properties.comment}
* @author ${global.user.userName}
*/
public class ${po.name}Po {
#foreach($property in $po.association)
/**
* $!{property.propertyComment}
*/
private ${property.propertyType} ${property.propertyName};
#end
public ${po.name}Po() {
}
#foreach($property in $po.association)
#set($propertyNameUpperCase = ${property.propertyName.substring(0, 1).toUpperCase().concat($property.propertyName.substring(1))})
public ${property.propertyType} get${propertyNameUpperCase}() {
return ${property.propertyName};
}
public void set${propertyNameUpperCase}(${property.propertyType} ${property.propertyName}) {
this.${property.propertyName} = ${property.propertyName};
}
#end
}
####新建生成策略，生成策略是一组标签集，定义了生成文件和生成文件夹的规则，标签中的属性采用EL表达式访问变量。
####新建实例，每个生成器可以创建多个实例，一个实例一份数据。
####进入工作台输入生成器所需数据。
####点击工具按钮，选择自定义的生成策略。
####弹出对话框，点击确定即可生成。
####生成后下载文件即可获得目标代码。
####此时再进入首页，就不是空空如也了
####另外生成器还可以导出来，满足一些如复制、备份的需求，有导出就有导入！！！
####示例中的生成器在blackdream/src/site/JavaBean代码生成器.zip 点击下载JavaBean代码生成器.zip
##sample项目说明
由于生成器所需的数据只能通过手动输入，不能实现自动化的需求，比如通过数据库表导入数据。
sample项目演示了如何通过简单的miniSDK来操作blackdream某个制定的生成器的数据。
sample/src/site/Employee.sql是sql脚本方便测试用建表。
sample/src/site/java数据层代码生成器.zip是一个比教程更为复杂一点的生成器文件，部署成功后导入即可，sample项目通过程序接口对其操作数据。