Files
ragflow/internal/syncer/connector/registry.go
2026-08-21 16:50:29 +08:00

104 lines
3.1 KiB
Go

//
// Copyright 2026 The InfiniFlow 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 connector
import (
"context"
"errors"
"fmt"
"ragflow/internal/dao"
"sync"
)
// ErrUnsupportedSource is returned when no Go connector is registered for a source.
var ErrUnsupportedSource = errors.New("unsupported connector source")
// UnsupportedSourceError identifies a connector source that is not implemented.
type UnsupportedSourceError struct {
Source string
}
func (e *UnsupportedSourceError) Error() string {
return fmt.Sprintf("%s %q", ErrUnsupportedSource, e.Source)
}
func (e *UnsupportedSourceError) Unwrap() error {
return ErrUnsupportedSource
}
// Factory creates a connector for a task context.
type Factory func(ctx context.Context, taskContext dao.SyncTaskContext) (Connector, error)
// ConfigFactory creates a connector from raw connector config.
type ConfigFactory func(config map[string]any) (Connector, error)
// Registry maps connector source names to Go connector factories.
type Registry struct {
mu sync.RWMutex
factories map[string]Factory
configFactories map[string]ConfigFactory
}
// NewRegistry creates an empty connector registry.
func NewRegistry() *Registry {
return &Registry{
factories: map[string]Factory{},
configFactories: map[string]ConfigFactory{},
}
}
// Register adds or replaces a connector factory.
func (r *Registry) Register(source string, factory Factory) {
r.mu.Lock()
defer r.mu.Unlock()
r.factories[source] = factory
}
// RegisterConfigFactory adds or replaces a raw config connector factory.
func (r *Registry) RegisterConfigFactory(source string, factory ConfigFactory) {
r.mu.Lock()
defer r.mu.Unlock()
r.configFactories[source] = factory
}
// Open creates a connector for a task context.
func (r *Registry) Open(ctx context.Context, taskContext dao.SyncTaskContext) (Connector, error) {
return r.openSource(ctx, taskContext.Connector.Source, taskContext)
}
// OpenFromConfig builds a connector from a raw config map.
func (r *Registry) OpenFromConfig(source string, config map[string]any) (Connector, error) {
r.mu.RLock()
factory := r.configFactories[source]
r.mu.RUnlock()
if factory == nil {
return nil, &UnsupportedSourceError{Source: source}
}
return factory(config)
}
// openSource creates a connector for a known source.
func (r *Registry) openSource(ctx context.Context, source string, taskContext dao.SyncTaskContext) (Connector, error) {
r.mu.RLock()
factory := r.factories[source]
r.mu.RUnlock()
if factory == nil {
return nil, &UnsupportedSourceError{Source: source}
}
return factory(ctx, taskContext)
}