This is an automated email from the ASF dual-hosted git repository.
snazy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/polaris.git
The following commit(s) were added to refs/heads/main by this push:
new 0e72f24b0 Fix warnings around TransactionWorkspaceMetaStoreManager
(#3044)
0e72f24b0 is described below
commit 0e72f24b0d95172d7bf1cd78320a9bcdec1a3b5b
Author: Christopher Lambert <[email protected]>
AuthorDate: Tue Nov 18 10:50:16 2025 +0100
Fix warnings around TransactionWorkspaceMetaStoreManager (#3044)
- dont return `null` for interface methods that are `@Nonnull`
- fix wrong method name parameters
- dont annotate void methods as `@Nonnull`
---
.../polaris/core/auth/PolarisSecretsManager.java | 1 -
.../polaris/core/entity/PolarisEventManager.java | 1 -
.../AtomicOperationMetaStoreManager.java | 2 +-
.../TransactionWorkspaceMetaStoreManager.java | 168 ++++++++-------------
.../TransactionalMetaStoreManagerImpl.java | 2 +-
5 files changed, 69 insertions(+), 105 deletions(-)
diff --git
a/polaris-core/src/main/java/org/apache/polaris/core/auth/PolarisSecretsManager.java
b/polaris-core/src/main/java/org/apache/polaris/core/auth/PolarisSecretsManager.java
index 28da598ef..19493ba5b 100644
---
a/polaris-core/src/main/java/org/apache/polaris/core/auth/PolarisSecretsManager.java
+++
b/polaris-core/src/main/java/org/apache/polaris/core/auth/PolarisSecretsManager.java
@@ -85,7 +85,6 @@ public interface PolarisSecretsManager {
* @param clientId principal client id
* @param principalId id of the principal whose secrets should be deleted
*/
- @Nonnull
void deletePrincipalSecrets(
@Nonnull PolarisCallContext callCtx, @Nonnull String clientId, long
principalId);
}
diff --git
a/polaris-core/src/main/java/org/apache/polaris/core/entity/PolarisEventManager.java
b/polaris-core/src/main/java/org/apache/polaris/core/entity/PolarisEventManager.java
index b4b789133..7c18d3142 100644
---
a/polaris-core/src/main/java/org/apache/polaris/core/entity/PolarisEventManager.java
+++
b/polaris-core/src/main/java/org/apache/polaris/core/entity/PolarisEventManager.java
@@ -25,7 +25,6 @@ import org.apache.polaris.core.PolarisCallContext;
import org.apache.polaris.core.persistence.BasePersistence;
public interface PolarisEventManager {
- @Nonnull
default void writeEvents(
@Nonnull PolarisCallContext callCtx, @Nonnull List<PolarisEvent>
polarisEvents) {
BasePersistence ms = callCtx.getMetaStore();
diff --git
a/polaris-core/src/main/java/org/apache/polaris/core/persistence/AtomicOperationMetaStoreManager.java
b/polaris-core/src/main/java/org/apache/polaris/core/persistence/AtomicOperationMetaStoreManager.java
index 431520e9f..d90223752 100644
---
a/polaris-core/src/main/java/org/apache/polaris/core/persistence/AtomicOperationMetaStoreManager.java
+++
b/polaris-core/src/main/java/org/apache/polaris/core/persistence/AtomicOperationMetaStoreManager.java
@@ -827,7 +827,7 @@ public class AtomicOperationMetaStoreManager extends
BaseMetaStoreManager {
/** {@inheritDoc} */
@Override
- public @Nonnull void deletePrincipalSecrets(
+ public void deletePrincipalSecrets(
@Nonnull PolarisCallContext callCtx, @Nonnull String clientId, long
principalId) {
// get metastore we should be using
BasePersistence ms = callCtx.getMetaStore();
diff --git
a/polaris-core/src/main/java/org/apache/polaris/core/persistence/TransactionWorkspaceMetaStoreManager.java
b/polaris-core/src/main/java/org/apache/polaris/core/persistence/TransactionWorkspaceMetaStoreManager.java
index b0c78c0b1..e788b999c 100644
---
a/polaris-core/src/main/java/org/apache/polaris/core/persistence/TransactionWorkspaceMetaStoreManager.java
+++
b/polaris-core/src/main/java/org/apache/polaris/core/persistence/TransactionWorkspaceMetaStoreManager.java
@@ -95,31 +95,32 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
this.delegate = delegate;
}
+ private RuntimeException illegalMethodError(String methodName) {
+ return diagnostics.fail("illegal_method_in_transaction_workspace",
methodName);
+ }
+
public List<EntityWithPath> getPendingUpdates() {
return ImmutableList.copyOf(pendingUpdates);
}
@Override
- public BaseResult bootstrapPolarisService(@Nonnull PolarisCallContext
callCtx) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"bootstrapPolarisService");
- return null;
+ public @Nonnull BaseResult bootstrapPolarisService(@Nonnull
PolarisCallContext callCtx) {
+ throw illegalMethodError("bootstrapPolarisService");
}
@Override
- public BaseResult purge(@Nonnull PolarisCallContext callCtx) {
- diagnostics.fail("illegal_method_in_transaction_workspace", "purge");
- return null;
+ public @Nonnull BaseResult purge(@Nonnull PolarisCallContext callCtx) {
+ throw illegalMethodError("purge");
}
@Override
- public EntityResult readEntityByName(
+ public @Nonnull EntityResult readEntityByName(
@Nonnull PolarisCallContext callCtx,
@Nullable List<PolarisEntityCore> catalogPath,
@Nonnull PolarisEntityType entityType,
@Nonnull PolarisEntitySubType entitySubType,
@Nonnull String name) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"readEntityByName");
- return null;
+ throw illegalMethodError("readEntityByName");
}
@Override
@@ -129,8 +130,7 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
@Nonnull PolarisEntityType entityType,
@Nonnull PolarisEntitySubType entitySubType,
@Nonnull PageToken pageToken) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"listEntities");
- return null;
+ throw illegalMethodError("listEntities");
}
@Override
@@ -140,86 +140,77 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
@Nonnull PolarisEntityType entityType,
@Nonnull PolarisEntitySubType entitySubType,
@Nonnull PageToken pageToken) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadEntities");
- return null;
+ throw illegalMethodError("listFullEntities");
}
@Override
- public GenerateEntityIdResult generateNewEntityId(@Nonnull
PolarisCallContext callCtx) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"generateNewEntityId");
- return null;
+ public @Nonnull GenerateEntityIdResult generateNewEntityId(@Nonnull
PolarisCallContext callCtx) {
+ throw illegalMethodError("generateNewEntityId");
}
@Override
- public CreatePrincipalResult createPrincipal(
+ public @Nonnull CreatePrincipalResult createPrincipal(
@Nonnull PolarisCallContext callCtx, @Nonnull PrincipalEntity principal)
{
- diagnostics.fail("illegal_method_in_transaction_workspace",
"createPrincipal");
- return null;
+ throw illegalMethodError("createPrincipal");
}
@Override
- public PrincipalSecretsResult loadPrincipalSecrets(
+ public @Nonnull PrincipalSecretsResult loadPrincipalSecrets(
@Nonnull PolarisCallContext callCtx, @Nonnull String clientId) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadPrincipalSecrets");
- return null;
+ throw illegalMethodError("loadPrincipalSecrets");
}
@Override
public void deletePrincipalSecrets(
@Nonnull PolarisCallContext callCtx, @Nonnull String clientId, long
principalId) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadPrincipalSecrets");
+ throw illegalMethodError("deletePrincipalSecrets");
}
@Override
- public PrincipalSecretsResult rotatePrincipalSecrets(
+ public @Nonnull PrincipalSecretsResult rotatePrincipalSecrets(
@Nonnull PolarisCallContext callCtx,
@Nonnull String clientId,
long principalId,
boolean reset,
@Nonnull String oldSecretHash) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"rotatePrincipalSecrets");
- return null;
+ throw illegalMethodError("rotatePrincipalSecrets");
}
@Override
- public PrincipalSecretsResult resetPrincipalSecrets(
+ public @Nonnull PrincipalSecretsResult resetPrincipalSecrets(
@Nonnull PolarisCallContext callCtx,
long principalId,
@Nonnull String resolvedClientId,
String customClientSecret) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"resetPrincipalSecrets");
- return null;
+ throw illegalMethodError("resetPrincipalSecrets");
}
@Override
- public CreateCatalogResult createCatalog(
+ public @Nonnull CreateCatalogResult createCatalog(
@Nonnull PolarisCallContext callCtx,
@Nonnull PolarisBaseEntity catalog,
@Nonnull List<PolarisEntityCore> principalRoles) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"createCatalog");
- return null;
+ throw illegalMethodError("createCatalog");
}
@Override
- public EntityResult createEntityIfNotExists(
+ public @Nonnull EntityResult createEntityIfNotExists(
@Nonnull PolarisCallContext callCtx,
@Nullable List<PolarisEntityCore> catalogPath,
@Nonnull PolarisBaseEntity entity) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"createEntityIfNotExists");
- return null;
+ throw illegalMethodError("createEntityIfNotExists");
}
@Override
- public EntitiesResult createEntitiesIfNotExist(
+ public @Nonnull EntitiesResult createEntitiesIfNotExist(
@Nonnull PolarisCallContext callCtx,
@Nullable List<PolarisEntityCore> catalogPath,
@Nonnull List<? extends PolarisBaseEntity> entities) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"createEntitiesIfNotExist");
- return null;
+ throw illegalMethodError("createEntitiesIfNotExist");
}
@Override
- public EntityResult updateEntityPropertiesIfNotChanged(
+ public @Nonnull EntityResult updateEntityPropertiesIfNotChanged(
@Nonnull PolarisCallContext callCtx,
@Nullable List<PolarisEntityCore> catalogPath,
@Nonnull PolarisBaseEntity entity) {
@@ -228,114 +219,100 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
}
@Override
- public EntitiesResult updateEntitiesPropertiesIfNotChanged(
+ public @Nonnull EntitiesResult updateEntitiesPropertiesIfNotChanged(
@Nonnull PolarisCallContext callCtx, @Nonnull List<EntityWithPath>
entities) {
- diagnostics.fail(
- "illegal_method_in_transaction_workspace",
"updateEntitiesPropertiesIfNotChanged");
- return null;
+ throw illegalMethodError("updateEntitiesPropertiesIfNotChanged");
}
@Override
- public EntityResult renameEntity(
+ public @Nonnull EntityResult renameEntity(
@Nonnull PolarisCallContext callCtx,
@Nullable List<PolarisEntityCore> catalogPath,
@Nonnull PolarisBaseEntity entityToRename,
@Nullable List<PolarisEntityCore> newCatalogPath,
@Nonnull PolarisEntity renamedEntity) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"renameEntity");
- return null;
+ throw illegalMethodError("renameEntity");
}
@Override
- public DropEntityResult dropEntityIfExists(
+ public @Nonnull DropEntityResult dropEntityIfExists(
@Nonnull PolarisCallContext callCtx,
@Nullable List<PolarisEntityCore> catalogPath,
@Nonnull PolarisBaseEntity entityToDrop,
@Nullable Map<String, String> cleanupProperties,
boolean cleanup) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"dropEntityIfExists");
- return null;
+ throw illegalMethodError("dropEntityIfExists");
}
@Override
- public PrivilegeResult grantUsageOnRoleToGrantee(
+ public @Nonnull PrivilegeResult grantUsageOnRoleToGrantee(
@Nonnull PolarisCallContext callCtx,
@Nullable PolarisEntityCore catalog,
@Nonnull PolarisEntityCore role,
@Nonnull PolarisEntityCore grantee) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"grantUsageOnRoleToGrantee");
- return null;
+ throw illegalMethodError("grantUsageOnRoleToGrantee");
}
@Override
- public PrivilegeResult revokeUsageOnRoleFromGrantee(
+ public @Nonnull PrivilegeResult revokeUsageOnRoleFromGrantee(
@Nonnull PolarisCallContext callCtx,
@Nullable PolarisEntityCore catalog,
@Nonnull PolarisEntityCore role,
@Nonnull PolarisEntityCore grantee) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"revokeUsageOnRoleFromGrantee");
- return null;
+ throw illegalMethodError("revokeUsageOnRoleFromGrantee");
}
@Override
- public PrivilegeResult grantPrivilegeOnSecurableToRole(
+ public @Nonnull PrivilegeResult grantPrivilegeOnSecurableToRole(
@Nonnull PolarisCallContext callCtx,
@Nonnull PolarisEntityCore grantee,
@Nullable List<PolarisEntityCore> catalogPath,
@Nonnull PolarisEntityCore securable,
@Nonnull PolarisPrivilege privilege) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"grantPrivilegeOnSecurableToRole");
- return null;
+ throw illegalMethodError("grantPrivilegeOnSecurableToRole");
}
@Override
- public PrivilegeResult revokePrivilegeOnSecurableFromRole(
+ public @Nonnull PrivilegeResult revokePrivilegeOnSecurableFromRole(
@Nonnull PolarisCallContext callCtx,
@Nonnull PolarisEntityCore grantee,
@Nullable List<PolarisEntityCore> catalogPath,
@Nonnull PolarisEntityCore securable,
@Nonnull PolarisPrivilege privilege) {
- diagnostics.fail(
- "illegal_method_in_transaction_workspace",
"revokePrivilegeOnSecurableFromRole");
- return null;
+ throw illegalMethodError("revokePrivilegeOnSecurableFromRole");
}
@Override
public @Nonnull LoadGrantsResult loadGrantsOnSecurable(
@Nonnull PolarisCallContext callCtx, PolarisEntityCore securable) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadGrantsOnSecurable");
- return null;
+ throw illegalMethodError("loadGrantsOnSecurable");
}
@Override
public @Nonnull LoadGrantsResult loadGrantsToGrantee(
@Nonnull PolarisCallContext callCtx, PolarisEntityCore grantee) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadGrantsToGrantee");
- return null;
+ throw illegalMethodError("loadGrantsToGrantee");
}
@Override
- public ChangeTrackingResult loadEntitiesChangeTracking(
+ public @Nonnull ChangeTrackingResult loadEntitiesChangeTracking(
@Nonnull PolarisCallContext callCtx, @Nonnull List<PolarisEntityId>
entityIds) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadEntitiesChangeTracking");
- return null;
+ throw illegalMethodError("loadEntitiesChangeTracking");
}
@Override
- public EntityResult loadEntity(
+ public @Nonnull EntityResult loadEntity(
@Nonnull PolarisCallContext callCtx,
long entityCatalogId,
long entityId,
- PolarisEntityType entityType) {
- diagnostics.fail("illegal_method_in_transaction_workspace", "loadEntity");
- return null;
+ @Nonnull PolarisEntityType entityType) {
+ throw illegalMethodError("loadEntity");
}
@Override
- public EntitiesResult loadTasks(
+ public @Nonnull EntitiesResult loadTasks(
@Nonnull PolarisCallContext callCtx, String executorId, PageToken
pageToken) {
- diagnostics.fail("illegal_method_in_transaction_workspace", "loadTasks");
- return null;
+ throw illegalMethodError("loadTasks");
}
@Override
@@ -360,46 +337,41 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
}
@Override
- public ResolvedEntityResult loadResolvedEntityById(
+ public @Nonnull ResolvedEntityResult loadResolvedEntityById(
@Nonnull PolarisCallContext callCtx,
long entityCatalogId,
long entityId,
PolarisEntityType entityType) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadResolvedEntityById");
- return null;
+ throw illegalMethodError("loadResolvedEntityById");
}
@Override
- public ResolvedEntityResult loadResolvedEntityByName(
+ public @Nonnull ResolvedEntityResult loadResolvedEntityByName(
@Nonnull PolarisCallContext callCtx,
long entityCatalogId,
long parentId,
@Nonnull PolarisEntityType entityType,
@Nonnull String entityName) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadResolvedEntityByName");
- return null;
+ throw illegalMethodError("loadResolvedEntityByName");
}
- @Nonnull
@Override
- public ResolvedEntitiesResult loadResolvedEntities(
+ public @Nonnull ResolvedEntitiesResult loadResolvedEntities(
@Nonnull PolarisCallContext callCtx,
@Nonnull PolarisEntityType entityType,
@Nonnull List<PolarisEntityId> entityIds) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadResolvedEntities");
- return null;
+ throw illegalMethodError("loadResolvedEntities");
}
@Override
- public ResolvedEntityResult refreshResolvedEntity(
+ public @Nonnull ResolvedEntityResult refreshResolvedEntity(
@Nonnull PolarisCallContext callCtx,
int entityVersion,
int entityGrantRecordsVersion,
@Nonnull PolarisEntityType entityType,
long entityCatalogId,
long entityId) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"refreshResolvedEntity");
- return null;
+ throw illegalMethodError("refreshResolvedEntity");
}
/** {@inheritDoc} */
@@ -407,8 +379,7 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
public <T extends PolarisEntity & LocationBasedEntity>
Optional<Optional<String>> hasOverlappingSiblings(
@Nonnull PolarisCallContext callContext, T entity) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"hasOverlappingSiblings");
- return Optional.empty();
+ throw illegalMethodError("hasOverlappingSiblings");
}
@Override
@@ -419,8 +390,7 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
@Nonnull List<PolarisEntityCore> policyCatalogPath,
@Nonnull PolicyEntity policy,
Map<String, String> parameters) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"attachPolicyToEntity");
- return null;
+ throw illegalMethodError("attachPolicyToEntity");
}
@Override
@@ -430,15 +400,13 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
@Nonnull PolarisEntityCore target,
@Nonnull List<PolarisEntityCore> policyCatalogPath,
@Nonnull PolicyEntity policy) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"detachPolicyFromEntity");
- return null;
+ throw illegalMethodError("detachPolicyFromEntity");
}
@Override
public @Nonnull LoadPolicyMappingsResult loadPoliciesOnEntity(
@Nonnull PolarisCallContext callCtx, @Nonnull PolarisEntityCore target) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadPoliciesOnEntity");
- return null;
+ throw illegalMethodError("loadPoliciesOnEntity");
}
@Override
@@ -446,14 +414,12 @@ public class TransactionWorkspaceMetaStoreManager
implements PolarisMetaStoreMan
@Nonnull PolarisCallContext callCtx,
@Nonnull PolarisEntityCore target,
@Nonnull PolicyType policyType) {
- diagnostics.fail("illegal_method_in_transaction_workspace",
"loadPoliciesOnEntityByType");
- return null;
+ throw illegalMethodError("loadPoliciesOnEntityByType");
}
- @Nonnull
@Override
public void writeEvents(
@Nonnull PolarisCallContext callCtx, @Nonnull List<PolarisEvent>
polarisEvents) {
- diagnostics.fail("illegal_method_in_transaction_workspace", "writeEvents");
+ throw illegalMethodError("writeEvents");
}
}
diff --git
a/polaris-core/src/main/java/org/apache/polaris/core/persistence/transactional/TransactionalMetaStoreManagerImpl.java
b/polaris-core/src/main/java/org/apache/polaris/core/persistence/transactional/TransactionalMetaStoreManagerImpl.java
index 6602cf01a..753c58ab6 100644
---
a/polaris-core/src/main/java/org/apache/polaris/core/persistence/transactional/TransactionalMetaStoreManagerImpl.java
+++
b/polaris-core/src/main/java/org/apache/polaris/core/persistence/transactional/TransactionalMetaStoreManagerImpl.java
@@ -876,7 +876,7 @@ public class TransactionalMetaStoreManagerImpl extends
BaseMetaStoreManager {
/** {@inheritDoc} */
@Override
- public @Nonnull void deletePrincipalSecrets(
+ public void deletePrincipalSecrets(
@Nonnull PolarisCallContext callCtx, @Nonnull String clientId, long
principalId) {
// get metastore we should be using
TransactionalPersistence ms = ((TransactionalPersistence)
callCtx.getMetaStore());