Class: ComposableOperations::Operation

Inherits:
Object
  • Object
show all
Includes:
SmartProperties
Defined in:
lib/composable_operations/operation.rb

Direct Known Subclasses

ComposedOperation

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(*args) ⇒ Operation

Returns a new instance of Operation.



91
92
93
94
95
96
97
98
# File 'lib/composable_operations/operation.rb', line 91

def initialize(*args)
  named_input_parameters   = args.shift(self.class.arity)
  options                  = args.last.kind_of?(Hash) ? args.pop : {}
  unnamed_input_parameters = args

  @input = named_input_parameters + unnamed_input_parameters
  super(options)
end

Class Attribute Details

.arityObject



10
11
12
# File 'lib/composable_operations/operation.rb', line 10

def arity
  @arity || 0
end

Instance Attribute Details

#backtraceObject

Returns the value of attribute backtrace.



88
89
90
# File 'lib/composable_operations/operation.rb', line 88

def backtrace
  @backtrace
end

#exceptionObject

Returns the value of attribute exception.



89
90
91
# File 'lib/composable_operations/operation.rb', line 89

def exception
  @exception
end

#inputObject (readonly)

Returns the value of attribute input.



85
86
87
# File 'lib/composable_operations/operation.rb', line 85

def input
  @input
end

#messageObject

Returns the value of attribute message.



87
88
89
# File 'lib/composable_operations/operation.rb', line 87

def message
  @message
end

#resultObject

Returns the value of attribute result.



86
87
88
# File 'lib/composable_operations/operation.rb', line 86

def result
  @result
end

Class Method Details

.exceptionObject



45
46
47
# File 'lib/composable_operations/operation.rb', line 45

def exception
  OperationError
end

.finalizersObject



34
35
36
37
38
39
40
41
42
43
# File 'lib/composable_operations/operation.rb', line 34

def finalizers
  finalizers = []
  klass = self
  while klass != Operation
    klass = klass.superclass
    finalizers += Array(klass.instance_variable_get(:@finalizers))
  end
  finalizers += Array(@finalizers)
  finalizers
end

.perform(*args) ⇒ Object



14
15
16
17
18
19
20
21
# File 'lib/composable_operations/operation.rb', line 14

def perform(*args)
  operation = new(*args)
  operation.perform

  raise operation.exception if operation.failed?

  operation.result
end

.preparatorsObject



23
24
25
26
27
28
29
30
31
32
# File 'lib/composable_operations/operation.rb', line 23

def preparators
  preparators = []
  klass = self
  while klass != Operation
    klass = klass.superclass
    preparators += Array(klass.instance_variable_get(:@preparators))
  end
  preparators += Array(@preparators)
  preparators
end

Instance Method Details

#failed?Boolean

Returns:

  • (Boolean)


100
101
102
# File 'lib/composable_operations/operation.rb', line 100

def failed?
  state == :failed
end

#halted?Boolean

Returns:

  • (Boolean)


104
105
106
# File 'lib/composable_operations/operation.rb', line 104

def halted?
  state == :halted
end

#message?Boolean

Returns:

  • (Boolean)


112
113
114
# File 'lib/composable_operations/operation.rb', line 112

def message?
  message.present?
end

#nameObject



116
117
118
# File 'lib/composable_operations/operation.rb', line 116

def name
  self.class.name
end

#performObject



120
121
122
123
124
125
126
127
128
129
130
131
# File 'lib/composable_operations/operation.rb', line 120

def perform
  self.result = catch(:halt) do
    prepare
    result = execute
    self.state = :succeeded
    result
  end

  finalize

  self.result
end

#succeeded?Boolean

Returns:

  • (Boolean)


108
109
110
# File 'lib/composable_operations/operation.rb', line 108

def succeeded?
  state == :succeeded
end