// Copyright (c) 2014 Couchbase, Inc. // 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 bleve import ( "github.com/blevesearch/bleve/document" "github.com/blevesearch/bleve/index" "github.com/blevesearch/bleve/index/store" ) // A Batch groups together multiple Index and Delete // operations you would like performed at the same // time. type Batch struct { indexOps map[string]interface{} internalOps map[string][]byte } // NewBatch creates a new empty batch. func NewBatch() *Batch { return &Batch{ indexOps: make(map[string]interface{}), internalOps: make(map[string][]byte), } } // Index adds the specified index operation to the // batch. NOTE: the bleve Index is not updated // until the batch is executed. func (b Batch) Index(id string, data interface{}) { b.indexOps[id] = data } // Delete adds the specified delete operation to the // batch. NOTE: the bleve Index is not updated until // the batch is executed. func (b Batch) Delete(id string) { b.indexOps[id] = nil } // SetInternal adds the specified set internal // operation to the batch. NOTE: the bleve Index is // not updated until the batch is executed. func (b Batch) SetInternal(key, val []byte) { b.internalOps[string(key)] = val } // SetInternal adds the specified delete internal // operation to the batch. NOTE: the bleve Index is // not updated until the batch is executed. func (b Batch) DeleteInternal(key []byte) { b.internalOps[string(key)] = nil } func (b Batch) Size() int { return len(b.indexOps) + len(b.internalOps) } // An Index implements all the indexing and searching // capabilities of bleve. An Index can be created // using the New() and Open() methods. type Index interface { Index(id string, data interface{}) error Delete(id string) error Batch(b *Batch) error Document(id string) (*document.Document, error) DocCount() (uint64, error) Search(req *SearchRequest) (*SearchResult, error) Fields() ([]string, error) DumpAll() chan interface{} DumpDoc(id string) chan interface{} DumpFields() chan interface{} Close() error Mapping() *IndexMapping Stats() *IndexStat GetInternal(key []byte) ([]byte, error) SetInternal(key, val []byte) error DeleteInternal(key []byte) error Advanced() (index.Index, store.KVStore, error) } // A Classifier is an interface describing any object // which knows how to identify its own type. type Classifier interface { Type() string } // New index at the specified path, must not exist. // The provided mapping will be used for all // Index/Search operations. func New(path string, mapping *IndexMapping) (Index, error) { return newIndexUsing(path, mapping, Config.DefaultKVStore, nil) } // NewUsing creates index at the specified path, // which must not already exist. // The provided mapping will be used for all // Index/Search operations. // The specified kvstore implemenation will be used // and the provided kvconfig will be passed to its // constructor. func NewUsing(path string, mapping *IndexMapping, kvstore string, kvconfig map[string]interface{}) (Index, error) { return newIndexUsing(path, mapping, kvstore, kvconfig) } // Open index at the specified path, must exist. // The mapping used when it was created will be used for all Index/Search operations. func Open(path string) (Index, error) { return openIndexUsing(path, nil) } // OpenUsing opens index at the specified path, must exist. // The mapping used when it was created will be used for all Index/Search operations. // The provided runtimeConfig can override settings // persisted when the kvstore was created. func OpenUsing(path string, runtimeConfig map[string]interface{}) (Index, error) { return openIndexUsing(path, runtimeConfig) }