2013-02-07 10:38:01 +00:00
|
|
|
// Copyright 2013 Prometheus Team
|
2012-11-26 19:11:34 +00:00
|
|
|
// 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.
|
|
|
|
|
2012-11-26 18:56:51 +00:00
|
|
|
package raw
|
2012-11-24 11:33:34 +00:00
|
|
|
|
2012-11-25 15:07:05 +00:00
|
|
|
import (
|
2013-01-27 17:49:45 +00:00
|
|
|
"github.com/prometheus/prometheus/coding"
|
2013-02-06 16:05:23 +00:00
|
|
|
"github.com/prometheus/prometheus/storage"
|
2012-11-25 15:07:05 +00:00
|
|
|
)
|
|
|
|
|
2013-03-24 06:00:17 +00:00
|
|
|
// Persistence models a key-value store for bytes that supports various
|
|
|
|
// additional operations.
|
2012-11-24 11:33:34 +00:00
|
|
|
type Persistence interface {
|
2013-04-01 11:22:38 +00:00
|
|
|
// Close reaps all of the underlying system resources associated with this
|
|
|
|
// persistence.
|
|
|
|
Close()
|
2013-03-24 06:00:17 +00:00
|
|
|
// Has informs the user whether a given key exists in the database.
|
2012-11-25 15:07:05 +00:00
|
|
|
Has(key coding.Encoder) (bool, error)
|
2013-03-24 06:00:17 +00:00
|
|
|
// Get retrieves the key from the database if it exists or returns nil if
|
|
|
|
// it is absent.
|
2012-11-25 15:07:05 +00:00
|
|
|
Get(key coding.Encoder) ([]byte, error)
|
2013-03-24 06:00:17 +00:00
|
|
|
// Drop removes the key from the database.
|
2012-11-25 15:07:05 +00:00
|
|
|
Drop(key coding.Encoder) error
|
2013-03-24 06:00:17 +00:00
|
|
|
// Put sets the key to a given value.
|
2012-11-25 15:07:05 +00:00
|
|
|
Put(key, value coding.Encoder) error
|
2013-02-06 16:05:23 +00:00
|
|
|
// ForEach is responsible for iterating through all records in the database
|
|
|
|
// until one of the following conditions are met:
|
|
|
|
//
|
|
|
|
// 1.) A system anomaly in the database scan.
|
|
|
|
// 2.) The last record in the database is reached.
|
|
|
|
// 3.) A FilterResult of STOP is emitted by the Filter.
|
|
|
|
//
|
|
|
|
// Decoding errors for an entity cause that entity to be skipped.
|
|
|
|
ForEach(decoder storage.RecordDecoder, filter storage.RecordFilter, operator storage.RecordOperator) (scannedEntireCorpus bool, err error)
|
2013-03-24 06:00:17 +00:00
|
|
|
// Commit applies the Batch operations to the database.
|
|
|
|
Commit(Batch) error
|
2012-11-24 11:33:34 +00:00
|
|
|
}
|
2013-03-24 06:00:17 +00:00
|
|
|
|
|
|
|
// Batch models a pool of mutations for the database that can be committed
|
|
|
|
// en masse. The interface implies no protocol around the atomicity of
|
|
|
|
// effectuation.
|
|
|
|
type Batch interface {
|
2013-04-01 11:22:38 +00:00
|
|
|
// Close reaps all of the underlying system resources associated with this
|
|
|
|
// batch mutation.
|
|
|
|
Close()
|
2013-03-24 06:00:17 +00:00
|
|
|
// Put follows the same protocol as Persistence.Put.
|
|
|
|
Put(key, value coding.Encoder)
|
|
|
|
// Drop follows the same protocol as Persistence.Drop.
|
|
|
|
Drop(key coding.Encoder)
|
|
|
|
}
|