Documentation ¶
Overview ¶
Copyright (c) 2021 Intel Corporation
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Index ¶
- Constants
- type BatchConfig
- type BatchMode
- type Compression
- type Conversion
- type CoreData
- type Encryption
- type Filter
- func (f Filter) FilterByDeviceName(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, result interface{})
- func (f Filter) FilterByProfileName(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, result interface{})
- func (f Filter) FilterByResourceName(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, result interface{})
- func (f Filter) FilterBySourceName(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, result interface{})
- type HTTPSender
- type JSONLogic
- type MQTTSecretConfig
- type MQTTSecretSender
- type MQTTTopicFormatter
- type ResponseData
- type Tags
Constants ¶
const ( BatchByCountOnly = iota BatchByTimeOnly BatchByTimeAndCount )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type BatchConfig ¶
type BatchConfig struct {
// contains filtered or unexported fields
}
BatchConfig ...
func NewBatchByCount ¶
func NewBatchByCount(batchThreshold int) (*BatchConfig, error)
NewBatchByCount create, initializes and returns a new instance for BatchConfig
func NewBatchByTime ¶
func NewBatchByTime(timeInterval string) (*BatchConfig, error)
NewBatchByTime create, initializes and returns a new instance for BatchConfig
func NewBatchByTimeAndCount ¶
func NewBatchByTimeAndCount(timeInterval string, batchThreshold int) (*BatchConfig, error)
NewBatchByTimeAndCount create, initializes and returns a new instance for BatchConfig
func (*BatchConfig) Batch ¶
func (batch *BatchConfig) Batch(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
Batch ...
type BatchMode ¶
type BatchMode int
BatchMode Enum for choosing behavior of Batch. Default is CountAndTime.
type Compression ¶
type Compression struct {
// contains filtered or unexported fields
}
func NewCompression ¶
func NewCompression() Compression
NewCompression creates, initializes and returns a new instance of Compression
func (*Compression) CompressWithGZIP ¶
func (compression *Compression) CompressWithGZIP(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
CompressWithGZIP compresses data received as either a string,[]byte, or json.Marshaller using gzip algorithm and returns a base64 encoded string as a []byte.
func (*Compression) CompressWithZLIB ¶
func (compression *Compression) CompressWithZLIB(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
CompressWithZLIB compresses data received as either a string,[]byte, or json.Marshaller using zlib algorithm and returns a base64 encoded string as a []byte.
type Conversion ¶
type Conversion struct { }
Conversion houses various built in conversion transforms (XML, JSON, CSV)
func NewConversion ¶
func NewConversion() Conversion
NewConversion creates, initializes and returns a new instance of Conversion
func (Conversion) TransformToJSON ¶
func (f Conversion) TransformToJSON(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, stringType interface{})
TransformToJSON transforms an EdgeX event to JSON. It will return an error and stop the pipeline if a non-edgex event is received or if no data is received.
func (Conversion) TransformToXML ¶
func (f Conversion) TransformToXML(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, stringType interface{})
TransformToXML transforms an EdgeX event to XML. It will return an error and stop the pipeline if a non-edgex event is received or if no data is received.
type CoreData ¶
func (*CoreData) PushToCoreData ¶
func (cdc *CoreData) PushToCoreData(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
PushToCoreData pushes the provided value as an event to CoreData using the device name and reading name that have been set. If validation is turned on in CoreServices then your deviceName and readingName must exist in the CoreMetadata and be properly registered in EdgeX.
type Encryption ¶
type Encryption struct { SecretPath string SecretName string EncryptionKey string InitializationVector string }
func NewEncryption ¶
func NewEncryption(encryptionKey string, initializationVector string) Encryption
NewEncryption creates, initializes and returns a new instance of Encryption
func NewEncryptionWithSecrets ¶
func NewEncryptionWithSecrets(secretPath string, secretName string, initializationVector string) Encryption
NewEncryptionWithSecrets creates, initializes and returns a new instance of Encryption configured to retrieve the encryption key from the Secret Store
func (Encryption) EncryptWithAES ¶
func (aesData Encryption) EncryptWithAES(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
EncryptWithAES encrypts a string, []byte, or json.Marshaller type using AES encryption. It will return a Base64 encode []byte of the encrypted data.
type Filter ¶
Filter houses various the parameters for which filter transforms filter on
func NewFilterFor ¶
NewFilterFor creates, initializes and returns a new instance of Filter that defaults FilterOut to false so it is filtering for specified values
func NewFilterOut ¶
NewFilterOut creates, initializes and returns a new instance of Filter that defaults FilterOut to ture so it is filtering out specified values
func (Filter) FilterByDeviceName ¶
func (f Filter) FilterByDeviceName(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, result interface{})
FilterByDeviceName filters based on the specified Device Names, aka Instance of a Device. If FilterOut is false, it filters out those Events not associated with the specified Device Names listed in FilterValues. If FilterOut is true, it out those Events that are associated with the specified Device Names listed in FilterValues.
func (Filter) FilterByProfileName ¶
func (f Filter) FilterByProfileName(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, result interface{})
FilterByProfileName filters based on the specified Device Profile, aka Class of Device. If FilterOut is false, it filters out those Events not associated with the specified Device Profile listed in FilterValues. If FilterOut is true, it out those Events that are associated with the specified Device Profile listed in FilterValues.
func (Filter) FilterByResourceName ¶
func (f Filter) FilterByResourceName(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, result interface{})
FilterByResourceName filters based on the specified Reading resource names, aka Instance of a Device. If FilterOut is false, it filters out those Event Readings not associated with the specified Resource Names listed in FilterValues. If FilterOut is true, it out those Event Readings that are associated with the specified Resource Names listed in FilterValues. This function will return an error and stop the pipeline if a non-edgex event is received or if no data is received.
func (Filter) FilterBySourceName ¶
func (f Filter) FilterBySourceName(ctx interfaces.AppFunctionContext, data interface{}) (continuePipeline bool, result interface{})
FilterBySourceName filters based on the specified Source for the Event, aka resource or command name. If FilterOut is false, it filters out those Events not associated with the specified Source listed in FilterValues. If FilterOut is true, it out those Events that are associated with the specified Source listed in FilterValues.
type HTTPSender ¶
type HTTPSender struct { URL string MimeType string PersistOnError bool HttpHeaderName string SecretName string SecretPath string }
HTTPSender ...
func NewHTTPSender ¶
func NewHTTPSender(url string, mimeType string, persistOnError bool) HTTPSender
NewHTTPSender creates, initializes and returns a new instance of HTTPSender
func NewHTTPSenderWithSecretHeader ¶
func NewHTTPSenderWithSecretHeader(url string, mimeType string, persistOnError bool, headerName string, secretPath string, secretName string) HTTPSender
NewHTTPSenderWithSecretHeader creates, initializes and returns a new instance of HTTPSender configured to use a secret header
func (HTTPSender) HTTPPost ¶
func (sender HTTPSender) HTTPPost(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
HTTPPost will send data from the previous function to the specified Endpoint via http POST. If no previous function exists, then the event that triggered the pipeline will be used. An empty string for the mimetype will default to application/json.
func (HTTPSender) HTTPPut ¶
func (sender HTTPSender) HTTPPut(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
HTTPPut will send data from the previous function to the specified Endpoint via http PUT. If no previous function exists, then the event that triggered the pipeline will be used. An empty string for the mimetype will default to application/json.
type JSONLogic ¶
type JSONLogic struct {
Rule string
}
JSONLogic ...
func NewJSONLogic ¶
NewJSONLogic creates, initializes and returns a new instance of HTTPSender
func (JSONLogic) Evaluate ¶
func (logic JSONLogic) Evaluate(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
Evaluate ...
type MQTTSecretConfig ¶
type MQTTSecretConfig struct { // BrokerAddress should be set to the complete broker address i.e. mqtts://mosquitto:8883/mybroker BrokerAddress string // ClientId to connect with the broker with. ClientId string // The name of the path in secret provider to retrieve your secrets SecretPath string // AutoReconnect indicated whether or not to retry connection if disconnected AutoReconnect bool // KeepAlive is the interval duration between client sending keepalive ping to broker KeepAlive string // ConnectTimeout is the duration for timing out on connecting to the broker ConnectTimeout string // Topic that you wish to publish to Topic string // QoS for MQTT Connection QoS byte // Retain setting for MQTT Connection Retain bool // SkipCertVerify SkipCertVerify bool // AuthMode indicates what to use when connecting to the broker. Options are "none", "cacert" , "usernamepassword", "clientcert". // If a CA Cert exists in the SecretPath then it will be used for all modes except "none". AuthMode string }
MQTTSecretConfig ...
type MQTTSecretSender ¶
type MQTTSecretSender struct {
// contains filtered or unexported fields
}
MQTTSecretSender ...
func NewMQTTSecretSender ¶
func NewMQTTSecretSender(mqttConfig MQTTSecretConfig, persistOnError bool) *MQTTSecretSender
NewMQTTSecretSender ...
func NewMQTTSecretSenderWithTopicFormatter ¶
func NewMQTTSecretSenderWithTopicFormatter(mqttConfig MQTTSecretConfig, persistOnError bool, topicFormatter MQTTTopicFormatter) *MQTTSecretSender
NewMQTTSecretSenderWithTopicFormatter allows passing a function to build a final publish topic from the combination of the configured topic and the input parameters passed to MQTTSend
func (*MQTTSecretSender) MQTTSend ¶
func (sender *MQTTSecretSender) MQTTSend(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
MQTTSend sends data from the previous function to the specified MQTT broker. If no previous function exists, then the event that triggered the pipeline will be used.
type MQTTTopicFormatter ¶
type MQTTTopicFormatter func(string, interfaces.AppFunctionContext, interface{}) (string, error)
type ResponseData ¶
type ResponseData struct {
ResponseContentType string
}
ResponseData houses transform for outputting data to configured trigger response, i.e. message bus
func NewResponseData ¶
func NewResponseData() ResponseData
NewResponseData creates, initializes and returns a new instance of ResponseData
func (ResponseData) SetResponseData ¶
func (f ResponseData) SetResponseData(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
SetResponseData sets the response data to that passed in from the previous function. It will return an error and stop the pipeline if the input data is not of type []byte, string or json.Marshaller
type Tags ¶
type Tags struct {
// contains filtered or unexported fields
}
Tags contains the list of Tag key/values
func (*Tags) AddTags ¶
func (t *Tags) AddTags(ctx interfaces.AppFunctionContext, data interface{}) (bool, interface{})
AddTags adds the pre-configured list of tags to the Event's tags collection.