serverMiddleware プロパティ
サーバーサイドミドルウェアを定義します。
-
型:
Array
-
要素:
String
またはObject
またはFunction
-
要素:
Nuxt はカスタムミドルウェアを追加できる connect インスタンスを内部で作ります。これにより外部サーバーを必要とせずに通常は /api
ルート)を登録できます。
connect 自体はミドルウェアなので、登録されたミドルウェアは nuxt start
と express-template のようなプログラムで使われるミドルウェアとして使う場合の両方で動作します。Nuxt モジュール もまた this.addServerMiddleware() を使って serverMiddleware
を提供できます。
それらに加え、デフォルト値が true
の prefix
オプションを導入しました。サーバーミドルウェアに router base を追加します。
例:
-
サーバーミドルウェアパス:
/server-middleware
-
Router base:
/admin
-
prefix: true
の場合(デフォルト):/admin/server-middleware
-
prefix: false
の場合:/server-middleware
サーバーミドルウェア vs ミドルウェア!
クライアントサイドやサーバーサイドレンダリングで Vue によって各ルートの前に呼び出されるルートのミドルウェア と混同しないでください。 serverMiddleware
プロパティに列挙されているミドルウェアは vue-server-renderer
の前にサーバーサイドで実行され、API リクエストの処理やアセットの提供などのサーバー固有のタスクに使用できます。
使い方
もしミドルウェアが文字列の場合、 Nuxt はそのミドルウェアを自動的に解決し要求します。
import serveStatic from 'serve-static'
export default {
serverMiddleware: [
// redirect-ssl npm パッケージを登録します
'redirect-ssl',
// /server-middleware/* を処理するために、プロジェクトの server-middleware ディレクトリからファイルを登録します
{ path: '/server-middleware', handler: '~/server-middleware/index.js' },
// カスタムインスタンスを作成することもできます
{ path: '/static2', handler: serveStatic(__dirname + '/static2') }
]
}
カスタムサーバーミドルウェア
カスタムミドルウェアの作成も可能です。詳細については Connect Docs を参照してください。
ミドルウェア(server-middleware/logger.js
):
export default function (req, res, next) {
// req は Node.js の HTTP リクエストオブジェクトです
console.log(req.url)
// res は Node.js の HTTP レスポンスオブジェクトです
// next は 次のミドルウェアを呼び出すための関数です。
// ミドルウェアがエンドポイントでない場合、関数の最後で next を呼び出すのを忘れないでください!
next()
}
serverMiddleware: ['~/server-middleware/logger']
カスタム API エンドポイント
サーバーミドルウェアも Express を拡張できます。これにより REST エンドポイントを作成できます。
const bodyParser = require('body-parser')
const app = require('express')()
app.use(bodyParser.json())
app.all('/getJSON', (req, res) => {
res.json({ data: 'data' })
})
module.exports = app
serverMiddleware: [
{ path: "/server-middleware", handler: "~/server-middleware/rest.js" },
],
オブジェクトの構文
パスにマッピングされた関数のリストでサーバーミドルウェアが構成されている場合:
export default {
serverMiddleware: [
{ path: '/a', handler: '~/server-middleware/a.js' },
{ path: '/b', handler: '~/server-middleware/b.js' },
{ path: '/c', handler: '~/server-middleware/c.js' }
]
}
あるいは、次のとおりオブジェクトを渡して定義することもできます:
export default {
serverMiddleware: {
'/a': '~/server-middleware/a.js',
'/b': '~/server-middleware/b.js',
'/c': '~/server-middleware/c.js'
}
}
![Sébastien Chopin](/_nuxt/image/e847b9.png)
![Nazaré da Piedade](/_nuxt/image/d5c785.png)
![Nobu](/_nuxt/image/888ba6.png)
![川音리오](/_nuxt/image/345a82.png)
![Maciek Palmowski](/_nuxt/image/2bdab1.png)
![Nestor Vera](/_nuxt/image/b6ef28.png)
![Daniel Roe](/_nuxt/image/0786f3.png)
![Yue Yang](/_nuxt/image/40c994.png)
![Jeronimas](/_nuxt/image/ba9a98.png)
![Clément Ollivier](/_nuxt/image/77339c.png)
![Alexander Lichter](/_nuxt/image/073577.png)
![N3-rd](/_nuxt/image/20bdf5.png)
![Adrien Zaganelli](/_nuxt/image/c3f019.png)
![Mag](/_nuxt/image/1fe278.png)
![Stefan Huber](/_nuxt/image/c3653a.png)
![Olga Bulat](/_nuxt/image/e50af3.png)
![Paiva](/_nuxt/image/ea02f0.png)
![Florian Reuschel](/_nuxt/image/ee31ca.png)
![Savas Vedova](/_nuxt/image/d403a7.png)
![HIJACK](/_nuxt/image/d0b78e.png)
![Vinícius Alves](/_nuxt/image/ba75e5.png)
![Kareem Dabbeet](/_nuxt/image/c79dfa.png)
![Valentín Costa](/_nuxt/image/3dd0d7.png)
![Ryan Skinner](/_nuxt/image/ec2d86.png)
![Alex Hirzel](/_nuxt/image/980fb6.png)
![Ajeet Chaulagain](/_nuxt/image/2fb9d1.png)
![René Eschke](/_nuxt/image/ddfbaa.png)
![Nico Devs](/_nuxt/image/5fa1fe.png)
![Muhammad](/_nuxt/image/76bed9.png)
![Naoki Hamada](/_nuxt/image/475300.png)
![Tom](/_nuxt/image/aae9cc.png)
![Yann Aufray](/_nuxt/image/305a71.png)
![Anthony Chu](/_nuxt/image/027d85.png)
![Nuzhat Minhaz](/_nuxt/image/431077.png)
![Lucas Portet](/_nuxt/image/260cbe.png)
![Richard Schloss](/_nuxt/image/7f63ae.png)
![Bobby](/_nuxt/image/42cdae.png)
![bpy](/_nuxt/image/ecc096.png)
![Antony Konstantinidis](/_nuxt/image/1434b0.png)
![Hibariya](/_nuxt/image/febb5a.png)
![Jose Seabra](/_nuxt/image/ede04e.png)
![Eze](/_nuxt/image/f22c13.png)
![Florian Lefebvre](/_nuxt/image/e3705e.png)
![Lucas Recoaro](/_nuxt/image/8cdc5c.png)
![Julien SEIXAS](/_nuxt/image/40a795.png)