Koala使用手册.docx

Koala使用手册目录1使用Koala快速创建项目42数据库反向生成实体152.1使用前提152.2从数据库到实体的配置153自动生成CRUD193.1“查询条件”配置213.2“列表页面”配置263.3“详情页面”配置303.4“新增页面”配置333.5“编辑页面”配置343.6确认与生成344EJB发布364.1发布EJB服务364.2访问EJB服务注意事项385WebService发布385.1SOAP WebService发布385.2RESTful WebService发布406Koala-WS安全机制446.1WS安全机制446.2Koala WS安全机制446.2.1IP白名单及黑名单过滤机制456.2.2用户名密码检验机制466.2.3IP,用户的角色控制机制46在认证的基础上，还需要对认证的用户能访问到的方法进行控制，因此引进角色机制，允许WS配置不同的角色所能访问到的方法是不同的。466.2.4其它机制476.3配置与使用476.3.1开机安全机制476.3.2配置黑白IP名单496.3.3用户名密码验证506.3.4方法级权限机制517权限系统的Web管理和使用537.1用户登录538通用查询658.1添加通用查询功能658.2通用查询的使用668.2.1配置数据源678.2.2通用查询的配置699监控系统的web管理与使用7210Koala使用JPA作为仓储实现的开发规范7910.1上下文环境7910.2领域层业务开发8210.3应用层接口开发8410.4应用层实现开发8511Koala Mybatis开发规范8811.1领域层开发88findByNamedQuery9811.2应用层开发100使用Koala快速创建项目打开eclipse的新建项目向导对话框，选择Koala-Koala Project。点击Next按钮，出现Koala的新建项目向导，如图：在“Project name”处填写项目名称，在“Location”处选择项目路径，在“Working sets”处选择working set。如果其他使用默认，可只填项目名称。点击Next按钮，进入下一步，进入maven信息填写的向导页。填写Group Id，Artifact Id，Version和Description等信息，除了Description外其他均为必填项。点击Next按钮，进入添加模块的向导页。?如图：中间显示的当前项目的子模块，右边是相应的子模块的操作，包括新增，修改以及删除等操作另外，你可以选择JPA或Mybatis做为数据库实现，Koala支持这两种方式你也可以使用SpringMVC或Struts2MVC做为前台MVC实现选择Use Default Modules会根据DDD领域思想自动生成五层模型的项目其中应用层分为接口和实现两个模块。“demo-infra”为基础设施层的模块，“demo-core”为领域层的模块，“demo-application”为应用层接口模块，“demo-applicationImpl”为应用层实现模块，“demo-web”为展现层模，“demo-conf”为配置模块。开发这可以根据项目需要，添加模块，并对已有模块配置进行编辑或者删除操作。下面介绍项目模块配置的操作。点击右边add按钮，进入模块信息编辑页面。在编辑模块信息页面中，填写模块名称，选择模块类型（即根据DDD分层思想，选择该模块所在层，如基础设施层，领域层，应用层，展现层等)功能依赖是指当前子模块中加入一些常用的功能，如FTP,缓存等。加入这些功能是开箱即用的。模块依赖是指定义模块之间的依赖关系。定义模块依赖前最好对DDD思想有一定的了解点击确认便新增加了一个子模块你还可以编辑模块或删除它们根据项目情况，添加完所需的模块之后，点击Next按钮，进入下一步。如果所添加的模块中有视图层的模块，将会进入子系统集成的配置界面。Koala为你的项目提供了三个子系统集成，包括权限子系统，监控子系统以及通用查询子系统选中复选框，以集成你需要集成的子系统，点击每个子系统右边的config可以进行更为详细的配置，具体参考各子系统的相关教程。完成选择之后，点击Next按钮，进入最后的项目信息汇总展示页面。该页面展示了之前所填写的项目极其各模块的所有信息供用户核对。Project中显示了所填写的项目名称，Maven中显示了所填写的项目的maven信 息，包括Group Id，Artifact Id，Version和Description等内容。Modules中显示了所填写的各个模块的详细信息，包括模块类型，模块名称，模块间的依赖等内 容。如果发现信息有误，可点击Back按钮回到对应的向导页面去做修改。如果核对无误，点击Finish按钮完成项目信息的填写并根据所填