Class: RubyEventStore::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/ruby_event_store/client.rb

Defined Under Namespace

Classes: Page

Instance Method Summary collapse

Constructor Details

#initialize(repository:, event_broker: PubSub::Broker.new, page_size: PAGE_SIZE, metadata_proc: nil, clock: ->{ Time.now.utc }) ⇒ Client

Returns a new instance of Client.



3
4
5
6
7
8
9
10
11
12
13
 
# File 'lib/ruby_event_store/client.rb', line 3

def initialize(repository:,
               event_broker:  PubSub::Broker.new,
               page_size: PAGE_SIZE,
               metadata_proc: nil,
               clock: ->{ Time.now.utc })
  @repository     = repository
  @event_broker   = event_broker
  @page_size      = page_size
  @metadata_proc  = metadata_proc
  @clock          = clock
end

Instance Method Details

#append_to_stream(event, stream_name: GLOBAL_STREAM, expected_version: :any) ⇒ Object 



21
22
23
24
25
26
 
# File 'lib/ruby_event_store/client.rb', line 21

def append_to_stream(event, stream_name: GLOBAL_STREAM, expected_version: :any)
  validate_expected_version(stream_name, expected_version)
  enriched_event = enrich_event_metadata(event)
  repository.create(enriched_event, stream_name)
  :ok
end

#delete_stream(stream_name) ⇒ Object

Raises:



28
29
30
31
32
 
# File 'lib/ruby_event_store/client.rb', line 28

def delete_stream(stream_name)
  raise IncorrectStreamData if stream_name.nil? || stream_name.empty?
  repository.delete_stream(stream_name)
  :ok
end

#publish_event(event, stream_name: GLOBAL_STREAM, expected_version: :any) ⇒ Object 



15
16
17
18
19
 
# File 'lib/ruby_event_store/client.rb', line 15

def publish_event(event, stream_name: GLOBAL_STREAM, expected_version: :any)
  append_to_stream(event, stream_name: stream_name, expected_version: expected_version)
  event_broker.notify_subscribers(event)
  :ok
end

#read_all_streams_backward(start: :head, count: page_size) ⇒ Object 



61
62
63
64
 
# File 'lib/ruby_event_store/client.rb', line 61

def read_all_streams_backward(start: :head, count: page_size)
  page = Page.new(repository, start, count)
  repository.read_all_streams_backward(page.start, page.count)
end

#read_all_streams_forward(start: :head, count: page_size) ⇒ Object 



56
57
58
59
 
# File 'lib/ruby_event_store/client.rb', line 56

def read_all_streams_forward(start: :head, count: page_size)
  page = Page.new(repository, start, count)
  repository.read_all_streams_forward(page.start, page.count)
end

#read_events_backward(stream_name, start: :head, count: page_size) ⇒ Object

Raises:



40
41
42
43
44
 
# File 'lib/ruby_event_store/client.rb', line 40

def read_events_backward(stream_name, start: :head, count: page_size)
  raise IncorrectStreamData if stream_name.nil? || stream_name.empty?
  page = Page.new(repository, start, count)
  repository.read_events_backward(stream_name, page.start, page.count)
end

#read_events_forward(stream_name, start: :head, count: page_size) ⇒ Object

Raises:



34
35
36
37
38
 
# File 'lib/ruby_event_store/client.rb', line 34

def read_events_forward(stream_name, start: :head, count: page_size)
  raise IncorrectStreamData if stream_name.nil? || stream_name.empty?
  page = Page.new(repository, start, count)
  repository.read_events_forward(stream_name, page.start, page.count)
end

#read_stream_events_backward(stream_name) ⇒ Object

Raises:



51
52
53
54
 
# File 'lib/ruby_event_store/client.rb', line 51

def read_stream_events_backward(stream_name)
  raise IncorrectStreamData if stream_name.nil? || stream_name.empty?
  repository.read_stream_events_backward(stream_name)
end

#read_stream_events_forward(stream_name) ⇒ Object

Raises:



46
47
48
49
 
# File 'lib/ruby_event_store/client.rb', line 46

def read_stream_events_forward(stream_name)
  raise IncorrectStreamData if stream_name.nil? || stream_name.empty?
  repository.read_stream_events_forward(stream_name)
end

#subscribe(subscriber, event_types, &proc) ⇒ Object 



66
67
68
69
70
 
# File 'lib/ruby_event_store/client.rb', line 66

def subscribe(subscriber, event_types, &proc)
  event_broker.add_subscriber(subscriber_or_proxy(subscriber), event_types).tap do |unsub|
    handle_subscribe(unsub, &proc)
  end
end

#subscribe_to_all_events(subscriber, &proc) ⇒ Object 



72
73
74
75
76
 
# File 'lib/ruby_event_store/client.rb', line 72

def subscribe_to_all_events(subscriber, &proc)
  event_broker.add_global_subscriber(subscriber_or_proxy(subscriber)).tap do |unsub|
    handle_subscribe(unsub, &proc)
  end
end