diff --git a/core/src/main/java/hudson/Functions.java b/core/src/main/java/hudson/Functions.java index 46794c2802..150b1b658c 100644 --- a/core/src/main/java/hudson/Functions.java +++ b/core/src/main/java/hudson/Functions.java @@ -379,7 +379,7 @@ public class Functions { } /** - * @since TODO + * @since 2.475 */ public static RunUrl decompose(StaplerRequest2 req) { List ancestors = req.getAncestors(); @@ -610,7 +610,7 @@ public class Functions { } /** - * @since TODO + * @since 2.475 */ public static Cookie getCookie(HttpServletRequest req, String name) { Cookie[] cookies = req.getCookies(); @@ -633,7 +633,7 @@ public class Functions { } /** - * @since TODO + * @since 2.475 */ public static String getCookie(HttpServletRequest req, String name, String defaultValue) { Cookie c = getCookie(req, name); @@ -753,7 +753,7 @@ public class Functions { * This is used to determine the "current" URL assigned to the given object, * so that one can compute relative URLs from it. * - * @since TODO + * @since 2.475 */ public static String getNearestAncestorUrl(StaplerRequest2 req, Object it) { List list = req.getAncestors(); @@ -981,7 +981,7 @@ public class Functions { } /** - * @since TODO + * @since 2.475 */ public static void adminCheck(StaplerRequest2 req, StaplerResponse2 rsp, Object required, Permission permission) throws IOException, ServletException { // this is legacy --- all views should be eventually converted to @@ -1013,7 +1013,7 @@ public class Functions { /** * Infers the hudson installation URL from the given request. * - * @since TODO + * @since 2.475 */ public static String inferHudsonURL(StaplerRequest2 req) { String rootUrl = Jenkins.get().getRootUrl(); @@ -2132,7 +2132,7 @@ public class Functions { } /** - * @since TODO + * @since 2.475 */ public static String getCrumb(StaplerRequest2 req) { Jenkins h = Jenkins.getInstanceOrNull(); @@ -2328,7 +2328,7 @@ public class Functions { /** * Called from renderOnDemand.jelly to generate the parameters for the proxy object generation. * - * @since TODO + * @since 2.475 */ @Restricted(NoExternalUse.class) public static StaplerRequest2.RenderOnDemandParameters createRenderOnDemandProxyParameters(JellyContext context, String attributesToCapture) { diff --git a/core/src/main/java/hudson/Plugin.java b/core/src/main/java/hudson/Plugin.java index 1427da9fda..065b604095 100644 --- a/core/src/main/java/hudson/Plugin.java +++ b/core/src/main/java/hudson/Plugin.java @@ -224,7 +224,7 @@ public abstract class Plugin implements Loadable, Saveable, StaplerProxy { *

* If you are using this method, you'll likely be interested in * using {@link #save()} and {@link #load()}. - * @since TODO + * @since 2.475 */ public void configure(StaplerRequest2 req, JSONObject formData) throws IOException, ServletException, FormException { try { @@ -250,7 +250,7 @@ public abstract class Plugin implements Loadable, Saveable, StaplerProxy { /** * This method serves static resources in the plugin under {@code hudson/plugin/SHORTNAME}. * - * @since TODO + * @since 2.475 */ public void doDynamic(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException { if (Util.isOverridden(Plugin.class, getClass(), "doDynamic", StaplerRequest.class, StaplerResponse.class)) { diff --git a/core/src/main/java/hudson/PluginManager.java b/core/src/main/java/hudson/PluginManager.java index e1f5d4cc11..b90b2eb9f6 100644 --- a/core/src/main/java/hudson/PluginManager.java +++ b/core/src/main/java/hudson/PluginManager.java @@ -379,7 +379,7 @@ public abstract class PluginManager extends AbstractModelObject implements OnMas private final PluginStrategy strategy; /** - * @since TODO + * @since 2.475 */ protected PluginManager(ServletContext context, File rootDir) { this.context = context; diff --git a/core/src/main/java/hudson/Util.java b/core/src/main/java/hudson/Util.java index 5ca66e9c44..b4529a0ea2 100644 --- a/core/src/main/java/hudson/Util.java +++ b/core/src/main/java/hudson/Util.java @@ -1852,7 +1852,7 @@ public class Util { * Find the specific ancestor, or throw an exception. * Useful for an ancestor we know is inside the URL to ease readability * - * @since TODO + * @since 2.475 */ @Restricted(NoExternalUse.class) public static @NonNull T getNearestAncestorOfTypeOrThrow(@NonNull StaplerRequest2 request, @NonNull Class clazz) { diff --git a/core/src/main/java/hudson/WebAppMain.java b/core/src/main/java/hudson/WebAppMain.java index 986452797f..d62e8da622 100644 --- a/core/src/main/java/hudson/WebAppMain.java +++ b/core/src/main/java/hudson/WebAppMain.java @@ -322,7 +322,7 @@ public class WebAppMain implements ServletContextListener { } /** - * @since TODO + * @since 2.475 */ public static void installExpressionFactory(ServletContextEvent event) { JellyFacet.setExpressionFactory(event, new ExpressionFactory2()); diff --git a/core/src/main/java/hudson/console/AnnotatedLargeText.java b/core/src/main/java/hudson/console/AnnotatedLargeText.java index 1798512f3e..963435afe1 100644 --- a/core/src/main/java/hudson/console/AnnotatedLargeText.java +++ b/core/src/main/java/hudson/console/AnnotatedLargeText.java @@ -95,7 +95,7 @@ public class AnnotatedLargeText extends LargeText { } /** - * @since TODO + * @since 2.475 */ public void doProgressiveHtml(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException { if (Util.isOverridden(AnnotatedLargeText.class, getClass(), "doProgressiveHtml", StaplerRequest.class, StaplerResponse.class)) { @@ -122,7 +122,7 @@ public class AnnotatedLargeText extends LargeText { /** * Aliasing what I think was a wrong name in {@link LargeText} * - * @since TODO + * @since 2.475 */ public void doProgressiveText(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException { doProgressText(req, rsp); @@ -146,7 +146,7 @@ public class AnnotatedLargeText extends LargeText { } /** - * @since TODO + * @since 2.475 */ @Override protected void setContentType(StaplerResponse2 rsp) { diff --git a/core/src/main/java/hudson/model/AbstractItem.java b/core/src/main/java/hudson/model/AbstractItem.java index af64ff19df..0e712d8a2e 100644 --- a/core/src/main/java/hudson/model/AbstractItem.java +++ b/core/src/main/java/hudson/model/AbstractItem.java @@ -649,7 +649,7 @@ public abstract class AbstractItem extends Actionable implements Loadable, Item, /** * Accepts the new description. * - * @since TODO + * @since 2.475 */ @RequirePOST public synchronized void doSubmitDescription(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException { @@ -690,7 +690,7 @@ public abstract class AbstractItem extends Actionable implements Loadable, Item, * since it predates {@code }. {@code /delete} goes to a Jelly page * which should now be unused by core but is left in case plugins are still using it. * - * @since TODO + * @since 2.475 */ @RequirePOST public void doDoDelete(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException, InterruptedException { @@ -736,7 +736,7 @@ public abstract class AbstractItem extends Actionable implements Loadable, Item, } /** - * @since TODO + * @since 2.475 */ @Override public void delete(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException { @@ -830,7 +830,7 @@ public abstract class AbstractItem extends Actionable implements Loadable, Item, /** * Accepts {@code config.xml} submission, as well as serve it. * - * @since TODO + * @since 2.475 */ @WebMethod(name = "config.xml") public void doConfigDotXml(StaplerRequest2 req, StaplerResponse2 rsp) diff --git a/core/src/main/java/hudson/model/AbstractProject.java b/core/src/main/java/hudson/model/AbstractProject.java index a380943687..61f407034c 100644 --- a/core/src/main/java/hudson/model/AbstractProject.java +++ b/core/src/main/java/hudson/model/AbstractProject.java @@ -1778,7 +1778,7 @@ public abstract class AbstractProject

, R extends } /** - * @since TODO + * @since 2.475 */ @Override protected void submit(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException, FormException { diff --git a/core/src/main/java/hudson/model/Actionable.java b/core/src/main/java/hudson/model/Actionable.java index d808831902..45a8978a03 100644 --- a/core/src/main/java/hudson/model/Actionable.java +++ b/core/src/main/java/hudson/model/Actionable.java @@ -342,7 +342,7 @@ public abstract class Actionable extends AbstractModelObject implements ModelObj } /** - * @since TODO + * @since 2.475 */ public Object getDynamic(String token, StaplerRequest2 req, StaplerResponse2 rsp) { if (Util.isOverridden(Actionable.class, getClass(), "getDynamic", String.class, StaplerRequest.class, StaplerResponse.class)) { @@ -374,7 +374,7 @@ public abstract class Actionable extends AbstractModelObject implements ModelObj } /** - * @since TODO + * @since 2.475 */ @Override public ContextMenu doContextMenu(StaplerRequest2 request, StaplerResponse2 response) throws Exception { diff --git a/core/src/main/java/hudson/model/BuildAuthorizationToken.java b/core/src/main/java/hudson/model/BuildAuthorizationToken.java index 3611824fb5..365403124c 100644 --- a/core/src/main/java/hudson/model/BuildAuthorizationToken.java +++ b/core/src/main/java/hudson/model/BuildAuthorizationToken.java @@ -54,7 +54,7 @@ public final class BuildAuthorizationToken { } /** - * @since TODO + * @since 2.475 */ public static BuildAuthorizationToken create(StaplerRequest2 req) { if (req.getParameter("pseudoRemoteTrigger") != null) { @@ -79,7 +79,7 @@ public final class BuildAuthorizationToken { } /** - * @since TODO + * @since 2.475 */ public static void checkPermission(Job project, BuildAuthorizationToken token, StaplerRequest2 req, StaplerResponse2 rsp) throws IOException { if (token != null && token.token != null) { diff --git a/core/src/main/java/hudson/model/Descriptor.java b/core/src/main/java/hudson/model/Descriptor.java index e2067bfc69..562b96e37b 100644 --- a/core/src/main/java/hudson/model/Descriptor.java +++ b/core/src/main/java/hudson/model/Descriptor.java @@ -580,7 +580,7 @@ public abstract class Descriptor> implements Loadable, * * @throws FormException * Signals a problem in the submitted form. - * @since TODO + * @since 2.475 */ public T newInstance(@Nullable StaplerRequest2 req, @NonNull JSONObject formData) throws FormException { if (Util.isOverridden(Descriptor.class, getClass(), "newInstance", StaplerRequest.class, JSONObject.class)) { @@ -626,7 +626,7 @@ public abstract class Descriptor> implements Loadable, * Replacement for {@link StaplerRequest2#bindJSON(Class, JSONObject)} which honors {@link #newInstance(StaplerRequest2, JSONObject)}. * This is automatically used inside {@link #newInstance(StaplerRequest2, JSONObject)} so a direct call would only be necessary * in case the top level binding might use a {@link Descriptor} which overrides {@link #newInstance(StaplerRequest2, JSONObject)}. - * @since TODO + * @since 2.475 */ public static T bindJSON(StaplerRequest2 req, Class type, JSONObject src) { return bindJSON(req, type, src, false); @@ -859,7 +859,7 @@ public abstract class Descriptor> implements Loadable, * See the developer documentation. * @return false * to keep the client in the same config page. - * @since TODO + * @since 2.475 */ public boolean configure(StaplerRequest2 req, JSONObject json) throws FormException { if (Util.isOverridden(Descriptor.class, getClass(), "configure", StaplerRequest.class, JSONObject.class)) { @@ -1062,7 +1062,7 @@ public abstract class Descriptor> implements Loadable, } /** - * @since TODO + * @since 2.475 */ @Restricted(NoExternalUse.class) public static URL getStaticHelpUrl(StaplerRequest2 req, Klass c, String suffix) { @@ -1142,7 +1142,7 @@ public abstract class Descriptor> implements Loadable, * List of descriptors to create instances from. * @return * Can be empty but never null. - * @since TODO + * @since 2.475 */ public static > List newInstancesFromHeteroList(StaplerRequest2 req, JSONObject formData, String key, @@ -1162,7 +1162,7 @@ public abstract class Descriptor> implements Loadable, } /** - * @since TODO + * @since 2.475 */ public static > List newInstancesFromHeteroList(StaplerRequest2 req, Object formData, diff --git a/core/src/main/java/hudson/model/Hudson.java b/core/src/main/java/hudson/model/Hudson.java index 7d45fd63d7..5ae161199c 100644 --- a/core/src/main/java/hudson/model/Hudson.java +++ b/core/src/main/java/hudson/model/Hudson.java @@ -81,7 +81,7 @@ public class Hudson extends Jenkins { } /** - * @since TODO + * @since 2.475 */ public Hudson(File root, ServletContext context) throws IOException, InterruptedException, ReactorException { this(root, context, null); @@ -96,7 +96,7 @@ public class Hudson extends Jenkins { } /** - * @since TODO + * @since 2.475 */ public Hudson(File root, ServletContext context, PluginManager pluginManager) throws IOException, InterruptedException, ReactorException { super(root, context, pluginManager); diff --git a/core/src/main/java/hudson/model/ItemGroupMixIn.java b/core/src/main/java/hudson/model/ItemGroupMixIn.java index 62a46f3952..404d213f73 100644 --- a/core/src/main/java/hudson/model/ItemGroupMixIn.java +++ b/core/src/main/java/hudson/model/ItemGroupMixIn.java @@ -144,7 +144,7 @@ public abstract class ItemGroupMixIn { * Creates a {@link TopLevelItem} for example from the submission of the {@code /lib/hudson/newFromList/form} tag * or throws an exception if it fails. * - * @since TODO + * @since 2.475 */ public synchronized TopLevelItem createTopLevelItem(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException { acl.checkPermission(Item.CREATE); diff --git a/core/src/main/java/hudson/model/Job.java b/core/src/main/java/hudson/model/Job.java index 2ba53d7182..e4d54d44b3 100644 --- a/core/src/main/java/hudson/model/Job.java +++ b/core/src/main/java/hudson/model/Job.java @@ -860,7 +860,7 @@ public abstract class Job, RunT extends Run, RunT extends Run, RunT extends Run> implements Reconfigurable } /** - * @since TODO + * @since 2.475 */ @Override public JobProperty reconfigure(StaplerRequest2 req, JSONObject form) throws FormException { diff --git a/core/src/main/java/hudson/model/Project.java b/core/src/main/java/hudson/model/Project.java index eb31add239..30efe857e8 100644 --- a/core/src/main/java/hudson/model/Project.java +++ b/core/src/main/java/hudson/model/Project.java @@ -228,7 +228,7 @@ public abstract class Project

, B extends Build> // /** - * @since TODO + * @since 2.475 */ @Override protected void submit(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException, FormException { diff --git a/core/src/main/java/hudson/model/RSS.java b/core/src/main/java/hudson/model/RSS.java index bb41c8af10..98cf0fb740 100644 --- a/core/src/main/java/hudson/model/RSS.java +++ b/core/src/main/java/hudson/model/RSS.java @@ -56,7 +56,7 @@ public final class RSS { * Entries to be listed in the RSS feed. * @param adapter * Controls how to render entries to RSS. - * @since TODO + * @since 2.475 */ public static void forwardToRss(String title, String url, Collection entries, FeedAdapter adapter, StaplerRequest2 req, HttpServletResponse rsp) throws IOException, ServletException { req.setAttribute("adapter", adapter); @@ -98,7 +98,7 @@ public final class RSS { * URL of the model object that owns this feed. Relative to the context root. * @param runList * Entries to be listed in the RSS feed. - * @since TODO + * @since 2.475 */ public static void rss(StaplerRequest2 req, StaplerResponse2 rsp, String title, String url, RunList runList) throws IOException, ServletException { rss(req, rsp, title, url, runList, null); @@ -128,7 +128,7 @@ public final class RSS { * Entries to be listed in the RSS feed. * @param feedAdapter * Controls how to render entries to RSS. - * @since TODO + * @since 2.475 */ public static void rss(StaplerRequest2 req, StaplerResponse2 rsp, String title, String url, RunList runList, FeedAdapter feedAdapter) throws IOException, ServletException { final FeedAdapter feedAdapter_ = feedAdapter == null ? Run.FEED_ADAPTER : feedAdapter; diff --git a/core/src/main/java/hudson/model/Run.java b/core/src/main/java/hudson/model/Run.java index 5359634d96..37b09fd47d 100644 --- a/core/src/main/java/hudson/model/Run.java +++ b/core/src/main/java/hudson/model/Run.java @@ -2209,7 +2209,7 @@ public abstract class Run, RunT extends Run, RunT extends Run T createInstance(Class type, StaplerRequest2 req, JSONObject parent, String fieldName) throws FormException { diff --git a/core/src/main/java/hudson/security/SecurityRealm.java b/core/src/main/java/hudson/security/SecurityRealm.java index d99e3487ea..0706f99a4a 100644 --- a/core/src/main/java/hudson/security/SecurityRealm.java +++ b/core/src/main/java/hudson/security/SecurityRealm.java @@ -278,7 +278,7 @@ public abstract class SecurityRealm extends AbstractDescribableImpl implements Http } /** - * @since TODO + * @since 2.475 */ public void writeTo(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException { if (Util.isOverridden(ListBoxModel.class, getClass(), "writeTo", StaplerRequest.class, StaplerResponse.class)) { diff --git a/core/src/main/java/hudson/util/PluginServletFilter.java b/core/src/main/java/hudson/util/PluginServletFilter.java index bb4ecfc18d..5e6ca8704d 100644 --- a/core/src/main/java/hudson/util/PluginServletFilter.java +++ b/core/src/main/java/hudson/util/PluginServletFilter.java @@ -105,7 +105,7 @@ public final class PluginServletFilter implements CompatibleFilter, ExtensionPoi * May be paired with {@link #removeFilter}. *

For most purposes you can instead use {@link HttpServletFilter}. * - * @since TODO + * @since 2.475 */ public static void addFilter(Filter filter) throws ServletException { Jenkins j = Jenkins.getInstanceOrNull(); @@ -141,7 +141,7 @@ public final class PluginServletFilter implements CompatibleFilter, ExtensionPoi * Checks whether the given filter is already registered in the chain. * @param filter the filter to check. * @return true if the filter is already registered in the chain. - * @since TODO + * @since 2.475 */ public static boolean hasFilter(Filter filter) { Jenkins j = Jenkins.getInstanceOrNull(); @@ -166,7 +166,7 @@ public final class PluginServletFilter implements CompatibleFilter, ExtensionPoi } /** - * @since TODO + * @since 2.475 */ public static void removeFilter(Filter filter) throws ServletException { Jenkins j = Jenkins.getInstanceOrNull(); diff --git a/core/src/main/java/jenkins/console/ConsoleUrlProvider.java b/core/src/main/java/jenkins/console/ConsoleUrlProvider.java index dcd3883ba0..637cf10145 100644 --- a/core/src/main/java/jenkins/console/ConsoleUrlProvider.java +++ b/core/src/main/java/jenkins/console/ConsoleUrlProvider.java @@ -85,7 +85,7 @@ public interface ConsoleUrlProvider extends Describable { /** * Looks up the {@link #getConsoleUrl} value from the first provider to offer one. - * @since TODO + * @since 2.476 */ static @NonNull String consoleUrlOf(Run run) { final List providers = new ArrayList<>(); diff --git a/core/src/main/java/jenkins/model/Jenkins.java b/core/src/main/java/jenkins/model/Jenkins.java index 3c756bbb7b..9af524b6b1 100644 --- a/core/src/main/java/jenkins/model/Jenkins.java +++ b/core/src/main/java/jenkins/model/Jenkins.java @@ -759,7 +759,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve private final transient ServletContext jakartaServletContext; /** - * @since TODO + * @since 2.475 */ public ServletContext getServletContext() { return this.jakartaServletContext; @@ -4435,7 +4435,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve /** * Logs out the user. * - * @since TODO + * @since 2.475 */ public void doLogout(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException, ServletException { String user = getAuthentication2().getName(); @@ -4933,7 +4933,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve } /** - * @since TODO + * @since 2.475 */ public static void _doScript(StaplerRequest2 req, StaplerResponse2 rsp, RequestDispatcher view, VirtualChannel channel, ACL acl) throws IOException, ServletException { // ability to run arbitrary script is dangerous diff --git a/core/src/main/java/jenkins/mvn/GlobalSettingsProvider.java b/core/src/main/java/jenkins/mvn/GlobalSettingsProvider.java index 98055fb39b..9e0a2cef24 100644 --- a/core/src/main/java/jenkins/mvn/GlobalSettingsProvider.java +++ b/core/src/main/java/jenkins/mvn/GlobalSettingsProvider.java @@ -29,7 +29,7 @@ public abstract class GlobalSettingsProvider extends AbstractDescribableImpl build, TaskListener listener); /** - * @since TODO + * @since 2.475 */ public static GlobalSettingsProvider parseSettingsProvider(StaplerRequest2 req) throws Descriptor.FormException, ServletException { JSONObject settings = req.getSubmittedForm().getJSONObject("globalSettings"); diff --git a/core/src/main/java/jenkins/security/BasicHeaderAuthenticator.java b/core/src/main/java/jenkins/security/BasicHeaderAuthenticator.java index 2906a1aa46..7b012292ef 100644 --- a/core/src/main/java/jenkins/security/BasicHeaderAuthenticator.java +++ b/core/src/main/java/jenkins/security/BasicHeaderAuthenticator.java @@ -38,7 +38,7 @@ public abstract class BasicHeaderAuthenticator implements ExtensionPoint { *

* When no processor can validate the username/password pair, caller will make * the request processing fail. - * @since TODO + * @since 2.475 */ @CheckForNull public Authentication authenticate2(HttpServletRequest req, HttpServletResponse rsp, String username, String password) throws IOException, ServletException {