现学现用，写个Maven插件用下

Maven 插件实践

上一次简单介绍了如何编写一个Maven插件，并且如何将插件的执行与Maven生命周期绑定，这样通过调用maven生命周期方法时，则会在配置的阶段按照插件的目标来执行代码。

专注于为中小企业提供成都网站设计、成都网站建设服务,电脑端+手机端+微信端的三站合一,更高效的管理,为中小企业江夏免费做网站提供优质的服务。我们立足成都，凝聚了一批互联网行业人才，有力地推动了上1000家企业的稳健成长，帮助中小企业通过网站建设实现规模扩充和转变。

今天通过一个具体的插件来熟悉在项目中的使用。

一般公司的项目结构或者代码结构都是非常固定的，有一些框架针对这种固化的代码结构或约定的规范，在开发前会严格对项目进行模块划分，对各个模块的代码结构也会严格要求。那么我们则可以根据这种约定的规范，通过工具来自动化的生成代码，从而减少开发人员的工作量。

示例项目

比如我们的项目一般都会由多个模块组成，比如下面的示例：

DMP
    ├ system
    │ ├ account
    │   ├ entity
    │   ├ dao
    │   └ service
    │   └ web
    │ ├ role
    │   ├ ...
    │ ├ permission
    │   ├ ...    
    │ └ pom.xml
    ├ monitor
    │ ├ database
    │   ├ ...
    │ ├ disk
    │   ├ ...
    │ ├ memory
    │   ├ ...    
    │ └ pom.xml
    └ pom.xml

在上面的例子中，我们项目包括了system、monitor等多个模块，其中system模块包含了account、role、permission三个子模块， monitor模块包含了database、disk、memory三个子模块，每个子模块又包含了特定的代码结构. 这个属于我们约定的模块划分规则，那么基于这样的规则，我们完全可以通过开发一个插件来自动生成这种约定结构的空项目。

实现步骤

假设插件名称为 `module-create-maven-plugin`，将来我们会通过该插件实现
项目模块文件夹和一些通用文件的自动生成。插件大概配置如下：

   
      
         com.sucls.blog.plugin
         module-create-plugin
         1.0.0
         
            E:\\_projects\\demo\\DMP
            
               system/account
               system/role
               monitor/databse
               monitor/disk
               monitor/memory

根据我们预期要求，来设想插件的开发过程。

定义一个maven插件项目

创建一个maven插件项目，在pom.xml中添加如下配置：




    4.0.0

    com.sucls.blog.plugin
    module-create-plugin
    1.0.0
    maven-plugin

    
        
            org.apache.maven
            maven-plugin-api
            3.8.1
        
        
            org.apache.maven
            maven-core
            3.8.1
        
        
            org.apache.maven.plugin-tools
            maven-plugin-annotations
            3.8.1
            provided
        
        
            org.freemarker
            freemarker
            2.3.32

创建一个Mojo根据配置添加实现逻辑

goal的名字设计成modules，由于最终项目是基于maven构建，所以会生成pom.xml，插件中的几个参数就是为了生成pom而设计

@Mojo(name = "run")
public class ModulesCreatePlugin extends AbstractMojo {

    @Parameter(property = "basedir",defaultValue = "${project.basedir}")
    private String basedir;

    @Parameter
    private String project;

    @Parameter(property = "groupId",defaultValue = "${project.groupId}")
    private String groupId;
    @Parameter(property = "artifactId",defaultValue = "${project.artifactId}")
    private String artifactId;
    @Parameter(property = "version",defaultValue = "${project.version}")
    private String version;

    @Parameter
    private List modules;


    private ModuleTemplateHelper moduleTemplateHelper;

    public ModulesCreatePlugin(){
        init();
    }

    public void init(){
        moduleTemplateHelper = new ModuleTemplateHelper();
    }

    @Override
    public void execute() throws MojoExecutionException, MojoFailureException {
        Log log = getLog();
        log.info(StringUtils.repeat("=",50));

        log.info(modules.toString());
        createModules();

        log.info(StringUtils.repeat("=",50));
    }

    private void createModules() {
        if(modules != null && modules.size() >0){
            List moduleFiles = new ArrayList<>();

            modules.forEach(module -> {
                // 创建目录
                File path = new File(basedir,module);
                path.mkdirs();
                moduleFiles.add(path);
            });

            Set parentModules = new HashSet<>();

            // 添加pom.xml
            for (File module : moduleFiles) {
                File parent = module.getParentFile();
                parentModules.add(parent.getName());
                // 上级pom
                if( !new File(parent,"pom.xml").exists() ){
                    moduleTemplateHelper.process("pom.ftl", new ModuleEntity(groupId,project,version, parent.getName()),parent.getAbsolutePath()+"/pom.xml");
                }
                // 追缴module
                XmlUtils.appendModule(new File(parent,"pom.xml"), module.getName());

                // 模块pom
                moduleTemplateHelper.process("jar.ftl", new ModuleEntity(groupId,parent.getName(),version,module.getName()),module.getAbsolutePath()+"/pom.xml");
                new File(module,"src/main/java").mkdirs();
                new File(module,"src/main/resources").mkdirs();
            }

            // 项目pom.xml追加module
            if(new File(basedir,"pom.xml").exists()){
                for (String parentModule : parentModules) {
                    XmlUtils.appendModule(new File(basedir,"pom.xml"), parentModule);
                }
            }
        }
    }

}

上面我们通过ModuleTemplateHelper辅助类结合freemaker框架，最后为各个模块生成对应的pom.xml文件；通过自定义的XmlUtils工具类结合JDK Documentation API，实现父级模块中modules节点的添加子module；

public class ModuleTemplateHelper {

    private Configuration configuration;

    public ModuleTemplateHelper() throws IOException {
        configuration = new Configuration(Configuration.VERSION_2_3_22);
        configuration.setTemplateLoader(new ClassTemplateLoader(this.getClass(), "/templates"));
        configuration.setDefaultEncoding("UTF-8");
    }

    public void process(String tpl, Object module, String outputPath){
        Template template = configuration.getTemplate(tpl);
        template.process(module, new FileWriter(outputPath));
    }
}
public class XmlUtils {

    static DocumentBuilderFactory documentBuilderFactory = DocumentBuilderFactory.newInstance();
    static TransformerFactory transformerFactory = TransformerFactory.newInstance();
    static DocumentBuilder documentBuilder;

    static {
        try {
            documentBuilder = documentBuilderFactory.newDocumentBuilder();
        } catch (ParserConfigurationException e) {
            throw new RuntimeException(e);
        }
    }
    

    /**
     *
     * @param pomXmlPath
     * @param moduleName
     */
    public static void appendModule(File pomXml, String moduleName) {
        try {
            Document document = documentBuilder.parse(pomXml);
            NodeList modules = document.getElementsByTagName("modules");
            Node modulesNode = null;
            if( modules.getLength()>0 ){
                modulesNode = modules.item(0);
            }
            if( modulesNode == null ){
                modulesNode = document.createElement("modules");
                document.appendChild(modulesNode);
            }
            // 追加
            Element module = document.createElement("module");
            module.setTextContent(moduleName);
            modulesNode.appendChild(module);

            // 保存
            transformerFactory.newTransformer().transform(new DOMSource(document), new StreamResult(pomXml));
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
}

生成插件

执行下面的命令即可生成插件jar，并安装到本地仓库

mvn clean package

在项目中调用插件

在项目中引入插件，并且按照需要的模块添加配置，最后在IDEA右侧则可以看到该插件，双击运行，最终项目结构如下图：

结束语

很多技术本身不复杂，合理使用与加工则可以将我们平时工作中重复相似的工作内容进行简化，很多自动化工具亦是如此，只不过这些工作由别人完成了。通过今天的示例，主要了解如何将学到的知识具体化到工作中。

网站名称：现学现用，写个Maven插件用下
URL网址：http://www.shufengxianlan.com/qtweb/news18/247218.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联

猜你还喜欢下面的内容

建站公司知识

同城分类信息

川银永信　　 　成都移动机房　　 　晟和广告　　 　崇州做网站　　 　绵阳网站制作　　 　成都网站设计　　 　成都活动策划　　 　wap网站建设　　 　明安消防器材　　 　重庆app软件开发　　 　成都婚庆策划　　 　高端网站设计　　 　重庆托管服务器　　 　芦山网站建设　　 　广汉锦华　　 　移动手机网站制作　　 　鳄鱼养殖　　 　香港云虚拟主机　　 　乐山做网站　　 　成都企业网站维护