apollo-server

mirror of https://github.com/vale981/apollo-server synced 2025-03-05 09:41:40 -05:00

History

Jesse Rosenberger aae212f869 Triggers for newly introduced `serverWillStart` lifecycle hooks. This commit follows-up on #1795, which introduced the new request pipeline, and implements the triggers for its new life-cycle hooks within the various integration packages. Previously, the only implementation was within the `apollo-server` package and didn't get triggered for those invoking the `applyMiddleware` method on integrations (e.g. `apollo-server-express`, `...-hapi` and `...-koa`). While in an ideal world, ALL existing `applyMiddleware` functions would be marked as `async` functions and allow us to `await ApolloServer#willStart`, in practice the only `applyMiddleware` which is currently `async` is the one within the Hapi implementation. Therefore, we'll instead kick off the `willStart` lifecycle hook as soon as `applyMiddleware` is started, return as quickly as we have before and then (essentially) yield the completion of Apollo Server's `willStart` prior to serving the first request — thus ensuring the completion of server-startup activities. Similarly, we'll do the same for `createHandler` methods on integrations which don't utilize Node.js server frameworks but don't have `async` handlers (e.g. AWS, Lambda, etc.).		2018-10-26 15:07:13 +03:00
..
src	Triggers for newly introduced `serverWillStart` lifecycle hooks.	2018-10-26 15:07:13 +03:00
.npmignore	include readme for npm packages	2017-10-23 15:13:31 -07:00
jest.config.js	Replace `{}` with `Object.create(null)` in `jest.config.js`	2018-10-12 13:00:13 +02:00
package.json	Publish	2018-10-10 22:30:54 +03:00
README.md	fix hapi readme	2018-07-13 13:35:53 -07:00
tsconfig.json	Remove test dependencies from non-test `tsconfig.json` files	2018-10-11 12:58:03 +02:00

README.md

title	description
Hapi	Setting up Apollo Server with Hapi

This is the Hapi integration of Apollo Server. Apollo Server is a community-maintained open-source Apollo Server that works with many Node.js HTTP server frameworks. Read the docs. Read the CHANGELOG.

npm install apollo-server-hapi@rc

Usage

The code below requires Hapi 17 or higher.

const { ApolloServer, gql } = require('apollo-server-hapi');
const Hapi = require('hapi');

async function StartServer() {
  const server = new ApolloServer({ typeDefs, resolvers });

  const app = new Hapi.server({
    port: 4000
  });

  await server.applyMiddleware({
    app,
  });

  await server.installSubscriptionHandlers(app.listener);

  await app.start();
}

StartServer().catch(error => console.log(error));

Context

The context is created for each request. The following code snippet shows the creation of a context. The arguments are the request, the request, and h, the response toolkit.

new ApolloServer({
  typeDefs,
  resolvers,
  context: async ({ request, h }) => {
    return { ... };
  },
})

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, take a look at the roadmap and make your first PR!