Support change signature refactoring (#2967)

---------

Signed-off-by: Shi Chen <[email protected]>

Author: CsCherrYY

.vscode/launch.json

@@ -7,14 +7,19 @@
 			"type": "extensionHost",
 			"request": "launch",
 			"runtimeExecutable": "${execPath}",
+			"debugWebviews": true,
 			"args": ["--extensionDevelopmentPath=${workspaceRoot}" ],
 			"env": {
 				"DEBUG_VSCODE_JAVA":"true"
 			},
 			"stopOnEntry": false,
 			"sourceMaps": true,
 			"outFiles": [ "${workspaceRoot}/dist/**/*.js" ],
-			"preLaunchTask": "npm: watch"
+			"preLaunchTask": "npm: watch",
+			"rendererDebugOptions": {
+				"urlFilter": "*redhat.java*",
+				"sourceMaps": true,
+			}
 		},
 		{
 			"name": "Launch Extension - Remote Server",
@@ -36,6 +41,7 @@
 			"type": "extensionHost",
 			"request": "launch",
 			"runtimeExecutable": "${execPath}",
+			"debugWebviews": true,
 			"args": ["--extensionDevelopmentPath=${workspaceRoot}" ],
 			"stopOnEntry": false,
 			"sourceMaps": true,
@@ -44,7 +50,11 @@
 				"JDTLS_CLIENT_PORT": "5036",
 				"DEBUG_VSCODE_JAVA":"true"
 			},
-			"preLaunchTask": "npm: watch"
+			"preLaunchTask": "npm: watch",
+			"rendererDebugOptions": {
+				"urlFilter": "*redhat.java*",
+				"sourceMaps": true,
+			}
 		},
 		{
 			"name": "Launch Extension - SyntaxLS Client",

document/_java.learnMoreAboutRefactorings.md

@@ -18,7 +18,9 @@
   - [Inline constant](#inline-constant)
   - [Inline local variable](#inline-local-variable)
   - [Inline method](#inline-method)
-- [Introduce Parameter](#introduce-parameter)
+- Method signature
+  - [Introduce Parameter](#introduce-parameter)
+  - [Change method signature](#change-method-signature)
 - Invert boolean
   - [Invert conditions](#invert-conditions)
   - [Invert local variable](#invert-local-variable)
@@ -469,6 +471,41 @@ public void addUser(String name) {
 }
 ```
 
+---
+
+## Change Method Signature
+Changes the method visibility, return type, name, and updates the parameters and exceptions. The above changes can be applied through the call hierarchy of the method.
+
+### Example
+Let's change signature for the method `public void setAddress(String address)`.
+
+#### Before
+
+```java
+public void setAddress(String address) {
+  this.address = address;
+}
+
+public void setAddr() {
+  this.setAddress("Addr");
+}
+```
+
+#### Refactor configuration
+
+![change_signature](./refactoring_change_signature.png)
+#### After
+```java
+public void setAddress1(Object newParam, String address) {
+  this.address = address;
+}
+
+public void setAddr() {
+  this.setAddress1(null, "Addr");
+}
+```
+---
+
 ## Invert conditions
 Inverts the boolean expression in the conditions.