Passed
Pull Request — master (#306)
by
unknown
02:42
created

asyncua.server.address_space   F

Complexity

Total Complexity 192

Size/Duplication

Total Lines 735
Duplicated Lines 0 %

Importance

Changes 0
Metric Value
eloc 539
dl 0
loc 735
rs 2
c 0
b 0
f 0
wmc 192

61 Methods

Rating   Name   Duplication   Size   Complexity  
A NodeData.__str__() 0 2 1
A NodeData.__init__() 0 5 1
A AttributeValue.__str__() 0 2 1
A AttributeService.__init__() 0 3 1
A AttributeValue.__init__() 0 4 1
A AttributeService.read() 0 6 2
A NodeManagementService.add_nodes() 0 5 2
B ViewService._suitable_direction() 0 8 6
B ViewService._translate_browsepath_to_nodeid() 0 23 5
A ViewService._get_sub_ref() 0 9 5
C ViewService._find_element_in_node() 0 15 9
A NodeManagementService.__init__() 0 3 1
A ViewService.translate_browsepaths_to_nodeids() 0 6 2
A ViewService.browse() 0 6 2
A ViewService.__init__() 0 3 1
B AttributeService.write() 0 18 7
A ViewService._is_suitable_ref() 0 12 5
A ViewService._browse() 0 11 4
B ViewService._suitable_reftype() 0 15 7
A NodeManagementService.try_add_nodes() 0 5 3
A AddressSpace.keys() 0 2 1
C MethodService._call() 0 25 9
B AddressSpace.generate_nodeid() 0 23 6
A NodeManagementService._delete_node_callbacks() 0 9 4
A AddressSpace.__init__() 0 7 1
A AddressSpace.add_method_callback() 0 3 1
A AddressSpace.read_attribute_value() 0 15 4
A NodeManagementService._add_ref_to_parent() 0 8 1
A NodeManagementService._add_node_attributes() 0 13 1
A NodeManagementService.try_add_references() 0 4 3
B AddressSpace.write_attribute_value() 0 22 6
A MethodService.stop() 0 2 1
A AddressSpace.make_aspace_shelf() 0 12 3
A NodeManagementService._add_node_attr() 0 7 3
B NodeManagementService._add_unique_reference() 0 10 6
A AddressSpace.add_datachange_callback() 0 13 3
B NodeManagementService._delete_reference() 0 13 6
A AddressSpace.delete_datachange_callback() 0 4 2
A NodeManagementService.delete_references() 0 5 2
A AddressSpace.empty() 0 3 1
A MethodService.__init__() 0 4 1
A AddressSpace.__contains__() 0 2 1
A NodeManagementService.delete_nodes() 0 5 2
B NodeManagementService._delete_unique_reference() 0 11 6
A AddressSpace.__delitem__() 0 2 1
A NodeManagementService.add_references() 0 5 2
A AddressSpace.get() 0 2 1
A AddressSpace.dump() 0 13 4
A AddressSpace.__setitem__() 0 2 1
A NodeManagementService._add_nodeattributes() 0 25 1
B NodeManagementService._delete_node() 0 19 7
A NodeManagementService._add_type_definition() 0 8 1
A AddressSpace.load() 0 6 2
A NodeManagementService._add_reference_no_check() 0 17 4
A MethodService.call() 0 6 2
F NodeManagementService._add_node() 0 67 16
A NodeManagementService._add_reference() 0 9 4
A AddressSpace.__getitem__() 0 2 1
A AddressSpace.load_aspace_shelf() 0 49 2
A NodeManagementService._add_ref_from_parent() 0 10 1
A MethodService._run_method() 0 6 2

How to fix   Complexity   

Complexity

Complex classes like asyncua.server.address_space often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes.

Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.

1
import asyncio
2
import pickle
3
import shelve
4
import logging
5
import collections
6
from datetime import datetime
7
from concurrent.futures import ThreadPoolExecutor
8
from functools import partial
9
10
from asyncua import ua
11
from .users import User, UserRole
12
13
_logger = logging.getLogger(__name__)
14
15
16
class AttributeValue(object):
17
18
    def __init__(self, value):
19
        self.value = value
20
        self.value_callback = None
21
        self.datachange_callbacks = {}
22
23
    def __str__(self):
24
        return f"AttributeValue({self.value})"
25
26
    __repr__ = __str__
27
28
29
class NodeData:
30
31
    def __init__(self, nodeid):
32
        self.nodeid = nodeid
33
        self.attributes = {}
34
        self.references = []
35
        self.call = None
36
37
    def __str__(self):
38
        return f"NodeData(id:{self.nodeid}, attrs:{self.attributes}, refs:{self.references})"
39
40
    __repr__ = __str__
41
42
43
class AttributeService:
44
45
    def __init__(self, aspace: "AddressSpace"):
46
        self.logger = logging.getLogger(__name__)
47
        self._aspace: "AddressSpace" = aspace
48
49
    def read(self, params):
50
        # self.logger.debug("read %s", params)
51
        res = []
52
        for readvalue in params.NodesToRead:
53
            res.append(self._aspace.read_attribute_value(readvalue.NodeId, readvalue.AttributeId))
54
        return res
55
56
    async def write(self, params, user=User(role=UserRole.Admin)):
57
        # self.logger.debug("write %s as user %s", params, user)
58
        res = []
59
        for writevalue in params.NodesToWrite:
60
            if user.role != UserRole.Admin:
61
                if writevalue.AttributeId != ua.AttributeIds.Value:
62
                    res.append(ua.StatusCode(ua.StatusCodes.BadUserAccessDenied))
63
                    continue
64
                al = self._aspace.read_attribute_value(writevalue.NodeId, ua.AttributeIds.AccessLevel)
65
                ual = self._aspace.read_attribute_value(writevalue.NodeId, ua.AttributeIds.UserAccessLevel)
66
                if not al.StatusCode.is_good() or not ua.ua_binary.test_bit(
67
                        al.Value.Value, ua.AccessLevel.CurrentWrite) or not \
68
                        ua.ua_binary.test_bit(ual.Value.Value, ua.AccessLevel.CurrentWrite):
69
                    res.append(ua.StatusCode(ua.StatusCodes.BadUserAccessDenied))
70
                    continue
71
            res.append(
72
                await self._aspace.write_attribute_value(writevalue.NodeId, writevalue.AttributeId, writevalue.Value))
73
        return res
74
75
76
class ViewService(object):
77
78
    def __init__(self, aspace: "AddressSpace"):
79
        self.logger = logging.getLogger(__name__)
80
        self._aspace: "AddressSpace" = aspace
81
82
    def browse(self, params):
83
        # self.logger.debug("browse %s", params)
84
        res = []
85
        for desc in params.NodesToBrowse:
86
            res.append(self._browse(desc))
87
        return res
88
89
    def _browse(self, desc):
90
        res = ua.BrowseResult()
91
        if desc.NodeId not in self._aspace:
92
            res.StatusCode = ua.StatusCode(ua.StatusCodes.BadNodeIdInvalid)
93
            return res
94
        node = self._aspace[desc.NodeId]
95
        for ref in node.references:
96
            if not self._is_suitable_ref(desc, ref):
97
                continue
98
            res.References.append(ref)
99
        return res
100
101
    def _is_suitable_ref(self, desc, ref):
102
        if not self._suitable_direction(desc.BrowseDirection, ref.IsForward):
103
            # self.logger.debug("%s is not suitable due to direction", ref)
104
            return False
105
        if not self._suitable_reftype(desc.ReferenceTypeId, ref.ReferenceTypeId, desc.IncludeSubtypes):
106
            # self.logger.debug("%s is not suitable due to type", ref)
107
            return False
108
        if desc.NodeClassMask and ((desc.NodeClassMask & ref.NodeClass) == 0):
109
            # self.logger.debug("%s is not suitable due to class", ref)
110
            return False
111
        # self.logger.debug("%s is a suitable ref for desc %s", ref, desc)
112
        return True
113
114
    def _suitable_reftype(self, ref1, ref2, subtypes):
115
        """
116
        """
117
        if ref1 == ua.NodeId(ua.ObjectIds.Null):
118
            # If ReferenceTypeId is not specified in the BrowseDescription,
119
            # all References are returned and includeSubtypes is ignored.
120
            return True
121
        if not subtypes and ref2.Identifier == ua.ObjectIds.HasSubtype:
122
            return False
123
        if ref1.Identifier == ref2.Identifier:
124
            return True
125
        oktypes = self._get_sub_ref(ref1)
126
        if not subtypes and ua.NodeId(ua.ObjectIds.HasSubtype) in oktypes:
127
            oktypes.remove(ua.NodeId(ua.ObjectIds.HasSubtype))
128
        return ref2 in oktypes
129
130
    def _get_sub_ref(self, ref):
131
        res = []
132
        nodedata = self._aspace[ref]
133
        if nodedata is not None:
134
            for ref in nodedata.references:
135
                if ref.ReferenceTypeId.Identifier == ua.ObjectIds.HasSubtype and ref.IsForward:
136
                    res.append(ref.NodeId)
137
                    res += self._get_sub_ref(ref.NodeId)
138
        return res
139
140
    def _suitable_direction(self, direction, isforward):
141
        if direction == ua.BrowseDirection.Both:
142
            return True
143
        if direction == ua.BrowseDirection.Forward and isforward:
144
            return True
145
        if direction == ua.BrowseDirection.Inverse and not isforward:
146
            return True
147
        return False
148
149
    def translate_browsepaths_to_nodeids(self, browsepaths):
150
        # self.logger.debug("translate browsepath: %s", browsepaths)
151
        results = []
152
        for path in browsepaths:
153
            results.append(self._translate_browsepath_to_nodeid(path))
154
        return results
155
156
    def _translate_browsepath_to_nodeid(self, path):
157
        # self.logger.debug("looking at path: %s", path)
158
        res = ua.BrowsePathResult()
159
        if not path.RelativePath.Elements[-1].TargetName:
160
            # OPC UA Part 4: Services, 5.8.4 TranslateBrowsePathsToNodeIds
161
            # it's unclear if this the check should also handle empty strings
162
            res.StatusCode = ua.StatusCode(ua.StatusCodes.BadBrowseNameInvalid)
163
            return res
164
        if path.StartingNode not in self._aspace:
165
            res.StatusCode = ua.StatusCode(ua.StatusCodes.BadNodeIdInvalid)
166
            return res
167
        current = path.StartingNode
168
        for el in path.RelativePath.Elements:
169
            nodeid = self._find_element_in_node(el, current)
170
            if not nodeid:
171
                res.StatusCode = ua.StatusCode(ua.StatusCodes.BadNoMatch)
172
                return res
173
            current = nodeid
174
        target = ua.BrowsePathTarget()
175
        target.TargetId = current
176
        target.RemainingPathIndex = 4294967295
177
        res.Targets = [target]
178
        return res
179
180
    def _find_element_in_node(self, el, nodeid):
181
        nodedata = self._aspace[nodeid]
182
        for ref in nodedata.references:
183
            if ref.BrowseName != el.TargetName:
184
                continue
185
            if ref.IsForward == el.IsInverse:
186
                continue
187
            if not el.IncludeSubtypes and ref.ReferenceTypeId != el.ReferenceTypeId:
188
                continue
189
            elif el.IncludeSubtypes and ref.ReferenceTypeId != el.ReferenceTypeId:
190
                if ref.ReferenceTypeId not in self._get_sub_ref(el.ReferenceTypeId):
191
                    continue
192
            return ref.NodeId
193
        self.logger.info("element %s was not found in node %s", el, nodeid)
194
        return None
195
196
197
class NodeManagementService:
198
199
    def __init__(self, aspace: "AddressSpace"):
200
        self.logger = logging.getLogger(__name__)
201
        self._aspace: "AddressSpace" = aspace
202
203
    def add_nodes(self, addnodeitems, user=User(role=UserRole.Admin)):
204
        results = []
205
        for item in addnodeitems:
206
            results.append(self._add_node(item, user))
207
        return results
208
209
    def try_add_nodes(self, addnodeitems, user=User(role=UserRole.Admin), check=True):
210
        for item in addnodeitems:
211
            ret = self._add_node(item, user, check=check)
212
            if not ret.StatusCode.is_good():
213
                yield item
214
215
    def _add_node(self, item, user, check=True):
216
        # self.logger.debug("Adding node %s %s", item.RequestedNewNodeId, item.BrowseName)
217
        result = ua.AddNodesResult()
218
219
        if not user.role == UserRole.Admin:
220
            result.StatusCode = ua.StatusCode(ua.StatusCodes.BadUserAccessDenied)
221
            return result
222
223
        if item.RequestedNewNodeId.has_null_identifier():
224
            # If Identifier of requested NodeId is null we generate a new NodeId using
225
            # the namespace of the nodeid, this is an extention of the spec to allow
226
            # to requests the server to generate a new nodeid in a specified namespace
227
            # self.logger.debug("RequestedNewNodeId has null identifier, generating Identifier")
228
            item.RequestedNewNodeId = self._aspace.generate_nodeid(item.RequestedNewNodeId.NamespaceIndex)
229
        else:
230
            if item.RequestedNewNodeId in self._aspace:
231
                self.logger.warning("AddNodesItem: Requested NodeId %s already exists", item.RequestedNewNodeId)
232
                result.StatusCode = ua.StatusCode(ua.StatusCodes.BadNodeIdExists)
233
                return result
234
235
        if item.ParentNodeId.is_null():
236
            # self.logger.info("add_node: while adding node %s, requested parent node is null %s %s",
237
            # item.RequestedNewNodeId, item.ParentNodeId, item.ParentNodeId.is_null())
238
            if check:
239
                result.StatusCode = ua.StatusCode(ua.StatusCodes.BadParentNodeIdInvalid)
240
                return result
241
242
        parentdata = self._aspace.get(item.ParentNodeId)
243
        if parentdata is None and not item.ParentNodeId.is_null():
244
            self.logger.info("add_node: while adding node %s, requested parent node %s does not exists",
245
                             item.RequestedNewNodeId, item.ParentNodeId)
246
            result.StatusCode = ua.StatusCode(ua.StatusCodes.BadParentNodeIdInvalid)
247
            return result
248
249
        if bool(self._aspace._nodes) and type(item.ParentNodeId) in [ua.NumericNodeId, ua.NodeId]:
250
            try:
251
                if item.BrowseName.Name in [ref.BrowseName.Name for ref in self._aspace._nodes[item.ParentNodeId].references]:
252
                    self.logger.warning("AddNodesItem: Requested Browsename %s already exists in Parent Node", item.BrowseName.Name)
253
                    result.StatusCode = ua.StatusCode(ua.StatusCodes.BadBrowseNameDuplicated)
254
                    return result
255
            except KeyError as e:
256
                if e.args[0].Identifier == 0 and e.args[0].NamespaceIndex == 0:
257
                    pass
258
                else:
259
                    self.logger.warning(f"{e} - NodeParent does not exist in Server")
260
                pass
261
262
263
        nodedata = NodeData(item.RequestedNewNodeId)
264
265
        self._add_node_attributes(nodedata, item, add_timestamps=check)
266
267
        # now add our node to db
268
        self._aspace[nodedata.nodeid] = nodedata
269
270
        if parentdata is not None:
271
            self._add_ref_from_parent(nodedata, item, parentdata)
272
            self._add_ref_to_parent(nodedata, item, parentdata)
273
274
        # add type definition
275
        if item.TypeDefinition != ua.NodeId():
276
            self._add_type_definition(nodedata, item)
277
278
        result.StatusCode = ua.StatusCode()
279
        result.AddedNodeId = nodedata.nodeid
280
281
        return result
282
283
    def _add_node_attributes(self, nodedata, item, add_timestamps):
284
        # add common attrs
285
        nodedata.attributes[ua.AttributeIds.NodeId] = AttributeValue(
286
            ua.DataValue(ua.Variant(nodedata.nodeid, ua.VariantType.NodeId))
287
        )
288
        nodedata.attributes[ua.AttributeIds.BrowseName] = AttributeValue(
289
            ua.DataValue(ua.Variant(item.BrowseName, ua.VariantType.QualifiedName))
290
        )
291
        nodedata.attributes[ua.AttributeIds.NodeClass] = AttributeValue(
292
            ua.DataValue(ua.Variant(item.NodeClass, ua.VariantType.Int32))
293
        )
294
        # add requested attrs
295
        self._add_nodeattributes(item.NodeAttributes, nodedata, add_timestamps)
296
297
    def _add_unique_reference(self, nodedata, desc):
298
        for r in nodedata.references:
299
            if r.ReferenceTypeId == desc.ReferenceTypeId and r.NodeId == desc.NodeId:
300
                if r.IsForward != desc.IsForward:
301
                    self.logger.error("Cannot add conflicting reference %s ", str(desc))
302
                    return ua.StatusCode(ua.StatusCodes.BadReferenceNotAllowed)
303
                break  # ref already exists
304
        else:
305
            nodedata.references.append(desc)
306
        return ua.StatusCode()
307
308
    def _add_ref_from_parent(self, nodedata, item, parentdata):
309
        desc = ua.ReferenceDescription()
310
        desc.ReferenceTypeId = item.ReferenceTypeId
311
        desc.NodeId = nodedata.nodeid
312
        desc.NodeClass = item.NodeClass
313
        desc.BrowseName = item.BrowseName
314
        desc.DisplayName = item.NodeAttributes.DisplayName
315
        desc.TypeDefinition = item.TypeDefinition
316
        desc.IsForward = True
317
        self._add_unique_reference(parentdata, desc)
318
319
    def _add_ref_to_parent(self, nodedata, item, parentdata):
320
        addref = ua.AddReferencesItem()
321
        addref.ReferenceTypeId = item.ReferenceTypeId
322
        addref.SourceNodeId = nodedata.nodeid
323
        addref.TargetNodeId = item.ParentNodeId
324
        addref.TargetNodeClass = parentdata.attributes[ua.AttributeIds.NodeClass].value.Value.Value
325
        addref.IsForward = False
326
        self._add_reference_no_check(nodedata, addref)
327
328
    def _add_type_definition(self, nodedata, item):
329
        addref = ua.AddReferencesItem()
330
        addref.SourceNodeId = nodedata.nodeid
331
        addref.IsForward = True
332
        addref.ReferenceTypeId = ua.NodeId(ua.ObjectIds.HasTypeDefinition)
333
        addref.TargetNodeId = item.TypeDefinition
334
        addref.TargetNodeClass = ua.NodeClass.DataType
335
        self._add_reference_no_check(nodedata, addref)
336
337
    def delete_nodes(self, deletenodeitems, user=User(role=UserRole.Admin)):
338
        results = []
339
        for item in deletenodeitems.NodesToDelete:
340
            results.append(self._delete_node(item, user))
341
        return results
342
343
    def _delete_node(self, item, user):
344
        if user.role != UserRole.Admin:
345
            return ua.StatusCode(ua.StatusCodes.BadUserAccessDenied)
346
347
        if item.NodeId not in self._aspace:
348
            self.logger.warning("DeleteNodesItem: NodeId %s does not exists", item.NodeId)
349
            return ua.StatusCode(ua.StatusCodes.BadNodeIdUnknown)
350
351
        if item.DeleteTargetReferences:
352
            for elem in self._aspace.keys():
353
                for rdesc in self._aspace[elem].references[:]:
354
                    if rdesc.NodeId == item.NodeId:
355
                        self._aspace[elem].references.remove(rdesc)
356
357
        self._delete_node_callbacks(self._aspace[item.NodeId])
358
359
        del (self._aspace[item.NodeId])
360
361
        return ua.StatusCode()
362
363
    def _delete_node_callbacks(self, nodedata):
364
        if ua.AttributeIds.Value in nodedata.attributes:
365
            for handle, callback in list(nodedata.attributes[ua.AttributeIds.Value].datachange_callbacks.items()):
366
                try:
367
                    callback(handle, None, ua.StatusCode(ua.StatusCodes.BadNodeIdUnknown))
368
                    self._aspace.delete_datachange_callback(handle)
369
                except Exception as ex:
370
                    self.logger.exception("Error calling delete node callback callback %s, %s, %s", nodedata,
371
                                          ua.AttributeIds.Value, ex)
372
373
    def add_references(self, refs, user=User(role=UserRole.Admin)):
374
        result = []
375
        for ref in refs:
376
            result.append(self._add_reference(ref, user))
377
        return result
378
379
    def try_add_references(self, refs, user=User(role=UserRole.Admin)):
380
        for ref in refs:
381
            if not self._add_reference(ref, user).is_good():
382
                yield ref
383
384
    def _add_reference(self, addref, user):
385
        sourcedata = self._aspace.get(addref.SourceNodeId)
386
        if sourcedata is None:
387
            return ua.StatusCode(ua.StatusCodes.BadSourceNodeIdInvalid)
388
        if addref.TargetNodeId not in self._aspace:
389
            return ua.StatusCode(ua.StatusCodes.BadTargetNodeIdInvalid)
390
        if user.role != UserRole.Admin:
391
            return ua.StatusCode(ua.StatusCodes.BadUserAccessDenied)
392
        return self._add_reference_no_check(sourcedata, addref)
393
394
    def _add_reference_no_check(self, sourcedata, addref):
395
        rdesc = ua.ReferenceDescription()
396
        rdesc.ReferenceTypeId = addref.ReferenceTypeId
397
        rdesc.IsForward = addref.IsForward
398
        rdesc.NodeId = addref.TargetNodeId
399
        if addref.TargetNodeClass == ua.NodeClass.Unspecified:
400
            rdesc.NodeClass = self._aspace.read_attribute_value(
401
                addref.TargetNodeId, ua.AttributeIds.NodeClass).Value.Value
402
        else:
403
            rdesc.NodeClass = addref.TargetNodeClass
404
        bname = self._aspace.read_attribute_value(addref.TargetNodeId, ua.AttributeIds.BrowseName).Value.Value
405
        if bname:
406
            rdesc.BrowseName = bname
407
        dname = self._aspace.read_attribute_value(addref.TargetNodeId, ua.AttributeIds.DisplayName).Value.Value
408
        if dname:
409
            rdesc.DisplayName = dname
410
        return self._add_unique_reference(sourcedata, rdesc)
411
412
    def delete_references(self, refs, user=User(role=UserRole.Admin)):
413
        result = []
414
        for ref in refs:
415
            result.append(self._delete_reference(ref, user))
416
        return result
417
418
    def _delete_unique_reference(self, item, invert=False):
419
        if invert:
420
            source, target, forward = item.TargetNodeId, item.SourceNodeId, not item.IsForward
421
        else:
422
            source, target, forward = item.SourceNodeId, item.TargetNodeId, item.IsForward
423
        for rdesc in self._aspace[source].references:
424
            if rdesc.NodeId == target and rdesc.ReferenceTypeId == item.ReferenceTypeId:
425
                if rdesc.IsForward == forward:
426
                    self._aspace[source].references.remove(rdesc)
427
                    return ua.StatusCode()
428
        return ua.StatusCode(ua.StatusCodes.BadNotFound)
429
430
    def _delete_reference(self, item, user):
431
        if item.SourceNodeId not in self._aspace:
432
            return ua.StatusCode(ua.StatusCodes.BadSourceNodeIdInvalid)
433
        if item.TargetNodeId not in self._aspace:
434
            return ua.StatusCode(ua.StatusCodes.BadTargetNodeIdInvalid)
435
        if item.ReferenceTypeId not in self._aspace:
436
            return ua.StatusCode(ua.StatusCodes.BadReferenceTypeIdInvalid)
437
        if user.role != UserRole.Admin:
438
            return ua.StatusCode(ua.StatusCodes.BadUserAccessDenied)
439
440
        if item.DeleteBidirectional:
441
            self._delete_unique_reference(item, True)
442
        return self._delete_unique_reference(item)
443
444
    def _add_node_attr(self, item, nodedata, name, vtype=None, add_timestamps=False):
445
        if item.SpecifiedAttributes & getattr(ua.NodeAttributesMask, name):
0 ignored issues
show
Comprehensibility Best Practice introduced by
The variable getattr does not seem to be defined.
Loading history...
446
            dv = ua.DataValue(ua.Variant(getattr(item, name), vtype))
447
            if add_timestamps:
448
                # dv.ServerTimestamp = datetime.utcnow()  # Disabled until someone explains us it should be there
449
                dv.SourceTimestamp = datetime.utcnow()
450
            nodedata.attributes[getattr(ua.AttributeIds, name)] = AttributeValue(dv)
451
452
    def _add_nodeattributes(self, item, nodedata, add_timestamps):
453
        self._add_node_attr(item, nodedata, "AccessLevel", ua.VariantType.Byte)
454
        self._add_node_attr(item, nodedata, "ArrayDimensions", ua.VariantType.UInt32)
455
        self._add_node_attr(item, nodedata, "BrowseName", ua.VariantType.QualifiedName)
456
        self._add_node_attr(item, nodedata, "ContainsNoLoops", ua.VariantType.Boolean)
457
        self._add_node_attr(item, nodedata, "DataType", ua.VariantType.NodeId)
458
        self._add_node_attr(item, nodedata, "Description", ua.VariantType.LocalizedText)
459
        self._add_node_attr(item, nodedata, "DisplayName", ua.VariantType.LocalizedText)
460
        self._add_node_attr(item, nodedata, "EventNotifier", ua.VariantType.Byte)
461
        self._add_node_attr(item, nodedata, "Executable", ua.VariantType.Boolean)
462
        self._add_node_attr(item, nodedata, "Historizing", ua.VariantType.Boolean)
463
        self._add_node_attr(item, nodedata, "InverseName", ua.VariantType.LocalizedText)
464
        self._add_node_attr(item, nodedata, "IsAbstract", ua.VariantType.Boolean)
465
        self._add_node_attr(item, nodedata, "MinimumSamplingInterval", ua.VariantType.Double)
466
        self._add_node_attr(item, nodedata, "NodeClass", ua.VariantType.Int32)
467
        self._add_node_attr(item, nodedata, "NodeId", ua.VariantType.NodeId)
468
        self._add_node_attr(item, nodedata, "Symmetric", ua.VariantType.Boolean)
469
        self._add_node_attr(item, nodedata, "UserAccessLevel", ua.VariantType.Byte)
470
        self._add_node_attr(item, nodedata, "UserExecutable", ua.VariantType.Boolean)
471
        self._add_node_attr(item, nodedata, "UserWriteMask", ua.VariantType.Byte)
472
        self._add_node_attr(item, nodedata, "ValueRank", ua.VariantType.Int32)
473
        self._add_node_attr(item, nodedata, "WriteMask", ua.VariantType.UInt32)
474
        self._add_node_attr(item, nodedata, "UserWriteMask", ua.VariantType.UInt32)
475
        self._add_node_attr(item, nodedata, "DataTypeDefinition", ua.VariantType.ExtensionObject)
476
        self._add_node_attr(item, nodedata, "Value", add_timestamps=add_timestamps)
477
478
479
class MethodService:
480
481
    def __init__(self, aspace: "AddressSpace"):
482
        self.logger = logging.getLogger(__name__)
483
        self._aspace: "AddressSpace" = aspace
484
        self._pool = ThreadPoolExecutor()
485
486
    def stop(self):
487
        self._pool.shutdown()
488
489
    async def call(self, methods):
490
        results = []
491
        for method in methods:
492
            res = await self._call(method)
493
            results.append(res)
494
        return results
495
496
    async def _call(self, method):
497
        self.logger.info("Calling: %s", method)
498
        res = ua.CallMethodResult()
499
        if method.ObjectId not in self._aspace or method.MethodId not in self._aspace:
500
            res.StatusCode = ua.StatusCode(ua.StatusCodes.BadNodeIdInvalid)
501
        else:
502
            node = self._aspace[method.MethodId]
503
            if node.call is None:
504
                res.StatusCode = ua.StatusCode(ua.StatusCodes.BadNothingToDo)
505
            else:
506
                try:
507
                    result = await self._run_method(node.call, method.ObjectId, *method.InputArguments)
508
                except Exception:
509
                    self.logger.exception("Error executing method call %s, an exception was raised: ", method)
510
                    res.StatusCode = ua.StatusCode(ua.StatusCodes.BadUnexpectedError)
511
                else:
512
                    if isinstance(result, ua.CallMethodResult):
513
                        res = result
514
                    elif isinstance(result, ua.StatusCode):
515
                        res.StatusCode = result
516
                    else:
517
                        res.OutputArguments = result
518
                    while len(res.InputArgumentResults) < len(method.InputArguments):
519
                        res.InputArgumentResults.append(ua.StatusCode())
520
        return res
521
522
    async def _run_method(self, func, parent, *args):
523
        if asyncio.iscoroutinefunction(func):
524
            return await func(parent, *args)
525
        p = partial(func, parent, *args)
526
        res = await asyncio.get_event_loop().run_in_executor(self._pool, p)
527
        return res
528
529
530
class AddressSpace:
531
    """
532
    The address space object stores all the nodes of the OPC-UA server and helper methods.
533
    The methods are thread safe
534
    """
535
536
    def __init__(self):
537
        self.logger = logging.getLogger(__name__)
538
        self._nodes = {}
539
        self._datachange_callback_counter = 200
540
        self._handle_to_attribute_map = {}
541
        self._default_idx = 2
542
        self._nodeid_counter = {0: 20000, 1: 2000}
543
544
    def __getitem__(self, nodeid):
545
        return self._nodes.__getitem__(nodeid)
546
547
    def get(self, nodeid):
548
        return self._nodes.get(nodeid, None)
549
550
    def __setitem__(self, nodeid, value):
551
        return self._nodes.__setitem__(nodeid, value)
552
553
    def __contains__(self, nodeid):
554
        return self._nodes.__contains__(nodeid)
555
556
    def __delitem__(self, nodeid):
557
        self._nodes.__delitem__(nodeid)
558
559
    def generate_nodeid(self, idx=None):
560
        if idx is None:
561
            idx = self._default_idx
562
        if idx in self._nodeid_counter:
563
            self._nodeid_counter[idx] += 1
564
        else:
565
            # get the biggest identifier number from the existed nodes in address space
566
            identifier_list = sorted([
567
                nodeid.Identifier for nodeid in self._nodes.keys()
568
                if nodeid.NamespaceIndex == idx and nodeid.NodeIdType in (
569
                    ua.NodeIdType.Numeric, ua.NodeIdType.TwoByte, ua.NodeIdType.FourByte
570
                )
571
            ])
572
            if identifier_list:
573
                self._nodeid_counter[idx] = identifier_list[-1]
574
            else:
575
                self._nodeid_counter[idx] = 1
576
        nodeid = ua.NodeId(self._nodeid_counter[idx], idx)
577
        while True:
578
            if nodeid in self._nodes:
579
                nodeid = self.generate_nodeid(idx)
580
            else:
581
                return nodeid
582
583
    def keys(self):
584
        return self._nodes.keys()
585
586
    def empty(self):
587
        """Delete all nodes in address space"""
588
        self._nodes = {}
589
590
    def dump(self, path):
591
        """
592
        Dump address space as binary to file; note that server must be stopped for this method to work
593
        DO NOT DUMP AN ADDRESS SPACE WHICH IS USING A SHELF (load_aspace_shelf), ONLY CACHED NODES WILL GET DUMPED!
594
        """
595
        # prepare nodes in address space for being serialized
596
        for nodeid, ndata in self._nodes.items():
597
            # if the node has a reference to a method call, remove it so the object can be serialized
598
            if ndata.call is not None:
599
                self._nodes[nodeid].call = None
600
601
        with open(path, 'wb') as f:
602
            pickle.dump(self._nodes, f, pickle.HIGHEST_PROTOCOL)
603
604
    def load(self, path):
605
        """
606
        Load address space from a binary file, overwriting everything in the current address space
607
        """
608
        with open(path, 'rb') as f:
609
            self._nodes = pickle.load(f)
610
611
    def make_aspace_shelf(self, path):
612
        """
613
        Make a shelf for containing the nodes from the standard address space; this is typically only done on first
614
        start of the server. Subsequent server starts will load the shelf, nodes are then moved to a cache
615
        by the LazyLoadingDict class when they are accessed. Saving data back to the shelf
616
        is currently NOT supported, it is only used for the default OPC UA standard address space
617
618
        Note: Intended for slow devices, such as Raspberry Pi, to greatly improve start up time
619
        """
620
        with shelve.open(path, 'n', protocol=pickle.HIGHEST_PROTOCOL) as s:
621
            for nodeid, ndata in self._nodes.items():
622
                s[nodeid.to_string()] = ndata
623
624
    def load_aspace_shelf(self, path):
625
        """
626
        Load the standard address space nodes from a python shelve via LazyLoadingDict as needed.
627
        The dump() method can no longer be used if the address space is being loaded from a shelf
628
629
        Note: Intended for slow devices, such as Raspberry Pi, to greatly improve start up time
630
        """
631
        raise NotImplementedError
632
633
        # ToDo: async friendly implementation - load all at once?
634
        class LazyLoadingDict(collections.MutableMapping):
0 ignored issues
show
Comprehensibility Best Practice introduced by
The variable collections does not seem to be defined.
Loading history...
635
            """
636
            Special dict that only loads nodes as they are accessed. If a node is accessed it gets copied from the
637
            shelve to the cache dict. All user nodes are saved in the cache ONLY. Saving data back to the shelf
638
            is currently NOT supported
639
            """
640
641
            def __init__(self, source):
642
                self.source = source  # python shelf
643
                self.cache = {}  # internal dict
644
645
            def __getitem__(self, key):
646
                # try to get the item (node) from the cache, if it isn't there get it from the shelf
647
                try:
648
                    return self.cache[key]
649
                except KeyError:
650
                    node = self.cache[key] = self.source[key.to_string()]
651
                    return node
652
653
            def __setitem__(self, key, value):
654
                # add a new item to the cache; if this item is in the shelf it is not updated
655
                self.cache[key] = value
656
657
            def __contains__(self, key):
658
                return key in self.cache or key.to_string() in self.source
659
660
            def __delitem__(self, key):
661
                # only deleting items from the cache is allowed
662
                del self.cache[key]
663
664
            def __iter__(self):
665
                # only the cache can be iterated over
666
                return iter(self.cache.keys())
667
668
            def __len__(self):
669
                # only returns the length of items in the cache, not unaccessed items in the shelf
670
                return len(self.cache)
671
672
        self._nodes = LazyLoadingDict(shelve.open(path, "r"))
673
674
    def read_attribute_value(self, nodeid, attr):
675
        # self.logger.debug("get attr val: %s %s", nodeid, attr)
676
        if nodeid not in self._nodes:
677
            dv = ua.DataValue()
678
            dv.StatusCode = ua.StatusCode(ua.StatusCodes.BadNodeIdUnknown)
679
            return dv
680
        node = self._nodes[nodeid]
681
        if attr not in node.attributes:
682
            dv = ua.DataValue()
683
            dv.StatusCode = ua.StatusCode(ua.StatusCodes.BadAttributeIdInvalid)
684
            return dv
685
        attval = node.attributes[attr]
686
        if attval.value_callback:
687
            return attval.value_callback()
688
        return attval.value
689
690
    async def write_attribute_value(self, nodeid, attr, value):
691
        # self.logger.debug("set attr val: %s %s %s", nodeid, attr, value)
692
        node = self._nodes.get(nodeid, None)
693
        if node is None:
694
            return ua.StatusCode(ua.StatusCodes.BadNodeIdUnknown)
695
        attval = node.attributes.get(attr, None)
696
        if attval is None:
697
            return ua.StatusCode(ua.StatusCodes.BadAttributeIdInvalid)
698
699
        old = attval.value
700
        attval.value = value
701
        cbs = []
702
        if old.Value != value.Value:  # only send call callback when a value change has happend
703
            cbs = list(attval.datachange_callbacks.items())
704
705
        for k, v in cbs:
706
            try:
707
                await v(k, value)
708
            except Exception as ex:
709
                self.logger.exception("Error calling datachange callback %s, %s, %s", k, v, ex)
710
711
        return ua.StatusCode()
712
713
    def add_datachange_callback(self, nodeid, attr, callback):
714
        self.logger.debug("set attr callback: %s %s %s", nodeid, attr, callback)
715
        if nodeid not in self._nodes:
716
            return ua.StatusCode(ua.StatusCodes.BadNodeIdUnknown), 0
717
        node = self._nodes[nodeid]
718
        if attr not in node.attributes:
719
            return ua.StatusCode(ua.StatusCodes.BadAttributeIdInvalid), 0
720
        attval = node.attributes[attr]
721
        self._datachange_callback_counter += 1
722
        handle = self._datachange_callback_counter
723
        attval.datachange_callbacks[handle] = callback
724
        self._handle_to_attribute_map[handle] = (nodeid, attr)
725
        return ua.StatusCode(), handle
726
727
    def delete_datachange_callback(self, handle):
728
        if handle in self._handle_to_attribute_map:
729
            nodeid, attr = self._handle_to_attribute_map.pop(handle)
730
            self._nodes[nodeid].attributes[attr].datachange_callbacks.pop(handle)
731
732
    def add_method_callback(self, methodid, callback):
733
        node = self._nodes[methodid]
734
        node.call = callback
735