handleFileUploadException(e);
        }
    }

    protected void prepareElementsHash() { // traditional name
        // #thinking jflute might lazy-loaded be unneeded? because created per request (2024/09/08)
        elementsAll = new HashMap<>();
        elementsText = new HashMap<>();
        elementsFile = new HashMap<>();
    }

     *
     * @return a new access context arranger
     */
    @Override
    protected AccessContextArranger newAccessContextArranger() { // for framework
        // fess does not use DBFlute, and this is unneeded so dummy
        return resource -> {
            final AccessContext context = new AccessContext();
            context.setAccessLocalDateTimeProvider(() -> timeManager.currentDateTime());

     *
     * @param connection RDMA connection that encountered error
     * @param error the error that occurred
     * @return true if error was handled and connection recovered, false if fallback needed
     */
    public boolean handleRdmaError(RdmaConnection connection, Exception error) {
        log.warn("RDMA error occurred: {}", error.getMessage());
        statistics.recordError();

        }
        return bytes;
    }

    /**
     * Check if key rotation is needed based on configurable usage limits
     *
     * @return true if key rotation is needed
     */
    public boolean needsKeyRotation() {
        return needsKeyRotation(0);
    }

    /**
     * Check if key rotation is needed, considering additional bytes to be encrypted
     *

- [ ] Java conventions followed
- [ ] JavaDoc for public APIs
- [ ] Tests pass (`mvn test`)
- [ ] No compiler warnings
- [ ] Proper exception handling
- [ ] Resource cleanup (AutoCloseable)
- [ ] Thread-safe if needed
- [ ] Code formatted (`mvn formatter:format`)
- [ ] License headers (`mvn license:format`)

---

## Quick Reference

### Key File Locations

    ├── stemmer_override.txt
    └── protwords.txt
```

## Important Notes

### No Database Changes Required

- Language configuration is entirely file-based
- No database or OpenSearch index updates needed
- Settings are loaded at application startup and cached

### Fallback Mechanism

        int bytesDecoded1 = fileInternalInfo.decode(buffer, 0, 5); // Less than needed
        assertEquals(8, bytesDecoded1); // Should still return 8
        assertEquals(expectedIndexNumber, fileInternalInfo.getIndexNumber());

        FileInternalInfo info2 = new FileInternalInfo();
        int bytesDecoded2 = info2.decode(buffer, 0, 15); // More than needed
        assertEquals(8, bytesDecoded2); // Should still return 8

                || url.startsWith("s3:") || url.startsWith("gcs:");
    }

    /**
     * Checks if the given URL represents a file system path for content serving.
     * Used to determine if special handling is needed for file system URLs.
     *
     * @param url the URL to check
     * @return true if the URL is a file system path (file, smb, smb1, ftp, storage, s3, gcs)
     */

            "filetype": doc.get("filetype", "html"),
            "created": doc.get("@timestamp", ""),
            "timestamp": doc.get("@timestamp", ""),
            # Add custom fields as needed
        }

        outfile.write(json.dumps(fess_doc) + '\n')
```

**Step 3: Import to Fess**

Option A: Via Admin UI
1. Go to **System > Backup**
2. Upload `fess-documents.json` (bulk format)

        }
    }

    @Test
    @DisplayName("Test decode with minimum buffer size")
    void testDecodeWithMinimumBuffer() throws SMBProtocolDecodingException {
        // Create buffer with exact size needed
        byte[] buffer = new byte[8];
        long value = 42L;
        SMBUtil.writeInt8(value, buffer, 0);

        // Decode with minimum length
        int bytesRead = fileInfo.decode(buffer, 0, 8);