---
schema_version: "1"
id: 7f7fa817a089119e9b8c412eb24c4602cd3ead4d5f12f338f6c8d0f5c9a77eb0
title: MUnit Resource Matchers Reference
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/munit/latest/resource-matchers-reference.md
canonical_url: https://docs.mulesoft.com/munit/latest/resource-matchers-reference
source_site: docs.mulesoft.com
content_type: documentation
content_hash: b4625dfb086bf919eb5af56f929df87226ccd604b3eb5af6bdb3a11c494091f4
description: MuleSoft Documentation Site
release: "3.7"
latest: true
---
---
product: MUnit
version: 3.7
is-latest-version: true
---

# MUnit Resource Matchers Reference

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

![logo acb active](/mulesoft/current/en-us/_/img/icons/anypoint-code-builder.svg "Anypoint Code Builder")Anypoint Code
Builder

![logo studio active](/mulesoft/current/en-us/_/img/icons/studio.svg "Anypoint Studio")Anypoint Studio

MUnit resource matchers are utility functions that read test resource files and create Mule messages
during a MUnit test. Use them to load file contents as streams, strings, or byte arrays, and to
inspect queue sizes in your test validations.

## getResourceAsStream(String)

Returns the resource from the path String as a stream.

Example

```xml
<set-payload
  value="#[MunitTools::getResourceAsStream('util/files/example.txt')]"/>
```

## getResourceAsReusableStream(String)

Returns the resource from the path String as a reusable stream.

Example

```xml
 <set-payload
   value="#[MunitTools::getResourceAsReusableStream('util/files/example.txt')]"/>
```

## getResourceAsString(path:String,encoding:String)

Returns the resource from the path String as a String, where the second parameter (encoding) is
optional.

Example

```xml
<set-payload
  value="#[MunitTools::getResourceAsString('util/files/example.txt')]"/>
```

You can also specify the encoding:

Example

```xml
<set-payload
  value="#[MunitTools::getResourceAsString('util/files/exampleISO.txt', 'ISO-8859-1')]"/>
```

## getResourceAsByteArray(String)

Returns the resource from the path String as a byte array.

Example

```xml
 <set-payload
   value="#[MunitTools::getResourceAsByteArray('util/files/example.txt')]"/>
```

## queueSize(String)

Returns the size of the queue specified inside `#[MunitTools::queueSize()]`.

For example, to assert the size of a queue named `QUEUE_SIZE`:

Example

```xml
<munit:execution>
  <munit-tools:queue queueName="QUEUE_SIZE">
    <munit-tools:value>#['EXAMPLE']</munit-tools:value>
  </munit-tools:queue>
</munit:execution>

<munit:validation>
  <munit-tools:assert-that expression="#[MunitTools::queueSize('QUEUE_SIZE')]" is="#[MunitTools::equalTo(1)]"/>
</munit:validation>
```

## createMessage(payload: Any, mimeType: String|Null , attributes: Any, attributeMimeType: String|Null)

Creates a Mule message with the specified attributes.

Example

```xml
<munit:execution>
     <set-payload value="#[MunitTools::createMessage( 'ITEM-1',  'text/plain', { property : 'ATTRIBUTE-1'}, null )]"/>
 </munit:execution>
```

## See Also

- [MUnit Matchers](https://docs.mulesoft.com/munit/latest/munit-matchers)

- [Core Matchers Reference](https://docs.mulesoft.com/munit/latest/core-matchers-reference)

- [String Matchers Reference](https://docs.mulesoft.com/munit/latest/string-matchers-reference)

- [Comparable Matchers Reference](https://docs.mulesoft.com/munit/latest/comparable-matchers-reference)