Table Of ContentWith React, Node.js, and Neo4j
William Lyon
M A N N I N G
{
moviesByTitle(title: "Matrix") {
title
year
}
}
4
Apollo GraphQL query
Client
1 Request
3 GraphQL API
Response
Apollo
{
"data": { Server
"moviesByTitle": [
{
"title": "Matrix
Web Reloaded, The",
client } "year": 2003 2 MATCH R(EmT:UMRoNv ime. t{ittiltel,e :m ."yMeaatrrix"})
]
} Cypher
} Bolt JavaScript driver
1 Client issues GraphQL query
2 GraphQL API sends Cypher query to Neo4j
3 Response sent to client
Database
4 Data updated in React component props and view rendered
A GraphQL request in a full stack GraphQL application
Full Stack GraphQL Applications
Full Stack
GraphQL Applications
W R , N . , N 4
ITH EACT ODE JS AND EO J
WILLIAM LYON
MANNING
SHELTER ISLAND
For online information and ordering of this and other Manning books, please visit
www.manning.com. The publisher offers discounts on this book when ordered in quantity.
For more information, please contact
Special Sales Department
Manning Publications Co.
20 Baldwin Road
PO Box 761
Shelter Island, NY 11964
Email: [email protected]
©2022 by Manning Publications Co. All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in
any form or by means electronic, mechanical, photocopying, or otherwise, without prior written
permission of the publisher.
Many of the designations used by manufacturers and sellers to distinguish their products are
claimed as trademarks. Where those designations appear in the book, and Manning
Publications was aware of a trademark claim, the designations have been printed in initial caps
or all caps.
Recognizing the importance of preserving what has been written, it is Manning’s policy to have
the books we publish printed on acid-free paper, and we exert our best efforts to that end.
Recognizing also our responsibility to conserve the resources of our planet, Manning books are
printed on paper that is at least 15 percent recycled and processed without the use of elemental
chlorine.
The author and publisher have made every effort to ensure that the information in this book
was correct at press time. The author and publisher do not assume and hereby disclaim any
liability to any party for any loss, damage, or disruption caused by errors or omissions, whether
such errors or omissions result from negligence, accident, or any other cause, or from any usage
of the information herein.
Manning Publications Co. Development editor: Karen Miller
20 Baldwin Road Technical development editor: Doug Warren
PO Box 761 Review editor: Aleksandar Dragosavljević
Shelter Island, NY 11964 Production editor: Andy Marinkovich
Copy editor: Christian Berk
Proofreader: Melody Dolab
Technical proofreader: Niek Palm
Typesetter: Gordan Salinovic
Cover designer: Marija Tudor
ISBN 9781617297038
Printed in the United States of America
brief contents
P 1 G G QL....................1
ART ETTING STARTED WITH FULL STACK RAPH
1 ■ What is full stack GraphQL? 3
2 ■ Graph thinking with GraphQL 29
3 ■ Graphs in the database 49
4 ■ The Neo4j GraphQL Library 67
P 2 B ................................................99
ART UILDING THE FRONTEND
5 ■ Building user interfaces with React 101
6 ■ Client-side GraphQL with React and Apollo Client 116
P 3 F .........................................137
ART ULL STACK CONSIDERATIONS
7 ■ Adding authorization and authentication 139
8 ■ Deploying our full stack GraphQL application 172
9 ■ Advanced GraphQL considerations 212
v
contents
preface xi
acknowledgments xii
about this book xiii
about the author xvi
about the cover illustration xvii
P 1 G G QL ......... 1
ART ETTING STARTED WITH FULL STACK RAPH
1 What is full stack GraphQL? 3
1.1 A look at full stack GraphQL 3
1.2 GraphQL 5
GraphQL type definitions 5 ■ Querying with GraphQL 7
Advantages of GraphQL 10 ■ Disadvantages of GraphQL 12
GraphQL tooling 13
1.3 React 15
React components 16 ■ JSX 16 ■ React tooling 16
1.4 Apollo 18
Apollo Server 18 ■ Apollo Client 18
1.5 Neo4j Database 18
Property graph data model 19 ■ Cypher query language 19
Neo4j tooling 20
vi
CONTENTS vii
1.6 How it all fits together 23
React and Apollo Client: Making the request 24 ■ Apollo Server
and GraphQL backend 25 ■ React and Apollo Client: Handling
the response 26
1.7 What we will build in this book 27
1.8 Exercises 28
2 Graph thinking with GraphQL 29
2.1 Your application data is a graph 30
2.2 Graphs in GraphQL 31
API modeling with type definitions: GraphQL-first development 31
Resolving data with resolvers 37 ■ Our first resolver 38
2.3 Combining type definitions and resolvers with
Apollo Server 41
Using Apollo Server 41 ■ Apollo Studio 42 ■ Implementing
resolvers 43 ■ Querying using Apollo Studio 46
2.4 Exercises 47
3 Graphs in the database 49
3.1 Neo4j overview 50
3.2 Graph data modeling with Neo4j 50
The property graph model 51 ■ Database constraints and
indexes 54
3.3 Data modeling considerations 54
Node vs. property 54 ■ Node vs. relationship 55 ■ Indexes 55
Specificity of relationship types 55 ■ Choosing a relationship
direction 55
3.4 Tooling: Neo4j desktop 55
3.5 Tooling: Neo4j Browser 56
3.6 Cypher 57
Pattern matching 57 ■ Properties 58 ■ CREATE 58
MERGE 62 ■ Defining database constraints with cypher 63
MATCH 64 ■ Aggregations 65
3.7 Using the Neo4j client drivers 65
3.8 Exercises 66
viii CONTENTS
4 The Neo4j GraphQL Library 67
4.1 Common GraphQL problems 68
Poor performance and the n + 1 query problem 68 ■ Boilerplate
and developer productivity 69
4.2 Introducing GraphQL database integrations 69
4.3 The Neo4j GraphQL Library 69
Project setup 70 ■ Generated GraphQL schema from type
definitions 74
4.4 Basic GraphQL queries 76
4.5 Ordering and pagination 79
4.6 Nested queries 80
4.7 Filtering 82
where argument 82 ■ Nested filter 82 ■ Logical operators:
AND, OR 83 ■ Filtering in selections 85
4.8 Working with temporal fields 86
Using a Date type in queries 86 ■ Date and DateTime filters 87
4.9 Working with spatial data 88
The Point type in selections 88 ■ Distance filter 89
4.10 Adding custom logic to our GraphQL API 90
The @cypher GraphQL schema directive 90 ■ Implementing
custom resolvers 94
4.11 Introspecting GraphQL schema from an existing database 96
4.12 Exercises 97
P 2 B ......................................99
ART UILDING THE FRONTEND
5 Building user interfaces with React 101
5.1 React overview 102
JSX and React elements 103 ■ React components 103
Component hierarchy 104
5.2 Create React App 104
Creating a React application with Create React App 104
5.3 State and React Hooks 110
5.4 Exercises 114
