def sendActivate(self, doId, parentId, zoneId, dclass=None, fields=None):
"""
Activate a DBSS object, given its doId, into the specified parentId/zoneId.
If both dclass and fields are specified, an ACTIVATE_WITH_DEFAULTS_OTHER
will be sent instead. In other words, the specified fields will be
auto-applied during the activation.
"""
fieldPacker = DCPacker()
fieldCount = 0
if dclass and fields:
for k, v in fields.items():
field = dclass.getFieldByName(k)
if not field:
self.notify.error(
'Activation request for %s object contains '
'invalid field named %s' % (dclass.getName(), k))
fieldPacker.rawPackUint16(field.getNumber())
fieldPacker.beginPack(field)
field.packArgs(fieldPacker, v)
fieldPacker.endPack()
fieldCount += 1
dg = PyDatagram()
dg.addServerHeader(doId, self.ourChannel,
DBSS_OBJECT_ACTIVATE_WITH_DEFAULTS)
dg.addUint32(doId)
dg.addUint32(0)
dg.addUint32(0)
self.send(dg)
# DEFAULTS_OTHER isn't implemented yet, so we chase it with a SET_FIELDS
dg = PyDatagram()
dg.addServerHeader(doId, self.ourChannel,
STATESERVER_OBJECT_SET_FIELDS)
dg.addUint32(doId)
dg.addUint16(fieldCount)
dg.appendData(fieldPacker.getString())
self.send(dg)
# Now slide it into the zone we expect to see it in (so it
# generates onto us with all of the fields in place)
dg = PyDatagram()
dg.addServerHeader(doId, self.ourChannel,
STATESERVER_OBJECT_SET_LOCATION)
dg.addUint32(parentId)
dg.addUint32(zoneId)
self.send(dg)
else:
dg = PyDatagram()
dg.addServerHeader(doId, self.ourChannel,
DBSS_OBJECT_ACTIVATE_WITH_DEFAULTS)
dg.addUint32(doId)
dg.addUint32(parentId)
dg.addUint32(zoneId)
self.send(dg)
def createObject(self, databaseId, dclass, fields={}, callback=None):
"""
Create an object in the specified database.
databaseId specifies the control channel of the target database.
dclass specifies the class of the object to be created.
fields is a dict with any fields that should be stored in the object on creation.
callback will be called with callback(doId) if specified. On failure, doId is 0.
"""
# Save the callback:
ctx = self.air.getContext()
self._callbacks[ctx] = callback
# Pack up/count valid fields.
fieldPacker = DCPacker()
fieldCount = 0
for k, v in list(fields.items()):
field = dclass.getFieldByName(k)
if not field:
self.notify.error('Creation request for %s object contains '
'invalid field named %s' %
(dclass.getName(), k))
fieldPacker.rawPackUint16(field.getNumber())
fieldPacker.beginPack(field)
field.packArgs(fieldPacker, v)
fieldPacker.endPack()
fieldCount += 1
# Now generate and send the datagram:
dg = PyDatagram()
dg.addServerHeader(databaseId, self.air.ourChannel,
DBSERVER_CREATE_OBJECT)
dg.addUint32(ctx)
dg.addUint16(dclass.getNumber())
dg.addUint16(fieldCount)
dg.appendData(fieldPacker.getString())
self.air.send(dg)
def update_object(self,
channel_id,
database_id,
do_id,
dclass,
new_fields,
old_fields=None,
callback=None):
"""
Update field(s) on an object, optionally with the requirement that the
fields must match some old value.
database_id and do_id represent the database control channel and object ID
for the update request.
new_fields is to be a dict of fieldname->value, representing the fields
to add/change on the database object.
old_fields, if specified, is a similarly-formatted dict that contains the
expected older values. If the values do not match, the database will
refuse to process the update. This is useful for guarding against race
conditions.
On success, the callback is called as callback(None).
On failure, the callback is called as callback(dict), where dict contains
the current object values. This is so that the updater can try again,
basing its updates off of the new values.
"""
# Ensure that the keys in new_fields and old_fields are the same if
# old_fields is given...
if old_fields is not None:
if set(new_fields.keys()) != set(old_fields.keys()):
self.notify.error(
'new_fields and old_fields must contain the same keys!')
return
field_packer = DCPacker()
field_count = 0
for k, v in new_fields.items():
field = dclass.get_field_by_name(k)
if not field:
self.notify.error(
'Update for %s(%d) object contains invalid field named %s'
% (dclass.get_name(), do_id, k))
field_packer.raw_pack_uint16(field.get_number())
if old_fields is not None:
# Pack the old values:
field_packer.begin_pack(field)
field.pack_args(field_packer, old_fields[k])
field_packer.end()
field_packer.begin_pack(field)
field.pack_args(field_packer, v)
field_packer.end_pack()
field_count += 1
# Generate and send the datagram:
dg = NetworkDatagram()
if old_fields is not None:
ctx = self.get_context()
self._callbacks[ctx] = callback
if field_count == 1:
dg.add_header(database_id, channel_id,
types.DBSERVER_OBJECT_SET_FIELD_IF_EQUALS)
else:
dg.add_header(database_id, channel_id,
types.DBSERVER_OBJECT_SET_FIELDS_IF_EQUALS)
dg.add_uint32(ctx)
else:
if field_count == 1:
dg.add_header(database_id, channel_id,
types.DBSERVER_OBJECT_SET_FIELD)
else:
dg.add_header(database_id, channel_id,
types.DBSERVER_OBJECT_SET_FIELDS)
dg.add_uint32(do_id)
if field_count != 1:
dg.add_uint16(field_count)
dg.append_data(field_packer.getString())
self._network.handle_send_connection_datagram(dg)
if old_fields is None and callback is not None:
# Why oh why did they ask for a callback if there's no old_fields?
# Oh well, better honor their request:
callback(None)