feat(HyperRequest): Add head and options shortcut methods

Author: elpete

README.md

@@ -181,6 +181,42 @@ Execute a DELETE request asynchronously. Returns a ColdBox Future that returns a
 | url  | string | false    | null    | An optional URL to set for the request.  |
 | body | struct | false    | null    | An optional body to set for the request. |
 
+##### `head`
+
+Execute a HEAD request.
+
+| Name        | Type   | Required | Default | Description                                                    |
+| ----------- | ------ | -------- | ------- | -------------------------------------------------------------- |
+| url         | string | false    | null    | An optional URL to set for the request.                        |
+| queryParams | struct | false    | null    | An optional struct of query parameters to set for the request. |
+
+##### `headAsync`
+
+Execute a HEAD request asynchronously. Returns a ColdBox Future that returns a HyperResponse.
+
+| Name        | Type   | Required | Default | Description                                                    |
+| ----------- | ------ | -------- | ------- | -------------------------------------------------------------- |
+| url         | string | false    | null    | An optional URL to set for the request.                        |
+| queryParams | struct | false    | null    | An optional struct of query parameters to set for the request. |
+
+##### `options`
+
+Execute an OPTIONS request.
+
+| Name        | Type   | Required | Default | Description                                                    |
+| ----------- | ------ | -------- | ------- | -------------------------------------------------------------- |
+| url         | string | false    | null    | An optional URL to set for the request.                        |
+| queryParams | struct | false    | null    | An optional struct of query parameters to set for the request. |
+
+##### `optionsAsync`
+
+Execute an OPTIONS request asynchronously. Returns a ColdBox Future that returns a HyperResponse.
+
+| Name        | Type   | Required | Default | Description                                                    |
+| ----------- | ------ | -------- | ------- | -------------------------------------------------------------- |
+| url         | string | false    | null    | An optional URL to set for the request.                        |
+| queryParams | struct | false    | null    | An optional struct of query parameters to set for the request. |
+
 ##### `send`
 
 Send the HTTP request and return a HyperResponse.

models/HyperRequest.cfc

@@ -383,6 +383,86 @@ component accessors="true" {
 		return sendAsync();
 	}
 
+	/**
+	 * Execute a HEAD request.
+	 *
+	 * @url         An optional url to set for the request.
+	 * @queryParams An optional struct of query parameters to set for the request.
+	 *
+	 * @returns     A HyperResponse instance for the request.
+	 */
+	function head( url, queryParams ) {
+		if ( !isNull( arguments.url ) ) {
+			setUrl( arguments.url );
+		}
+		if ( !isNull( arguments.queryParams ) ) {
+			setQueryParams( [] );
+			withQueryParams( arguments.queryParams );
+		}
+		setMethod( "HEAD" );
+		return send();
+	}
+
+	/**
+	 * Execute a HEAD request asynchronously.
+	 *
+	 * @url         An optional url to set for the request.
+	 * @queryParams An optional struct of query parameters to set for the request.
+	 *
+	 * @returns     A ColdBox Future instance.
+	 */
+	function headAsync( url, queryParams ) {
+		if ( !isNull( arguments.url ) ) {
+			setUrl( arguments.url );
+		}
+		if ( !isNull( arguments.queryParams ) ) {
+			setQueryParams( [] );
+			withQueryParams( arguments.queryParams );
+		}
+		setMethod( "HEAD" );
+		return sendAsync();
+	}
+
+	/**
+	 * Execute an OPTIONS request.
+	 *
+	 * @url         An optional url to set for the request.
+	 * @queryParams An optional struct of query parameters to set for the request.
+	 *
+	 * @returns     A HyperResponse instance for the request.
+	 */
+	function options( url, queryParams ) {
+		if ( !isNull( arguments.url ) ) {
+			setUrl( arguments.url );
+		}
+		if ( !isNull( arguments.queryParams ) ) {
+			setQueryParams( [] );
+			withQueryParams( arguments.queryParams );
+		}
+		setMethod( "OPTIONS" );
+		return send();
+	}
+
+	/**
+	 * Execute an OPTIONS request asynchronously.
+	 *
+	 * @url         An optional url to set for the request.
+	 * @queryParams An optional struct of query parameters to set for the request.
+	 *
+	 * @returns     A ColdBox Future instance.
+	 */
+	function optionsAsync( url, queryParams ) {
+		if ( !isNull( arguments.url ) ) {
+			setUrl( arguments.url );
+		}
+		if ( !isNull( arguments.queryParams ) ) {
+			setQueryParams( [] );
+			withQueryParams( arguments.queryParams );
+		}
+		setMethod( "OPTIONS" );
+		return sendAsync();
+	}
+
 	/**
 	 * Add additional query parameters to the request.
 	 * Note: This will remove any values with duplicate keys prior to adding the new struct of params.