Enums are a powerful language feature of Swift. They are more than a type-safe way of defining different states. But in this article, we’ll concentrate on the basic enum functionality in Swift and we’ll integrate them in a GraphQL API server which is based on Vapor. If you are new to GraphQL in combination with Vapor, I recommend reading my previous article where I go through the steps on how to build a GraphQL server with Swift and Vapor.

This Article can also be read on my personal blog: https://alexsteiner.de/blog/posts/graphql-with-vapor-part-2/

In this article, we’ll extend the todo API example. Therefore we use a GraphQL Vapor template as a starting point. We want to build the feature of marking a todo as done or moving it to a “for later” list. To represent the different states of a todo we make use of enums. We’ll save this state property with the rest of the information in a database and make them available through an extension to the GraphQL API that is already in place.

Creating the project

So let’s get started by creating a new Vapor project based on the GraphQL templated we build up in the previous article. Therefore we use the Vapor toolchain but instead of creating a project from the default template we specify the repository of the GraphQL template: vapor new todo-server --template=alexsteinerde/vapor-graphql-template

TodoState enum

Now we can add our enum which represents the different states our todo can be in: TodoState. As it belongs to the Todoclass we can add it as a sub-enum. We let the enum conform to String so it's prepared to be Codable and also to CaseIterable which allows us to automatically infer all possible cases when registering it in our GraphQL schema later.

Extended Todo Model

We extend our existing Todo model to store the state as a property and also add support for saving the state to a Fluent database.

We add the property state and add a new constructor parameter that can be pass in but is set to .open by default.
To support database storage of the TodoState in the used SQLite database we need to extend it and make it conform to Content and SQLiteEnumType. The first protocol is familiar in the Vapor world. But SQLiteEnumType is something that isn't used every day. This protocol requires us to implement the reflectDecoded() method. We need to provide two unique cases of our enum to make storage possible. Here we return the cases .done and .open. But we could also use .open and .forLater.

By default, we use the SQLite Fluent database which stores data in-memory. If you want to use MySQL, PostgreSQL or other databases you can look up the requirements of a storable enum at the Vapor documentation or in the Vapor Discord channel.

Business Logic API

Next, we write the business logic that lets us change the state of a todo. To identify the todo we want to change we use the id. The id and the new state are our two arguments. They can be found in the struct ChangeTodoStateArguments.

The function changeTodoState accepts the current request to use for database operations and the arguments. It returns the updated Todo as a future. To update the todo we first search for the given id. If no entry is found we throw a notFounderror. Otherwise, we replace the old state with the new one and save it to the database by calling .save(on: request).

Field Keys

To add the new state property to our GraphQL Todo type we first need to define the state case of the Todo.FieldKeysenum:

And we also add a new case to the TodoAPI.FieldKeys enum which we call changeTodoState. This will represent the name of the mutation to change the state of a todo.

We don’t need to define the names for the arguments as field keys if we don’t want to add descriptions to each argument.

Schema

Now let’s modify our schema instance in the Schema.swift file. We need to add the enum type to our Schema (1). It must be defined before any other usage of the TodoState type! The Enum constructor normally needs an array of Values that represent the cases the enum has. But with GraphQLKit an extension to the type is provided that allows enums that conform to CaseIterable to be passed directly without a list of values to the constructor. Secondly, we add the new Field state to our Todo type (2). And to switch between states we add the new mutation changeTodoState at the end (3). As mentioned earlier, we only need to provide each parameter to the mutation field if we want to add descriptions. Otherwise, it is inferred automatically by the argument type of the changeTodoState function.

Example Queries

Now that we have our API ready we can run the server and go to http://localhost:8080 to execute queries against our GraphQL API.

Conclusion

This time we added enum functionality to GraphQL. We build on top of the previous template and the end result can be found in a separate GitHub repository.

What we haven’t implemented is creating a new todo with a given state via GraphQL. But this isn’t too complicated and doesn’t require too many changes. Take it as a challenge and try implementing this by yourself and maybe you come up with some great results I haven’t thought about yet.

What are other use cases you have when developing your APIs? Do you think GraphQL can be an advantage there? Let me know your thoughts in the comments, on Twitter or via email.

--

--

--

Server Side Swift developer with background in iOS and web development.

Love podcasts or audiobooks? Learn on the go with our new app.

Recommended from Medium

SwiftUI: Using Views in a Modularized Design

5 Useful Cocoapods for Swift 5.3

How to send data from Side Menu to MainViewController in swift

Integrating Crashlytics with Carthage in 2020

Encrypting Common Scenarios in Swift

Enforce Swift style and conventions with SwiftLint

Concurrency in Swift: Avoiding the Pitfalls

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Alexander Steiner

Alexander Steiner

Server Side Swift developer with background in iOS and web development.

More from Medium

The best registries for your Swift Package

[Codility] CyclicRotation (Swift)

IOS custom view implementation

Swift Concurrency: Dispatch Semaphore