improve: PrimaryUpdateAndCacheUtils locks, naming and doc improvements#2799

csviri wants to merge 9 commits intomainoperator-framework/java-operator-sdk:mainfrom

primary-cache-with-lockoperator-framework/java-operator-sdk:primary-cache-with-lockCopy head branch name to clipboard