Add Dubbo Annotation Processor (Add deprecated method warn when called by user, #10850)

[win120a]

What is the purpose of the change

Trying to provide a solution of #10850.

Brief changelog

Adds an annotation processor, which adds a line of code in every methods decorated by @Deprecated. Like getServiceName() in class URL of dubbo-common module (decompiled result):

@Deprecated
public String getServiceName() {
    DeprecatedMethodInvocationCounter.onDeprecatedMethodCalled("org.apache.dubbo.common.URL.getIntParameter(String key,int defaultValue)");
    return this.getServiceInterface();
}

Per suggestion from Albumen Kevin, the count of the deprecated method invocation is also recorded.

Verifying this change

Use a decomplier (like Java Decompiler, or FernFlower decompiler in IntelliJ IDEA) to see the result.

[win120a]

Related dubbo-website PR: apache/dubbo-website#2140

[win120a]

@AlbumenJ PTAL.

[AlbumenJ]

Please rebase your branch onto 3.2

[AlbumenJ]

Can the inserted code also inserted into xxx-source.jar?

[win120a]

Please rebase your branch onto 3.2 .

Rebased.

Just insert DeprecatedMethodCollector.collect(xxx) here. Log and count in DeprecatedMethodCollector.collect.

Moved all the logic to org.apache.dubbo.common.DeprecatedMethodInvocationCounter#onDeprecatedMethodCalled() .

Can the inserted code also inserted into xxx-source.jar?

Unfortunately, it can't. It works as a compiler addon (an annotation processor). It directly modifies the Abstract Syntax Tree (i.e. the .class file), the source code remains untouched. Since the source plugin in Maven just copies the source, the generated sources.jar will not appear the modified code.

[AlbumenJ]

@chickenlj PTAL

[AlbumenJ]

Please add excluede in FileTests

[win120a]

@AlbumenJ PTAL.

The scope configuration of pom.xml is required to import javac package (tools.jar), which causes 'bugs' in SonarLint.

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
10 Code Smells

4.3% Coverage
1.0% Duplication

[AlbumenJ]

LGTM