Translate to Japanese (日本語).

Language code: ja.

### Grammar and tone

1) Use polite, instructional Japanese (です/ます調).
2) Keep the tone concise and technical (match existing Japanese FastAPI docs).

### Headings

1) Follow the existing Japanese style: short, descriptive headings (often noun phrases), e.g. 「チェック」.
2) Do not add a trailing period at the end of headings.

### Quotes

        // Test with English
        List<AnalyzeToken> tokensEn = analyzer.analyze(text, field, "en");
        assertNotNull(tokensEn);
        assertEquals(2, tokensEn.size());

        // Test with Japanese
        List<AnalyzeToken> tokensJa = analyzer.analyze(text, field, "ja");
        assertNotNull(tokensJa);
        assertEquals(2, tokensJa.size());

        // Test with null language

    @Test
    public void testConvertWithJapaneseText() throws IOException {
        // Test convert with Japanese text
        String text = "テスト";
        String field = "content";

        List<String> results = converter.convert(text, field, "ja");

        assertNotNull(results);
        // Should use Japanese analyzer and transliterator
    }

    @Test

**Test Count**: 10 tests

**Key Scenarios**:
- ✅ Valid filename extraction
- ✅ Null parameters handling
- ✅ Empty/missing resource name
- ✅ Special characters in filename (Japanese, paths)
- ✅ Input stream not consumed (only validated)
- ✅ Whitespace and empty string handling

---

### 3. ArchiveExtractorErrorHandlingTest.java
**Purpose**: Test improved error handling in archive extractors.

        assertEquals(1, readings.size());
        assertEquals("TEST@#$%123", readings.get(0));
    }

    @Test
    public void testConvertWithJapaneseText() throws IOException {
        // Test convert with Japanese text
        testConverter.setJapaneseMode(true);
        converter.init();
        String text = "東京";
        String field = "content";

        List<String> readings = converter.convert(text, field, "ja");

Damos la bienvenida a pull requests para tu idioma.

### Traducciones

- [English](../../README.md)
- [日本語 (Japanese)](../ja/README.md)
- [简体中文 (Simplified Chinese)](../zh-CN/README.md)
- [Português (Brazilian Portuguese)](../pt-BR/README.md)
- [Français (French)](../fr/README.md)
- [Deutsch (German)](../de/README.md)

    }

    @Test
    public void testWithJapaneseCharacters() {
        // Test with Japanese characters
        String word = "日本語テスト";
        float boost = 2.0f;
        List<String> readings = Arrays.asList("ニホンゴテスト");
        List<String> fields = Arrays.asList("content_ja");
        List<String> tags = Arrays.asList("japanese");
        List<String> roles = Arrays.asList("admin");

* 🌐 Add Japanese translation for `docs/ja/docs/tutorial/dependencies/sub-dependencies.md`. PR [#1959](https://github.com/tiangolo/fastapi/pull/1959) by [@SwftAlpc](https://github.com/SwftAlpc).
* 🌐 Add Japanese translation for `docs/ja/docs/tutorial/background-tasks.md`. PR [#2668](https://github.com/tiangolo/fastapi/pull/2668) by [@tokusumi](https://github.com/tokusumi).

We welcome pull requests for your language.

### Translations

- [日本語 (Japanese)](docs/ja/README.md)
- [简体中文 (Simplified Chinese)](docs/zh-CN/README.md)
- [Español (Spanish)](docs/es/README.md)
- [Português (Brazilian Portuguese)](docs/pt-BR/README.md)
- [Français (French)](docs/fr/README.md)

Nous accueillons les pull requests pour votre langue.

### Traductions

- [English](../../README.md)
- [日本語 (Japanese)](../ja/README.md)
- [简体中文 (Simplified Chinese)](../zh-CN/README.md)
- [Español (Spanish)](../es/README.md)
- [Português (Brazilian Portuguese)](../pt-BR/README.md)
- [Deutsch (German)](../de/README.md)