mirror of
https://github.com/vale981/apollo-server
synced 2025-03-13 22:36:42 -04:00
94 lines
3.3 KiB
Markdown
94 lines
3.3 KiB
Markdown
---
|
|
title: Hapi
|
|
description: Setting up Apollo Server with Hapi
|
|
---
|
|
|
|
[](https://badge.fury.io/js/apollo-server-core) [](https://circleci.com/gh/apollographql/apollo-cache-control-js) [](https://coveralls.io/github/apollographql/apollo-server?branch=master) [](https://www.apollographql.com/#slack)
|
|
|
|
This is the Hapi integration of Apollo Server. Apollo Server is a community-maintained open-source Apollo Server that works with all Node.js HTTP server frameworks: Express, Connect, Hapi, Koa and Restify. [Read the docs](https://www.apollographql.com/docs/apollo-server/). [Read the CHANGELOG.](https://github.com/apollographql/apollo-server/blob/master/CHANGELOG.md)
|
|
|
|
```sh
|
|
npm install apollo-server@beta apollo-server-hapi@beta
|
|
```
|
|
|
|
## Usage
|
|
|
|
After constructing Apollo server, a hapi server can be enabled with a call to `registerServer`. Ensure that `autoListen` is set to false in the `Hapi.server` constructor.
|
|
|
|
The code below requires Hapi 17 or higher.
|
|
|
|
```js
|
|
const { ApolloServer, gql } = require('apollo-server');
|
|
const { registerServer } = require('apollo-server-hapi');
|
|
|
|
const HOST = 'localhost';
|
|
|
|
const typeDefs = gql`
|
|
type Query {
|
|
hello: String
|
|
}
|
|
`;
|
|
|
|
const resolvers = {
|
|
Query: {
|
|
hello: () => 'hello',
|
|
},
|
|
}
|
|
|
|
async function StartServer() {
|
|
const server = new ApolloServer({ typeDefs, resolvers });
|
|
|
|
await registerServer({
|
|
server,
|
|
//Hapi Server constructor options
|
|
options: {
|
|
host: HOST,
|
|
},
|
|
});
|
|
|
|
server.listen().then(({ url }) => {
|
|
console.log(`🚀 Server ready at ${url}`);
|
|
});
|
|
}
|
|
|
|
StartServer().catch(error => console.log(error));
|
|
```
|
|
|
|
For more advanced use cases or migrating from 1.x, a Hapi server can be constructed and passed into `registerServer`.
|
|
|
|
```js
|
|
const { ApolloServer, gql } = require('apollo-server');
|
|
const { registerServer } = require('apollo-server-hapi');
|
|
const Hapi = require('hapi');
|
|
|
|
async function StartServer() {
|
|
const server = new ApolloServer({ typeDefs, resolvers });
|
|
|
|
const app = new Hapi.server({
|
|
//autoListen must be set to false, since Apollo Server will setup the listener
|
|
autoListen: false,
|
|
host: HOST,
|
|
});
|
|
|
|
await registerServer({
|
|
server,
|
|
app,
|
|
});
|
|
|
|
server.listen().then(({ url }) => {
|
|
console.log(`🚀 Server ready at ${url}`);
|
|
});
|
|
}
|
|
|
|
StartServer().catch(error => console.log(error));
|
|
```
|
|
|
|
## Principles
|
|
|
|
Apollo Server is built with the following principles in mind:
|
|
|
|
* **By the community, for the community**: Apollo Server's development is driven by the needs of developers
|
|
* **Simplicity**: by keeping things simple, Apollo Server is easier to use, easier to contribute to, and more secure
|
|
* **Performance**: Apollo Server is well-tested and production-ready - no modifications needed
|
|
|
|
Anyone is welcome to contribute to Apollo Server, just read [CONTRIBUTING.md](https://github.com/apollographql/apollo-server/blob/master/CONTRIBUTING.md), take a look at the [roadmap](https://github.com/apollographql/apollo-server/blob/master/ROADMAP.md) and make your first PR!
|