Catatan: Python 2.7 telah mencapai akhir dukungan pada 31 Januari 2024. Aplikasi Python 2.7 Anda yang sudah ada akan terus berjalan dan menerima traffic. Namun, App Engine mungkin memblokir deployment ulang aplikasi yang menggunakan runtime setelah akhir tanggal dukungannya. Sebaiknya migrasikan ke Python versi terbaru yang didukung.

Class MessageField

Class MessageField digunakan untuk menentukan pesan agar terjadi transmisi yang efisien di seluruh jaringan atau ruang proses. Pesan ditentukan menggunakan class kolom.

MessageField disediakan oleh modul protorpc.messages.

Konstruktor

Konstruktor class MessageField didefinisikan sebagai berikut:

class MessageField(message_type, number, [required=False | repeated=False])

Menentukan kolom untuk nilai sub-pesan.

Argumen

message_type: Jenis pesan untuk kolom. Harus merupakan subclass dari Pesan.
angka: Jumlah kolom. Harus unik per class pesan.
required=False: Apakah kolom ini wajib diisi atau tidak. Tidak dapat muncul bersamaan dengan argumen repeated; jangan tentukan repeated=True jika Anda menggunakan required=True.
repeated=False: Apakah kolom ini diulang atau tidak. Tidak dapat muncul bersamaan dengan argumen required; jangan tentukan required=True jika Anda menggunakan repeated=True.

Memicu FieldDefinitionError jika message_type tidak valid.

Properti Class

Class MessageField menyediakan properti berikut:

jenis

Jenis Python yang digunakan untuk nilai kolom ini. Misalnya, dalam kasus DateTimeField, type adalah datetime.datetime. Untuk MessageFields yang ditentukan pengguna, type adalah jenis Pesan yang ditentukan.

message_type

Jenis pesan dasar yang digunakan untuk serialisasi. Secara khusus, ini adalah jenis yang dapat Anda simpan pada instance class Message. Misalnya, untuk DateTimeField, jenisnya adalah message_types.DateTimeMessage. Untuk kolom pesan normal, kolom ini akan menjadi subclass pesan protorpc. Contoh:

class Sub(messages.Message):
  x = messages.IntegerField(1)

class M(messages.Message):
  sub = messages.MessageField(Sub, 1)
  dt = message_types.DateTimeField(2)

print 'M.sub.type         =', M.sub.type
print 'M.sub.message_type =', M.sub.message_type
print 'M.dt.type          =', M.dt.type
print 'M.dt.message_type  =', M.dt.message_type

=== output ===
M.sub.type                 = <class '__main__.Sub>
M.sub.message_type = <class '__main__.Sub'>
M.dt.type                   = <type 'datetime.datetime'>
M.dt.message_type   = <class 'protorpc.message_types.DateTimeMessage'>