Merge pull request #1457 from lucee/update-6.2.0.164

Update and import new stuff from 6.2.0.164
lucee · Nov 10, 2024 · 19e033d · 19e033d
2 parents 7c9c37e + b4021f0
commit 19e033d
Show file tree

Hide file tree

Showing 74 changed files with 178 additions and 7 deletions.
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -39,7 +39,7 @@ jobs:
         with:
           webroot: ${{ github.workspace }}
           execute: /build-all.cfm
-          luceeVersion: 6.1.0.238-SNAPSHOT
+          luceeVersion: 6.2.0.164-SNAPSHOT
           # redis, chart, lucene, form. ajax, chart
           extensions: 60772C12-F179-D555-8E2CD2B4F7428718;version=3.0.0.54-SNAPSHOT,D46B46A9-A0E3-44E1-D972A04AC3A8DC10,EFDEB172-F52E-4D84-9CD1A1F561B3DFC8,FAD67145-E3AE-30F8-1C11A6CCF544F0B7,6E2CB28F-98FB-4B51-B6BE6C64ADF35473,DF28D0A4-6748-44B9-A2FDC12E4E2E4D38
       - name: Upload Artifact

diff --git a/docs/03.reference/01.functions/deserializejson/_arguments/format.md b/docs/03.reference/01.functions/deserializejson/_arguments/format.md
@@ -0,0 +1,4 @@
+The format of the input string. Possible values are:
+
+- **json**: Standard JSON format
+- **json5**: JSON5 format which allows additional features such as comments and unquoted keys
diff --git a/docs/03.reference/01.functions/gatewayaction/_arguments/action.md b/docs/03.reference/01.functions/gatewayaction/_arguments/action.md
@@ -0,0 +1 @@
+action to execute, possible values are [start,stop and restart]
diff --git a/docs/03.reference/01.functions/gatewayaction/_arguments/gatewayID.md b/docs/03.reference/01.functions/gatewayaction/_arguments/gatewayID.md
@@ -0,0 +1 @@
+Identifier of the gateway to do the action on.
diff --git a/docs/03.reference/01.functions/gatewayaction/_arguments/timeout.md b/docs/03.reference/01.functions/gatewayaction/_arguments/timeout.md
@@ -0,0 +1 @@
+in case `waitForIt` is set to `true`, this defines how long we wait for the process to end, default is one second.
diff --git a/docs/03.reference/01.functions/gatewayaction/_arguments/waitForIt.md b/docs/03.reference/01.functions/gatewayaction/_arguments/waitForIt.md
@@ -0,0 +1 @@
+Wait for the process to end (starting, stopping or restarting)
diff --git a/docs/03.reference/01.functions/gatewayaction/_returnTypeDesc.md b/docs/03.reference/01.functions/gatewayaction/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/gatewayaction/_usageNotes.md b/docs/03.reference/01.functions/gatewayaction/_usageNotes.md
diff --git a/docs/03.reference/01.functions/gatewayaction/function.md b/docs/03.reference/01.functions/gatewayaction/function.md
@@ -0,0 +1,8 @@
+---
+title: GatewayAction
+id: function-gatewayaction
+categories:
+- gateways
+---
+
+Executes a specifc action for a gateway instance.
diff --git a/docs/03.reference/01.functions/gatewaystate/_arguments/gatewayID.md b/docs/03.reference/01.functions/gatewaystate/_arguments/gatewayID.md
@@ -0,0 +1 @@
+Identifier of the gateway to get info for.
diff --git a/docs/03.reference/01.functions/gatewaystate/_returnTypeDesc.md b/docs/03.reference/01.functions/gatewaystate/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/gatewaystate/_usageNotes.md b/docs/03.reference/01.functions/gatewaystate/_usageNotes.md
diff --git a/docs/03.reference/01.functions/gatewaystate/function.md b/docs/03.reference/01.functions/gatewaystate/function.md
@@ -0,0 +1,8 @@
+---
+title: GatewayState
+id: function-gatewaystate
+categories:
+- gateways
+---
+
+Return the current state for the given gateway id.
diff --git a/docs/03.reference/01.functions/isjson/_arguments/format.md b/docs/03.reference/01.functions/isjson/_arguments/format.md
@@ -0,0 +1,4 @@
+The format of the input string. Possible values are:
+
+- **json**: Standard JSON format
+- **json5**: JSON5 format which allows additional features such as comments and unquoted keys
diff --git a/docs/03.reference/01.functions/javacast/_arguments/javaSettings.md b/docs/03.reference/01.functions/javacast/_arguments/javaSettings.md
@@ -0,0 +1 @@
+javasettings to use to load the class
diff --git a/docs/03.reference/01.functions/mavenload/_arguments/input.md b/docs/03.reference/01.functions/mavenload/_arguments/input.md
@@ -0,0 +1 @@
+A struct or an array of structs specifying the Maven coordinates, including groupId, artifactId, and version.
diff --git a/docs/03.reference/01.functions/mavenload/_returnTypeDesc.md b/docs/03.reference/01.functions/mavenload/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/mavenload/_usageNotes.md b/docs/03.reference/01.functions/mavenload/_usageNotes.md
diff --git a/docs/03.reference/01.functions/mavenload/function.md b/docs/03.reference/01.functions/mavenload/function.md
@@ -0,0 +1,32 @@
+---
+title: MavenLoad
+id: function-mavenload
+related:
+- function-createobject
+categories:
+- classloading
+- dependencies
+- jars
+- java
+- maven
+---
+
+Loads all JAR files from one or more Maven endpoints and makes them available for use within the Lucee server environment. 
+This function can be used to load dependencies, including transitive ones, for example at server startup.
+
+### Example Usage of MavenLoad Function
+
+The `MavenLoad` function allows you to load JAR files from Maven repositories, including all transitive dependencies. 
+This is particularly useful during server startup to ensure that all required libraries are available.
+
+#### Example Input as an Array of Structs:
+
+```cfml
+mavenLoad([
+{
+"groupId": "org.slf4j",
+"artifactId": "slf4j-api",
+"version": "1.7.32"
+}
+]);
+```
diff --git a/docs/03.reference/01.functions/s3createbucket/_arguments/accessKeyId.md b/docs/03.reference/01.functions/s3createbucket/_arguments/accessKeyId.md
@@ -0,0 +1 @@
+S3 accessKeyId, if not defined it checks the system property/environment variable for [lucee.s3.accesskeyid].
diff --git a/docs/03.reference/01.functions/s3createbucket/_arguments/acl.md b/docs/03.reference/01.functions/s3createbucket/_arguments/acl.md
@@ -0,0 +1 @@
+an array of struct where each struct represents an ACL grant
diff --git a/docs/03.reference/01.functions/s3createbucket/_arguments/bucketName.md b/docs/03.reference/01.functions/s3createbucket/_arguments/bucketName.md
@@ -0,0 +1 @@
+Name of the bucket to create
diff --git a/docs/03.reference/01.functions/s3createbucket/_arguments/host.md b/docs/03.reference/01.functions/s3createbucket/_arguments/host.md
@@ -0,0 +1 @@
+the provider to connect, if not set Amazon AWS is used.
diff --git a/docs/03.reference/01.functions/s3createbucket/_arguments/location.md b/docs/03.reference/01.functions/s3createbucket/_arguments/location.md
@@ -0,0 +1 @@
+location of the S3 storage.
diff --git a/docs/03.reference/01.functions/s3createbucket/_arguments/secretAccessKey.md b/docs/03.reference/01.functions/s3createbucket/_arguments/secretAccessKey.md
@@ -0,0 +1 @@
+S3 secretAccessKey, if not defined it checks the system property/environment variable for [lucee.s3.secretaccesskey].
diff --git a/docs/03.reference/01.functions/s3createbucket/_arguments/timeout.md b/docs/03.reference/01.functions/s3createbucket/_arguments/timeout.md
@@ -0,0 +1 @@
+timeout for this execution
diff --git a/docs/03.reference/01.functions/s3createbucket/_returnTypeDesc.md b/docs/03.reference/01.functions/s3createbucket/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/s3createbucket/_usageNotes.md b/docs/03.reference/01.functions/s3createbucket/_usageNotes.md
diff --git a/docs/03.reference/01.functions/s3createbucket/function.md b/docs/03.reference/01.functions/s3createbucket/function.md
@@ -0,0 +1,9 @@
+---
+title: s3createbucket
+id: function-s3createbucket
+related:
+categories:
+- s3
+---
+
+Creates a bucket on S3.
diff --git a/docs/03.reference/01.functions/s3deletebucket/function.md b/docs/03.reference/01.functions/s3deletebucket/function.md
@@ -2,7 +2,7 @@
 title: s3deletebucket
 id: function-s3deletebucket
 related:
-categories:
+- function-s3delete
 ---
 
-deletes a bucket, this function is deprecated, use instead S3Delete.
+deletes a bucket, this function is deprecated, use instead [[function-S3Delete]].
diff --git a/docs/03.reference/01.functions/s3download/_arguments/accessKeyId.md b/docs/03.reference/01.functions/s3download/_arguments/accessKeyId.md
@@ -0,0 +1 @@
+S3 `accessKeyId`, if not defined it checks the system property/environment variable for [lucee.s3.accesskeyid].
diff --git a/docs/03.reference/01.functions/s3download/_arguments/bucketName.md b/docs/03.reference/01.functions/s3download/_arguments/bucketName.md
@@ -0,0 +1 @@
+Name of the bucket to download.
diff --git a/docs/03.reference/01.functions/s3download/_arguments/charset.md b/docs/03.reference/01.functions/s3download/_arguments/charset.md
@@ -0,0 +1 @@
+charset to use to store the content.
diff --git a/docs/03.reference/01.functions/s3download/_arguments/host.md b/docs/03.reference/01.functions/s3download/_arguments/host.md
@@ -0,0 +1 @@
+The provider to connect, if not set Amazon AWS is used.
diff --git a/docs/03.reference/01.functions/s3download/_arguments/objectName.md b/docs/03.reference/01.functions/s3download/_arguments/objectName.md
@@ -0,0 +1 @@
+Name of the object to download.
diff --git a/docs/03.reference/01.functions/s3download/_arguments/secretAccessKey.md b/docs/03.reference/01.functions/s3download/_arguments/secretAccessKey.md
@@ -0,0 +1 @@
+S3 secretAccessKey, if not defined it checks the system property/environment variable for [lucee.s3.secretaccesskey].
diff --git a/docs/03.reference/01.functions/s3download/_arguments/target.md b/docs/03.reference/01.functions/s3download/_arguments/target.md
@@ -0,0 +1,13 @@
+Optional. Defines the target where the downloaded data will be directed.
+
+If a file path is provided, the data is saved to that path, the file path must be provided with help of the function "fileOpen" like this [fileOpen(path,"write")].
+
+If a closure or function is given, it will be invoked with parts of the downloaded data as its argument.
+The function should accept a single argument named 'line' for line-by-line processing,
+'string{Number}' for string blocks of a specified size,
+or 'binary{Number}' for binary blocks of a specified size.
+
+The function should return a boolean value: returning false will stop further reading from S3,
+while true will continue the process.
+
+If this argument is omitted, the function returns the downloaded data directly.
diff --git a/docs/03.reference/01.functions/s3download/_arguments/timeout.md b/docs/03.reference/01.functions/s3download/_arguments/timeout.md
@@ -0,0 +1 @@
+timeout for this execution
diff --git a/docs/03.reference/01.functions/s3download/_returnTypeDesc.md b/docs/03.reference/01.functions/s3download/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/s3download/_usageNotes.md b/docs/03.reference/01.functions/s3download/_usageNotes.md
diff --git a/docs/03.reference/01.functions/s3download/function.md b/docs/03.reference/01.functions/s3download/function.md
@@ -0,0 +1,9 @@
+---
+title: s3download
+id: function-s3download
+categories:
+- s3
+---
+
+Downloads an object from an S3 bucket. 
+It can save the object to a specified path, return its content directly, or process the content in parts through a provided closure or UDF (User-Defined Function).
diff --git a/docs/03.reference/01.functions/s3getversioninfo/_arguments/accessKeyId.md b/docs/03.reference/01.functions/s3getversioninfo/_arguments/accessKeyId.md
@@ -0,0 +1 @@
+S3 accessKeyId. If not defined, checks the system property/environment variable for [lucee.s3.accesskeyid].
diff --git a/docs/03.reference/01.functions/s3getversioninfo/_arguments/bucketName.md b/docs/03.reference/01.functions/s3getversioninfo/_arguments/bucketName.md
@@ -0,0 +1 @@
+Name of the bucket to get info for.
diff --git a/docs/03.reference/01.functions/s3getversioninfo/_arguments/host.md b/docs/03.reference/01.functions/s3getversioninfo/_arguments/host.md
@@ -0,0 +1 @@
+The provider to connect to. If not set, Amazon AWS is used.
diff --git a/docs/03.reference/01.functions/s3getversioninfo/_arguments/objectName.md b/docs/03.reference/01.functions/s3getversioninfo/_arguments/objectName.md
@@ -0,0 +1 @@
+Name of the object (path) within the bucket to get info for. If not defined, info of the bucket is returned.
diff --git a/docs/03.reference/01.functions/s3getversioninfo/_arguments/secretAccessKey.md b/docs/03.reference/01.functions/s3getversioninfo/_arguments/secretAccessKey.md
@@ -0,0 +1 @@
+S3 secretAccessKey. If not defined, checks the system property/environment variable for [lucee.s3.secretaccesskey].
diff --git a/docs/03.reference/01.functions/s3getversioninfo/_arguments/timeout.md b/docs/03.reference/01.functions/s3getversioninfo/_arguments/timeout.md
@@ -0,0 +1 @@
+Timeout for this execution (in milliseconds).
diff --git a/docs/03.reference/01.functions/s3getversioninfo/_returnTypeDesc.md b/docs/03.reference/01.functions/s3getversioninfo/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/s3getversioninfo/_usageNotes.md b/docs/03.reference/01.functions/s3getversioninfo/_usageNotes.md
diff --git a/docs/03.reference/01.functions/s3getversioninfo/function.md b/docs/03.reference/01.functions/s3getversioninfo/function.md
@@ -0,0 +1,9 @@
+---
+title: s3getversioninfo
+id: function-s3getversioninfo
+related:
+categories:
+- s3
+---
+
+Returns version information as a query for a specific object or bucket.
diff --git a/docs/03.reference/01.functions/s3listbucket/_arguments/blockfactor.md b/docs/03.reference/01.functions/s3listbucket/_arguments/blockfactor.md
diff --git a/docs/03.reference/01.functions/s3listbucket/_arguments/listener.md b/docs/03.reference/01.functions/s3listbucket/_arguments/listener.md
@@ -0,0 +1,9 @@
+Optional. Defines the target where the downloaded data will be directed. 
+If a file path is provided, the data is saved to that path, the file path must be provided with help of the function "fileOpen" like this [fileOpen(path,"write")]. 
+If a closure or function is given, it will be invoked with parts of the downloaded data as its argument. 
+The function should accept a single argument named 'line' for line-by-line processing, 
+'string{Number}' for string blocks of a specified size, 
+or 'binary{Number}' for binary blocks of a specified size. 
+The function should return a boolean value: returning false will stop further reading from S3, 
+while true will continue the process. 
+If this argument is omitted, the function returns the downloaded data directly.
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/accessKeyId.md b/docs/03.reference/01.functions/s3upload/_arguments/accessKeyId.md
@@ -0,0 +1 @@
+S3 accessKeyId, if not defined it checks the system property/environment variable for [lucee.s3.accesskeyid].
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/acl.md b/docs/03.reference/01.functions/s3upload/_arguments/acl.md
@@ -0,0 +1 @@
+an array of struct where each struct represents an ACL grant
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/bucketName.md b/docs/03.reference/01.functions/s3upload/_arguments/bucketName.md
@@ -0,0 +1 @@
+Name of the bucket of your object to write
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/host.md b/docs/03.reference/01.functions/s3upload/_arguments/host.md
@@ -0,0 +1 @@
+the provider to connect, if not set Amazon AWS is used.
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/location.md b/docs/03.reference/01.functions/s3upload/_arguments/location.md
@@ -0,0 +1 @@
+location of the S3 storage.
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/objectName.md b/docs/03.reference/01.functions/s3upload/_arguments/objectName.md
@@ -0,0 +1 @@
+Name of the object (path) within the bucket of your object to write
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/secretAccessKey.md b/docs/03.reference/01.functions/s3upload/_arguments/secretAccessKey.md
@@ -0,0 +1 @@
+S3 secretAccessKey, if not defined it checks the system property/environment variable for [lucee.s3.secretaccesskey].
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/source.md b/docs/03.reference/01.functions/s3upload/_arguments/source.md
@@ -0,0 +1 @@
+Source file to write to S3. A string path to a file or a object created with the function "fileOpen".
diff --git a/docs/03.reference/01.functions/s3upload/_arguments/timeout.md b/docs/03.reference/01.functions/s3upload/_arguments/timeout.md
@@ -0,0 +1 @@
+timeout for this execution
diff --git a/docs/03.reference/01.functions/s3upload/_returnTypeDesc.md b/docs/03.reference/01.functions/s3upload/_returnTypeDesc.md
diff --git a/docs/03.reference/01.functions/s3upload/_usageNotes.md b/docs/03.reference/01.functions/s3upload/_usageNotes.md
diff --git a/docs/03.reference/01.functions/s3upload/function.md b/docs/03.reference/01.functions/s3upload/function.md
@@ -0,0 +1,9 @@
+---
+title: s3upload
+id: function-s3upload
+related:
+categories:
+- s3
+---
+
+Uploads a file to S3.
diff --git a/docs/03.reference/02.tags/component/_attributes/accessors.md b/docs/03.reference/02.tags/component/_attributes/accessors.md
@@ -0,0 +1 @@
+If set to true, enables implicit getters and setters for the component's properties. For persistent CFCs, accessors are always enabled.
diff --git a/docs/03.reference/02.tags/component/_attributes/implements.md b/docs/03.reference/02.tags/component/_attributes/implements.md
@@ -0,0 +1 @@
+Lists the interfaces that the component implements, specifying the set of functions that the component must provide.
diff --git a/docs/03.reference/02.tags/component/_attributes/modifier.md b/docs/03.reference/02.tags/component/_attributes/modifier.md
@@ -0,0 +1 @@
+Defines the type of component: `none` for a regular component, `abstract` for a component that cannot be instantiated directly and must be extended, or `final` for a component that cannot be extended by other components.
diff --git a/docs/03.reference/02.tags/function/_attributes/consumes.md b/docs/03.reference/02.tags/function/_attributes/consumes.md
@@ -0,0 +1 @@
+A comma-separated list of acceptable MIME types that the function can accept or consume. If no value is specified, all MIME types are consumed by default. Use this attribute to control the types of content the function can handle. This attribute overrides the `consumes` attribute at the component level.
diff --git a/docs/03.reference/02.tags/function/_attributes/httpmethod.md b/docs/03.reference/02.tags/function/_attributes/httpmethod.md
@@ -0,0 +1,10 @@
+Specifies the HTTP method to use when calling the function as part of a RESTful service. Accepted values include:
+
+- `GET`: Requests information from the server.
+- `POST`: Sends information to the server for processing.
+- `PUT`: Requests the server to store the message body at the specified URL.
+- `DELETE`: Requests the server to delete the specified URL.
+- `HEAD`: Similar to GET but without a response body.
+- `OPTIONS`: Requests information about the communication options available for the server or the specified URL.
+
+If not specified, the `GET` method is used by default.
diff --git a/docs/03.reference/02.tags/function/_attributes/produces.md b/docs/03.reference/02.tags/function/_attributes/produces.md
@@ -0,0 +1 @@
+A comma-separated list of MIME types that the function can produce. The function will respond with the most acceptable media type as declared by the client. This attribute overrides the `produces` attribute at the component level.
diff --git a/docs/03.reference/02.tags/function/_attributes/restpath.md b/docs/03.reference/02.tags/function/_attributes/restpath.md
@@ -0,0 +1 @@
+Defines a sub-resource path for the function when used as part of a RESTful web service. The path is case-sensitive and should avoid special characters. Regular expressions can be included in the path.
diff --git a/docs/03.reference/02.tags/import/tag.md b/docs/03.reference/02.tags/import/tag.md
@@ -2,7 +2,10 @@
 title: <cfimport>
 id: tag-import
 related:
+- function-createobject
+- function-mavenload
 categories:
+- java
 ---
 
-To import a JSP Taglibrary or a CFML Custom Tag Directory
+To import a JSP Taglibrary or a CFML Custom Tag Directory
diff --git a/docs/03.reference/05.objects/string/deserializejson/_arguments/format.md b/docs/03.reference/05.objects/string/deserializejson/_arguments/format.md
@@ -0,0 +1,4 @@
+The format of the input string. Possible values are:
+
+- **json**: Standard JSON format
+- **json5**: JSON5 format which allows additional features such as comments and unquoted keys
diff --git a/docs/04.guides/13.Various/05.command-line-interface/page.md b/docs/04.guides/13.Various/05.command-line-interface/page.md
@@ -12,7 +12,7 @@ Right now, at the beginning, we would like to lay a solid foundation for the fut
 
 To this end, feel free to hop into the user group and join the conversation!
 
-### Download ###
+### Commandbox ###
 
 The CLI is currently available for Windows (win32 version), Linux and OS X (bin version).
 
@@ -26,8 +26,6 @@ It is available with or without a JRE, and there is an experimental "CLI Express
 
 [https://commandbox.ortusbooks.com/getting-started-guide](https://commandbox.ortusbooks.com/getting-started-guide)
 
-[https://commandbox.ortusbooks.com/getting-started-guide](https://commandbox.ortusbooks.com/getting-started-guide)
-
 ### Installation ###
 
 Call lucee or lucee.exe (depending on OS) directly, or put it somewhere in your system path, or modify your system path to include the executable's location.