关于插件:confluence宏插件开发03Hello-World宏开发

5次阅读

共计 2980 个字符，预计需要花费 8 分钟才能阅读完成。

通过后面的两篇文单的介绍，咱们曾经实现了开发环境的筹备和根本工程的创立。在这个根底上咱们来写一个 HelloWorld 宏。

应用 Idea 的时候有一个注意事项，就是要批改 maven 的 setting.xml 文件。因为 confluence 应用的本人的服务器 maven.atlassian.com 来下载 maven 依赖。

点击 Idea 左上角的 File 菜单
关上 Settings…
找到 Build, Execution, Deployment, 点开 Build Tools, 抉择 Maven
批改 User settings file 的配置，点击左边的 override, 就能够写入值了。能够通过 atlas-version 命令来查看 SDK 的装置目录，咱们应用 SDK 目录下的 apache-maven-3.5.4\conf\setting.xml 配置文件
在 Idea 里更新 maven 的配置，查看是否 maven 依赖都能失常加载。第一次加载 maven 依赖的时候会比拟耗时间。

关上 src\main\resources\atlassian-plugin.xml 文件
在 </web-resource> 前面退出，以下代码：

<xhtml-macro name="helloworld" class="com.example.Helloworld" key='helloworld-macro'>
        <description key="helloworld.macro.desc"/>
        <category name="formatting"/>
        <parameters/>
    </xhtml-macro>

留神，xhtml-macro 和 web-resource 是同级节点。

关上 src\main\resources\myConfluenceMacro.properties 文件，退出 helloworld.macro.desc 配置项

helloworld.macro.desc=Hello World

创立 Helloworld 类，写入以下代码

package com.example;

import com.atlassian.confluence.content.render.xhtml.ConversionContext;
import com.atlassian.confluence.macro.Macro;
import com.atlassian.confluence.macro.MacroExecutionException;
import java.util.Map;

public class Helloworld implements Macro {
    @Override
    public String execute(Map<String, String> map, String s, ConversionContext conversionContext)
            throws MacroExecutionException {return "<h1>Hello World</h1>";}
    @Override
    public BodyType getBodyType() {return BodyType.NONE;}
    @Override
    public OutputType getOutputType() {return OutputType.BLOCK;}
}

在命令行里运行 atlas-mvn package 命令，从新打包

atlas-mvn package

打包胜利后，会输入相似以下的信息：

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 11.916 s
[INFO] Finished at: 2021-03-01T18:20:54+08:00
[INFO] ------------------------------------------------------------------------

切换到原来运行 atlas-run 的命令行窗口，你能够看到相似以下的日志输入：

[INFO] [talledLocalContainer] 2021-03-01 18:21:00,379 INFO [QuickReload - Plugin Installer] [atlassian.plugin.manager.DefaultPluginManager] updatePlugin Updating plugin 'com.example.myConfluenceMacro-tests' from version '1.0.0-SNAPSHOT' to version '1.0.0-SNAPSHOT'
[INFO] [talledLocalContainer] 2021-03-01 18:21:00,379 INFO [QuickReload - Plugin Installer] [atlassian.plugin.manager.DefaultPluginManager] broadcastPluginDisabling Disabling com.example.myConfluenceMacro-tests
[INFO] [talledLocalContainer] 2021-03-01 18:21:01,629 INFO [QuickReload - Plugin Installer] [plugins.quickreload.install.PluginInstallerMechanic] installPluginImmediately
[INFO] [talledLocalContainer]                                           ^
[INFO] [talledLocalContainer]                                           |
[INFO] [talledLocalContainer]                                           |
[INFO] [talledLocalContainer]                                           |
[INFO] [talledLocalContainer]                                           |
[INFO] [talledLocalContainer]                                           |
[INFO] [talledLocalContainer]
[INFO] [talledLocalContainer]           If you can type on a Dvorak keyboard can you automatically speak Esperanto and program in Lisp?
[INFO] [talledLocalContainer]
[INFO] [talledLocalContainer] Quick Reload Finished (2979 ms) - 'myConfluenceMacro-1.0.0-SNAPSHOT-tests.jar'