The package file provides the necessary functions to treat files from XSQL-Script. Files can be created, removed, edited, read them, stored in the database...
The following table shows the most important functions, separateds by differents aspects as: Binary or Character functions. Functions which reference a file via
an identifier or directly through an argument in which is passed the file. Functions to which you can indicate the character set and to which you cannot.
1 Xsql file
| Character | Binary |
|---|---|
| Functions which reference to the file with the attribute id | |
| file.writer.open [encoding] | file.out.open |
| file.writer.close | file.out.close |
| file.writer.print | file.out.print [encoding] |
| file.writer.println | file.out.println [encoding] |
| file.writer.println | file.out.println |
| file.writer.print.sql | file.out.print.sql |
| file.out.write | |
| Functions to which the file is passed as entry argument. | |
| file.chars.read [encoding] | file.bytes.read |
| file.chars.write [encoding-src,encoding-dst] | file.bytes.write |
Nota informativa
It is discouraged the use of the functions file.out, being preferable to use the funtions file.writer.
| File mode | ||||
|---|---|---|---|---|
| Type | Privilege | Name | Location | Description |
| temp | base | application server $HOME/temp, a temporal file. It is the default option. | ||
| absolute | final | application server filesystem, a file of absolute path. | ||
| disktool | final | wic_conf:wic_user_diskdata, a entry to disktool. | ||
| mailtool | final | wic_conf:wic_user_maildata, a entry to mailtool. | ||
Annex to the table 'File mode':
- privileged: For security the interpreter who executes the program XSQL-Script does not let any directory of the file system be accessed.
In the configuration database wic_conf the directories to which the XSQL-Script programs executed on a given server can access are determined.
- yes_ The server allows the acces to the enabled directories (parametrized for each of the servers WebStudio in the configuration database wic_conf).
- no: if the file is temporal is located in temporal directories of the file system.
- location: location of a file.
- final: The file is founded by the indicated name.
- base: if the file is temporal, the final name of the file has a randomly generated part and the indicated name forms the base of the final name.
- persistent: existence of the file.
- yes: The file is persistent, it will exist after the ending of the program.
- no: The existence of the file is limited to the execution time of the XSQL-Script. Once the program ends, it is removed.