org.xrpl.xrpl4j.codec.binary.definitions.FieldInstance Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of xrpl4j-binary-codec Show documentation
Show all versions of xrpl4j-binary-codec Show documentation
Classes for converting to XRPL binary format
package org.xrpl.xrpl4j.codec.binary.definitions;
import org.immutables.value.Value.Immutable;
import org.xrpl.xrpl4j.codec.binary.FieldHeader;
/**
* Holder of {@link FieldHeader} and {@link FieldInfo} data. Provided by {@link DefinitionsService} for looking up
* fields and their related type data.
*/
@Immutable
public interface FieldInstance extends Comparable {
static ImmutableFieldInstance.Builder builder() {
return ImmutableFieldInstance.builder();
}
/**
* Sort order position for fields of the same type. For example, "Fee" has a type "Amount" and has a sort order of
* 8th.
*
* @return An int with the nth value.
*/
int nth();
/**
* If field is included in signed transactions.
*
* @return {@code true} if this is a signing field; {@code false} otherwise.
*/
boolean isSigningField();
/**
* If field is included in binary serialized representation.
*
* @return {@code true} if this FieldInof is serialized; {@code false} otherwise.
*/
boolean isSerialized();
/**
* Field name.
*
* @return A {@link String} representing the name of this FieldInstance.
*/
String name();
/**
* XRPL type (e.g. UInt32, AccountID, etc).
*
* @return A {@link String} representing the type of this FieldInstance.
*/
String type();
/**
* Whether or not this FieldInstance is variable-length encoded.
*
* @return {@code true} this FieldInstance is variable-length encoded; {@code false} otherwise.
*/
boolean isVariableLengthEncoded();
/**
* Globally unique ordinal position based on type code and field code.
*
* @return An int representing the ordinal of this FieldInstance.
*/
default int ordinal() {
return (header().typeCode() << 16) | nth();
}
/**
* The {@link FieldHeader} for this {@link FieldInstance}.
*
* @return A {@link FieldHeader} for this {@link FieldInstance}.
*/
FieldHeader header();
@Override
default int compareTo(FieldInstance other) {
return Integer.compare(this.ordinal(), other.ordinal());
}
}