new Field(buildernon-null, messagenon-null, rule, keytypenullable, type, name, id, optionsopt, oneofopt, non-null, syntaxnullable)
Constructs a new Message Field.
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
builder |
ProtoBuf.Builder | Builder reference |
|
message |
ProtoBuf.Reflect.Message | Message reference |
|
rule |
string | Rule, one of requried, optional, repeated |
|
keytype |
string |
<nullable> |
Key data type, if any. |
type |
string | Data type, e.g. int32 |
|
name |
string | Field name |
|
id |
number | Unique field id |
|
options |
Object.<string, *> |
<optional> |
Options |
oneof |
ProtoBuf.Reflect.Message.OneOf |
<optional> |
Enclosing OneOf |
syntax |
string |
<nullable> |
The syntax level of this definition (e.g., proto3) |
- Source:
Extends
Members
(non-null) builder :ProtoBuf.Builder
Builder reference.
Type:
- Inherited From:
- Source:
className :string
Fully qualified class name
Type:
- string
- Overrides:
- Source:
defaultValue :*
Default value.
Type:
- *
- Source:
element :ProtoBuf.Element
Element implementation. Created in build() after types are resolved.
Type:
- ProtoBuf.Element
- Source:
id :number
Unique message field id.
Type:
- number
- Source:
keyElement :ProtoBuf.Element
Key element implementation, for map fields. Created in build() after types are resolved.
Type:
- ProtoBuf.Element
- Source:
keyType :string|Object|null
Message field key type. Type reference string if unresolved, protobuf type if resolved. Valid only if this.map === true, null otherwise.
Type:
- string | Object | null
- Source:
map :boolean
Message field map flag.
Type:
- boolean
- Source:
name :string
Object name in namespace.
Type:
- string
- Overrides:
- Source:
(nullable) oneof :ProtoBuf.Reflect.Message.OneOf
Enclosing OneOf.
Type:
- Source:
(non-null) options :Object.<string, *>
Message field options.
Type:
- Object.<string, *>
- Source:
originalName :string
Original field name.
Type:
- string
- Source:
(nullable) parent :ProtoBuf.Reflect.T
Parent object.
Type:
- Inherited From:
- Source:
repeated :boolean
Message field repeated flag.
Type:
- boolean
- Source:
required :boolean
Message field required flag.
Type:
- boolean
- Source:
resolvedType :ProtoBuf.Reflect.T|null
Resolved type reference inside the global namespace.
Type:
- ProtoBuf.Reflect.T | null
- Source:
syntax :string
Syntax level of this definition (e.g., proto3).
Type:
- string
- Source:
type :string|Object
Message field type. Type reference string if unresolved, protobuf type if resolved. In a map field, this is the value type.
Type:
- string | Object
- Source:
Methods
build()
Builds this type.
- Overrides:
- Source:
Throws:
-
If this type cannot be built directly
- Type
- Error
calculate(value, messagenon-null) → {number}
Calculates the length of this field's value on the network level.
Parameters:
Name | Type | Description |
---|---|---|
value |
* | Field value |
message |
ProtoBuf.Builder.Message | Runtime message |
- Source:
Returns:
Byte length
- Type
- number
decode(wireType, buffer, skipRepeatedopt) → {*}
Decode the field value from the specified buffer.
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
wireType |
number | Leading wire type |
|
buffer |
ByteBuffer | ByteBuffer to decode from |
|
skipRepeated |
boolean |
<optional> |
Whether to skip the repeated check or not. Defaults to false. |
- Source:
Throws:
-
If the field cannot be decoded
- Type
- Error
Returns:
Decoded value: array for packed repeated fields, [key, value] for map fields, or an individual value otherwise.
- Type
- *
encode(value, buffer, messagenon-null) → {ByteBuffer}
Encodes the specified field value to the specified buffer.
Parameters:
Name | Type | Description |
---|---|---|
value |
* | Verified field value |
buffer |
ByteBuffer | ByteBuffer to encode to |
message |
ProtoBuf.Builder.Message | Runtime message |
- Source:
Throws:
-
If the field cannot be encoded
- Type
- Error
Returns:
The ByteBuffer for chaining
- Type
- ByteBuffer
fqn() → {string}
Returns the fully qualified name of this object.
- Inherited From:
- Source:
Returns:
Fully qualified name as of ".PATH.TO.THIS"
- Type
- string
hasWirePresence(value, messagenon-null) → {boolean}
Determines whether the field will have a presence on the wire given its value.
Parameters:
Name | Type | Description |
---|---|---|
value |
* | Verified field value |
message |
ProtoBuf.Builder.Message | Runtime message |
- Source:
Returns:
Whether the field will be present on the wire
- Type
- boolean
toString(includeClassopt)
Returns a string representation of this Reflect object (its fully qualified name).
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
includeClass |
boolean |
<optional> |
Set to true to include the class name. Defaults to false. |
- Inherited From:
- Source:
Returns:
String representation
verifyValue(value, skipRepeatedopt) → {*}
Checks if the given value can be set for this field.
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
value |
* | Value to check |
|
skipRepeated |
boolean |
<optional> |
Whether to skip the repeated value check or not. Defaults to false. |
- Source:
Throws:
-
If the value cannot be set for this field
- Type
- Error
Returns:
Verified, maybe adjusted, value
- Type
- *