forked from aws/aws-lambda-runtime-interface-emulator
-
Notifications
You must be signed in to change notification settings - Fork 3
Expand file tree
/
Copy pathexternalagent.go
More file actions
204 lines (171 loc) · 5.4 KB
/
externalagent.go
File metadata and controls
204 lines (171 loc) · 5.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
package core
import (
"fmt"
"time"
"go.amzn.com/lambda/core/statejson"
"github.com/google/uuid"
)
// ExternalAgent represents external agent
type ExternalAgent struct {
Name string
ID uuid.UUID
events map[Event]struct{}
ManagedThread Suspendable
currentState ExternalAgentState
stateLastModified time.Time
Pid int
StartedState ExternalAgentState
RegisteredState ExternalAgentState
ReadyState ExternalAgentState
RunningState ExternalAgentState
InitErrorState ExternalAgentState
ExitErrorState ExternalAgentState
ShutdownFailedState ExternalAgentState
ExitedState ExternalAgentState
LaunchErrorState ExternalAgentState
errorType string
}
// NewExternalAgent returns new instance of a named agent
func NewExternalAgent(name string, initFlow InitFlowSynchronization, invokeFlow InvokeFlowSynchronization) *ExternalAgent {
agent := &ExternalAgent{
Name: name,
ID: uuid.New(),
ManagedThread: NewManagedThread(),
events: make(map[Event]struct{}),
}
agent.StartedState = &ExternalAgentStartedState{agent: agent, initFlow: initFlow}
agent.RegisteredState = &ExternalAgentRegisteredState{agent: agent, initFlow: initFlow}
agent.ReadyState = &ExternalAgentReadyState{agent: agent}
agent.RunningState = &ExternalAgentRunningState{agent: agent, invokeFlow: invokeFlow}
agent.InitErrorState = &ExternalAgentInitErrorState{}
agent.ExitErrorState = &ExternalAgentExitErrorState{}
agent.ShutdownFailedState = &ExternalAgentShutdownFailedState{}
agent.ExitedState = &ExternalAgentExitedState{}
agent.LaunchErrorState = &ExternalAgentLaunchErrorState{}
agent.setStateUnsafe(agent.StartedState)
return agent
}
func (s *ExternalAgent) String() string {
return fmt.Sprintf("%s (%s)", s.Name, s.ID)
}
// SuspendUnsafe the current running thread
func (s *ExternalAgent) SuspendUnsafe() {
s.ManagedThread.SuspendUnsafe()
}
// Release will resume a suspended thread
func (s *ExternalAgent) Release() {
s.ManagedThread.Release()
}
// SetState using the lock
func (s *ExternalAgent) SetState(state ExternalAgentState) {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
s.setStateUnsafe(state)
}
func (s *ExternalAgent) setStateUnsafe(state ExternalAgentState) {
s.currentState = state
s.stateLastModified = time.Now()
}
func ValidateExternalAgentEvent(e Event) error {
switch e {
case InvokeEvent:
return nil
case ShutdownEvent:
return nil
}
return errInvalidEventType
}
func (s *ExternalAgent) subscribeUnsafe(e Event) error {
if err := ValidateExternalAgentEvent(e); err != nil {
return err
}
s.events[e] = struct{}{}
return nil
}
// IsSubscribed checks whether agent is subscribed the Event
func (s *ExternalAgent) IsSubscribed(e Event) bool {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
_, found := s.events[e]
return found
}
// SubscribedEvents returns events to which the agent is subscribed
func (s *ExternalAgent) SubscribedEvents() []string {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
events := []string{}
for event := range s.events {
events = append(events, string(event))
}
return events
}
// GetState returns agent's current state
func (s *ExternalAgent) GetState() ExternalAgentState {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.currentState
}
// Register an agent with the platform
func (s *ExternalAgent) Register(events []Event) error {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.currentState.Register(events)
}
// Ready - mark an agent as ready
func (s *ExternalAgent) Ready() error {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.currentState.Ready()
}
// InitError - agent registered but failed to initialize
func (s *ExternalAgent) InitError(errorType string) error {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.currentState.InitError(errorType)
}
// ExitError - agent reported unrecoverable error
func (s *ExternalAgent) ExitError(errorType string) error {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.currentState.ExitError(errorType)
}
// ShutdownFailed - terminal state, agent didn't exit gracefully
func (s *ExternalAgent) ShutdownFailed() error {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.currentState.ShutdownFailed()
}
// Exited - agent shut down successfully
func (s *ExternalAgent) Exited() error {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.currentState.Exited()
}
// ErrorType returns error type reported during init or exit
func (s *ExternalAgent) ErrorType() string {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.errorType
}
// Exited - agent shut down successfully
func (s *ExternalAgent) LaunchError(err error) error {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return s.currentState.LaunchError(err)
}
// GetAgentDescription returns agent description object for debugging purposes
func (s *ExternalAgent) GetAgentDescription() statejson.ExtensionDescription {
s.ManagedThread.Lock()
defer s.ManagedThread.Unlock()
return statejson.ExtensionDescription{
Name: s.Name,
ID: s.ID.String(),
State: statejson.StateDescription{
Name: s.currentState.Name(),
LastModified: s.stateLastModified.UnixNano() / int64(time.Millisecond),
},
ErrorType: s.errorType,
}
}