17-Frameworks_exercise/

README

Exercise: Implement the GoWorkshop API

Choice of Frameworks

• Gin
• Echo
• Goji

Endpoints are:

courses:

• create a course POST /courses
• show a course GET /course
• delete a course DELETE /courses/:id

registrations:

• create a registration POST /registrations
• show a registration GET /registration/:id
• list all registrations GET /registrations

The following commands using the httpie should work given that the service is running and listening on port 8000:

http POST localhost:8000/courses name=new_course description="awesome content" start_time=2016-11-02T09:00:00-08:00 end_time=2016-11-02T17:00:00-08:00 location="Santa Barbara"
http localhost:8000/courses/10 -v
http DELETE localhost:8000/courses/10 -v

http localhost:8000/registrations -v
http POST localhost:8000/registrations first_name=me last_name=here address:='{"number":43,"street":"Some Street","city":"Denver","state":"CO","zip":80205}' course_href=/courses/1 -v
http localhost:8000/registrations -v
http localhost:8000/registrations/11 -v

Database

The library package implements a in-memory database:

	import "github.com/bketelsen/buildingapis/exercises/library"

Create a new database with:

	db := library.NewDB()

The database contains pre-seeded data. To create an empty database use:

	db := library.NewEmptyDB()

Insert

	model := &library.RegistrationModel{
		ID:        library.NewID(),
		CourseID:  courseID,
		FirstName: firstName,
		LastName:  lastName,
		Address:   address,
	}
	err := db.Insert("registrations", model)

Get

	list, err := db.List("registrations", "id", strconv.Itoa(id))

List

	list, err := db.List("registrations", "id", nil)

Delete

	err := db.Delete("courses", "id", strconv.Itoa(id))

Reminder:

The GoWorkshop API consists of two resources:

• courses represent a specific workshop course with start and end times and a location.
• registrations represent a registration to a course with details about the attendee.

It should be possible to create, show and delete courses and create, show and list registrations.

The course type should have the following fields:

Name	Type	Description
id	Integer	Course identifier
href	String	API relative URI
name	String	Course name
description	String	Description
start_time	DateTime	Start date and time
end_time	DateTime	End date and time
location	String	Location (city)

The registration type should have the following fields:

Name	Type	Description
id	Integer	Identifier
href	String	API relative URI
first_name	String	Course name
last_name	String	Description
address	Address	Start date and time

The Address type should have the following fields:

Name	Type	Description
number	Integer	Street Number
street	String	Street Name
city	String	City name
state	String	US State code
zip	Integer	US Zip code