https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/ Recent content in The File Store API on sillysky.net Hugo -- gohugo.io en Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestoreaddfiletolist/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestoreaddfiletolist/ This is an internal message from FileStores. It is used to add a local file (for example, one that has just been created) from the Filestore directory to the FileStore's internal list of all managed files. { "id": "15e58db7-41b9-48c6-9cb8-6a1e76255481", "name": "FILE_STORE_ADD_FILE_TO_LIST", "isNanoService": "false", "type": "REQUEST", "namespaces": "", "description": "Add a file to the file list.", "slots": [ { "key": "1", "name": "FILE", "direction": "REQUEST", "presenceConstraint": "MANDATORY", "type": "RECORD", "description": "The file description (CRecordFileStoreFile). https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestoreaddlocalfile/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestoreaddlocalfile/ This message imports a local file into the FileStore of a nyssr.net node. This message belongs to the FileStore API. The message is a nanoservice of the SYSTEM namespace. { "id": "e62b8dea-1596-415a-b054-3fb15fd4d354", "name": "FILE_STORE_ADD_LOCAL_FILE", "description": "Add a local file to the file store.", "isNanoService": "true", "type": "REQUEST", "namespaces": "SYSTEM", "slots": [ { "key": "1", "name": "PATH", "direction": "REQUEST", "presenceConstraint": "MANDATORY", "type": "STRING", "description": "The path of the file." }, { " https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorefile/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorefile/ This record is a data record for transporting information about a file. This message belongs to the The File Store API API. { "id": "2152ee2c-45fa-4f46-8ad1-e91c3b77fd0c", "name": "FILE_STORE_FILE", "description": "A file record.", "isNanoService": "false", "type": "DATA_RECORD", "slots": [ { "key": "1", "name": "HASH", "type": "STRING", "description": "The hash of the file (base32 encoded)." }, { "key": "2", "name": "PATH", "type": "STRING", "description": "The relative path of the file." }, { "key": " https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestoregetchunk/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestoregetchunk/ This is an internal message from FileStores. FileStores don't transmit entire files at once to avoid clogging network lines. Every file download is split into many small chunks. This message is used to retrieve one chunk of a file from another FileStore. { "id": "60ff0699-bca8-400b-a997-7a1bbb8724c9", "name": "FILE_STORE_GET_CHUNK", "description": "Get a file chunk from a network file store.", "isNanoService": "false", "type": "REQUEST", "slots": [ { "key": "hash", "name": "HASH", "direction": "REQUEST", " https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestoregetfileinfo/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestoregetfileinfo/ The message retrieves information about a file stored in a The File Store API. This message belongs to the FileStore API. However, when it is sent to the The File Registry API, the FileRegistry selects a FileStore that hosts the requested file and forwards the message to that FileStore. In this way, the sender not only receives the file's data but also learns which FileStore it is stored in. { " https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorenotifyfiledownloaded/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorenotifyfiledownloaded/ This is an internal message from FileStores. A file was downloaded by a FileStore Job from another FileStore. The FileStore will add the file to its internal lists and subsequently register it with the File Registry. { "id": "b39ebcec-07f7-4442-a448-6cf6229bbcf2", "name": "FILE_STORE_NOTIFY_FILE_DOWNLOADED", "description": "Notification: A file has been downloaded and saved into the indexed directory.", "isNanoService": "false", "type": "NOTIFICATION", "slots": [ { "key": "1", "name": "PATH", "direction": "REQUEST", "presenceConstraint": "MANDATORY", "type": " https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorenotifyfileimported/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorenotifyfileimported/ This is an internal message from FileStores. This message serves as a notification from a file import job to the FileStore. It indicates that a new file has been successfully imported. The FileStore will subsequently add the file to its internal lists and register it with the File Registry. { "id": "02bf09f0-d1d8-40af-9788-e9a46c884c74", "name": "FILE_STORE_NOTIFY_FILE_IMPORTED", "description": "Notification: A file has been imported into the indexed directory.", "isNanoService": "false", "type": "NOTIFICATION", "slots": [ { " https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorerequestfile/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorerequestfile/ Request a file from a The File Store API. This request should always be sent to the local FileStore, as it will download the file from another FileStore if necessary and then return it in the response. This message belongs to the FileStore API. The message is a nanoservice of the SYSTEM namespace. { "id": "0b85e177-500e-47dc-b794-4675e0985d94", "name": "FILE_STORE_REQUEST_FILE", "description": "Request a file from the local file store.", "isNanoService": "true", "type": " https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorestorechunk/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorestorechunk/ This is an internal message from FileStores. This message is used when files are transferred from one FileStore to another. Files are not transferred in one piece but in blocks (Default: 10000 bytes per block). This specific message is used to transfer a single file block. { "id": "def6693e-5729-44a5-9532-dc5b872375d5", "name": "FILE_STORE_STORE_CHUNK", "description": "Store a file chunk into a network file store.", "isNanoService": "false", "type": "REQUEST", "slots": [ { "key": "hash", " https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorestorefile/ Tue, 09 Dec 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/plugins/supplied-plugins/plugin-jars/ny_filestoreplugin/the-file-store-api/crecordfilestorestorefile/ This is an internal message from FileStores. This message saves a file from a target to a file store. The accompanying record contains the file description. After receiving the message, the file store begins requesting the first chunks. { "id": "b88cdb0c-fb4f-4910-9bdd-c1b18257c5bd", "name": "FILE_STORE_STORE_FILE", "description": "Store a file into a network file store.", "isNanoService": "false", "type": "REQUEST", "slots": [ { "key": "1", "name": "FILE", "direction": "REQUEST", "presenceConstraint": "MANDATORY", "type": "RECORD", "description": "