Shinsuke Sugaya <******@****.***> 1444529815 +0900

 *
 * <p>HTML escaping is particularly tricky: For example, <a
 * href="https://www.w3.org/TR/html4/types.html#h-6.2">some elements' text contents must not be HTML
 * escaped</a>. As a result, it is impossible to escape an HTML document correctly without
 * domain-specific knowledge beyond what {@code HtmlEscapers} provides. We strongly encourage the
 * use of HTML templating systems.
 *
 * @author Sven Mawson

Sebastián Ramírez <******@****.***> 1759914201 +0900

{* ../../docs_src/custom_response/tutorial004.py hl[7,21,23] *}

이 예제에서, `generate_html_response()` 함수는 HTML을 `str`로 반환하는 대신 이미 `Response`를 생성하고 반환합니다.

`generate_html_response()`를 호출한 결과를 반환함으로써, 기본적인 **FastAPI** 기본 동작을 재정의 하는 `Response`를 이미 반환하고 있습니다.

하지만 `response_class`에 `HTMLResponse`를 함께 전달했기 때문에, FastAPI는 이를 OpenAPI 및 대화형 문서에서 `text/html`로 HTML을 문서화 하는 방법을 알 수 있습니다.

<img src="/img/tutorial/custom-response/image01.png">

## 사용 가능한 응답들

* 업로드 된 파일의 메타데이터를 얻을 수 있습니다.
* <a href="https://docs.python.org/3/glossary.html#term-file-like-object" class="external-link" target="_blank">file-like</a>  `async` 인터페이스를 갖고 있습니다.
* file-like object를 필요로하는 다른 라이브러리에 직접적으로 전달할 수 있는 파이썬 <a href="https://docs.python.org/3/library/tempfile.html#tempfile.SpooledTemporaryFile" class="external-link" target="_blank">`SpooledTemporaryFile`</a> 객체를 반환합니다.

### `UploadFile`

    /**
     * UTF-7 Byte Order Mark definition.
     */
    protected static final ByteOrderMark BOM_UTF_7 = new ByteOrderMark("UTF-7", 0x2B, 0x2F, 0x76);

    /**
     * HTML4 unescape translator.
     */
    protected static final CharSequenceTranslator UNESCAPE_HTML4 = new AggregateTranslator(

        assertEquals("http://hoge/index.html", htmlTransformer.normalizeUrl(url));

        url = "http://hoge/index.html;jsessionid=hoge?a=1";
        assertEquals("http://hoge/index.html?a=1", htmlTransformer.normalizeUrl(url));

        url = "http://hoge/index.html;jsessionid=hoge.fuga?a=1";
        assertEquals("http://hoge/index.html?a=1", htmlTransformer.normalizeUrl(url));

        assertTrue(auth.matches("ftp://otherhost:21/test/aaa.html"));

        // Test with IP address
        auth.setServer("192.168.1.1");
        assertTrue(auth.matches("ftp://192.168.1.1:21/test/aaa.html"));
        assertTrue(auth.matches("ftp://192.168.1.1/test/aaa.html"));
        assertFalse(auth.matches("ftp://hostname/test/aaa.html"));

        // Test with more complex paths

    HtmlNext path_Error_NotFoundJsp = new HtmlNext("/error/notFound.jsp");

    /** The path of the HTML: /error/redirect.jsp */
    HtmlNext path_Error_RedirectJsp = new HtmlNext("/error/redirect.jsp");

    /** The path of the HTML: /error/system.jsp */
    HtmlNext path_Error_SystemJsp = new HtmlNext("/error/system.jsp");

    /** The path of the HTML: /footer.jsp */

* Reference Documentation

 * {{{./lifecycles.html}lifecycles}} and {{{./default-bindings.html}plugin bindings to <<<default>>> lifecycle}},

 * {{{./artifact-handlers.html}default artifact handlers}}, to manage {{{../maven-model/maven.html#class_dependency}dependency types}},

 * {{{./extension.html}extension descriptor}} and {{{./core-extensions.html}core extensions}},