FilePack
const class FilePack : Obj, Weblet
FilePack is an in-memory cache of multiple text files to service static resources via HTTP. It takes one or more text files and creates one compound file. The result is stored in RAM using GZIP compression. Or you can use the pack utility method to store the result to your own files/buffers.
The onGet method is used to service GET requests for the bundle. The Content-Type header is set based on file extension of files bundled. It also implictly supports ETag/Last-Modified for 304 optimization.
The core factory is the makeFiles constructor. A suite of utility methods is provided for standard bundling of Fantom JavaScrit and CSS files.
Construct a bundle for the given list of text files
Compile the locale props into a JavaScript file "{locale}.js"
Get the standard pod JavaScript file or null if no JS code
Compile a list of pod JavaScript files into a single unified source map file
Map a set of pods to "/res/css/{name}.css" CSS files
Pack multiple text files together and write to the given output stream
Compile the timezone database into a JavaScript file "tz.js"
Given a set of pods return a list of JavaScript files that form a complete Fantom application
Return the required sys etc files
Given a set of pods return a list of CSS files that form a complete Fantom application
Compile the mime type database into a Javascript file "mime.js"
Map a set of pods to "/{name}.js" JavaScript files
Service an HTTP GET request for this bundle file
Compile the indexed props database into a JavaScript file "index-props.js"
Compile the unit database into a JavaScript file "unit.js"
static new makeFiles(File[] files, MimeType? mimeType)
Construct a bundle for the given list of text files
virtual Void onGet()
Service an HTTP GET request for this bundle file
static OutStream pack(File[] files, OutStream out)
Pack multiple text files together and write to the given output stream. A trailing newline is automatically added if the file is missing one. Empty files are skipped. The stream is not closed. Return the given out stream.
static File[] toAppCssFiles(Pod[] pods)
Given a set of pods return a list of CSS files that form a complete Fantom application:
- flatten the pods using Pod.flattenDepends
- order them by dependencies using Pod.orderByDepends
- return toPodCssFiles
static File[] toAppJsFiles(Pod[] pods)
Given a set of pods return a list of JavaScript files that form a complete Fantom application:
- flatten the pods using Pod.flattenDepends
- order them by dependencies using Pod.orderByDepends
- insert toEtcJsFiles immediately after "sys.js"
static File[] toEtcJsFiles()
Return the required sys etc files:
- add toMimeJsFile
- add toUnitsJsFile
- add toIndexPropsJsFile
static File toIndexPropsJsFile(Pod[] pods)
Compile the indexed props database into a JavaScript file "index-props.js"
static File toLocaleJsFile(Locale locale, Pod[] pods)
Compile the locale props into a JavaScript file "{locale}.js"
static File toMimeJsFile()
Compile the mime type database into a Javascript file "mime.js"
static File[] toPodCssFiles(Pod[] pods)
Map a set of pods to "/res/css/{name}.css" CSS files. Ignore pods that are missing a CSS file. This method does not flatten/order the pods.
static File? toPodJsFile(Pod pod)
Get the standard pod JavaScript file or null if no JS code. The standard location used by the Fantom JS compiler is "/{pod-name}.js"
static File[] toPodJsFiles(Pod[] pods)
Map a set of pods to "/{name}.js" JavaScript files. Ignore pods that are missing a JavaScript file. This method does not flatten/order the pods.
static File toPodJsMapFile(File[] files, [Str:Obj]? options)
Compile a list of pod JavaScript files into a single unified source map file. The list of files passed to this method should match exactly the list of files used to create the corresponding JavaScript FilePack. If the file is the standard pod JS file, then we will include an offset version of "{pod}.js.map" generated by the JavaScript compiler. Otherwise if the file is another JavaScript file (such as units.js) then we just add the appropiate offset.
The sourceRoot option may be passed in to replace "/dev/{podName}" as the root URI used to fetch source files from the server.
@Deprecated { msg=... }
static File toTimezonesJsFile()
Compile the timezone database into a JavaScript file "tz.js"
static File toUnitsJsFile()
Compile the unit database into a JavaScript file "unit.js"