A simple example of an API-based web app.
This week we are not doing tests, instead you should make sure all your previous tests are passing, and then you can play with the JStagram example app. For inspiration, here is a list of things you might consider doing in JStagram:
- fix: delete an uploaded file if it isn't an image (packages such as file_type or jimp may help here).
- new feature: add paging to the main page to go beyond the first 10 results (you might want to define query parameter
page
for that) - new feature: add a per-picture page to show a single picture nicely
- new feature: look for a thumbnail package and process the image into full resolution for viewing and thumbnail for the index page
- new feature if you like databases: make title search full-text - MySQL has fulltext indexes and search functions
NB: if you're choosing an image processing package the benefit of choosing a native JS library is that it will work on any platform. Conversely the benefit of something that's compiles for a specific OS is native speed. We tend to favour potability for ease of development by many users.
To get the example running, you must install the source code and all modules and then run the server from the command line:
- To download the code, either use git (the simplest option):
git clone https://github.com/portsoc/ws_api.git
cd ws_api
or download and unpack the zip which on linux can be achieved using
wget https://github.com/portsoc/ws_api/archive/master.zip
then
unzip master.zip
cd ws_api-master
- To download any libraries the code uses, type:
npm install
- Start the server by typing:
npm start
- Visit your website.
- If you're on your VM you just need to put your VM's IP address into a browser, or if you're developing on a desktop machine it will be http://127.0.0.1:8080 .
-
Do the first two steps above
-
Change the mention of
model-inmemory
tomodel-mysql
inserver.js
. -
Install and run MySQL.
- If you're using your VM for this, MySQL is already installed and running.
-
Edit
examples/config.json
so that your databasehost
,user
andpassword
properties are correct.- The defaults should work on your VM.
-
Install the database and tables using:
npm run initsql
- If your
host
anduser
differ from the defaults, you may need to updatepackage.json
for theinitsql
script to work.
- If your
-
Start the server by typing:
npm start
- Visit your website.
- If you're on your VM you just need to put your VM's IP address into a browser, or if you're developing on a desktop machine it will be http://127.0.0.1:8080 .
If at all possible, we recommend you use git to download code rather than zips of a repository. This is preferable because if the repo is updated, then syncing those changes requires just one command (git pull
) and usually any merging can be done automatically. Git is very powerful and we heartily encourages you to become familiar with it.