发布于 2017-11-03 00:58:54 | 72 次阅读 | 评论: 0 | 来源: 网友投递

这里有新鲜出炉的精品教程,程序狗速度看过来!

YMP 轻量级JAVA开发框架

YMP(yMatePlatform)开发框架是一套轻量级的JAVA应用开发框架,开发初衷只是想按自己的编码习惯,尽量采用最简单的方式实现我需要的东西,达到简化工作任务、统一开发流程为目标,能够减轻一点点的工作压力,让开发变成快乐的事!


YMP-Maven-Extension(YMP Maven扩展工具)

帮助您快速搭建基于YMP框架的各种Java工程结构的Maven扩展工具集合,主要包括项目模板和Maven插件命令两部分。

YMP框架项目地址:https://gitee.com/suninformation/ymate-platform-v2

1、项目模板

目前提供以下4种项目模板:

  • ymate-archetype-quickstart (quickstart):标准Java工程,已集成YMP依赖;

  • ymate-archetype-webapp (webapp):JavaWeb工程,已集成WebMVC框架相关依赖和完整的参数配置;

  • ymate-archetype-module (module):YMP模块工程,提供Demo示例及JUint测试代码;

  • ymate-archetype-serv (serv):YMP服务工程,分别提供TCP、UDP客户端和服务端示例程序及相关配置;

查看使用文档:通过项目模板自动生成Java工程

2、Maven插件命令

  • 在pom.xml文件中添加插件配置(必须):

    <plugin>      <groupId>net.ymate.maven.plugins</groupId>      <artifactId>ymate-maven-plugin</artifactId>      <version>1.0-SNAPSHOT</version>  </plugin>
  • 执行命令格式:

    mvn ymate:<COMMAND> -D<PARAM_1>=<VALUE_1> -D<PARAM_n>=<VALUE_n>

    注:请在pom.xml文件所在路径下执行;

  • 命令列表:

                            命令                         说明
                            module                         模块代码生成器
                            controller                         控制器类生成器
                            mapping                         控制器请求方法生成器
                            interceptor                         拦截器类生成器
                            validator                         验证器类生成器
                            repository                         存储器类生成器
                            service                         服务层类生成器
                            config                         配置类生成器
                            enpasswd                         字符串加密
                            depasswd                         字符串解密
                            tomcat                         Tomcat服务配置生成器
                            entity                         数据实体代码生成器
                            crud                         CRUD代码生成器

2.1 插件命令详解

2.1.1 module:模块代码生成器

用于生成基于IModule接口的模块代码实现(完全替代ymate-archetype-module (module)模板);

参数列表:

                        参数名称                         必须                         说明
                        name                         是                         模块名称
                        package                         否                         模块包名,默认值:${project.groupId}.module

命令示例:

创建名称为Demo的模块;

执行命令:

mvn ymate:module -Dname=Demo

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:module (default-cli) @ ympDemo ---  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/module/IDemo.java  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/module/Demo.java  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/module/IDemoModuleCfg.java  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/module/impl/DefaultModuleCfg.java  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.504s  [INFO] Finished at: Tue Oct 31 17:12:56 CST 2017  [INFO] Final Memory: 9M/245M  [INFO] ------------------------------------------------------------------------
2.1.2 controller:控制器类生成器

        用于生成适用于WebMVC模块的控制器类代码;

参数列表:

                        参数名称                         必须                         说明
                        name                         是                         控制器名称
                        package                         否                         控制器包名,默认值:${project.groupId}.controller
                        suffix                         否                         控制器类名后缀,默认值:Controller
                        singleton                         否                         控制器是否为单例,默认值:true
                        transaction                         否                         是否添加事务注解,默认值:false
                        mapping                         否                         控制器请求根路径,默认值:空
                        mapping.method                         否                         控制器请求方式,默认值:空,多个用,分隔,取值范围:GET,HEAD,POST,PUT,DELETE,OPTIONS,TRACE
                        mapping.header                         否                         控制器请求头,默认值:空,多个用,分隔
                        mapping.param                         否                         控制器请求参数,默认值:空,多个用,分隔

命令示例:

创建名称为DemoAction的控制器类,内容如下:

@Controller  @RequestMapping(value = "/user/info", method = {Type.HttpMethod.POST, Type.HttpMethod.GET} )  public class DemoAction {        @RequestMapping("/")      public IView __index() throws Exception {          return View.textView("Hello YMPer!");      }  }

执行命令:

mvn ymate:controller -Dname=Demo -Dsuffix=Action -Dmapping=/user/info -Dmapping.method=post,get

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:controller (default-cli) @ ympDemo ---  [INFO] properties:  [INFO] 	|--controllerName:DemoAction  [INFO] 	|--packageName:net.ymate.demo.controller  [INFO] 	|--singleton:true  [INFO] 	|--transaction:false  [INFO] 	|--mapping:/user/info  [INFO] 	  |--method:POST  [INFO] 	  |--method:GET  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/controller/DemoAction.java  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.377s  [INFO] Finished at: Tue Oct 31 17:48:20 CST 2017  [INFO] Final Memory: 8M/245M  [INFO] ------------------------------------------------------------------------
2.1.3 mapping:控制器请求方法生成器

用于为指定的控制器类追加请求方法代码片段;

参数列表:

                        参数名称                         必须                         说明
                        name                         是                         控制器名称
                        package                         否                         控制器包名,默认值:${project.groupId}.controller
                        suffix                         否                         控制器类名后缀,默认值:Controller
                        method                         是                         控制器方法名称
                        method.param                         否                         控制器方法参数,默认值:空,多个用,分隔;可以通过<取值方式>:<参数名称>指定参数取值方式,取值方式包括:path,header,cookie,model,file
                        fileUpload                         否                         是否添加@FileUpload注解
                        transaction                         否                         是否添加事务注解,默认值:false
                        mapping                         否                         控制器请求根路径,默认值:空
                        mapping.method                         否                         控制器请求方式,默认值:空,多个用,分隔,取值范围:GET,HEAD,POST,PUT,DELETE,OPTIONS,TRACE
                        mapping.header                         否                         控制器请求头,默认值:空,多个用,分隔
                        mapping.param                         否                         控制器请求参数,默认值:空,多个用,分隔

命令示例:

为名称为DemoAction的控制器类添加__sayHi请求方法并添加username和age方法参数,其中age参数通过@Pathvariable注解获取,内容如下:

@RequestMapping(value = "/sayHi/{age}" )  public IView __sayHi(@RequestParam String username, @PathVariable String age) throws Exception {      return View.textView("mapping: /sayHi/{age}");  }

执行命令:

mvn ymate:mapping -Dname=Demo -Dsuffix=Action -Dmapping=/sayHi/{age} -Dmethod=sayHi -Dmethod.param=username,path:age

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:mapping (default-cli) @ ympDemo ---  [INFO] properties:  [INFO] 	|--controllerName:DemoAction  [INFO] 	|--fileUpload:false  [INFO] 	|--transaction:false  [INFO] 	|--method:__sayHi  [INFO] 	  |--param:username  [INFO] 	  |--param:path:age  [INFO] 	|--mapping:/sayHi/{age}  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/controller/DemoAction.java  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.482s  [INFO] Finished at: Wed Nov 01 22:27:58 CST 2017  [INFO] Final Memory: 11M/309M  [INFO] ------------------------------------------------------------------------
2.1.4 interceptor:拦截器类生成器

用于生成拦截器类代码;

参数列表:

                        参数名称                         必须                         说明
                        name                         是                         拦截器名称
                        package                         否                         拦截器包名,默认值:${project.groupId}.intercept
                        suffix                         否                         拦截器类名后缀,默认值:Interceptor

命令示例:

创建名称为DemoInterceptor的拦截器,内容如下:

public class DemoInterceptor extends AbstractInterceptor {        @Override      protected Object __before(InterceptContext context) throws Exception {          return null;      }        @Override      protected Object __after(InterceptContext context) throws Exception {          return null;      }  }

执行命令:

mvn ymate:interceptor -Dname=Demo

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:interceptor (default-cli) @ ympDemo ---  [INFO] properties:  [INFO] 	|--interceptorName:DemoInterceptor  [INFO] 	|--packageName:net.ymate.demo.intercept  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/intercept/DemoInterceptor.java  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.421s  [INFO] Finished at: Wed Nov 01 22:41:23 CST 2017  [INFO] Final Memory: 9M/245M  [INFO] ------------------------------------------------------------------------
2.1.5 validator:验证器类生成器

用于生成验证器注解及类代码;

参数列表:

                        参数名称                         必须                         说明
                        name                         是                         验证器名称
                        package                         否                         验证器包名,默认值:${project.groupId}.validation
                        suffix                         否                         验证器类名后缀,默认值:Validator

命令示例:

创建名称为VDemo和DemoValidator的验证器注解和验证器类,内容如下:

@Target({ElementType.FIELD, ElementType.PARAMETER})  @Retention(RetentionPolicy.RUNTIME)  @Documented  public @interface VDemo {        /**       * @return 自定义验证消息       */      String msg() default "";  }    @Validator(VDemo.class)  @CleanProxy  public class DemoValidator extends AbstractValidator {        @Override      public ValidateResult validate(ValidateContext context) {          Object _paramValue = context.getParamValue();          if (_paramValue != null) {              boolean _matched = false;              VDemo _anno = (VDemo) context.getAnnotation();                // TODO Code here.                if (_matched) {                  String _pName = StringUtils.defaultIfBlank(context.getParamLabel(), context.getParamName());                  _pName = __doGetI18nFormatMessage(context, _pName, _pName);                  String _msg = StringUtils.trimToNull(_anno.msg());                  if (_msg != null) {                      _msg = __doGetI18nFormatMessage(context, _msg, _msg, _pName);                  }                  return new ValidateResult(context.getParamName(), _msg);              }          }          return null;      }  }

执行命令:

mvn ymate:validator -Dname=Demo

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:validator (default-cli) @ ympDemo ---  [INFO] properties:  [INFO] 	|--validatorName:DemoValidator  [INFO] 	|--packageName:net.ymate.demo.validation  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/validation/VDemo.java  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/validation/DemoValidator.java  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.438s  [INFO] Finished at: Wed Nov 01 22:48:42 CST 2017  [INFO] Final Memory: 9M/245M  [INFO] ------------------------------------------------------------------------
2.1.6 repository:存储器类生成器

用于生成存储器类代码;

参数列表:

                        参数名称                         必须                         说明
                        name                         是                         存储器名称
                        package                         否                         存储器包名,默认值:${project.groupId}.repository
                        suffix                         否                         存储器类名后缀,默认值:Repository
                        transaction                         否                         是否添加事务注解,默认值:false
                        config                         否                         是否启用配置对象,默认值:false
                        interface                         否                         是否启用接口模式,默认值:false

命令示例:

创建名称为DemoRepository的存储器并启用配置对象和接口模式,内容如下:

public interface IDemoRepository {        IResultSet<Object[]> execSql(String hash, IResultSet<Object[]> results) throws Exception;        List<Object[]> execQuery(String hash, IResultSet<Object[]>... results) throws Exception;  }    @Repository  @Transaction  public class DemoRepository implements IDemoRepository,  IRepository {        @Inject      private DemoRepositoryConfig __config;        @Override      public IConfiguration getConfig() {          return __config;      }        /**      * 自定义SQL      */      @Repository("select * from table1 where hash = ${hash}")      public IResultSet<Object[]> execSql(String hash, IResultSet<Object[]> results) throws Exception {          return results;      }        /**      * 读取配置文件中的SQL      */      @Repository(item = "demo_query")      public List<Object[]> execQuery(String hash, IResultSet<Object[]>... results) throws Exception {          return results[0].getResultData();      }  }

执行命令:

mvn ymate:repository -Dname=Demo -Dtransaction=true -Dconfig=true -Dinterface=true

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:repository (default-cli) @ ympDemo ---  [INFO] properties:  [INFO] 	|--repositoryName:DemoRepository  [INFO] 	|--packageName:net.ymate.demo.repository  [INFO] 	|--transaction:true  [INFO] 	|--withConfig:true  [INFO] 	|--withInterface:true  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/repository/IDemoRepository.java  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/repository/impl/DemoRepository.java  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.438s  [INFO] Finished at: Wed Nov 01 23:36:27 CST 2017  [INFO] Final Memory: 9M/245M  [INFO] ------------------------------------------------------------------------
2.1.7 service:服务层类生成器

用于生成服务层类代码;

参数列表:

                        参数名称                         必须                         说明
                        name                         是                         服务类名称
                        package                         否                         服务类包名,默认值:${project.groupId}.service
                        suffix                         否                         服务类名后缀,默认值:Service
                        transaction                         否                         是否添加事务注解,默认值:false

命令示例:

创建名称为DemoService的服务类及接口,内容如下:

public interface IDemoService {  }    @Bean  public class DemoService implements IDemoService {  }

执行命令:

mvn ymate:service -Dname=Demo

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:service (default-cli) @ ympDemo ---  [INFO] properties:  [INFO] 	|--serviceName:DemoService  [INFO] 	|--packageName:net.ymate.demo.service  [INFO] 	|--transaction:false  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/service/IDemoService.java  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/service/impl/DemoService.java  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.425s  [INFO] Finished at: Wed Nov 01 23:44:13 CST 2017  [INFO] Final Memory: 10M/309M  [INFO] ------------------------------------------------------------------------
2.1.8 config:配置类生成器

用于生成基于YMP框架配置体系结构的配置类代码及相关配置文件;

参数列表:

                        参数名称                         必须                         说明
                        name                         是                         配置类名称
                        home                         否                         配置体系根路径,WEB工程默认值:/src/main/webapp/WEB-INF,普通工程默认值:/src/main/resources
                        properties                         否                         是否使用properties格式的配置文件,默认值:false
                        file                         否                         自定义配置文件相对路径,默认值:`cfgs/<配置类名称>.cfg.<xml
                        package                         否                         配置类包名,默认值:${project.groupId}.service
                        suffix                         否                         配置类名后缀,默认值:Service
                        interface                         否                         是否启用接口模式,默认值:false

命令示例:

创建名称为DemoConfig的配置类、接口和配置文件,内容如下:

public interface IDemoConfig {  }    @Configuration("cfgs/demo.cfg.xml")  public class DemoConfig extends DefaultConfiguration implements IDemoConfig {  }    // --- cfgs/demo.cfg.xml    <?xml version="1.0" encoding="UTF-8"?>  <!-- 用XML格式书写与configuration.properties相同的配置内容 -->  <!-- XML根节点为properties, abc代表扩展属性key, xyz代表扩展属性值 -->  <properties abc="xyz">      <!-- 分类节点为category, 默认分类名称为default, abc代表扩展属性key, xyz代表扩展属性值 -->      <category name="default" abc="xyz">          <!-- 属性标签为property, name代表属性名称, value代表属性值(也可以用property标签包裹), abc代表扩展属性key, xyz代表扩展属性值 -->          <property name="company_name" abc="xyz" value="Apple Inc."/>          <!-- 用属性标签表示一个数组或集合数据类型的方法, abc代表扩展属性key, xyz代表扩展属性值, 这一点与properties配置文件不同 -->          <property name="products" abc="xyz">              <!-- 集合元素必须用value标签包裹, 且value标签不要包括任何扩展属性 -->              <value>iphone</value>              <value>ipad</value>              <value>imac</value>              <value>itouch</value>          </property>          <!-- 用属性标签表示一个MAP数据类型的方法, abc代表扩展属性key, xyz代表扩展属性值, 扩展属性与item将被合并处理  -->          <property name="product_spec" abc="xzy">              <!-- MAP元素用item标签包裹, 且item标签必须包含name扩展属性(其它扩展属性将被忽略), 元素值由item标签包裹 -->              <item name="color">red</item>              <item name="weight">120g</item>              <item name="size">small</item>              <item name="age">2015</item>          </property>      </category>  </properties>

执行命令:

mvn ymate:config -Dname=Demo -Dinterface=true

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:config (default-cli) @ ympDemo ---  [INFO] properties:  [INFO] 	|--type:jar  [INFO] 	|--configHome:/src/main/resources  [INFO] 	|--configName:DemoConfig  [INFO] 	|--packageName:net.ymate.demo.config  [INFO] 	|--fileName:cfgs/demo.cfg.xml  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/config/IDemoConfig.java  [INFO] Output file: /Users/.../ympDemo/src/main/java/net/ymate/demo/config/impl/DemoConfig.java  [INFO] Output file: /Users/.../ympDemo/src/main/resources/cfgs/demo.cfg.xml  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.434s  [INFO] Finished at: Thu Nov 02 00:05:02 CST 2017  [INFO] Final Memory: 9M/245M  [INFO] ------------------------------------------------------------------------
2.1.9 enpasswd:字符串加密

基于IPasswordProcessor密码处理器接口的默认DES实现,对数据库等登录密码进行加密操作;

参数列表:

                        参数名称                         必须                         说明
                        passwd                         是                         原始字符串

命令示例:

对字符串abc12345678进行加密:

执行命令:

mvn ymate:enpasswd -Dpasswd=abc12345678

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:enpasswd (default-cli) @ ympDemo ---  [INFO] Encrypt password: D3ytOQrD63BlKGDMJnaYsQ==  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.515s  [INFO] Finished at: Thu Nov 02 09:00:35 CST 2017  [INFO] Final Memory: 11M/245M  [INFO] ------------------------------------------------------------------------
2.1.10 depasswd:字符串解密

基于IPasswordProcessor密码处理器接口的默认DES实现,对数据库等登录密码进行解密操作;

参数列表:

                        参数名称                         必须                         说明
                        passwd                         是                         已加密字符串

命令示例:

对已加密字符串D3ytOQrD63BlKGDMJnaYsQ==进行解密:

执行命令:

mvn ymate:depasswd -Dpasswd=D3ytOQrD63BlKGDMJnaYsQ==

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:depasswd (default-cli) @ ympDemo ---  [INFO] Decrypt password: abc12345678  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.459s  [INFO] Finished at: Thu Nov 02 09:03:51 CST 2017  [INFO] Final Memory: 11M/245M  [INFO] ------------------------------------------------------------------------
2.1.11 tomcat:Tomcat服务配置生成器

生成基于Tomcat的获立JVM服务目录结构及配置文件,目前支持Tomcat版本:6、7、8;

参数列表:

                        参数名称                         必须                         说明
                        serviceName                         是                         服务名称(若在Windows环境下同时为注册服务名称)
                        catalinaHome                         是                         Tomcat软件包安装路径,默认值:${CATALINA_HOME}
                        catalinaBase                         否                         生成的服务存放的位置,默认值:当前路径
                        hostName                         否                         主机名称,默认值:localhost
                        hostAlias                         否                         别名,默认值:空
                        tomcatVersion                         否                         指定Tomcat软件包的版本,默认值:7,目前支持:6,7,8,(必须与catalinaHome指定的版本匹配)
                        servicePort                         否                         服务端口(Tomcat服务的Server端口),默认值:8005
                        connectorPort                         否                         容器端口(Tomcat服务的Connector端口),默认值:8088
                        ajp                         否                         是否启用AJP配置,默认值:false
                        ajpHost                         否                         AJP主机名称,默认值:localhost
                        ajpPort                         否                         AJP端口,默认值:8009

命令示例:

基于Tomcat7.x创建名称为DemoServer的服务:

执行命令:

mvn ymate:tomcat -DserviceName=DemoServer -DcatalinaHome=/Users/.../apache-tomcat-7.0.54 -DcatalinaBase=/Users/.../Temp

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:tomcat (default-cli) @ ympDemo ---  [INFO] Tomcat Service:DemoServer  [INFO] 	|--CatalinaHome:/Users/.../apache-tomcat-7.0.54  [INFO] 	|--CatalinaBase:/Users/.../Temp  [INFO] 	|--HostName:localhost  [INFO] 	|--HostAlias:  [INFO] 	|--TomcatVersion:7  [INFO] 	|--ServerPort:8005  [INFO] 	|--ConnectorPort:8080  [INFO] 	|--RedirectPort:8443  [INFO] 	|--Ajp:false  [INFO] Output file: /Users/.../Temp/DemoServer/conf/server.xml  [INFO] Output file: /Users/.../Temp/DemoServer/vhost.conf  [INFO] Output file: /Users/.../Temp/DemoServer/bin/install.bat  [INFO] Output file: /Users/.../Temp/DemoServer/bin/manager.bat  [INFO] Output file: /Users/.../Temp/DemoServer/bin/shutdown.bat  [INFO] Output file: /Users/.../Temp/DemoServer/bin/startup.bat  [INFO] Output file: /Users/.../Temp/DemoServer/bin/uninstall.bat  [INFO] Output file: /Users/.../Temp/DemoServer/bin/manager.sh  [INFO] Output file: /Users/.../Temp/DemoServer/webapps/ROOT/index.jsp  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.498s  [INFO] Finished at: Thu Nov 02 10:05:47 CST 2017  [INFO] Final Memory: 11M/309M  [INFO] ------------------------------------------------------------------------

生成的文件说明:

                        文件名称                         说明
                        conf/server.xml                         Tomcat服务配置文件
                        vhost.conf                         与Nginx和Apache Server整合所需配置
                        bin/install.bat                         Windows环境下服务安装
                        bin/manager.bat                         Windows环境下打开Tomcat服务管理
                        bin/shutdown.bat                         Windows环境下服务停止
                        bin/startup.bat                         Windows环境下服务启动
                        bin/uninstall.bat                         Windows环境下服务卸载
                        bin/manager.sh                         Linux或Unix环境下控制服务的启动或停止等操作
                        webapps/ROOT/index.jsp                         默认JSP首页文件

Linux下服务的启动和停止:

需要为manager.sh添加执行权限:

执行命令:

chmod +x manager.sh

启动服务:

执行命令:

./manager.sh start

控制台输出:

Using CATALINA_BASE:   /Users/.../Temp/DemoServer  Using CATALINA_HOME:   /Users/.../apache-tomcat-7.0.54  Using CATALINA_TMPDIR: /Users/.../Temp/DemoServer/temp  Using JRE_HOME:        /Library/Java/JavaVirtualMachines/jdk1.8.0_20.jdk/Contents/Home  Using CLASSPATH:       /Users/.../apache-tomcat-7.0.54/bin/bootstrap.jar:/Users/.../apache-tomcat-7.0.54/bin/tomcat-juli.jar  Using CATALINA_PID:    /Users/.../Temp/DemoServer/logs/catalina.pid  Tomcat started.

停止服务:

执行命令:

./manager.sh stop

控制台输出:

Using CATALINA_BASE:   /Users/.../Temp/DemoServer  Using CATALINA_HOME:   /Users/.../apache-tomcat-7.0.54  Using CATALINA_TMPDIR: /Users/.../Temp/DemoServer/temp  Using JRE_HOME:        /Library/Java/JavaVirtualMachines/jdk1.8.0_20.jdk/Contents/Home  Using CLASSPATH:       /Users/.../apache-tomcat-7.0.54/bin/bootstrap.jar:/Users/.../apache-tomcat-7.0.54/bin/tomcat-juli.jar  Using CATALINA_PID:    /Users/.../Temp/DemoServer/logs/catalina.pid  Tomcat stopped.
2.1.12 entity:数据实体代码生成器

通过已有数据库表结构生成对应的数据实体类,支持表和视图,支持ConsoleTable和markdown格式输出表结构;

参数列表:

                        参数名称                         必须                         说明
                        view                         否                         指定本次针对视图生成代码,默认值:false
                        markdown                         否                         是否采用markdown格式输出表结构,默认值:false

数据源及生成规则配置:

在生成数据实体之前,需要先将默认数据源和实体生成规则配置好,请根据实际需求配置并确认ymp-conf.properties以下内容:

#-------------------------------------  # JDBC持久化模块初始化参数  #-------------------------------------    # 是否显示执行的SQL语句,默认为false  ymp.configs.persistence.jdbc.ds.default.show_sql=true    # 数据库表前缀名称,默认为空  ymp.configs.persistence.jdbc.ds.default.table_prefix=ym_    # 数据库连接字符串,必填参数  ymp.configs.persistence.jdbc.ds.default.connection_url=jdbc:mysql://localhost:3306/ymate_demo    # 数据库访问用户名称,必填参数  ymp.configs.persistence.jdbc.ds.default.username=root    # 数据库访问密码,可选参数  ymp.configs.persistence.jdbc.ds.default.password=    #-------------------------------------  # JDBC数据实体代码生成器配置参数  #-------------------------------------    # 是否生成新的BaseEntity类,默认为false(即表示使用框架提供的BaseEntity类)  ymp.params.jdbc.use_base_entity=    # 是否使用类名后缀,不使用和使用的区别如: User-->UserModel,默认为false  ymp.params.jdbc.use_class_suffix=    # 是否采用链式调用模式,默认为false  ymp.params.jdbc.use_chain_mode=    # 是否添加类成员属性值状态变化注解,默认为false  ymp.params.jdbc.use_state_support=    # 实体及属性命名过滤器接口实现类,默认为空  ymp.params.jdbc.named_filter_class=    # 数据库名称(仅针对特定的数据库使用,如Oracle),默认为空  ymp.params.jdbc.db_name=    # 数据库用户名称(仅针对特定的数据库使用,如Oracle),默认为空  ymp.params.jdbc.db_username=    # 数据库表名称前缀,多个用'|'分隔,默认为空  ymp.params.jdbc.table_prefix=    # 否剔除生成的实体映射表名前缀,默认为false  ymp.params.jdbc.remove_table_prefix=    # 预生成实体的数据表名称列表,多个用'|'分隔,默认为空表示全部生成  ymp.params.jdbc.table_list=    # 排除的数据表名称列表,在此列表内的数据表将不被生成实体,多个用'|'分隔,默认为空  ymp.params.jdbc.table_exclude_list=    # 需要添加@Readonly注解声明的字段名称列表,多个用'|'分隔,默认为空  ymp.params.jdbc.readonly_field_list=    # 生成的代码文件输出路径,默认为${root}  ymp.params.jdbc.output_path=    # 生成的代码所属包名称,默认为: packages  ymp.params.jdbc.package_name=

命令示例:

执行命令:

mvn ymate:entity

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building carfriend-core 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:entity (default-cli) @ carfriend-core ---  十一月 02, 2017 11:41:09 上午 net.ymate.platform.core.YMP init  信息:  __   ____  __ ____          ____    / /  /  |  _   __   _|___     V /| |/| | |_) |   / / __) |    | | | |  | |  __/    V / / __/    |_| |_|  |_|_|       _/ |_____|  Website: http://www.ymate.net/  十一月 02, 2017 11:41:09 上午 net.ymate.platform.core.YMP init  信息: Initializing ymate-platform-core-2.0.2-Release build-20171030-0108 - debug:true  十一月 02, 2017 11:41:09 上午 net.ymate.platform.persistence.jdbc.JDBC init  信息: Initializing ymate-platform-persistence-jdbc-2.0.2-Release build-20171030-0108  十一月 02, 2017 11:41:09 上午 net.ymate.platform.core.YMP init  信息: Initialization completed, Total time: 191ms  十一月 02, 2017 11:41:09 上午 net.ymate.platform.persistence.jdbc.base.AbstractOperator execute  信息: [show full tables where Table_type='BASE TABLE'][][1][31ms]  Output file /Users/.../src/main/java/net/ymate/model/CategoryAttribute.java  TABLE_NAME: ym_category_attribute  MODEL_NAME: CategoryAttribute  +-------------+-------------------+-------------+----------------+--------+-----------+-------+----------+---------+---------+  | COLUMN_NAME | COLUMN_CLASS_NAME | PRIMARY_KEY | AUTO_INCREMENT | SIGNED | PRECISION | SCALE | NULLABLE | DEFAULT | REMARKS |  +-------------+-------------------+-------------+----------------+--------+-----------+-------+----------+---------+---------+  | id          | java.lang.String  | TRUE        | FALSE          | FALSE  | 32        | 0     | FALSE    | NULL    |         |  +-------------+-------------------+-------------+----------------+--------+-----------+-------+----------+---------+---------+  | catetory_id | java.lang.String  | FALSE       | FALSE          | FALSE  | 32        | 0     | FALSE    | NULL    |         |  +-------------+-------------------+-------------+----------------+--------+-----------+-------+----------+---------+---------+  | attr_key    | java.lang.String  | FALSE       | FALSE          | FALSE  | 255       | 0     | FALSE    | NULL    |         |  +-------------+-------------------+-------------+----------------+--------+-----------+-------+----------+---------+---------+  | attr_value  | java.lang.String  | FALSE       | FALSE          | FALSE  | 16383     | 0     | TRUE     | NULL    |         |  +-------------+-------------------+-------------+----------------+--------+-----------+-------+----------+---------+---------+  | type        | java.lang.Integer | FALSE       | FALSE          | FALSE  | 2         | 0     | TRUE     | 0       |         |  +-------------+-------------------+-------------+----------------+--------+-----------+-------+----------+---------+---------+  | owner       | java.lang.String  | FALSE       | FALSE          | FALSE  | 32        | 0     | TRUE     | NULL    |         |  +-------------+-------------------+-------------+----------------+--------+-----------+-------+----------+---------+---------+      [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 1.013s  [INFO] Finished at: Thu Nov 02 11:41:10 CST 2017  [INFO] Final Memory: 12M/208M  [INFO] ------------------------------------------------------------------------

特别提示:

通过插件生成的代码默认放置在src/main/java路径,当数据库表发生变化时,直接执行插件命令就可以快速更新数据实体对象;

如果使用的JDBC驱动是mysql-connector-java-6.x及以上版本时,需要配置db_name和db_username参数,否则会产生异常;

2.1.13 crud:CRUD代码生成器

通过规则配置文件自动生成控制器(Controller)、存储器(Repository)等类代码,包括拦截器、参数验证、权限控制、文件上传、组件条件查询等;

参数列表:

                        参数名称                         必须                         说明
                        file                         否                         CRUD规则配置文件,默认值:misc/crud.json
                        action                         否                         指定本次生成哪些代码,默认值:全部,取值范围:controller,repository
                        fromDb                         否                         是否通过数据库表结构生成规则配置文件,默认值:false
                        mapping                         否                         指定生成的控制器基准RequestMapping路径,默认值:空

命令示例:

生成默认CRUD规则配置文件:

执行命令:

mvn ymate:crud

控制台输出:

Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8  [INFO] Scanning for projects...  [INFO]  [INFO] ------------------------------------------------------------------------  [INFO] Building ympDemo 1.0-SNAPSHOT  [INFO] ------------------------------------------------------------------------  [INFO]  [INFO] --- ymate-maven-plugin:1.0-SNAPSHOT:crud (default-cli) @ ympDemo ---  [INFO] Output file: /Users/.../Temp/ympDemo/misc/crud.json  [INFO] ------------------------------------------------------------------------  [INFO] BUILD SUCCESS  [INFO] ------------------------------------------------------------------------  [INFO] Total time: 0.424s  [INFO] Finished at: Thu Nov 02 12:12:17 CST 2017  [INFO] Final Memory: 9M/245M  [INFO] ------------------------------------------------------------------------

若使用-DfromDb=true方式通过数据库表结构生成规则配置文件,需要在ymp-conf.properties文件中配置好默认数据源;

以上命令在执行时,若crud.json配置文件存在则直接生成代码,否则将生成默认配置文件,内容如下:

规则配置文件说明:

{      "application": {                        // ————基本信息          "name": "ympDemo",                  // 名称          "version": "1.0-SNAPSHOT",          // 当前配置版本          "package": "net.ymate.demo",        // 代码基准包名          "author": "ymatescaffold",          // 作者信息          "createTime": "2017/11/02 12:12",   // 配置文件创建时间          "locked": false                     // 是否锁定,锁定状态下不会生成任何文件      },      "security": {               // ————权限安全相关配置          "enabled": false,       // 是否开启权限配置          "name": "",             // 权限组名称          "prefix": "",           // 权限名称前缀          "roles": {              // 基本角色配置              "admin": false,     // 是否管理员角色              "operator": false,  // 是否操作员角色              "user": false       // 是否普通用户角色          },          "permissions": []       // 全局权限列表,如:["USER_ADD", "USER_DETAIL"]      },      "intercept": {      // ————拦截器相关配置          "before": [],   // 前置拦截器类名集合,如:["net.ymate.demo.intercept.UserInterceptor"]          "after": [],    // 后置拦截器类名集合          "around": [],   // 环绕(前、后置)拦截器类名集合          "params": {}    // 拦截器参数,如:{"p1": "p1_value"}      },      "apis": [                               // ————接口对象相关配置          {              "name": "",                     // 当前接口对象名称,如:”user“              "mapping": "",                  // 当前控制器类基准URL路径,如:"/v1/user"              "type": "model",                // 生成类型,取值范围:model,query              "model": "",                    // 数据实体类名,当type="model"时必填,如:"net.ymate.model.User"              "query": "",                    // SQL查询语句,当type="query"时必填              "description": "",              // 文档描述              "locked": false,                // 是否锁定,锁定状态下忽略当前配置的代码生成              "timestamp": false,             // 是否使用create_time和last_modify_time字段              "status": [                     // ————自定义数据状态处理相关配置                  {                      "enabled": false,       // 是否生成此状态配置代码                      "name": "delete",       // 名称(用于生成方法名称)                      "column": "is_deleted", // 对应的数据表字段名称                      "type": "integer",      // 数据类型,常用string,integer,long等对象类型                      "value": "1",           // 本次操作将变更字段的值                      "reason": false,        // 是否必须提交操作原因说明参数                      "description": ""       // 文档描述                  }              ],              "primary": {                // ——主键参数                  "name": "",             // 参数名称                  "label": "",            // 参数标签名称(用于显示)                  "column": "",           // 参数对应的数据表字段名称                  "type": "string",       // 数据类型,常用string,integer,long等对象类型                  "validation": {         // ————参数验证相关配置                      "max": 0,           // 参数最大长度                      "min": 0,           // 参数最小长度                      "regex": "",        // 正则表达式                      "numeric": false    // 是否必须为数值                  },                  "description": ""       // 参数文档描述              },              "params": [                     // ————参数集合                  {                      "name": "",             // 参数名称                      "label": "",            // 参数标签名称(用于显示)                      "column": "",           // 参数对应的数据表字段名称                      "type": "string",       // 数据类型,常用string,integer,long等对象类型                      "required": false,      // 是否必须                      "defaultValue": "",     // 参数默认值                      "validation": {         // ————参数验证相关配置                          "max": 0,           // 参数最大长度                          "min": 0,           // 参数最小长度                          "regex": "",        // 正则表达式                          "mobile": false,    // 是否必须为手机号码格式                          "email": false,     // 是否必须为邮箱地址格式                          "numeric": false,   // 是否必须为数值                          "datetime": false   // 是否必须为日期时间戳                      },                      "filter": {             // ————查询相关配置                          "enabled": false,   // 是否作为查询条件                          "like": false,      // 是否采用like进行查询(自动为参数值两端添加"%")                          "region": false     // 是否采用between进行范围查询(一般用于数值和时间参数)                      },                      "upload": {             // ————文件上传相关配置                          "enabled": false,   // 是否接收上传文件                          "contentTypes": []  // 上传文件类型,如:["image/png", "image/jpeg"]                      },                      "description": ""       // 参数文档描述                  }              ]          }      ]  }

One More Thing

YMP不仅提供便捷的Web及其它Java项目的快速开发体验,也将不断提供更多丰富的项目实践经验。

了解更多有关YMP框架的内容,请访问官网:http://www.ymate.net/



历史版本 :
YMP v2.0.4 发布,轻量级 Java 应用开发框架
YMP v2.0.3 发布,轻量级 Java 应用开发框架
YMP Maven 扩展工具 v1.0 发布,快速搭建 Java 项目
YMP v2.0.2 发布,轻量级 Java 应用开发框架
YMP v2.0.1 发布,轻量级 Java 应用开发框架
YMP v2.0 模块项目集中发布!第一波!
YMP v2.0.0 发布,轻量级 Java 应用开发框架
YMP v2发布,轻量级Web开发框架
YMP v1.0 发布,轻量级 Web 开发框架
最新网友评论  共有(0)条评论 发布评论 返回顶部

Copyright © 2007-2017 PHPERZ.COM All Rights Reserved   冀ICP备14009818号  版权声明  广告服务