HDDS-13098. Create PicoCLI mixin to standardize datanode selection options

[sreejasahithi]

What changes were proposed in this pull request?

Introduced a reusable PicoCLI mixin (NodeSelectionMixin) to standardize datanode selection options across commands. This includes:

--node-id for datanode UUID

--hostname for datanode host name

--ip for datanode IP address

Deprecated older/ambiguous options like --id, --uuid, and --address for clarity and consistency, while retaining them in hidden mode to preserve backward compatibility.

What is the link to the Apache JIRA

https://issues.apache.org/jira/browse/HDDS-13098

How was this patch tested?

https://github.com/sreejasahithi/ozone/actions/runs/15778605382

[aryangupta1998]

Mostly looks good to me!
If user enters a current value and a deprecated value like,
ozone admin datanode usageinfo --node-id X --uuid Y
then we should be able to warn users!

[sreejasahithi]

If user enters a current value and a deprecated value like, ozone admin datanode usageinfo --node-id X --uuid Y then we should be able to warn users!

The options --node-id and --uuid are mutually exclusive, meaning only one of them can be specified at a time.
If a user provides both options, as in the following command:
ozone admin datanode usageinfo --node-id X --uuid Y

They will receive the following error message:
Error: --node-id=, --uuid= are mutually exclusive (specify only one)
This error is followed by the usage/help message.

[sarvekshayr]

Thanks for working on this @sreejasahithi.

In TestDecommissionStatusSubCommand, the current tests cover the deprecated --id option, but there's no test for the --node-id option.
Could you please add a test case to cover --node-id as well?

[Tejaskriya]

Thanks for working on this @sreejasahithi , please find my comments below

Also I think you can try updating your branch with the latest master, the test failures seem unrelated to your changes, it may get resolved.

[aryangupta1998]

LGTM!

[Tejaskriya]

Thanks for the patch @sreejasahithi , and for the reviews @sarvekshayr @aryangupta1998