log appropriate error messages to build console

[rantoniuk]

Pick up #711 by @Hardikrathod01 and resolve conflicts.

Related issues

#702
#711

Changes

See #711

Tests

• I have tested my changes with a Jira Cloud
• I have verified that the Code Coverage is not lower than before / that all the changes are covered as needed

Checklist

• Make sure you are requesting the pull request from a custom branch and not your master/main branch
• Ensure that the pull request title represents the desired changelog entry
• Apply relevant PR labels, at least one of feature or bugfix or documentation

[Copilot]

Pull request overview

This PR improves error handling and logging by replacing TimeoutException with RestClientException throughout the JIRA plugin, ensuring that appropriate error messages are logged to the build console when REST API calls fail.

Key Changes:

• Replaced TimeoutException with RestClientException in method signatures and exception handling across the codebase
• Added try-catch blocks in pipeline steps and build steps to catch RestClientException and log error messages to the build console
• Modified JiraRestService to throw RestClientException with descriptive messages instead of returning null or empty collections on errors

Reviewed changes

Copilot reviewed 29 out of 29 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
src/main/java/hudson/plugins/jira/JiraRestService.java	Core change: throws RestClientException with descriptive messages instead of returning null/empty collections
src/main/java/hudson/plugins/jira/JiraSession.java	Updated method signatures to throw RestClientException instead of TimeoutException
src/main/java/hudson/plugins/jira/JiraSite.java	Added RestClientException handling and updated method signatures
src/main/java/hudson/plugins/jira/pipeline/*.java	Added try-catch blocks to log RestClientException messages to console in SearchIssuesStep, IssueSelectorStep, IssueFieldUpdateStep, and CommentStep
src/main/java/hudson/plugins/jira/JiraIssueUpdateBuilder.java	Changed exception handling from TimeoutException to RestClientException
src/main/java/hudson/plugins/jira/JiraEnvironmentVariableBuilder.java	Added try-catch to handle RestClientException and log to console
src/main/java/hudson/plugins/jira/JiraCreateIssueNotifier.java	Wrapped build result handling in try-catch for RestClientException
src/main/java/hudson/plugins/jira/JiraJobAction.java	Added RestClientException to catch block
src/main/java/hudson/plugins/jira/Updater.java	Removed RestClientException from method signature and simplified error logging
src/main/java/hudson/plugins/jira/selector/JqlIssueSelector.java	Changed exception type from TimeoutException to RestClientException
src/main/java/hudson/plugins/jira/*ParameterDefinition.java	Updated method signatures to include RestClientException
src/test/java/hudson/plugins/jira/pipeline/*.java	Added comprehensive tests for REST exception handling in pipeline steps
src/test/java/hudson/plugins/jira/*.java	Added tests for exception logging and updated existing tests to use RestClientException

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.

[Copilot]

Typo in error message: "findIsusueIds" should be "findIssueIds".

Suggested change

	doThrow(new RestClientException("[Jira] Jira REST findIsusueIds error. Cause: 401 error", throwable))
	.when(issueSelector)
	.findIssueIds(build, site, listener);
	JiraEnvironmentVariableBuilder builder = spy(new JiraEnvironmentVariableBuilder(issueSelector));
	doReturn(site).when(builder).getSiteForProject(project);
	assertThat(builder.perform(build, launcher, listener), is(false));
	verify(logger).println("[Jira] Jira REST findIsusueIds error. Cause: 401 error");
	doThrow(new RestClientException("[Jira] Jira REST findIssueIds error. Cause: 401 error", throwable))
	.when(issueSelector)
	.findIssueIds(build, site, listener);
	JiraEnvironmentVariableBuilder builder = spy(new JiraEnvironmentVariableBuilder(issueSelector));
	doReturn(site).when(builder).getSiteForProject(project);
	assertThat(builder.perform(build, launcher, listener), is(false));
	verify(logger).println("[Jira] Jira REST findIssueIds error. Cause: 401 error");