1. Install and start a MySQL server

2. Create elide database

    mysql> create database elide;
   

3. Create elide user with password elide123

    mysql> grant all on elide.* to 'elide'@'localhost' identified by 'elide123';
   

4. Launch the example webservice

    ~/elide $ mvn install
    ~/elide $ cd elide-example/elide-persistence-mysql-example
    ~/elide/elide-example/elide-persistence-mysql-example $ mvn exec:java -Dexec.mainClass="com.yahoo.elide.example.persistence.Main"
   

5. Create an author

    $ curl -H'Content-Type: application/vnd.api+json' -H'Accept: application/vnd.api+json' --data '{
      "data": {
        "id": "-",
        "type": "author",
        "attributes": {
          "name": "Ernest Hemingway"
        }
      }
    }' -X POST http://localhost:4080/author
   

6. Create a book

    $ curl -H'Content-Type: application/vnd.api+json' -H'Accept: application/vnd.api+json' --data '{
      "data": {
        "id": "-",
        "type": "book",
        "attributes": {
          "title": "The Old Man and the Sea",
          "genre": "Literary Fiction",
          "language": "English"
        }
      }
    }' -X POST http://localhost:4080/book
   

7. Associate the author and book

    $ curl -H'Content-Type: application/vnd.api+json' -H'Accept: application/vnd.api+json' --data '{
      "data": {
        "id": "1",
        "type": "author"
      }
    }' -X PATCH http://localhost:4080/book/1/relationships/authors
   

8. Get books

    $ curl -H'Content-Type: application/vnd.api+json' -H'Accept: application/vnd.api+json' http://localhost:4080/book/
   

You can also load some pre-configured authors and books using load_elide.sh in src/main/scripts/