tomcat - Xwiki 重新加载组件 jar

Question

根据guide ，向 XWiki 添加新组件涉及将 jar 文件放入 XE_WAR_HOME/WEB-INF/lib。但是，我似乎需要在使用新组件之前重新启动 tomcat。有没有办法解决这个重启？组件管理器设法在不重新启动 tomcat 的情况下从存储库安装新组件，因此原则上似乎可以...

与此相关，如果我将 jar 替换为具有相同名称的更新版本，即使重新启动 tomcat 似乎也不会更新现有组件。那么在这种情况下我可以显式触发重新加载吗？

Answer 1

同时更新了指南并展示了如何执行此操作。

简而言之:将本地 Maven 存储库添加到 xwiki.properties:

extension.repositories=local:maven:file://${sys:user.home}/.m2/repository
extension.repositories=maven-xwiki:maven:http://nexus.xwiki.org/nexus/content/groups/public
extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/ 

(需要另外两行来重新添加“默认”存储库)

在 Wiki UI 中，安装 Extension Tweak

然后对于每个构建周期:

• 通过 mvn install 构建您的扩展
• 转到 Wiki 中的扩展部分
• 在“高级搜索”中查找您的扩展(您的本地 Maven 存储库不可搜索，因此您需要告知完整 ID - 即 my.extension.group:my-extension-id和版本 - 即 0.1-SNAPSHOT)
• 删除当前安装的扩展
• 通过/xwiki/bin/view/Admin/InstalledExtensionsTweak 刷新缓存
• 再次在“高级搜索”中查找您的扩展程序，并安装它

因为我不想将我的回答限制在复制指南中的“Howto”，这里有一个小脚本应该执行“重新安装”部分(即在运行 mvn install 后使用它>) 给你:

# "config" section:

# variables should be URL encoded; '%3A' is ':' 
EXTENSION_ID=org.xwiki.contrib%3Aapplication-mocca-calendar-ui
VERSION=2.5-SNAPSHOT
BASE_URL=http://localhost:8080/xwiki

# of course you can use curl here if you prefer
WGET="wget -q -O /dev/null --auth-no-challenge --http-user=Admin --http-password=admin"
# alternative for debugging
#WGET="wget -S -O - --auth-no-challenge --http-user=Admin --http-password=admin"

QUERY="extensionId=${EXTENSION_ID}&extensionVersion=${VERSION}&extensionNamespace=wiki%3Axwiki&form_token=dummy"
 
set -o errexit

# first remove the old version of the extension
$WGET "${BASE_URL}/bin/get/XWiki/AddExtensions?basicauth=1&extensionAction=uninstall&${QUERY}"

# confirm uninstall
sleep 1
$WGET "${BASE_URL}/bin/get/XWiki/AddExtensions?basicauth=1&extensionAction=continue&${QUERY}"
# confirm uninstall again (this time to "remove unused pages") 
sleep 1
$WGET "${BASE_URL}/bin/get/XWiki/AddExtensions?basicauth=1&extensionAction=continue&${QUERY}"

# flush the cache
$WGET "${BASE_URL}/bin/get/Admin/InstalledExtensionsTweak?basicauth=1&eaction=clean_confirm"

# add new version
$WGET "${BASE_URL}/bin/get/XWiki/AddExtensions?basicauth=1&extensionAction=install&${QUERY}"

# confirm: start adding
sleep 1
$WGET "${BASE_URL}/bin/get/XWiki/AddExtensions?basicauth=1&extensionAction=continue&${QUERY}"

# just in case we get a conflict: overwrite with new version
sleep 1.5
$WGET "${BASE_URL}/bin/get/XWiki/AddExtensions?basicauth=1&extensionAction=continue&autoResolve=true&versionToKeep=NEXT&${QUERY}"

如果你想使用这个脚本，你必须在 xwiki.properties 中通过设置禁用 CSRF-Protection:csrf.enabled = false。 (或者，您可以通过从响应中的 HTML 中读取 csrf-token 来修改脚本。)

脚本没有错误处理。如果您在执行后没有看到更新，请执行上述步骤找出问题所在。

附录:至少在 XWiki 14.x 中，get/XWiki/AddExtensions 应该替换为 get/XWiki/Extensions