Hono Basics
Tradus de
ScribdTranslationsHono Basics
Tradus de
ScribdTranslationsÎncepere
Utilizarea Hono este foarte simplă. Putem configura proiectul, scrie cod, dezvolta cu un
server local și desfășurați rapid. Același cod va funcționa pe orice mediu de execuție, doar cu
puncte de intrare diferite. Să privim utilizarea de bază a Hono.
## Incepător
Șabloanele de început sunt disponibile pentru fiecare platformă. Folosiți următorul "create-hono"
comandă.
:::
[npm]
npm create hono@latest my-app
```
[yarn]
yarn crea hono my-app
```
[pnpm]
pnpm creează hono my-app
```
[bun]
bunx creare-hono my-app
```
[deno]
deno run -A npm:create-hono my-app
```
:::
Apoi ți se va cere să alegi ce șablon dorești să folosești.
Să alegem Cloudflare Workers pentru acest exemplu.
```
? Ce șablon vrei să folosești?
aws-lambda
bun
clouflare-pages
cloudflare-workers
deno
rapid
nextjs
nodejs
vercel
```
Șablonul va fi adus în `my-app`, așa că accesați-l și instalați-l
dependențe.
:::</code-group>
[npm]
cd aplicatia-mea
npm i
```
[yarn]
cd aplicația mea
fir
```
[pnpm]
cd my-app
pnpm i
```
[bun]
cd aplicația mea
bun i
```
:::
Odată ce instalarea pachetului este completă, rulati următoarea comandă pentru a porni
server local.
:: cod-grupă
[npm]
npm run dev
```
[yarn]
yarn dev
```
[pnpm]
pnpm dev
```
[bun]
bun run dev
```
:::
Bună lume
Puteți scrie cod în TypeScript cu instrumentul de dezvoltare Cloudflare Workers
Wrangler, Deno, Bun sau altele, fără a fi conștienți de transpilare.
Write your first application with Hono in `src/[Link]`. The example below is a
aplicație Hono de pornire.
Părțile `import` și `export default` finale pot varia de la un runtime la altul,
dar tot codul aplicației va rula același cod peste tot.
```ts
import { Hono } din 'hono'
const app = nou Hono()
[Link]('/', (c) => {
Salut Hono!
})
exportați în mod implicit aplicația
```
Porniți serverul de dezvoltare și accesați `[Link] cu browserul dumneavoastră.
::: grup de cod
[npm]
npm run dev
```
[yarn]
yarn dev
```
[pnpm]
pnpm dev
```
[bun]
bun run dev
```
:::
Întoarce JSON
Returnarea JSON-ului este, de asemenea, ușoară. Următorul este un exemplu de gestionare a unei cereri GET
la `/api/hello` și returnând un răspuns `application/json`.
```ts
[Link]('/api/hello', (c) => {
return [Link]({
ok: true,
message: 'Hello Hono!',
})
})
```
## Request and Response
Obținerea unui parametru de cale, a unei valori de interogare URL și adăugarea unui antet de răspuns este
scris astfel.
```ts
[Link]('/posts/:id', (c) => {
const page = [Link]('page')
const id = [Link]('id')
[Link]('X-Message', 'Bună!')
Vrei să vezi ${page} din ${id}
})
```
Putem gestiona cu ușurință POST, PUT și DELETE, nu doar GET.
```ts
[Link]('/posts', (c) => [Link]('Creat!', 201))
/posts/:id a fost șters!
```
## Return HTML
Hono este, de asemenea, potrivit pentru a returna puțin HTML. Schimbați numele fișierului în
`src/[Link]` și configurarea acestuia pentru a utiliza JSX (verificați cu fiecare runtime așa cum este)
diferit). Nu este nevoie să folosești un cadru enorm de front-end.
```tsx
const View = () => {
returnați (
<html>
<body>
<h1>Salut Hono!</h1>
</body>
</html>
)
}
[Link]('/pagina', (c) => {
return [Link](<View />)
})
```
## Returnează răspunsul brut
De asemenea, poți returna datele brute
[Răspuns]([Link]
```ts
[Link]('/', (c) => {
return new Response('Good morning!')
})
```
## Utilizarea Middleware
Middleware poate face munca grea pentru tine.
De exemplu, adăugați în Autentificarea de bază.
```ts
import { basicAuth } din 'hono/basic-auth'
// ...
aplicație folosește(
/admin/*
basicAuth({
username: 'admin',
password: 'secret',
})
)
[Link]('/admin', (c) => {
Ești autorizat!
})
```
Există middleware-uri utile încorporate, inclusiv Bearer și autentificarea folosind JWT,
CORS and ETag.
Hono oferă de asemenea middleware de la terți folosind biblioteci externe, cum ar fi GraphQL
Server și Firebase Auth.
Și poți să îți faci propriul middleware.
Adapter
Există adaptoare pentru funcții dependente de platformă, de exemplu, gestionarea fișierelor statice.
De exemplu, pentru a gestiona fișiere statice în Cloudflare Workers, importați `hono/cloudflare-
lucrători.
```ts
import { serveStatic } din 'hono/cloudflare-workers'
[Link]('/static/*', serveStatic({ root: './' }))
```
## Pasul următor
Cele mai multe coduri vor funcționa pe orice platformă, dar există ghiduri pentru fiecare.
De exemplu, cum să configurezi proiectele sau cum să le implementezi.
Vă rugăm să consultați pagina pentru platforma exactă pe care doriți să o utilizați pentru a crea
aplicație!