A bytestream is a sequence of bytes. Typically, each byte is an 8-bit quantity (octets), and so the term octet stream is sometimes used interchangeably. An octet may be encoded as a sequence of 8 bits in multiple different ways (see endianness) so there is no unique and direct translation between bytestreams and bitstreams. If there is only one significant input octet (e.g., 'M'), or when the last input group contains only one octet, all 8 bits will be captured in the first two Base64 digits (12 bits); the four least significant bits of the last content-bearing 6-bit block will turn out to be zero, and discarded on decoding (along with the succeeding two = padding.
This might be something else to look at, but maybe an options: string contentType = System.Web.MimeMapping.GetMimeMapping(fileName).
The default behavior of the Base64OutputStream is to ENCODE, whereas the default behavior of the Base64InputStream is to DECODE. But this behavior can be overridden by using a different constructor.
This class implements section 6.8. Base64 Content-Transfer-Encoding from RFC 2045 Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies by Freed and Borenstein.
Since this class operates directly on byte streams, and not character streams, it is hard-coded to only encode/decode character encodings which are compatible with the lower 127 ASCII chart (ISO-8859-1, Windows-1252, UTF-8, etc).
Note: It is mandatory to close the stream after the last byte has been written to it, otherwise the final padding will be omitted and the resulting data will be incomplete/inconsistent.
You can set the decoding behavior when the input bytes contain leftover trailing bits that cannot be created by a valid encoding. These can be bits that are unused from the final character or entire characters. The default mode is lenient decoding.
- Lenient: Any trailing bits are composed into 8-bit bytes where possible. The remainder are discarded.
- Strict: The decoding will raise an
IllegalArgumentException
if trailing bits are not part of a valid encoding. Any unused bits from the final character must be zero. Impossible counts of entire final characters are not allowed.
When strict decoding is enabled it is expected that the decoded bytes will be re-encoded to a byte array that matches the original, i.e. no changes occur on the final character. This requires that the input bytes use the same padding and alphabet as the encoder.
-->Various content types can flow through a logic app,for example, JSON, XML, flat files, and binary data.While Logic Apps supports all content types, some have nativesupport and don't require casting or conversion in your logic apps.Other types might require casting or conversion as necessary.This article describes how Logic Apps handles content types andhow you can correctly cast or convert these types when necessary.
To determine the appropriate way for handling content types,Logic Apps relies on the Content-Type
header value in HTTP calls,for example:
- application/json (native type)
- text/plain (native type)
application/json
Logic Apps stores and handles any request with the application/jsoncontent type as a JavaScript Notation (JSON) object.By default, you can parse JSON content without any casting.To parse a request that has a header with the 'application/json' content type,you can use an expression. This example returns the value dog
from theanimal-type
array without casting:
@body('myAction')['animal-type'][0]
If you're working with JSON data that doesn't specify a header,you can manually cast that data to JSON by using thejson() function,for example:
@json(triggerBody())['animal-type']
Create tokens for JSON properties
Logic Apps provides the capability for you to generate user-friendlytokens that represent the properties in JSON content so you canreference and use those properties more easily in your logic app's workflow.
Request trigger
When you use this trigger in the Logic App Designer, you can providea JSON schema that describes the payload you expect to receive.The designer parses JSON content by using this schema and generatesuser-friendly tokens that represent the properties in your JSON content.You can then easily reference and use those properties throughout yourlogic app's workflow.
If you don't have a schema, you can generate the schema.
In the Request trigger, select Use sample payload to generate schema.
Under Enter or paste a sample JSON payload, provide a sample payloadand then choose Done. For example:
The generated schema now appears in your trigger.
Here is the underlying definition for your Request trigger in the code view editor:
In your request, make sure you include a
Content-Type
headerand set the header's value toapplication/json
.
Parse JSON action
When you use this action in the Logic App Designer,you can parse JSON output and generate user-friendlytokens that represent the properties in your JSON content.You can then easily reference and use those propertiesthroughout your logic app's workflow. Similar tothe Request trigger, you can provide or generate aJSON schema that describes the JSON content you want to parse.That way, you can more easily consume data from Azure Service Bus,Azure Cosmos DB, and so on.
text/plain
When your logic app receives HTTP messages thathave the Content-Type
header set to text/plain
,your logic app stores those messages in raw form.If you include these messages in subsequent actions without casting,requests go out with the Content-Type
header set to text/plain
.
For example, when you're working with a flat file,you might get an HTTP request with the Content-Type
header set to text/plain
content type:
Date,Name,Address
Oct-1,Frank,123 Ave
Image/octet-stream Base64
If you then send this request on in a later action as the body for another request,for example, @body('flatfile')
, that second request also has a Content-Type
header that's set to text/plain
. If you're working with data that is plain textbut didn't specify a header, you can manually cast that data to text by using thestring() functionsuch as this expression:
@string(triggerBody())
application/xml and application/octet-stream
Octet Stream Base64
Logic Apps always preserves the Content-Type
in a received HTTP request or response.So if your logic app receives content with Content-Type
set to application/octet-stream
,and you include that content in a later action without casting,the outgoing request also has Content-Type
set to application/octet-stream
.That way, Logic Apps can guarantee that data doesn't get lost while moving through the workflow.However, the action state, or inputs and outputs, is stored in a JSON objectwhile the state moves through the workflow.
Converter functions
To preserve some data types, Logic Apps converts content to a binarybase64-encoded string with appropriate metadata that preserves boththe $content
payload and the $content-type
, which are automatically converted.
This list describes how Logic Apps converts content when you use thesefunctions:
json()
: Casts data toapplication/json
xml()
: Casts data toapplication/xml
binary()
: Casts data toapplication/octet-stream
string()
: Casts data totext/plain
base64()
: Converts content to a base64-encoded stringbase64toString()
: Converts a base64-encoded string totext/plain
base64toBinary()
: Converts a base64-encoded string toapplication/octet-stream
dataUri()
: Converts a string to a data URIdataUriToBinary()
: Converts a data URI to a binary stringdataUriToString()
: Converts a data URI to a string
For example, if you receive an HTTP requestwhere Content-Type
set to application/xml
,such as this content:
You can cast this content by using the @xml(triggerBody())
expression with the xml()
and triggerBody()
functionsand then use this content later. Or, you can use the@xpath(xml(triggerBody()), '/CustomerName')
expressionwith the xpath()
and xml()
functions.
Other content types
Logic Apps works with and supports other content types,but might require that you manually get the messagebody by decoding the $content
variable.
For example, suppose your logic app gets triggered by a requestwith the application/x-www-url-formencoded
content type.To preserve all the data, the $content
variable in therequest body has a payload that's encoded as a base64 string:
CustomerName=Frank&Address=123+Avenue
Because the request isn't plain text or JSON,the request is stored in the action as follows:
Logic Apps provides native functions for handling form data, for example:
Or, you can manually access the data by using an expression such as this example:
@string(body('formdataAction'))
If you wanted the outgoing request to have the sameapplication/x-www-url-formencoded
content type header,you can add the request to the action's body withoutany casting by using an expression such as @body('formdataAction')
.However, this method only works when the body is the onlyparameter in the body
input. If you try to use the@body('formdataAction')
expression in an application/json
request,you get a runtime error because the body is sent encoded.