mem

README

REST Layer Memory backend

This REST Layer resource storage backend stores data in memory with no persistence. This package is provided as an implementation example and a test backend to be used for testing only.

DO NOT USE THIS IN PRODUCTION.

Usage

Simply create a memory resource handler per resource:

import "github.com/rs/rest-layer/resource/testing/mem"

index.Bind("foo", foo, mem.NewHandler(), resource.DefaultConf)

Latency Simulation

As local memory access is very fast, this handler is not very useful when it comes to working with latency related issues. This handler allows you to simulate latency by setting an artificial delay:

root.Bind("foo", resource.NewResource(foo, mem.NewSlowHandler(5*time.Second), resource.DefaultConf)

With this configuration, the memory handler will pause 5 seconds before processing every request. If the passed net/context is canceled during that wait, the handler won't process the request and return the appropriate rest.Error as specified in the REST Layer storage handler implementation doc.

Documentation

Overview

Package mem is an example REST backend storage that stores everything in memory.

Index

• type MemoryHandler
  • func NewHandler() *MemoryHandler
  • func NewSlowHandler(latency time.Duration) *MemoryHandler
  • func (m *MemoryHandler) Clear(ctx context.Context, q *query.Query) (total int, err error)
  • func (m *MemoryHandler) Delete(ctx context.Context, item *resource.Item) (err error)
  • func (m *MemoryHandler) Find(ctx context.Context, q *query.Query) (list *resource.ItemList, err error)
  • func (m *MemoryHandler) Insert(ctx context.Context, items []*resource.Item) (err error)
  • func (m *MemoryHandler) Update(ctx context.Context, item *resource.Item, original *resource.Item) (err error)

Types

type MemoryHandler

type MemoryHandler struct {
	sync.RWMutex

	// If Latency is set, the handler will introduce an artificial latency on
	// all operations.
	Latency time.Duration
	// contains filtered or unexported fields
}

MemoryHandler is an example handler storing data in memory.

func NewHandler

func NewHandler() *MemoryHandler

NewHandler creates an empty memory handler.

func NewSlowHandler

func NewSlowHandler(latency time.Duration) *MemoryHandler

NewSlowHandler creates an empty memory handler with specified latency.

func (*MemoryHandler) Clear

func (m *MemoryHandler) Clear(ctx context.Context, q *query.Query) (total int, err error)

Clear clears all items from the memory store matching q.

func (*MemoryHandler) Delete

func (m *MemoryHandler) Delete(ctx context.Context, item *resource.Item) (err error)

Delete deletes an item from memory.

func (*MemoryHandler) Find

func (m *MemoryHandler) Find(ctx context.Context, q *query.Query) (list *resource.ItemList, err error)

Find items from memory matching the q.

func (*MemoryHandler) Insert

func (m *MemoryHandler) Insert(ctx context.Context, items []*resource.Item) (err error)

Insert inserts new items in memory.

func (*MemoryHandler) Update

func (m *MemoryHandler) Update(ctx context.Context, item *resource.Item, original *resource.Item) (err error)

Update replace an item by a new one in memory.