mirror of
https://github.com/vale981/apollo-server
synced 2025-03-06 10:11:40 -05:00
40f9a4982f
Previously, we were planning to offer two kinds of APIs in "Apollo Server 2": middleware functions just like in 1.0, and the new ApolloServer class. We have not yet implemented ApolloServer for all of our supported web frameworks, so this meant that the 2.0 version of modules such as apollo-server-koa (which does not yet have an ApolloServer class) offered very little benefits over apollo-server-koa@1.0 (as most of the benefits of 2.0 come from ApolloServer). This is confusing. We are going to improve the current registerServer API so that there's no real benefit to using a separately-exported middleware directly rather than creating an ApolloServer and applying it to your web framework. So the AS 2.0 API will just be ApolloServer. This means it doesn't make sense for us to publish 2.x versions of the packages that don't yet support this API. So this commit removes support for the following web frameworks: Adonis, Azure Functions, Koa, Lambda, Micro, and Restify. (We leave in place Express, Hapi, and Cloudflare workers.) This isn't because we don't like these frameworks and don't want them to work with Apollo Server 2.0! We would love to see each package resurrected and an ApolloServer implementation built, either during this current 2.x beta phase or after the official 2.0 release. Deleting these packages for now makes it more clear which frameworks support 2.0 and which don't, rather than existing in a state where apollo-server-express@2 has ApolloServer and apollo-server-koa@2 does not.
2.9 KiB
2.9 KiB
| title | description |
|---|---|
| Express / Connect | Setting up Apollo Server with Express.js or Connect |
This is the Express and Connect integration of GraphQL Server. Apollo Server is a community-maintained open-source GraphQL server that works with many Node.js HTTP server frameworks. Read the docs. Read the CHANGELOG.
npm install apollo-server@beta apollo-server-express@beta
Express
const express = require('express');
const { registerServer } = require('apollo-server-express');
const { ApolloServer, gql } = require('apollo-server');
// Construct a schema, using GraphQL schema language
const typeDefs = gql`
type Query {
hello: String
}
`;
// Provide resolver functions for your schema fields
const resolvers = {
Query: {
hello: () => 'Hello world!',
},
};
const server = new ApolloServer({ typeDefs, resolvers });
const app = express();
registerServer({ server, app });
server.listen().then(({ url }) => {
console.log(`🚀 Server ready at ${url}`);
});
Connect
import connect from 'connect';
const { registerServer } = require('apollo-server-express');
const { ApolloServer, gql } = require('apollo-server');
// Construct a schema, using GraphQL schema language
const typeDefs = gql`
type Query {
hello: String
}
`;
// Provide resolver functions for your schema fields
const resolvers = {
Query: {
hello: () => 'Hello world!',
},
};
const server = new ApolloServer({ typeDefs, resolvers });
const app = connect();
registerServer({ server, app });
server.listen().then(({ url }) => {
console.log(`🚀 Server ready at ${url}`);
});
Principles
GraphQL Server is built with the following principles in mind:
- By the community, for the community: GraphQL Server's development is driven by the needs of developers
- Simplicity: by keeping things simple, GraphQL Server is easier to use, easier to contribute to, and more secure
- Performance: GraphQL Server is well-tested and production-ready - no modifications needed
Anyone is welcome to contribute to GraphQL Server, just read CONTRIBUTING.md, take a look at the roadmap and make your first PR!