-
Notifications
You must be signed in to change notification settings - Fork 326
Rename AccessConfig and AccessConfigProvider for clarity #2883
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Rename AccessConfig and AccessConfigProvider for clarity #2883
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@CodingBangboo Thanks for the contribution! The rename LGTM as it would help avoid confusion when we consolidate and introduce CatalogAccessConfig in the future, per comment.
Would love to hear others' thoughts on this!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This rename looks reasonable to me 👍 Thanks for your contribution, @CodingBangboo !
| * Constructor for success | ||
| * | ||
| * @param accessConfig credentials | ||
| * @param storageAccessConfig credentials |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nit: this javadoc is no longer accurate. Since the class name is pretty much self-describing now, I do not see a reason to have javadoc for this parameter (can we put anything there that is not covered by the class?).
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good point. I think we can keep it there for consistency with the javadoc in other BaseResult classes. I also added a tiny bit to indicate that it is the result from a successful getSubscopedCredsForEntity().
144700b to
558d524
Compare
| * Constructor for success | ||
| * | ||
| * @param accessConfig credentials | ||
| * @param storageAccessConfig credentials generated by a successful getSubscopedCredsForEntity() |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As far as this class is concerned, why does it matter that storageAccessConfig is generated by a successful getSubscopedCredsForEntity()?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@CodingBangboo @HonahX : I know this is a minor point, but I'd prefer to avoid false requirements in javadoc... WDYT about this one?
To be clear: I propose to remove this javadoc line completely. I believe the java doc on the parameter type is sufficient in this case.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
What changes were proposed in this pull request?
As a follow up of #2736 (comment), we would like to rename the
AccessConfigandAccessConfigProvidertoStorageAccessConfigandStorageAccessConfigProviderrespectively, including renamingAccessConfigProvider's methodgetAccessConfigtogetStorageAccessConfig. This renaming PR adds clarity to differentiating between two types of external services: storage and catalog accesses.Why are the changes needed?
Does this PR introduce any user-facing change?
How was this patch tested?
CHANGELOG.md