Package io.cucumber.messages.types

Class Attachment

java.lang.Object

io.cucumber.messages.types.Attachment

public final class Attachment
extends Object

Represents the Attachment message in Cucumber's message protocol

See Also:

Github - Cucumber - Messages //// Attachments (parse errors, execution errors, screenshots, links...) An attachment represents any kind of data associated with a line in a [Source](#io.cucumber.messages.Source) file. It can be used for: * Syntax errors during parse time * Screenshots captured and attached during execution * Logs captured and attached during execution It is not to be used for runtime errors raised/thrown during execution. This is captured in `TestResult`.

Constructor Summary

Constructors

Constructor	Description
Attachment(String body, AttachmentContentEncoding contentEncoding, String fileName, String mediaType, Source source, String testCaseStartedId, String testStepId, String url)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
String	getBody()	The body of the attachment.
AttachmentContentEncoding	getContentEncoding()	Whether to interpret `body` "as-is" (IDENTITY) or if it needs to be Base64-decoded (BASE64).
Optional<String>	getFileName()	Suggested file name of the attachment.
String	getMediaType()	The media type of the data.
Optional<Source>	getSource()
Optional<String>	getTestCaseStartedId()
Optional<String>	getTestStepId()
Optional<String>	getUrl()	A URL where the attachment can be retrieved.
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Attachment

public Attachment(String body,
                  AttachmentContentEncoding contentEncoding,
                  String fileName,
                  String mediaType,
                  Source source,
                  String testCaseStartedId,
                  String testStepId,
                  String url)

Method Detail

getBody

public String getBody()

The body of the attachment. If `contentEncoding` is `IDENTITY`, the attachment is simply the string. If it's `BASE64`, the string should be Base64 decoded to obtain the attachment.

getContentEncoding

public AttachmentContentEncoding getContentEncoding()

Whether to interpret `body` "as-is" (IDENTITY) or if it needs to be Base64-decoded (BASE64). Content encoding is *not* determined by the media type, but rather by the type of the object being attached: - string: IDENTITY - byte array: BASE64 - stream: BASE64

getFileName

public Optional<String> getFileName()

Suggested file name of the attachment. (Provided by the user as an argument to `attach`)

getMediaType

public String getMediaType()

The media type of the data. This can be any valid [IANA Media Type](https://www.iana.org/assignments/media-types/media-types.xhtml) as well as Cucumber-specific media types such as `text/x.cucumber.gherkin+plain` and `text/x.cucumber.stacktrace+plain`

getSource

public Optional<Source> getSource()

getTestCaseStartedId

public Optional<String> getTestCaseStartedId()

getTestStepId

public Optional<String> getTestStepId()

getUrl

public Optional<String> getUrl()

A URL where the attachment can be retrieved. This field should not be set by Cucumber. It should be set by a program that reads a message stream and does the following for each Attachment message: - Writes the body (after base64 decoding if necessary) to a new file. - Sets `body` and `contentEncoding` to `null` - Writes out the new attachment message This will result in a smaller message stream, which can improve performance and reduce bandwidth of message consumers. It also makes it easier to process and download attachments separately from reports.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object