Web方法

这一部分正在进行中。想要帮助吗?检查必威国际有限公司jenkinsci-docs邮件列表.要了解为Jenkins项目做出贡献的其他方法,请参见必威国际有限公司这个页面是关于参与和贡献的

Jenkins 2.1必威国际有限公司38.4和Jenkins 2.154的变化

Web方法需要提供一些指示,表明它们是用于订书机路由的:

  • 订书机认可的任何适用注释,例如:@RequirePOST

  • 任何可推论的参数类型,例如:StaplerRequest

  • 任何可被订书机识别的参数注释,例如:@AncestorInPath

  • 任何声明的异常类型实现HttpResponse,例如,HttpResponseException

  • 返回类型实现HttpResponse

如果这些指标都不存在,则Stapler将不再调用该方法作为Jenkins 2.138.4和Jenkins 2.154中的web方法。必威国际有限公司一些例子:

public void doRun() public String doRun(String foo)抛出异常

当SECURITY-595修复程序阻止对URL的访问时,会向Jenkins日志中写入类似如下的警告消息:必威国际有限公司

警告:新的订书机路由规则将导致URL "/example"不再被允许。如果你认为使用它是安全的,请将以下代码添加到白名单中:"method hudson.model.Hudson doExample"。了解更多信息:https://www.jenki必威国际有限公司ns.io/redirect/stapler-routing

管理员可以按照说明让方法或字段在特定的实例上工作,但理想情况下,应该首先更改组件以防止出现问题:

  • 添加上一节中列出的任何指示器,使您的方法可路由。

  • 为web方法添加注释@StaplerDispatchable.的依赖项可能需要添加io.必威国际有限公司jenkins.stapler: io.jenkins.stapler库以使该注释可用。

参考文献