View source for WebFund 2024F: Assignment 1

Please submit the answers to the following questions via Brightspace by <del>October 7, 2024</del> '''October 9, 2024'''. There are 20 points in 6 questions.

Submit your answers as a plain text file following [https://homeostasis.scs.carleton.ca/~soma/webfund-2024f/templates/comp2406-a1-template.txt this template].  Name your answer file "comp2406-assign1-<username>.txt" (where <username> is your MyCarletonOne username).  Please make sure to use your correct student ID number otherwise your grades may not be properly recorded.

Your answers will be parsed by a script in order to help with grading so please preserve the format of the template.  No other formats will be accepted.

Note that the file should be a text file, preferably a UNIX text file (so LF line endings, not CRLF).  (See the [https://en.wikipedia.org/wiki/Text_file Wikipedia page on text files] to learn more.)

<b>You may use [https://homeostasis.scs.carleton.ca/~soma/webfund-2024f/validators/a1-validator.html this validator page] to make sure your answer file is properly named and formatted.</b>

'''Please solve each question rather than look up their answers. Solutions where the answer was found through an online search or answered by a friend or AI will likely get partial or no marks.''' The questions can only be fully answered by documenting your journey to find the answer rather than the answer itself. Outside resources and other individuals should be used to help with specific technical problems (e.g., JavaScript syntax and semantics), not to solve the problem itself. Your solution should be your own, and the journey by which you reach it should be your own.

Having said this, for each question, please include what outside resources you used to complete each of your answers, including other students, man pages, and web resources (including AI services). You do not need to list help from the instructor, TA, or information covered in lecture or tutorial.

==Questions==

<ol>
<li>[2] What directory does simpleserver2 use for serving content? How did you verify your answer was correct?
<li>[2] Does simpleserver2 support serving PDFs? (What does "support" in this context mean?) How did you verify that your answer was correct?
<li>[3] How does the behavior of simpleserver2 change if you make MIMEtype() an async function? (Be brief and specific.) How did you check this? And what could you change in simpleserver2 to make it work as before (without removing the async function declaration)?
<li>[4] Currently simpleserver2 will serve content no matter the method of the incoming request.
  <ol style="list-style-type:lower-alpha">
   <li>[2] How could you modify simpleserver2 so that it only returns content on GET requests? When it receives a non-GET method, it should return the string "Method not implemented." and the status code 501.
   <li>[2] What issues arose when implementing the answer to the previous question? How did you verify your answer was correct? (Hint: you'll probably want to use a command-line tool.)
  </ol>
<li>[4] How could you change simpleserver2 so that it loaded the page not found template from a file (rather than it being included in the source)? The template should be loaded when the server starts. Note that your solution should only use functions or methods that are in the tutorial code.
  <ol style="list-style-type:lower-alpha">
   <li>[2] What code needs to be added, changed, or removed? Be precise.</li>
   <li>[1] Why do you think your solution is correct?</li>
   <li>[1] What mistakes, errors, or other problems arose while you were developing your solution?</li>
  </ol>
<li>[5] How could you change line 80 of simpleserver2.js (the assignment of <tt>origpath</tt>) so that it directly extracted the path (pathname) from the request URL string, instead of first converting it into a URL object? You can use any built-in JavaScript string manipluation facilities, including regular expressions. Make sure your solution does not include the protocol, hostname, port number, query, or fragment. Your solution should work for any host the the server is running on.
  <ol style="list-style-type:lower-alpha">
   <li>[2] What is your solution? Please give the precise code.</li>
   <li>[1] What resources did you use while developing your solution?</li>
   <li>[1] How did you test your solution to make sure it was correct?</li>
   <li>[1] What mistakes, errors, or other problems arose while you were developing your solution?</li>
  </ol>
</ol>

==Code==

[https://homeostasis.scs.carleton.ca/~soma/webfund-2024f/code/simpleserver2.js Download simpleserver2.js]

<syntaxhighlight lang="javascript" line>
// SPDX-License-Identifier: GPL-3.0-or-later
// Copyright (C) 2024 Anil Somayaji
//
// simpleserver2.js
// for COMP 2406 (Fall 2024), Carleton University
// 
// Initial version: Sept 26, 2024
//
// run with the following command:
//    deno run --allow-net --allow-read simpleserver2.js
//

const status_NOT_FOUND = 404;
const status_OK = 200;

function MIMEtype(filename) {

    const MIME_TYPES = {
        'css': 'text/css',
        'gif': 'image/gif',
        'htm': 'text/html',
        'html': 'text/html',
        'ico': 'image/x-icon',
        'jpeg': 'image/jpeg',
        'jpg': 'image/jpeg',
        'js': 'text/javascript',
        'json': 'application/json',
        'png': 'image/png',
        'txt': 'text/text'
    };

    var extension = "";
    
    if (filename) {
        extension = filename.slice(filename.lastIndexOf('.')+1).toLowerCase();
    }

    return MIME_TYPES[extension] || "application/octet-stream";
};


function template_header(title) {
    return `<!DOCTYPE html>
<html>
  <head>
    <title>${title}</title>
  </head>
`
}

function template_notFound(path) {
    return template_header("Page not found") +
        `<body>
<h1>Page not found</h1>

<p>Sorry, the requested page was not found.</p>
</body>
</html>
`
}

async function fileData(path) {
    var contents, status, contentType;
    
    try {
        contents = await Deno.readFile("./www" + path);
        status = status_OK;
        contentType = MIMEtype(path);
    } catch (e) {
        contents = template_notFound(path);
        status = status_NOT_FOUND;
        contentType = "text/html";
    }
    
    return { contents, status, contentType };
}

async function handler(req) {

    var origpath = new URL(req.url).pathname;    
    var path = origpath;
    
    if (path === "/") {
        path = "/index.html";
    }
    
    var r = await fileData(path);

    console.log(`${r.status} ${req.method} ${r.contentType} ${origpath}`); 

    return new Response(r.contents,
                        {status: r.status,
                         headers: {
                             "content-type": r.contentType,
                         }});
}

Deno.serve(handler);
</syntaxhighlight>

==Solutions==

[https://homeostasis.scs.carleton.ca/~soma/webfund-2024f/solutions/comp2406-a1-solutions.txt Solutions for Assignment 1.]