Exploring Tag Islands (Tags In CFScript) In Lucee CFML 5.3.1.13

<cfscript>
	
	echo( "<p>Pre tag-island</p>" );

	```
	<p>In tag-island</p>
	```

	echo( "<p>Post tag-island</p>" );

</cfscript>

<cfscript>
	
	echo( "<p>Pre tag-island</p>" );

	echo("
		<p>
			In tag-island
		</p>
	");

	echo( "<p>Post tag-island</p>" );

</cfscript>

<cfscript>

	dump( getUserById( 1 ) );

	// ------------------------------------------------------------------------------- //
	// ------------------------------------------------------------------------------- //

	public array function getUserById( required numeric userID ) {

		var results = queryExecute(
			sql = "
				/* DEBUG: getUserById(). */
				SELECT
					u.id,
					u.name,
					u.email
				FROM
					user u
				WHERE
					u.id = :userID
				;
			",
			params = {
				userID: {
					value: userID,
					sqlType: "integer"
				}
			},
			options = {
				datasource: "testing",
				returnType: "array"
			}
		);

		if ( ! results.len() ) {

			throw(
				type = "NotFound",
				message = "User not found",
				detail = "User with id [#userID#] could not be found."
			);

		}

		return( results );

	}

</cfscript>

<cfscript>

	dump( getUserById( 1 ) );

	// ------------------------------------------------------------------------------- //
	// ------------------------------------------------------------------------------- //

	public array function getUserById( required numeric userID ) {

		// NOTE: Historically, I've always authored by "Data Access Layer" (DAL) using
		// tags so that I could use the CFQuery tag. I know that I can use queryExeucte()
		// these days; but, it's still not quite as easy as writing plain CFQuery and
		// CFQueryParam tags.
		```
		<cfquery name="local.results" datasource="testing" returntype="array">
			/* DEBUG: getUserById(). */
			SELECT
				u.id,
				u.name,
				u.email
			FROM
				user u
			WHERE
				u.id = <cfqueryparam value="#userID#" sqltype="integer" />
			;
		</cfquery>
		```

		if ( ! results.len() ) {

			throw(
				type = "NotFound",
				message = "User not found",
				detail = "User with id [#userID#] could not be found."
			);

		}

		return( results );

	}

</cfscript>

<cfscript>

	sendMail( "Let's talk about puppies!", "puppies" );

	// ------------------------------------------------------------------------------- //
	// ------------------------------------------------------------------------------- //

	public void function sendMail(
		required string subject,
		required string topic
		) {

		// NOTE: Historically, I would accomplish this same thing by putting the CFMail
		// content in a .CFM file which I would then "include" into a saveContent buffer.
		// This demo makes it seem feasible to include as a tag-island; however, in
		// reality, HTML MARKUP FOR EMAILS IS VERY NASTY - as such, other than the most
		// trivial emails, there's no way I would want to mix the CFMail markup alongside
		// anything else.
		```
		<cfoutput>
			<cfsavecontent variable="local.htmlContent">
				<p>
					Dear Kim,
				</p>

				<p>
					I would like to talk to you about #encodeForHtml( topic )#. Do you
					have time later this week to discuss?
				</p>
			</cfsavecontent>

			<cfsavecontent variable="local.textContent">
				Dear Kim,

				I would like to talk to you about #encodeForHtml( topic )#. Do you have time later this week to discuss?
			</cfsavecontent>
		</cfoutput>
		```

		mail
			to = "kim@bennadel.com"
			from = "ben@bennadel.com"
			subject = subject
			type = "html"
			async = false
			{

			mailPart type = "text/html" {
				echo( htmlContent.reReplace( "(?m)^\t{4}", "", "all" ).trim() );
			}

			mailPart type = "text/plain" {
				echo( textContent.reReplace( "(?m)^\t{4}", "", "all" ).trim() );
			}

		}

	}
	
</cfscript>

<cfscript>
	
	// ....

	savecontent variable="local.htmlContent" {
		echo("
			<p>
				Dear Kim,
			</p>

			<p>
				I would like to talk to you about #encodeForHtml( topic )#. Do you
				have time later this week to discuss?
			</p>
		");
	}
	savecontent variable="local.textContent" {
		echo("
			Dear Kim,

			I would like to talk to you about #encodeForHtml( topic )#. Do you have time later this week to discuss?
		");
	}

	// ....

</cfscript>

<cfscript>

	friends = [
		{ id: 1, name: "Kim" },
		{ id: 2, name: "Arnold" },
		{ id: 3, name: "Tina" },
		{ id: 4, name: "Libby" }
	];

	saveFriends( friends );

	// ------------------------------------------------------------------------------- //
	// ------------------------------------------------------------------------------- //

	public void function saveFriends( required array friends ) {

		// Building XML documents "by hand" is a horrible experience. Using a tag-island
		// to construct an XML document could be a feasible "win". Though, to be honest,
		// I almost never create XML documents these days (JSON for the win!).
		```
		<cfoutput>
			<cfxml variable="local.body">
				<Friends>
					<cfloop index="friend" array="#friends#">
						<Friend
							id="#encodeForXmlAttribute( friend.id )#"
							name="#encodeForXmlAttribute( friend.name )#"
						/>
					</cfloop>
				</Friends>
			</cfxml>
		</cfoutput>
		```

		http
			result = "local.results"
			method = "POST"
			url = "http://127.0.0.1:52116/some-xml-api-end-point/"
			timeout = 2
			{

			httpParam
				type = "header"
				name = "Content-Type"
				value = "application/xml"
			;

			httpParam
				type = "body"
				value = toString( body )
			;

		}

		if ( ! results.statusCode.find( "2\d\d" ) ) {

			throw(
				type = "ApiFailure",
				message = "XML post failed",
				detail = "XML post returned with non-200 status code [#results.statusCode#].",
				extendedInfo = "File content: #results.fileContent#"
			);

		}

	}

</cfscript>