From de79a806d915bf13eb68681bac4f46915efd0ad5 Mon Sep 17 00:00:00 2001
From: rafliesa <rflisaa@gmail.com>
Date: Fri, 28 Mar 2025 14:55:56 +0700
Subject: [PATCH] Reflection Subscriber-1
---
README.md | 92 ++-----------------------------------------------------
1 file changed, 3 insertions(+), 89 deletions(-)
diff --git a/README.md b/README.md
index 7e0fc90..5a4d436 100644
--- a/README.md
+++ b/README.md
@@ -1,89 +1,3 @@
-# BambangShop Receiver App
-Tutorial and Example for Advanced Programming 2024 - Faculty of Computer Science, Universitas Indonesia
-
----
-
-## About this Project
-In this repository, we have provided you a REST (REpresentational State Transfer) API project using Rocket web framework.
-
-This project consists of four modules:
-1. `controller`: this module contains handler functions used to receive request and send responses.
- In Model-View-Controller (MVC) pattern, this is the Controller part.
-2. `model`: this module contains structs that serve as data containers.
- In MVC pattern, this is the Model part.
-3. `service`: this module contains structs with business logic methods.
- In MVC pattern, this is also the Model part.
-4. `repository`: this module contains structs that serve as databases.
- You can use methods of the struct to get list of objects, or operating an object (create, read, update, delete).
-
-This repository provides a Rocket web framework skeleton that you can work with.
-
-As this is an Observer Design Pattern tutorial repository, you need to implement a feature: `Notification`.
-This feature will receive notifications of creation, promotion, and deletion of a product, when this receiver instance is subscribed to a certain product type.
-The notification will be sent using HTTP POST request, so you need to make the receiver endpoint in this project.
-
-## API Documentations
-
-You can download the Postman Collection JSON here: https://ristek.link/AdvProgWeek7Postman
-
-After you download the Postman Collection, you can try the endpoints inside "BambangShop Receiver" folder.
-
-Postman is an installable client that you can use to test web endpoints using HTTP request.
-You can also make automated functional testing scripts for REST API projects using this client.
-You can install Postman via this website: https://www.postman.com/downloads/
-
-## How to Run in Development Environment
-1. Set up environment variables first by creating `.env` file.
- Here is the example of `.env` file:
- ```bash
- ROCKET_PORT=8001
- APP_INSTANCE_ROOT_URL=http://localhost:${ROCKET_PORT}
- APP_PUBLISHER_ROOT_URL=http://localhost:8000
- APP_INSTANCE_NAME=Safira Sudrajat
- ```
- Here are the details of each environment variable:
- | variable | type | description |
- |-------------------------|--------|-----------------------------------------------------------------|
- | ROCKET_PORT | string | Port number that will be listened by this receiver instance. |
- | APP_INSTANCE_ROOT_URL | string | URL address where this receiver instance can be accessed. |
- | APP_PUUBLISHER_ROOT_URL | string | URL address where the publisher instance can be accessed. |
- | APP_INSTANCE_NAME | string | Name of this receiver instance, will be shown on notifications. |
-2. Use `cargo run` to run this app.
- (You might want to use `cargo check` if you only need to verify your work without running the app.)
-3. To simulate multiple instances of BambangShop Receiver (as the tutorial mandates you to do so),
- you can open new terminal, then edit `ROCKET_PORT` in `.env` file, then execute another `cargo run`.
-
- For example, if you want to run 3 (three) instances of BambangShop Receiver at port `8001`, `8002`, and `8003`, you can do these steps:
- - Edit `ROCKET_PORT` in `.env` to `8001`, then execute `cargo run`.
- - Open new terminal, edit `ROCKET_PORT` in `.env` to `8002`, then execute `cargo run`.
- - Open another new terminal, edit `ROCKET_PORT` in `.env` to `8003`, then execute `cargo run`.
-
-## Mandatory Checklists (Subscriber)
-- [ ] Clone https://gitlab.com/ichlaffterlalu/bambangshop-receiver to a new repository.
-- **STAGE 1: Implement models and repositories**
- - [ ] Commit: `Create Notification model struct.`
- - [ ] Commit: `Create SubscriberRequest model struct.`
- - [ ] Commit: `Create Notification database and Notification repository struct skeleton.`
- - [ ] Commit: `Implement add function in Notification repository.`
- - [ ] Commit: `Implement list_all_as_string function in Notification repository.`
- - [ ] Write answers of your learning module's "Reflection Subscriber-1" questions in this README.
-- **STAGE 3: Implement services and controllers**
- - [ ] Commit: `Create Notification service struct skeleton.`
- - [ ] Commit: `Implement subscribe function in Notification service.`
- - [ ] Commit: `Implement subscribe function in Notification controller.`
- - [ ] Commit: `Implement unsubscribe function in Notification service.`
- - [ ] Commit: `Implement unsubscribe function in Notification controller.`
- - [ ] Commit: `Implement receive_notification function in Notification service.`
- - [ ] Commit: `Implement receive function in Notification controller.`
- - [ ] Commit: `Implement list_messages function in Notification service.`
- - [ ] Commit: `Implement list function in Notification controller.`
- - [ ] Write answers of your learning module's "Reflection Subscriber-2" questions in this README.
-
-## Your Reflections
-This is the place for you to write reflections:
-
-### Mandatory (Subscriber) Reflections
-
-#### Reflection Subscriber-1
-
-#### Reflection Subscriber-2
+# Reflection Subscriber-1
+## 1.In this tutorial, we used RwLock<> to synchronise the use of Vec of Notifications. Explain why it is necessary for this case, and explain why we do not use Mutex<> instead?
+Dengan menggunakan RwLock<>, kita memastikan bahwa proses konkurensi terjadi secara aman. Kita memastikan bahwa proses read diblok hanya ketika terjadi proses write. Berbeda dengan mutex yang hanya mengizinkan 1 thread untuk mengakses data dalam satu waktu.
\ No newline at end of file
--
GitLab