Documentation
¶
Overview ¶
Package factory contains predefined messages based on messages in [Profile.xlsx] provided in the Official FIT SDK. This package handles message and field creation, as well as registering manufacturer specific messages to be used for certain manufacturer's generated FIT file. You can always generate your own custom SDK using cmd/fitgen, but for those who prefer using this SDK as it is, what this package provides might be sufficient.
Index ¶
Constants ¶
const ( // NameUnknown is unknown message or field name NameUnknown string = "unknown" )
Variables ¶
var ( // ErrRegisterForbidden occurs when trying to create manufacturer specific message outside available range. ErrRegisterForbidden = errors.New("register is forbidden") )
Functions ¶
func CreateField ¶
CreateField creates new field based on defined messages in the factory. If not found, it returns new field with "unknown" name.
Field's FieldBase is a pointer struct embedded, and this will only create a shallow copy of the field, so changing any value declared in FieldBase is prohibited (except fot the unknown field) since it still referencing the same struct. If you want a deep copy of the Field, create it by calling field.Clone().
func CreateMesg ¶
CreateMesg creates new message based on defined messages in the factory. If not found, it returns proto.Message{Num: num}.
This will create a shallow copy of the Fields, so changing any value declared in Field's FieldBase is prohibited (except in case of unknown field). If you want a deep copy of the mesg, clone it by calling mesg.Clone().
NOTE: This method is not used by either the decoder or the encoder, and the data will only be populated once upon the first invocation.
func CreateMesgOnly ¶
CreateMesgOnly is a syntax sugar for creating proto.Message{Num: num}.
func RegisterMesg ¶
RegisterMesg registers a new message that is not defined in the profile.xlsx. You can not edit or replace existing predefined messages in the factory, you can only edit the messages you have registered. However, we don't create a lock for efficiency, since this is intended to be used on instantiation. If you want to change something without triggering data race, you can create a new instance of Factory using New().
By registering, any FIT file containing these messages can be recognized instead of returning "unknown" message.
Types ¶
type Factory ¶
type Factory struct {
// contains filtered or unexported fields
}
Factory handles creation and registration for FIT's message and field.
func New ¶
func New() *Factory
New creates new Factory with predefined messages. Use this if you work with multiple manufacturers that have different manufacturer specific messages, Otherwise, use StandardFactory().
New is not receiving messages on purpose: to comply with FIT term and conditions which is not allowing edit on existing messages. Receiving messages through here means we need to validate all of it, while RegisterMesg is already exist for that purpose.
func (*Factory) CreateField ¶
CreateField creates new field based on defined messages in the factory. If not found, it returns new field with "unknown" name.
Field's FieldBase is a pointer struct embedded, and this will only create a shallow copy of the field, so changing any value declared in FieldBase is prohibited (except fot the unknown field) since it still referencing the same struct. If you want a deep copy of the Field, create it by calling field.Clone().
func (*Factory) CreateMesg ¶
CreateMesg creates new message based on defined messages in the factory. If not found, it returns proto.Message{Num: num}.
This will create a shallow copy of the Fields, so changing any value declared in Field's FieldBase is prohibited (except in case of unknown field). If you want a deep copy of the mesg, clone it by calling mesg.Clone().
NOTE: This method is not used by either the decoder or the encoder, and the data will only be populated once upon the first invocation.
func (*Factory) CreateMesgOnly ¶
CreateMesgOnly is a syntax sugar for creating proto.Message{Num: num}.
func (*Factory) RegisterMesg ¶
RegisterMesg registers a new message that is not defined in the profile.xlsx. You can not edit or replace existing predefined messages in the factory, you can only edit the messages you have registered. However, we don't create a lock for efficiency, since this is intended to be used on instantiation. If you want to change something without triggering data race, you can create a new instance of Factory using New().
By registering, any FIT file containing these messages can be recognized instead of returning "unknown" message.
Source Files