[SCB-1351] Some issues about using toolkit plugin

• Type: Task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: toolkit-0.1.0
• Fix Version/s: toolkit-0.1.0
• Component/s: toolkit
• Assignee: mabin
• Reporter: mabin
• Created: 05/Jul/19 11:27
• Updated: 22/Aug/19 08:25
• Resolved: 22/Aug/19 08:25

Description

use toolkit plugin to generate contract file,document and verify contract from myself sample,find some error as below,
1.the generated contract file is incorrect,it has no sufix name.
2.generate document from contract file,
[ERROR] Failed to execute goal org.apache.servicecomb.toolkit:toolkit-maven-plugin:0.1.0-SNAPSHOT:generateDoc (default-cli) on project bmi: Execution default-cli of goal org.apache.servicecomb.toolkit:toolkit-maven-plugin:0.1.0-SNAPSHOT:generateDoc failed.: NullPointerException -> [Help 1]
org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.servicecomb.toolkit:toolkit-maven-plugin:0.1.0-SNAPSHOT:generateDoc (default-cli) on project bmi: Execution default-cli of goal org.apache.servicecomb.toolkit:toolkit-maven-plugin:0.1.0-SNAPSHOT:generateDoc failed.
at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:213)
at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:154)
at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:146)
at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:117)
at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:81)
at org.apache.maven.lifecycle.internal.builder.singlethreaded.SingleThreadedBuilder.build(SingleThreadedBuilder.java:51)
at org.apache.maven.lifecycle.internal.LifecycleStarter.execute(LifecycleStarter.java:128)
at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:309)
at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:194)
at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:107)
at org.apache.maven.cli.MavenCli.execute(MavenCli.java:993)
at org.apache.maven.cli.MavenCli.doMain(MavenCli.java:345)
at org.apache.maven.cli.MavenCli.main(MavenCli.java:191)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at org.codehaus.plexus.classworlds.launcher.Launcher.launchEnhanced(Launcher.java:289)
at org.codehaus.plexus.classworlds.launcher.Launcher.launch(Launcher.java:229)
at org.codehaus.plexus.classworlds.launcher.Launcher.mainWithExitCode(Launcher.java:415)
at org.codehaus.plexus.classworlds.launcher.Launcher.main(Launcher.java:356)
Caused by: org.apache.maven.plugin.PluginExecutionException: Execution default-cli of goal org.apache.servicecomb.toolkit:toolkit-maven-plugin:0.1.0-SNAPSHOT:generateDoc failed.
at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:145)
at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:208)
... 20 more
Caused by: java.lang.NullPointerException
at org.apache.servicecomb.toolkit.plugin.GenerateContractsDocMojo$1.visitFile(GenerateContractsDocMojo.java:80)
at org.apache.servicecomb.toolkit.plugin.GenerateContractsDocMojo$1.visitFile(GenerateContractsDocMojo.java:70)
at java.nio.file.Files.walkFileTree(Files.java:2670)
at java.nio.file.Files.walkFileTree(Files.java:2742)
at org.apache.servicecomb.toolkit.plugin.GenerateContractsDocMojo.execute(GenerateContractsDocMojo.java:70)
at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:134)
... 21 more
[ERROR]
3.the report of contract verification is not correct.It does not correctly distinguish between different letter contract files.
4.some parameters of toolkit-maven-plugin are not easy to understand,eg outputDir,format,docOutputDir and so on,they should be optimized.

Issue Links

• is a parent of: SCB-1358 the issue of invalid naming of generated contract files
• is a parent of: SCB-1359 the issue of generating document failure
• is a parent of: SCB-1360 the issue of verifying contract file is not correct
• is a parent of: SCB-1361 optimize toolkit user experience
• links to: GitHub Pull Request #6