feat: add ContextAdapter interface to support context in adapters (#1305

)

* feat: AdapterWithContext interface

* refactor: ContextAdapter interface

* Update adapter_context.go

* Update adapter_context.go

* Update adapter_context.go

---------

Co-authored-by: hsluoyz <hsluoyz@qq.com>

persist/adapter_context.go

@@ -0,0 +1,41 @@
+// Copyright 2023 The casbin Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package persist
+
+import (
+	"context"
+
+	"github.com/casbin/casbin/v2/model"
+)
+
+// ContextAdapter provides a context-aware interface for Casbin adapters.
+type ContextAdapter interface {
+	Adapter
+
+	// LoadPolicyCtx loads all policy rules from the storage with context.
+	LoadPolicyCtx(ctx context.Context, model model.Model) error
+	// SavePolicyCtx saves all policy rules to the storage with context.
+	SavePolicyCtx(ctx context.Context, model model.Model) error
+
+	// AddPolicyCtx adds a policy rule to the storage with context.
+	// This is part of the Auto-Save feature.
+	AddPolicyCtx(ctx context.Context, sec string, ptype string, rule []string) error
+	// RemovePolicyCtx removes a policy rule from the storage with context.
+	// This is part of the Auto-Save feature.
+	RemovePolicyCtx(ctx context.Context, sec string, ptype string, rule []string) error
+	// RemoveFilteredPolicyCtx removes policy rules that match the filter from the storage with context.
+	// This is part of the Auto-Save feature.
+	RemoveFilteredPolicyCtx(ctx context.Context, sec string, ptype string, fieldIndex int, fieldValues ...string) error
+}